Creation
A service account belongs to one organization and has a name and a description.POST /v2/iam/service_accounts
Output
GET /v2/iam/service_accounts lists the organization’s service accounts, PATCH /v2/iam/service_accounts/{id} renames one, and POST /v2/iam/service_accounts/{id}/actions/disable stops every token it holds until .../actions/enable.
Tokens
A service account token authenticates a request as the service account. Telnyx returns its value in the creation response only.POST /v2/iam/service_accounts/{id}/tokens
Output
Authorization: Bearer <token>. DELETE /v2/iam/service_accounts/{id}/tokens/{token_id} revokes it, and .../tokens/{token_id}/actions/deactivate pauses it.
Grants
Each grant gives the service account one role, and it can hold up to ten. Their statements decide every request its tokens send.POST /v2/iam/grants
action_ids and role_ids a service account carries from before IAM no longer apply. A service account without a grant is refused every action.
A service account token cannot manage IAM. Roles, grants, and settings are changed by the organization owner.