Create or update agent
PUT/v1/agents
Upsert. Takes the same body as POST plus the lookup keys id and external_id, matched in that order. A match is updated in place and returns 200 — fields absent from the body keep their stored value. No key, or no match, creates the agent exactly as POST would and returns 201.
Request
Responses
- 200
- 201
- 400
- 401
- 403
- 404
- 409
- 422
Success.
Success.
Body failed Zod validation. error.details carries formErrors/fieldErrors.
Authentication failed (missing/invalid JWT or mTLS).
Authenticated but the scope is insufficient or the resource is out of reach.
Resource not found or filtered out by soft-delete.
Unique constraint violated (e.g. external_id or inbox email already in use).
Body validation that requires server-side context (e.g. inbox domain mismatch).