Roles

Update a role

Changed on

Update a custom role by its ID. At least one field must be provided. Predefined roles cannot be updated.

Payload Requirements

  • At least one of name, description, or permissions must be provided.
  • When permissions is provided, the existing permissions are fully replaced with the new set.
  • name, if provided, must be unique within the account.
  • System-managed fields (id, created_at, updated_at, is_predefined) cannot be modified.

Valid example

{
  "name": "Senior Data Scientist",
  "permissions": ["PROJECT_READ", "DATASET_READ", "DATASET_CREATE", "DATASET_DELETE"]
}

Invalid example (no fields provided)

{}
patch/v2/roles/{role_id}

Request

  • Base URL
    https://api.arize.com
  • URL
    https://api.arize.com/v2/roles/{role_id}
  • Auth
    HTTP bearer

Path parameters

role_idstring required

A universally unique identifier (base64-encoded opaque string).

Example:RW50aXR5OjEyMzQ1

The unique role identifier (base64)

Request body

namestring

Updated name for the role. Must be unique within the account.

descriptionstring nullable

Updated description of the role. Set to null to clear it.

permissionsPermission[]

Replacement set of permissions. When provided, the existing permissions are fully replaced. Each value must be a valid permission identifier.

Response

A role object.

idstring required

Unique identifier for the role.

namestring required

Human-readable name of the role.

descriptionstring

A brief description of the role's purpose.

permissionsPermission[] required

List of permissions granted by this role. Each value corresponds to a permission identifier (e.g. PROJECT_READ, DATASET_CREATE). Returned only to callers with ROLE_READ.

is_predefinedboolean required

Whether this role is a system-defined predefined role. Predefined roles cannot be updated or deleted.

created_atstring date-time required

Timestamp when the role was created.

updated_atstring date-time required

Timestamp when the role was last updated.

Changes

  • 84ac8681f9e2Revision changes
    • warning

      added the new PROJECT_SPAN_EVAL_FEEDBACK_UPDATE enum value to the / response property for the response status

    • info

      added the new PROJECT_SPAN_EVAL_FEEDBACK_UPDATE enum value to the request property /

  • ab71b10cee8fRevision changes
    • warning

      added the new DASHBOARD_TEMPLATE_CREATE enum value to the / response property for the response status

    • warning

      added the new DASHBOARD_TEMPLATE_DELETE enum value to the / response property for the response status

    • warning

      added the new DASHBOARD_TEMPLATE_READ enum value to the / response property for the response status

    • warning

      added the new DASHBOARD_TEMPLATE_UPDATE enum value to the / response property for the response status

    • info

      added the new DASHBOARD_TEMPLATE_CREATE enum value to the request property /

    • info

      added the new DASHBOARD_TEMPLATE_DELETE enum value to the request property /

    • info

      added the new DASHBOARD_TEMPLATE_READ enum value to the request property /

    • info

      added the new DASHBOARD_TEMPLATE_UPDATE enum value to the request property /