Update an agent

Update an agent's status or cash allocation. All fields are optional —
only include the ones you want to change.

Status transitions

FromToEffect
activepausedAgent stops accepting new orders
pausedactiveAgent resumes accepting orders
active / pauseddisabledPermanently disabled, cannot be re-enabled

Adjusting cash

Increasing allocation deducts from your unallocated balance. Decreasing
it returns cash to the unallocated pool.

# Pause an agent
curl -X PATCH https://api.usetradecraft.io/v1/agents/momentum-trader \
  -H "Authorization: Bearer al_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "status": "paused" }'

# Increase allocation
curl -X PATCH https://api.usetradecraft.io/v1/agents/momentum-trader \
  -H "Authorization: Bearer al_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "cash_allocation": 7500 }'
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The agent's unique name (lowercase, no spaces).

Body Params
string
enum

New status for the agent.

Allowed:
number
≥ 0.01

New total cash allocation (replaces current value).

Responses

Language
Credentials
Bearer
tc_...
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json