Criar ou atualizar agente
PUT/v1/agents
Upsert. Recebe o mesmo corpo do POST mais as chaves de busca id e external_id, casadas nessa ordem. Um match é atualizado in place e responde 200 — campos ausentes do corpo mantêm o valor armazenado. Sem chave, ou sem match, cria o agente exatamente como o POST faria e responde 201.
Request
Responses
- 200
- 201
- 400
- 401
- 403
- 404
- 409
- 422
Sucesso.
Sucesso.
O corpo falhou na validação Zod. error.details carrega formErrors/fieldErrors.
Falha de autenticação (JWT ou mTLS ausente/inválido).
Autenticado, mas o escopo é insuficiente ou o recurso está fora de alcance.
Recurso não encontrado ou filtrado por soft-delete.
Restrição de unicidade violada (ex.: external_id ou email da inbox já em uso).
Validação do corpo que requer contexto do lado do servidor (ex.: domínio da inbox incompatível).