Skip to content
by Unity Nodes
Partner docsapi reference › admin › update an organization member role as a system administrator

NEAR AI Cloud: Update an organization member role as a system administrator.

Updated 13-11-2026

PUT /v1/admin/organizations/{org_id}/members/{user_id} Update an organization member role as a system administrator. Deprecated: this endpoint is moving to cloud-platform at the same path; the cloud-platform base URL will be announced. Behaviour may differ in edge cases.

Assigning the owner role transfers ownership from the current owner to an existing organization member. The previous owner is demoted to admin.

Admin permissions: admin session or read_write token. A read_only token receives HTTP 403 with error.type insufficient_permissions before the handler runs.

Parameters:

  • org_id (path, string, required): Organization ID.
  • user_id (path, string, required): User ID.

Request body (application/json):

  • role (string, required): Member role enum for API. one of owner, admin, member

Responses: 200: Member role updated

  • id (string, required)
  • invited_by (string)
  • joined_at (string, date-time, required)
  • organization_id (string, required)
  • role (string, required): one of owner, admin, member
  • user_id (string, required) 400: Invalid request 401: Unauthorized 403: System administrator privileges required Missing admin privileges (forbidden) or insufficient token permission (insufficient_permissions). 404: Organization or member not found 422: Malformed request body 500: Internal server error