Users

Modify user

Modifies a user's role in the organization.

post/organization/users/{user_id}

Path parameters

user_idstring required

The ID of the user.

Request body

rolestring nullable

owner or reader

role_idstring nullable

Role ID to assign to the user.

technical_levelstring nullable

Technical level metadata.

developer_personastring nullable

Developer persona metadata.

Response

User role updated successfully.

object'organization.user' required

The object type, which is always organization.user

idstring required

The identifier, which can be referenced in API endpoints

namestring nullable

The name of the user

emailstring nullable

The email address of the user

rolestring nullable

owner or reader

added_atinteger required

The Unix timestamp (in seconds) of when the user was added.

is_defaultboolean

Whether this is the organization's default user.

createdinteger

The Unix timestamp (in seconds) of when the user was created.

is_service_accountboolean

Whether the user is a service account.

is_scale_tier_authorized_purchaserboolean nullable

Whether the user is an authorized purchaser for Scale Tier.

is_scim_managedboolean

Whether the user is managed through SCIM.

api_key_last_used_atinteger nullable

The Unix timestamp (in seconds) of the user's last API key usage.

technical_levelstring nullable

The technical level metadata for the user.

developer_personastring nullable

The developer persona metadata for the user.

Changes

Changed in 4 of the 164 revisions of this API.923

Sep 25, 2026d86203de41ae4See the full diff
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  added the non-success response with the status
  response-non-success-status-added
May 13, 202674cbcf73838f818See the full diff
- ▲
  removed the enum value owner of the request property
  request-property-enum-value-removed
- ▲
  removed the enum value reader of the request property
  request-property-enum-value-removed
- ▲
  the response property became optional for the status
  response-property-became-optional
- ▲
  the response property became optional for the status
  response-property-became-optional
- ▲
  the response property became optional for the status
  response-property-became-optional
- ▲
  response property email list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property name list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  response property role list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ○
  the endpoint scheme security AdminApiKeyAuth was added to the API
  api-security-added
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property
- ○
  the request property became optional
  request-property-became-optional
- ○
  request property list-of-types was widened by adding types null to media type application/json
  request-property-list-of-types-widened
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  removed the owner enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the reader enum value from the response property for the response status
  response-property-enum-value-removed
This revision also has 40 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Oct 17, 2024cc9f99ba40bc1See the full diff
- ▲
  added the new path request parameter user_id
  new-request-path-parameter
Aug 6, 20248eca3b09b7051See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history