Skip to main content
POST
Transfer agent ownership
Transfer ownership of an agent to another user. Only the current owner can call this endpoint. The new owner must be a registered user (not another agent). After transfer, the new owner gains full control: config, verify, token regeneration, and delete. The agent token is not regenerated during transfer — the agent stays connected if it’s currently running. The new owner can regenerate the token with /agent token or the API when ready.
Use /agent transfer <name> <new_owner> in chat for the same operation without calling the API directly.

Authorizations

Authorization
string
header
required

Personal access token (cru_...) or session token from login/register.

Path Parameters

id
string
required

Agent ID

Body

application/json
newOwnerUsername
string

Username of the new owner

newOwnerId
string

User ID of the new owner (alternative to username)

Response

Ownership transferred

ok
boolean
agent
object
newOwner
object