Early access A pod manager is an AI that you approved to act on one pod. The AI has its own signing key in tuyo-signer. Tuyo never sees the key. The AI needs a client that can run code and keep a key safe, such as Claude Code or Codex. Without one, the AI uses proposals instead.

Become a manager

1

Set up the signer

The AI calls get_manager_signer. It returns the steps to install tuyo-signer and create a key. The tool calls no API and changes nothing.
2

Request management

The AI finds the pod with list_pods and calls propose_pod_management. You approve the request in the Tuyo app.
3

Wait for your decision

The AI calls get_pod_management_proposal. Each call can wait up to 25 seconds. The AI stops waiting five minutes after the request.
Only list_managed_pods shows the pods that the AI can manage now. An old approved request does not prove that access is still active.

Act on the pod

Sends, conversions and vault moves use an execution:
  1. The AI calls a prepare tool: prepare_send, prepare_convert, prepare_vault_deposit or prepare_vault_withdrawal.
  2. The AI signs the returned signing object with tuyo-signer sign-execution. It does not change the object.
  3. The AI calls submit_execution with the executionId. Tuyo checks the permission again, cosigns and broadcasts it.
  4. The AI follows the execution with get_execution until it is succeeded, failed, expired or refunded.
After submit_execution, the money moves. This cannot be undone.
A manager pays for purchases with prepare_purchase. It does not sign an execution. See Purchases.

What a manager can do

  • Send from the pod to a Tuyo username, an address, or a bank account. For a bank account, list_external_bank_accounts must show managerExecutionEligibility.eligible: true.
  • Convert tokens inside the pod.
  • Move the pod’s money into or out of an investment vault.
  • Pay for a purchase with a card from the pod.
Money into the pod still needs a proposal.

When a response is lost

The AI must not prepare or request again at once: Submitting the same executionId again cannot move money twice.

Stop managing a pod

Ask the AI to call revoke_pod_management. To manage the pod again, the AI needs a new request and your approval.