For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Log inBook a demo
GuidesAPI Reference
GuidesAPI Reference
  • API Reference
      • GETList Current Org Users
      • POSTCreate Current Org User
      • GETGet Current Org User
      • PUTUpdate Current Org User
      • DELDelete Current Org User
      • GETList Partner Users
      • POSTCreate Partner User
      • GETGet Partner User
      • PUTUpdate Partner User
      • DELDelete Partner User
      • POSTCreate Partner User API Key
Logo
Log inBook a demo
API ReferenceUsers

Update Current Org User

PUT
https://app.polytomic.com/api/organization/users/:id
PUT
/api/organization/users/:id
$curl -X PUT https://app.polytomic.com/api/organization/users/248df4b7-aa70-47b8-a036-33ac447e668d \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json" \
>     -d '{}'
1{
2  "data": {
3    "email": "jane.doe@polytomic.com",
4    "id": "248df4b7-aa70-47b8-a036-33ac447e668d",
5    "organization_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
6    "role_ids": [
7      "9f8e7d6c-5b4a-3210-fedc-ba9876543210"
8    ],
9    "role": "admin"
10  }
11}
Updates the permissions roles assigned to a user in the caller's current organization. Only the user's role assignments are modified. Profile information such as name and email address is not affected by this endpoint.
Was this page helpful?
Previous

Delete Current Org User

Next

Authentication

AuthorizationBearer
Bearer user API key
OR
AuthorizationBasic

Basic organization-scoped API key

Path parameters

idstringRequiredformat: "uuid"
Unique identifier of the user to update.

Headers

X-Polytomic-VersionstringOptional

Request

This endpoint expects an object.
role_idslist of stringsOptional
Identifiers of the permissions roles to assign to the user. Must contain at least one entry when provided.
rolestringOptionalDeprecated

Deprecated legacy role name. Use role_ids instead.

Response

OK
dataobject

Errors

403
Forbidden Error
422
Unprocessable Entity Error
500
Internal Server Error