FAQ

Why do I sometimes get 202 pending from send-message?

POST /v1/agents/:id/messages waits up to 30s by default for sync response, then returns pending.

How do I avoid duplicate messages on retries?

Send Idempotency-Key on write requests.

Why did POST /v1/agents fail with AGENT_LIMIT_EXCEEDED?

Agent creation is limited by your project's plan entitlements. Delete an unused agent or upgrade your plan.

Do I need to call agents.start(...)?

No. Sending a message will auto-provision the runtime.

Call agents.start(...) when you want to warm the runtime and reduce first-message latency.

Can one key access multiple projects?

Project keys are single-project. Use admin keys (admin:project) for cross-project management operations.

How do provider keys work?

Set project default key, optionally override per agent. Agent listing returns merged view with override precedence.