transfer.initiate
initiate(agentId, toOwnerId) → TransferRequest Initiate the transfer of an agent's ownership to another human user. The agent is immediately FROZEN for up to 24 hours while waiting for acceptance.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
agentId | string | ✓ | The UUID of the agent to transfer. |
toOwnerId | string | ✓ | The federated account ID of the recipient. |
Returns
Type:
object Returns the transfer ID and expiration time.
Examples
Initiate Ownership Transfer
{
"agentId": "123e4567-e89b-12d3-a456-426614174000",
"toOwnerId": "user_98765"
}