Obter agente de IA por ID
GET/ai-agents/:id
Returns the same shape as the rows from the list endpoint. Requires scope finance/ai_agents with access level read. 404 covers both "doesn't exist" and "not in the tenant" — the API does not distinguish.
Requisição
Respostas
- 200
- 401
- 403
- 404
- 429
- 500
Get an AI agent by id
Missing / invalid / expired / revoked token.
Token lacks the finance/ai_agents scope or the read access level, or sub does not match any workspace.
AI agent not found among the token person's agents in the workspace.
Rate limit exceeded for this token. Reads and writes have separate budgets, both on a 1-hour sliding window. The response carries X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset and Retry-After — wait out Retry-After rather than retrying immediately.
Unhandled server error.