Change a team member's role on an entity

PATCH

/entity-access/{id}

Update the role assigned to an existing entity access (team membership) record, replacing its permission set with the ACLs associated with the new role. Only identities with the can_change_entity_member_role permission (granted via the * wildcard or that specific ACL) on the entity may perform this action. The entity owner's access record cannot be modified through this endpoint.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Query Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

The member's role was updated successfully. The response reflects the new role and its display name.

Bodyapplication/json

🟠400

🟠401

🟠403

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH '/entity-access/01HQZR2BKPFQ8MXJVT3G7LWNE?entity_id=01HQZR2BKPFQ8MXJVT3G7LWNA' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "role": "operations"
}'

Response Example

200 - Success

{
    "message": "Entity access role updated successfully",
    "status": "success",
    "data": {
        "id": "01HQZR2BKPFQ8MXJVT3G7LWNE",
        "identity_id": "01HQZR2BKPFQ8MXJVT3G7LW01",
        "role": "operations",
        "role_name": "Operations"
    }
}

Modified at 2026-09-30 00:29:30

Create a currency conversion quote

Remove a member's access to an entity