Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Atualiza a configuração de um agente de IA existente.
PATCH /v1/ai-agents/:id
PUT /v1/ai-agents/:id — mesmo handler, mantido por compatibilidade.
Escopo necessário: write:ai_agents
| Nível | Comportamento |
|---|---|
| Campos de primeiro nível | Só os enviados mudam. Os demais permanecem |
Objetos aninhados (scope, behavior, aiConfig, limits…) | Substituídos por inteiro, não mesclados |
aiConfig: { "persona": { "name": "Alice" } } descarta todo o resto do aiConfig —
instruções, memórias, regras de ação. Leia o agente com
GET /v1/ai-agents/:id, altere o objeto completo e devolva inteiro.curl -X PATCH https://api.socialsell.ai/v1/ai-agents/66445c483fa9572a0b2496cb \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{"name": "Qualificador de Leads v2", "priority": 20}'
HTTP 200 com o agente atualizado.
active vale imediatamente para as próximas execuções. Para testar mudanças sem impacto em produção, pause o agente antes, ou trabalhe numa cópia.| Código | Status | Descrição |
|---|---|---|
VALIDATION_ERROR | 400 | Corpo inválido. details[] aponta o campo |
INVALID_ID | 400 | ID com formato inválido |
NOT_FOUND | 404 | Agente não encontrado |