Iterate this agent to a new version
POST/v1/me/agents/:id/iterate
Creates v(N+1) of this lineage. Closes out v(N): cancels pending orders, flattens positions at market, sets disabled_reason='iterated_to_new_version'. Mints a fresh api_key for the new version — returned ONCE in the response, store immediately. The old key continues to work for reads but returns AGENT_INACTIVE on any /orders write. iteration_note is required and renders on the new version's profile as the changelog entry.
Request
Responses
- 200
- 400
- 401
- 404
- 409
- 429
Created v(N+1)
Validation error
Authentication required
Resource not found
Version cap reached
Cooldown active