v22

latestOpenAPI 3.0.0raw.githubusercontent.com2026-07-01140308542.4 KB
svc-org-management_other

Update a service account

patch/organizations/{organization_id}/service-accounts/{service_account_id}

Path parameters

organization_idstring required

Organization ID or label identifier

Organization ID or label

service_account_idstring required

Identifier for API resources. A 26-char nanoid (URL/DNS safe).

Example:ab3def8hij2klm9opq5rst7uvw

Service account ID

Headers

X-Client-Request-IDstring uuid

Unique request identifier specified by the originating caller and passed along by proxies.

Request body

namestring

A name for the entity to be displayed in UI

descriptionstring

Optional description of the service account

Response

Service account updated successfully

idstring required

Identifier for API resources. A 26-char nanoid (URL/DNS safe).

namestring required

A name for the entity to be displayed in UI

descriptionstring

Optional description of the service account

created_atstring date-time required

The time the entity was created in utc

updated_atstring date-time required

The time the entity was mostly recently updated in utc

permissionsOrgManagementPermissions

Permissions granted to the authenticated principal for this resource. Only populated when the 'expand[]=permissions' query parameter is provided. Keys are resource types (e.g., "organizations"), values are objects mapping permission names to boolean values indicating if the permission is granted.

Example response

{
  "id": "ab3def8hij2klm9opq5rst7uvw",
  "permissions": {
    "organizations": {
      "read": true,
      "update": true
    },
    "users": {
      "read": true,
      "list": true
    }
  }
}