SecureAuth Agent Authority
secureauth.com
Request demoFree trial
APIAuth

Replace a user's roles

Replace the roles a person holds.

PUT
/users/{user_id}/roles

Replace the roles a person holds.

Authorization

ApiKeyAuth
headerAuthorizationBearer <token>

Bearer token authentication. Send an API key (a saai_api_-prefixed token) as Authorization: Bearer <token>.

Required permission

manage_roles

Path Parameters

user_id*string
Formatuuid

Request Body

application/json
  1. body

The roles a person holds. Replacing the set is how roles are assigned.

role_ids*array<>

Response Body

The request has succeeded.

application/json
  1. response
items*array<>
Example Request
curl -X PUT 'https://your-org.aisecurity.services.us.connect.secureauth.com/api/v1/users/497f6eca-6276-4993-bfeb-53cbbbba6f08/roles' \  -H 'Content-Type: application/json' \  -d '{  "role_ids": [    "3805f8ab-a16f-4b9c-912c-4f3e3ae2a6f1"  ]}'
Example Response
{  "items": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "name": "string",      "system": true    }  ]}

Update a role PUT

Replace a custom role's name, description, and permissions.

Read judge model GET

The model the DLP judge runs on for this organization and where that choice comes from. Never the endpoint or credential.