Transfer ownership of an entity

POST

/entity-ownership-transfers

Transfers ownership of an entity from the authenticated identity to another identity that already has resource access to that entity. The authenticated identity must currently be the entity's owner; the new owner is identified by the id of their existing identity-resource-access record on the entity (not by their identity id), and they must not already be the owner. On success, the previous owner is demoted to the administrator role (retaining full administrative access) and the new owner's access record is promoted to owner with unrestricted permissions. Both updates happen atomically within a single database transaction — if either update fails, neither is applied.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

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

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Ownership of the entity was transferred successfully.

Bodyapplication/json

🟠400

🟠401

🟠403

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location '/entity-ownership-transfers' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "entity_id": "01HQZR2BKPFQ8MXJVT3G7LW01",
    "new_owner_access_id": "01HQZR2BKPFQ8MXJVT3G7LWNA"
}'

Response Example

201 - Success

{
    "message": "Entity ownership transferred successfully",
    "status": "success",
    "data": {
        "entity_id": "01HQZR2BKPFQ8MXJVT3G7LW01",
        "previous_owner_access_id": "01HQZR2BKPFQ8MXJVT3G7LW02",
        "new_owner_access_id": "01HQZR2BKPFQ8MXJVT3G7LWNA"
    }
}

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

Revoke an entity access invite

Update the authenticated identity's name