{"openapi":"3.1.0","info":{"title":"Vai Faz API","version":"0.2.0","description":"REST por tenant. Credenciais só valem no hostname emissor. Listas administrativas são limitadas a 100 itens; a biblioteca usa cursor. Tokens OAuth são exclusivos de /mcp. Escritas do navegador exigem Origin válido. Valores monetários são centavos de BRL. Schemas administrativos aceitam objetos cujos campos são validados pelo servidor e apresentados na área administrativa."},"servers":[{"url":"https://staging-aula.felipebelloni.com.br/api/v1"}],"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","description":"Chave vf_ com escopos, expiração e associação ativa."},"session":{"type":"apiKey","in":"cookie","name":"__Secure-vf-aa90899f07b4.session_token","description":"Sessão host-only da Better Auth; use login do navegador. Nome em desenvolvimento não inclui __Secure-."}},"schemas":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"fields":{"type":"object","additionalProperties":true}}}}}}},"paths":{"/catalog":{"get":{"summary":"Busca exemplos publicados com paginação por cursor","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[],"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"tool","in":"query","schema":{"type":"string"}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50}}]}},"/examples/{id}":{"get":{"summary":"Consulta metadados e blocos autorizados de um exemplo","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[],"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]},"/examples/{id}/learning":{"post":{"summary":"Atualiza progresso, nota, favorito ou comentário; learning:write","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["action"],"properties":{"action":{"enum":["progress","note","favorite","comment"]},"text":{"type":"string","maxLength":20000},"completed":{"type":"boolean"},"enabled":{"type":"boolean"},"positionSeconds":{"type":"integer","minimum":0}}}}}},"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]},"/me":{"get":{"summary":"Consulta os próprios direitos e aprendizagem; access:read","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/me/preferences":{"patch":{"summary":"Atualiza consentimento promocional; access:read","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["marketingOptIn"],"properties":{"marketingOptIn":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/me/connections":{"get":{"summary":"Lista aplicativos OAuth autorizados pelo usuário","description":"Exige sessão do navegador neste hostname. Administração exige MFA recente.","security":[{"session":[]}],"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/me/connections/{id}":{"delete":{"summary":"Revoga autorização e tokens do aplicativo; id é client_id","description":"Exige sessão do navegador neste hostname. Administração exige MFA recente.","security":[{"session":[]}],"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]},"/analytics/events":{"post":{"summary":"Registra page.view somente com cookie de consentimento; UUID deduplica eventos","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["eventId","name","path","viewport"],"properties":{"eventId":{"type":"string","format":"uuid"},"name":{"const":"page.view"},"path":{"type":"string","maxLength":500,"pattern":"^/(?!/)[^?#]*$"},"viewport":{"enum":["mobile","tablet","desktop"]}}}}}},"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/invitations/accept":{"post":{"summary":"Aceita convite válido destinado ao e-mail autenticado","description":"Exige sessão do navegador neste hostname. Administração exige MFA recente.","security":[{"session":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["token"],"properties":{"token":{"type":"string"}}}}}},"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/checkout":{"post":{"summary":"Cria checkout da assinatura integral ou oferta privada válida","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":100}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/billing/portal":{"post":{"summary":"Abre portal financeiro do próprio cliente","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/offers/{id}":{"get":{"summary":"Consulta oferta privada pelo token destinado ao usuário autenticado","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]},"/assets/{id}/download":{"get":{"summary":"Autoriza arquivo privado e redireciona para URL temporária","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"responses":{"303":{"description":"Redirecionamento temporário; não armazenar em cache.","headers":{"Location":{"schema":{"type":"string","format":"uri"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]},"/collections/{id}/quiz":{"post":{"summary":"Envia respostas do questionário autorizado","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]},"/collections/{id}/certificate":{"post":{"summary":"Emite certificado após cumprir os critérios da trilha","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]},"/admin/examples":{"get":{"summary":"Lista até 100 exemplos administrativos; content:write","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"Cria exemplo, blocos e versão; content:write","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"201":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/admin/examples/{id}":{"put":{"summary":"Salva nova versão de exemplo; content:write","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]},"/admin/collections":{"post":{"summary":"Cria curso, coleção ou trilha; content:write","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"201":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/admin/collections/{id}":{"put":{"summary":"Atualiza organização, liberação gradual e questionário; content:write","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]},"/admin/uploads":{"post":{"summary":"Prepara upload privado com limite e tipo de arquivo; content:write","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"201":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/admin/uploads/{id}/complete":{"post":{"summary":"Confirma existência e tamanho do arquivo enviado; content:write","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]},"/admin/members":{"get":{"summary":"Lista até 100 associações deste tenant; members:read","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/admin/members/{id}":{"patch":{"summary":"Altera papel ou suspende associação; members:write","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]},"/admin/invitations":{"post":{"summary":"Cria convite e agenda mensagem; members:write","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"201":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/admin/products":{"post":{"summary":"Configura preço em BRL; assinatura integral é a única compra pública","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"201":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/admin/offers":{"post":{"summary":"Cria oferta privada com destinatário, valor, duração e validade","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"201":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/admin/coupons":{"post":{"summary":"Cria cupom de desconto da assinatura; billing:write","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":100}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/admin/refunds":{"post":{"summary":"Solicita reembolso auditado; billing:write","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":100}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/admin/grants":{"post":{"summary":"Concede direito manual auditado; members:write","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/admin/grants/{id}":{"patch":{"summary":"Revoga direito manual com justificativa; members:write","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]},"/admin/comments":{"get":{"summary":"Lista comentários pendentes; comments:moderate","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/admin/comments/{id}":{"patch":{"summary":"Aprova ou rejeita comentário; comments:moderate","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]},"/admin/reports":{"get":{"summary":"Indicadores reais de finanças, aprendizagem, e-mail e analytics; reports:read","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/admin/commercial":{"get":{"summary":"Produtos, ofertas, pedidos e assinaturas; billing:read","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/admin/communications":{"get":{"summary":"Templates, jornadas, histórico e filas em revisão; integrations:write","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/admin/email-templates":{"post":{"summary":"Cria template promocional; integrations:write","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/admin/email-templates/{id}":{"put":{"summary":"Edita template; classificação dos e-mails essenciais é preservada","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]},"/admin/journeys":{"post":{"summary":"Cria jornada de até dez etapas; exige consentimento promocional do destinatário","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/admin/journeys/{id}":{"put":{"summary":"Edita jornada e cancela envios pendentes da versão anterior","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"patch":{"summary":"Habilita ou desabilita jornada","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]},"/admin/integrations":{"get":{"summary":"Lista chaves mascaradas, endpoints e entregas; integrations:write","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/admin/api-keys":{"post":{"summary":"Emite chave com escopos e até 90 dias; token exibido uma vez","description":"Exige sessão do navegador neste hostname. Administração exige MFA recente.","security":[{"session":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"201":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/admin/api-keys/{id}":{"delete":{"summary":"Revoga chave de integração; integrations:write","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]},"/admin/webhooks":{"post":{"summary":"Cria endpoint HTTPS com assinatura HMAC e histórico","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"201":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/admin/webhooks/{id}":{"patch":{"summary":"Habilita ou desabilita endpoint de webhook","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]},"/admin/tenants":{"get":{"summary":"Lista ambientes permitidos; tenants:write","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"Cria tenant com domínio pendente; somente proprietário ou delegado","description":"Exige sessão do navegador neste hostname. Administração exige MFA recente.","security":[{"session":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"201":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/admin/domains/{id}/verify":{"post":{"summary":"Verifica propriedade por TXT _vaifaz; ativação depende de TLS e provisionamento","description":"Exige sessão do navegador neste hostname. Administração exige MFA recente.","security":[{"session":[]}],"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}]},"/admin/branding":{"patch":{"summary":"Altera nome, descrição, WhatsApp e cor; tenants:write","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/admin/audit":{"get":{"summary":"Consulta até 100 eventos de auditoria; members:write","description":"Escopos e permissões atuais do usuário são verificados em cada chamada. Administração exige MFA ou chave com escopo permitido.","security":[{"apiKey":[]},{"session":[]}],"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/admin/settings/smtp":{"get":{"summary":"Consulta configuração mascarada de smtp","description":"Exige sessão do navegador neste hostname. Administração exige MFA recente.","security":[{"session":[]}],"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"summary":"Salva configuração cifrada de smtp; campos secretos vazios preservam o valor","description":"Exige sessão do navegador neste hostname. Administração exige MFA recente.","security":[{"session":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"Testa conexão smtp; SMTP exige destinatário explícito","description":"Exige sessão do navegador neste hostname. Administração exige MFA recente.","security":[{"session":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/admin/settings/stripe":{"get":{"summary":"Consulta configuração mascarada de stripe","description":"Exige sessão do navegador neste hostname. Administração exige MFA recente.","security":[{"session":[]}],"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"summary":"Salva configuração cifrada de stripe; campos secretos vazios preservam o valor","description":"Exige sessão do navegador neste hostname. Administração exige MFA recente.","security":[{"session":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"Testa conexão stripe; SMTP exige destinatário explícito","description":"Exige sessão do navegador neste hostname. Administração exige MFA recente.","security":[{"session":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/admin/settings/r2":{"get":{"summary":"Consulta configuração mascarada de r2","description":"Exige sessão do navegador neste hostname. Administração exige MFA recente.","security":[{"session":[]}],"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"summary":"Salva configuração cifrada de r2; campos secretos vazios preservam o valor","description":"Exige sessão do navegador neste hostname. Administração exige MFA recente.","security":[{"session":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"summary":"Testa conexão r2; SMTP exige destinatário explícito","description":"Exige sessão do navegador neste hostname. Administração exige MFA recente.","security":[{"session":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"responses":{"200":{"description":"Resposta JSON autorizada; operações externas podem retornar 503 quando ainda não configuradas."},"400":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Erro de validação, autorização ou integração.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"externalDocs":{"description":"OAuth MCP, autorização e webhooks","url":"https://staging-aula.felipebelloni.com.br/api/docs"}}