{"openapi":"3.1.0","info":{"title":"Piloto do Afiliado API","version":"1.1.0"},"paths":{"/v1/contas":{"get":{"summary":"Listar contas sociais","description":"Listar contas sociais","tags":["contas"],"security":[{"bearerAuth":[]}],"x-escopo":"contas:ler","x-ferramentas-mcp":["listar_contas"],"parameters":[],"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}}},"/v1/plataformas":{"get":{"summary":"Listar plataformas disponíveis","description":"Listar plataformas disponíveis","tags":["contas"],"security":[{"bearerAuth":[]}],"x-escopo":"contas:ler","x-ferramentas-mcp":["listar_plataformas"],"parameters":[],"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}}},"/v1/capacidades":{"get":{"summary":"Ler capacidades confirmadas","description":"Lê o snapshot das opções de publicação. Não chama as redes; use atualizar_capacidades para confirmar opções atuais.","tags":["contas"],"security":[{"bearerAuth":[]}],"x-escopo":"contas:ler","x-ferramentas-mcp":["listar_capacidades"],"parameters":[{"name":"contas","in":"query","required":false,"schema":{"default":[],"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}},"style":"form","explode":false}],"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}},"post":{"summary":"Atualizar capacidades na rede","description":"Consulta a rede e grava as opções atuais de publicação. Consome quota do provedor.","tags":["contas"],"security":[{"bearerAuth":[]}],"x-escopo":"contas:ler","x-ferramentas-mcp":["atualizar_capacidades"],"parameters":[{"name":"contas","in":"query","required":false,"schema":{"default":[],"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}},"style":"form","explode":false}],"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}}},"/v1/conectar/{plataforma}":{"post":{"summary":"Iniciar conexão de conta social","description":"Devolve a URL de OAuth. Antes de abri-la, o dono da chave precisa estar logado no Piloto no mesmo navegador; depois autoriza a rede. Esta ferramenta não conclui o consentimento.","tags":["contas"],"security":[{"bearerAuth":[]}],"x-escopo":"contas:escrever","x-ferramentas-mcp":["conectar_conta"],"parameters":[{"name":"plataforma","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}},{"name":"reconectar","in":"query","required":false,"schema":{"type":"string","enum":["0","1"]}}],"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}}},"/v1/contas/{id}":{"delete":{"summary":"Desconectar conta social","description":"Revoga o acesso à conta e pode cancelar trabalho pendente. Requer uma instrução explícita do usuário para desconectar.","tags":["contas"],"security":[{"bearerAuth":[]}],"x-escopo":"contas:escrever","x-ferramentas-mcp":["desconectar_conta"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}}],"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}}},"/v1/contas/{id}/mensagens":{"get":{"summary":"Ler configuração de mensagens","description":"Ler configuração de mensagens","tags":["contas"],"security":[{"bearerAuth":[]}],"x-escopo":"contas:ler","x-ferramentas-mcp":["ler_mensagens_conta"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}}],"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}},"put":{"summary":"Configurar mensagens automáticas da conta","description":"Aplica boas-vindas, menu e iniciadores na rede. Operação geracional: resultado incerto exige conferência, nunca retry cego.","tags":["contas"],"security":[{"bearerAuth":[]}],"x-escopo":"contas:escrever","x-ferramentas-mcp":["configurar_mensagens_conta"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}}},"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}}},"/v1/contas/{id}/assinar":{"post":{"summary":"Assinar eventos da conta","description":"Solicita a assinatura de eventos da conta; respeita as barreiras de operações pendentes.","tags":["contas"],"security":[{"bearerAuth":[]}],"x-escopo":"contas:escrever","x-ferramentas-mcp":["assinar_webhook_conta"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}}],"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}}},"/v1/publicacoes":{"get":{"summary":"Listar publicações","description":"Lista agendados e publicados com paginação, filtros por conta/período, calendário e totais. Passe proximo em antes para continuar.","tags":["posts"],"security":[{"bearerAuth":[]}],"x-escopo":"posts:ler","x-ferramentas-mcp":["listar_posts"],"parameters":[{"name":"limite","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"antes","in":"query","required":false,"schema":{"type":"string","maxLength":512}},{"name":"conta","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}},{"name":"de","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":9007199254740991}},{"name":"ate","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":9007199254740991}}],"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}},"post":{"summary":"Agendar publicação","description":"Cria a publicação com mídia previamente enviada. Incluir automacao exige também automacoes:escrever. Preserve idempotencia nos retries. Sem quando publica assim que a fila trabalhar.","tags":["posts"],"security":[{"bearerAuth":[]}],"x-escopo":"posts:escrever","x-ferramentas-mcp":["agendar_post"],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"}}],"x-escopos-condicionais":[{"campo":"automacao","escopo":"automacoes:escrever"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"legenda":{"default":"","type":"string","maxLength":63206},"titulo":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]},"midia":{"default":[],"maxItems":35,"type":"array","items":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}},"contas":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}},"quando":{"type":"string","maxLength":64},"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"automacao":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"additionalProperties":false,"required":["contas"]}}}},"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}}},"/v1/publicacoes/{id}":{"get":{"summary":"Consultar publicação por ID","description":"Consultar publicação por ID","tags":["posts"],"security":[{"bearerAuth":[]}],"x-escopo":"posts:ler","x-ferramentas-mcp":["obter_post"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}}],"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}},"patch":{"summary":"Editar ou reagendar publicação","description":"Edita somente enquanto nada foi enviado. Envie apenas campos alterados; a configuração substitui o objeto anterior, portanto preserve as opções existentes.","tags":["posts"],"security":[{"bearerAuth":[]}],"x-escopo":"posts:escrever","x-ferramentas-mcp":["editar_post"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"legenda":{"type":"string","maxLength":63206},"titulo":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]},"midia":{"maxItems":35,"type":"array","items":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}},"quando":{"type":"string","maxLength":64},"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"additionalProperties":false}}}},"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}},"delete":{"summary":"Cancelar publicação pendente; Excluir histórico de publicação encerrada","description":"Cancela somente alvos pendentes e conserva o histórico, inclusive em retries.\n\nRemove somente o registro local de uma publicação encerrada. Não apaga o post da rede nem cancela publicações ainda pendentes.","tags":["posts"],"security":[{"bearerAuth":[]}],"x-escopo":"posts:escrever","x-ferramentas-mcp":["cancelar_post","excluir_post"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}},{"name":"acao","in":"query","required":true,"schema":{"type":"string","enum":["cancelar","excluir"]}}],"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}}},"/v1/publicacoes/{id}/publicar":{"post":{"summary":"Publicar agora","description":"Antecipa o envio usando a mesma fila e proteção contra duplicação do cron. Pode devolver processando; consulte obter_post para acompanhar.","tags":["posts"],"security":[{"bearerAuth":[]}],"x-escopo":"posts:escrever","x-ferramentas-mcp":["publicar_agora"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}}],"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}}},"/v1/publicacoes/{id}/alvos/{alvoId}/assumir-publicado":{"post":{"summary":"Assumir publicação como entregue","description":"Só use após instrução explícita e conferência humana na rede. Assume a entrega sem reenviar; no Instagram informe o media ID real. O envio antigo ainda pode terminar.","tags":["posts"],"security":[{"bearerAuth":[]}],"x-escopo":"posts:escrever","x-ferramentas-mcp":["resolver_publicacao_incerta"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}},{"name":"alvoId","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"externoId":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}}},"/v1/midias":{"get":{"summary":"Listar arquivos enviados","description":"Listar arquivos enviados","tags":["midia"],"security":[{"bearerAuth":[]}],"x-escopo":"posts:ler","x-ferramentas-mcp":["listar_midias"],"parameters":[{"name":"limite","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"antes","in":"query","required":false,"schema":{"type":"string","maxLength":512}},{"name":"tipo","in":"query","required":false,"schema":{"type":"string","enum":["imagem","video","documento"]}}],"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}}},"/v1/midia/instrucoes":{"get":{"summary":"Obter instruções de upload","description":"Explica o upload binário por PUT /v1/midia. Arquivos grandes não atravessam JSON/MCP; não aceita base64, caminho local nem URL remota.","tags":["midia"],"security":[{"bearerAuth":[]}],"x-escopo":"posts:escrever","x-ferramentas-mcp":["instrucoes_upload_midia"],"parameters":[],"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}}},"/v1/feed":{"get":{"summary":"Listar feed das contas","description":"Listar feed das contas","tags":["feed"],"security":[{"bearerAuth":[]}],"x-escopo":"feed:ler","x-ferramentas-mcp":["listar_feed"],"parameters":[{"name":"limite","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"antes","in":"query","required":false,"schema":{"type":"string","maxLength":8192}},{"name":"conta","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}},{"name":"rede","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}}],"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}}},"/v1/feed/sincronizar":{"post":{"summary":"Sincronizar feed na rede","description":"Consulta a rede de uma conta e atualiza o feed local. Use cursorProximo da cobertura para continuar na rede. A cobertura e erros acompanham a resposta.","tags":["feed"],"security":[{"bearerAuth":[]}],"x-escopo":"feed:sincronizar","x-ferramentas-mcp":["sincronizar_feed"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"conta":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"cursor":{"type":"string","maxLength":8192}},"additionalProperties":false,"required":["conta"]}}}},"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}}},"/v1/analytics":{"get":{"summary":"Ler analytics","description":"Ler analytics","tags":["analytics"],"security":[{"bearerAuth":[]}],"x-escopo":"analytics:ler","x-ferramentas-mcp":["analytics_posts"],"parameters":[{"name":"dias","in":"query","required":false,"schema":{"default":30,"type":"integer","minimum":1,"maximum":365}},{"name":"conta","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}},{"name":"rede","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}},{"name":"origem","in":"query","required":false,"schema":{"default":"todos","type":"string","enum":["piloto","feed","todos"]}}],"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}},"post":{"summary":"Atualizar analytics","description":"Atualiza um lote de métricas e retorna números, cobertura e falhas. Passe atualizacao.proximo em cursor, com os mesmos filtros e sem forcar, para continuar. Consome quota das redes; forcar ignora o cache.","tags":["analytics"],"security":[{"bearerAuth":[]}],"x-escopo":"analytics:ler","x-ferramentas-mcp":["atualizar_analytics"],"parameters":[{"name":"dias","in":"query","required":false,"schema":{"default":30,"type":"integer","minimum":1,"maximum":365}},{"name":"conta","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}},{"name":"rede","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}},{"name":"origem","in":"query","required":false,"schema":{"default":"todos","type":"string","enum":["piloto","feed","todos"]}},{"name":"forcar","in":"query","required":false,"schema":{"type":"string","enum":["0","1"]}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":8192}}],"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}}},"/v1/publicacoes/{id}/metricas":{"get":{"summary":"Ler métricas da publicação","description":"Ler métricas da publicação","tags":["analytics"],"security":[{"bearerAuth":[]}],"x-escopo":"analytics:ler","x-ferramentas-mcp":["metricas_post"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}}],"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}},"post":{"summary":"Atualizar métricas da publicação","description":"Atualizar métricas da publicação","tags":["analytics"],"security":[{"bearerAuth":[]}],"x-escopo":"analytics:ler","x-ferramentas-mcp":["atualizar_metricas_post"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}},{"name":"forcar","in":"query","required":false,"schema":{"type":"string","enum":["0","1"]}}],"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}}},"/v1/automacoes":{"get":{"summary":"Listar automações e andamento","description":"Listar automações e andamento","tags":["automacoes"],"security":[{"bearerAuth":[]}],"x-escopo":"automacoes:ler","x-ferramentas-mcp":["listar_automacoes"],"parameters":[],"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}},"post":{"summary":"Criar automação de Instagram","description":"Cria automação por conta, agendamento ou post publicado. Não reenvie cegamente após uma resposta perdida; consulte a lista antes.","tags":["automacoes"],"security":[{"bearerAuth":[]}],"x-escopo":"automacoes:escrever","x-ferramentas-mcp":["criar_automacao"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"contaId":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"publicacaoId":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"mediaId":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"},"keyword":{"type":"string","maxLength":500},"mensagem":{"type":"string","maxLength":1000},"respostas":{"maxItems":20,"type":"array","items":{"type":"string","maxLength":1000}},"exigirFollow":{"type":"boolean"},"followMsg":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}]},"ativa":{"type":"boolean"},"rotulo":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}]},"passos":{"anyOf":[{"maxItems":50,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},{"type":"null"}]}},"additionalProperties":false,"required":["contaId"]}}}},"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}}},"/v1/automacoes/{id}":{"patch":{"summary":"Editar, ativar ou pausar automação","description":"Editar, ativar ou pausar automação","tags":["automacoes"],"security":[{"bearerAuth":[]}],"x-escopo":"automacoes:escrever","x-ferramentas-mcp":["editar_automacao"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"keyword":{"type":"string","maxLength":500},"mensagem":{"type":"string","maxLength":1000},"respostas":{"maxItems":20,"type":"array","items":{"type":"string","maxLength":1000}},"exigirFollow":{"type":"boolean"},"followMsg":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}]},"ativa":{"type":"boolean"},"rotulo":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}]},"passos":{"anyOf":[{"maxItems":50,"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},{"type":"null"}]}},"additionalProperties":false}}}},"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}},"delete":{"summary":"Excluir automação","description":"Exclui a automação e seu histórico de execuções. Para pausar sem apagar, use editar_automacao com ativa=false.","tags":["automacoes"],"security":[{"bearerAuth":[]}],"x-escopo":"automacoes:escrever","x-ferramentas-mcp":["excluir_automacao"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}}],"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}}},"/v1/caixa":{"get":{"summary":"Listar conversas da Caixa","description":"Listar conversas da Caixa","tags":["caixa"],"security":[{"bearerAuth":[]}],"x-escopo":"caixa:ler","x-ferramentas-mcp":["listar_conversas"],"parameters":[{"name":"limite","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":512}},{"name":"conta","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}},{"name":"rede","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}},{"name":"tipo","in":"query","required":false,"schema":{"type":"string","enum":["dm","comentario"]}},{"name":"busca","in":"query","required":false,"schema":{"type":"string","maxLength":80}},{"name":"arquivadas","in":"query","required":false,"schema":{"type":"string","enum":["0","1"]}},{"name":"naoLidas","in":"query","required":false,"schema":{"type":"string","enum":["0","1"]}}],"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}}},"/v1/caixa/{id}":{"get":{"summary":"Ler conversa e histórico","description":"Lê mensagens, janela de resposta e contexto do post. Abrir não marca como lida.","tags":["caixa"],"security":[{"bearerAuth":[]}],"x-escopo":"caixa:ler","x-ferramentas-mcp":["obter_conversa"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}},{"name":"antes","in":"query","required":false,"schema":{"type":"string","maxLength":512}}],"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}}},"/v1/nao-lidas":{"get":{"summary":"Contar conversas não lidas","description":"Contar conversas não lidas","tags":["caixa"],"security":[{"bearerAuth":[]}],"x-escopo":"caixa:ler","x-ferramentas-mcp":["contar_nao_lidas"],"parameters":[],"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}}},"/v1/caixa/{id}/responder":{"post":{"summary":"Responder conversa","description":"Envia uma resposta autorizada pelo usuário. Preserve idempotencia no retry; respeita a janela, o checkpoint e resultados incertos. Use intencaoId em estado_resposta para conferir o resultado.","tags":["caixa"],"security":[{"bearerAuth":[]}],"x-escopo":"caixa:escrever","x-ferramentas-mcp":["responder_conversa"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[A-Za-z0-9._:-]+$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"texto":{"type":"string","minLength":1,"maxLength":1000},"modo":{"type":"string","enum":["dm","publico"]}},"additionalProperties":false,"required":["texto"]}}}},"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}}},"/v1/caixa/{id}/respostas/{intencaoId}":{"get":{"summary":"Consultar estado de uma resposta","description":"Lê o estado da intenção sem enviar nada. armada/incerta não autoriza reenvio; mensagemId ausente com enviada indica registro local pendente.","tags":["caixa"],"security":[{"bearerAuth":[]}],"x-escopo":"caixa:ler","x-ferramentas-mcp":["estado_resposta"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}},{"name":"intencaoId","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}}],"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}}},"/v1/caixa/{id}/arquivar":{"post":{"summary":"Arquivar ou reabrir conversa","description":"Arquivar ou reabrir conversa","tags":["caixa"],"security":[{"bearerAuth":[]}],"x-escopo":"caixa:escrever","x-ferramentas-mcp":["arquivar_conversa"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"arquivada":{"default":true,"type":"boolean"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}}},"/v1/caixa/{id}/lida":{"post":{"summary":"Marcar conversa como lida","description":"Marcar conversa como lida","tags":["caixa"],"security":[{"bearerAuth":[]}],"x-escopo":"caixa:escrever","x-ferramentas-mcp":["marcar_conversa_lida"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}}],"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}}},"/v1/caixa/{id}/nao-lida":{"post":{"summary":"Marcar conversa como não lida","description":"Marcar conversa como não lida","tags":["caixa"],"security":[{"bearerAuth":[]}],"x-escopo":"caixa:escrever","x-ferramentas-mcp":["marcar_conversa_nao_lida"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}}],"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}}},"/v1/respostas":{"get":{"summary":"Listar respostas prontas","description":"Listar respostas prontas","tags":["caixa"],"security":[{"bearerAuth":[]}],"x-escopo":"caixa:ler","x-ferramentas-mcp":["listar_respostas_prontas"],"parameters":[],"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}},"post":{"summary":"Criar resposta pronta","description":"Criar resposta pronta","tags":["caixa"],"security":[{"bearerAuth":[]}],"x-escopo":"caixa:escrever","x-ferramentas-mcp":["criar_resposta_pronta"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"titulo":{"type":"string","minLength":1,"maxLength":100},"texto":{"type":"string","minLength":1,"maxLength":1000}},"additionalProperties":false,"required":["titulo","texto"]}}}},"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}}},"/v1/respostas/{id}":{"patch":{"summary":"Editar resposta pronta","description":"Editar resposta pronta","tags":["caixa"],"security":[{"bearerAuth":[]}],"x-escopo":"caixa:escrever","x-ferramentas-mcp":["editar_resposta_pronta"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"titulo":{"type":"string","minLength":1,"maxLength":100},"texto":{"type":"string","minLength":1,"maxLength":1000}},"additionalProperties":false}}}},"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}},"delete":{"summary":"Excluir resposta pronta","description":"Excluir resposta pronta","tags":["caixa"],"security":[{"bearerAuth":[]}],"x-escopo":"caixa:escrever","x-ferramentas-mcp":["excluir_resposta_pronta"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$"}}],"responses":{"200":{"description":"Operação concluída ou estado atual"},"201":{"description":"Registro criado"},"400":{"description":"Entrada inválida"},"401":{"description":"Chave ausente ou inválida"},"403":{"description":"Escopo ou espaço recusado"},"404":{"description":"Registro não encontrado no espaço"},"409":{"description":"Estado mudou ou efeito em andamento"},"422":{"description":"Validação do produto"},"429":{"description":"Limite atingido","headers":{"Retry-After":{"schema":{"type":"string"},"description":"Segundos até poder tentar novamente, quando disponíveis"}}}}}},"/v1/midia":{"put":{"summary":"Upload binário de mídia","tags":["midia"],"security":[{"bearerAuth":[]}],"x-escopo":"posts:escrever","requestBody":{"required":true,"content":{"image/jpeg":{"schema":{"type":"string","format":"binary"}},"image/png":{"schema":{"type":"string","format":"binary"}},"video/mp4":{"schema":{"type":"string","format":"binary"}},"video/quicktime":{"schema":{"type":"string","format":"binary"}},"application/pdf":{"schema":{"type":"string","format":"binary"}},"application/msword":{"schema":{"type":"string","format":"binary"}},"application/vnd.openxmlformats-officedocument.wordprocessingml.document":{"schema":{"type":"string","format":"binary"}},"application/vnd.ms-powerpoint":{"schema":{"type":"string","format":"binary"}},"application/vnd.openxmlformats-officedocument.presentationml.presentation":{"schema":{"type":"string","format":"binary"}}}},"responses":{"201":{"description":"Arquivo recebido: id, tipo e url"},"411":{"description":"Content-Length obrigatório"},"413":{"description":"Tamanho ou quota excedida"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"pda_..."}}}}