{"openapi":"3.0.1","info":{"title":"SDK de Assinatura Digital — API","description":"Motor de assinatura digital self-hosted multi-jurisdição (ICP-Brasil + eIDAS).\n\n## Módulos Implementados\n\n### 🪪 Assinatura Eletrônica (SES/AES)\n- `POST /api/v1/sign-electronic` — Assina PDF sem certificado (SES ou AES com OTP)\n- `POST /api/v1/otp/send` — Solicita OTP via e-mail, SMS ou WhatsApp (adaptador de entrega configurável)\n- `POST /api/v1/otp/verify` — Verifica código OTP\n\n### ✅ Validação de Assinaturas\n- `POST /api/v1/validate` — Validação completa PAdES/CAdES/XAdES/ASiC com relatório detalhado\n\n### 🕐 Carimbo de Tempo (RFC 3161)\n- `POST /api/v1/timestamp` — Solicita TimeStampToken à TSA configurada\n\n### 🔐 Trust Anchors (LOTL eIDAS + ICP-Brasil)\n- `GET /api/v1/trust-anchors` — Lista trust anchors ativos\n\n### 📋 Solicitações de Assinatura (Workflow Multi-signatário)\n- `POST /api/v1/sign-requests` — Cria solicitação com múltiplos signatários\n- `GET /api/v1/sign-requests` — Lista solicitações\n- `GET /api/v1/sign-requests/{id}` — Detalhes da solicitação\n- `POST /api/v1/sign-requests/{id}/sign` — Signatário assina\n- `POST /api/v1/sign-requests/{id}/qualified/prepare` — Prepara assinatura com certificado do titular\n- `POST /api/v1/sign-requests/{id}/qualified/complete` — Conclui PAdES sem selo Venue\n- `DELETE /api/v1/sign-requests/{id}` — Cancela solicitação\n\n### 🧩 Modelos e geração documental\n- `GET|POST /api/v1/templates` — Lista e cria modelos tipados\n- `GET|PATCH|DELETE /api/v1/templates/{id}` — Consulta, versiona e exclui\n- `POST /api/v1/templates/{id}/sign-requests` — Gera o PDF e inicia assinatura\n\n### 📑 Gestão de contratos (CLM)\n- `GET|POST /api/v1/contracts` — Pesquisa e cria contratos\n- `GET|PUT /api/v1/contracts/{id}` — Consulta e atualiza com ETag\n- `GET /api/v1/contracts/renewals` — Agenda de renovação/vencimento\n- `GET /api/v1/contracts/obligations/due` — Obrigações abertas por prazo\n\n### 📊 Trilha de Auditoria (Hash-chain SHA-256)\n- `GET /api/v1/audit?limit=50` — Lista os eventos mais recentes e devolve\n  o veredito da cadeia completa em `chainIntact` (limite máximo: 200)\n\n### 🏢 Plataforma multiempresa\n- `GET /api/v1/platform/overview` — Resumo do tenant autenticado\n- `POST /api/v1/platform/tenants` — Cadastra empresa (somente PLATFORM_ADMIN)\n- `GET|POST|DELETE /api/v1/platform/api-keys` — Gerencia credenciais do tenant\n\n## Autenticação\nIntegrações podem usar OAuth 2.1/OIDC com escopos granulares quando o\nresource server está habilitado: Authorization Code com PKCE S256 para\nclientes públicos e Client Credentials para integrações B2B. `X-API-Key`\npermanece disponível para compatibilidade. Usuários humanos usam sessão\nopaca em cookie `__Host-venue_session` HttpOnly/Secure (ou Bearer opaco para\nclientes não-browser).\nLinks públicos de assinatura em `/sign/**` usam o token opaco do signatário.\nSelo e keystore da Venue são superfícies internas, ausentes deste contrato público.\n","version":"1.2.0","x-venue-contract-revision":"2026-09-08.6"},"servers":[{"url":"https://api.venuesign.tech","description":"Generated server url"}],"security":[{"ApiKey":[]},{"BearerAuth":[]},{"HumanSessionCookie":[]}],"tags":[{"name":"automations","description":"Preenchimento, geração, envio e acompanhamento documental durável"},{"name":"templates","description":"Modelos versionados, variáveis tipadas e geração de documentos"},{"name":"contract-collaboration","description":"Redlines, comentários e decisões de revisão"},{"name":"timestamp","description":"Carimbo de tempo RFC 3161 (Time Stamping Authority)"},{"name":"sign-requests","description":"Gerenciamento de solicitações de assinatura e fluxo de signatários"},{"name":"onboarding","description":"Criação inicial de ambiente empresarial"},{"name":"contacts","description":"Agenda persistente, cifrada e isolada por tenant"},{"name":"approvals","description":"Aprovações em estágios sequenciais com aprovadores paralelos"},{"name":"contracts","description":"Ciclo de vida, renovações, obrigações e timeline de contratos"},{"name":"biometric-verifications","description":"Provas faciais minimizadas e revisão humana"},{"name":"validate","description":"Validação completa de assinaturas digitais via dss-validation"},{"name":"clauses","description":"Biblioteca versionada de cláusulas e inserções em contratos/modelos"},{"name":"trust-anchors","description":"Consulta das âncoras ativas; mutações são exclusivas da operação Venue"},{"name":"platform","description":"Portal multiempresa, empresas e credenciais de integração"},{"name":"otp","description":"Verificação OTP (fator de controle exclusivo para AES)"},{"name":"multi-document-envelopes","description":"Envelopes de assinatura coordenados com dois ou mais documentos"},{"name":"templates-docx","description":"Importação e exportação DOCX local de modelos versionados"},{"name":"commercial","description":"Planos, trial, assinatura, quotas, uso e faturamento provider-neutral"},{"name":"sign-electronic","description":"Assinatura eletrônica SES/AES (sem certificado digital)"},{"name":"audit","description":"Trilha de auditoria encadeada por hash"}],"paths":{"/api/v1/platform/tenants/{tenantId}":{"get":{"tags":["platform"],"summary":"Consulta uma empresa por identificador","operationId":"getTenant","parameters":[{"name":"tenantId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Empresa não encontrada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Acesso ao tenant negado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"200":{"description":"Empresa encontrada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}},"put":{"tags":["platform"],"summary":"Atualiza nome e e-mail de contato de uma empresa","operationId":"updateTenant","parameters":[{"name":"tenantId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateTenantRequest"}}},"required":true},"responses":{"200":{"description":"Empresa atualizada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantResponse"}}}},"404":{"description":"Empresa não encontrada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Acesso ao tenant negado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"400":{"description":"Alteração inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}},"patch":{"tags":["platform"],"summary":"Atualiza nome e e-mail de contato de uma empresa","operationId":"updateTenant_1","parameters":[{"name":"tenantId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateTenantRequest"}}},"required":true},"responses":{"200":{"description":"Empresa atualizada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantResponse"}}}},"404":{"description":"Empresa não encontrada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Acesso ao tenant negado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"400":{"description":"Alteração inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/reviews/{reviewId}/comments/{commentId}/resolution":{"put":{"tags":["contract-collaboration"],"operationId":"resolveComment","parameters":[{"name":"reviewId","in":"path","required":true,"schema":{"type":"string"}},{"name":"commentId","in":"path","required":true,"schema":{"type":"string"}},{"name":"If-Match","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/identity/sso/providers/{providerId}":{"put":{"tags":["human-identity-controller"],"operationId":"updateOidcProvider","parameters":[{"name":"providerId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveOidcProviderRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OidcProviderView"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}},"delete":{"tags":["human-identity-controller"],"operationId":"deleteOidcProvider","parameters":[{"name":"providerId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Operação concluída sem corpo de resposta"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/contracts/{contractId}":{"get":{"tags":["contracts"],"operationId":"get_3","parameters":[{"name":"contractId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContractResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}},"put":{"tags":["contracts"],"operationId":"update","parameters":[{"name":"contractId","in":"path","required":true,"schema":{"type":"string"}},{"name":"If-Match","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WriteContractRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContractResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/contracts/{contractId}/obligations/{obligationId}":{"get":{"tags":["contracts"],"operationId":"getObligation","parameters":[{"name":"contractId","in":"path","required":true,"schema":{"type":"string"}},{"name":"obligationId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ObligationResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}},"put":{"tags":["contracts"],"operationId":"updateObligation","parameters":[{"name":"contractId","in":"path","required":true,"schema":{"type":"string"}},{"name":"obligationId","in":"path","required":true,"schema":{"type":"string"}},{"name":"If-Match","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WriteObligationRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ObligationResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}},"delete":{"tags":["contracts"],"operationId":"deleteObligation","parameters":[{"name":"contractId","in":"path","required":true,"schema":{"type":"string"}},{"name":"obligationId","in":"path","required":true,"schema":{"type":"string"}},{"name":"If-Match","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"204":{"description":"Obrigação excluída; resposta sem corpo"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/contacts/{contactId}":{"put":{"tags":["contacts"],"operationId":"update_1","parameters":[{"name":"contactId","in":"path","required":true,"schema":{"type":"string"}},{"name":"If-Match","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}},"delete":{"tags":["contacts"],"operationId":"delete_1","parameters":[{"name":"contactId","in":"path","required":true,"schema":{"type":"string"}},{"name":"If-Match","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"204":{"description":"Contato excluído; resposta sem corpo"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/commercial/admin/tenants/{tenantId}/subscription":{"get":{"tags":["commercial"],"summary":"Consulta a assinatura de um tenant","description":"Exclusivo de PLATFORM_ADMIN","operationId":"adminSubscription","parameters":[{"name":"tenantId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}},"put":{"tags":["commercial"],"summary":"Atribui trial ou assinatura a um tenant","description":"Exclusivo de PLATFORM_ADMIN","operationId":"assignSubscription","parameters":[{"name":"tenantId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionWriteRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/api/v1/commercial/admin/plans/{planId}":{"put":{"tags":["commercial"],"summary":"Cria ou atualiza plano e entitlements","description":"Exclusivo de PLATFORM_ADMIN","operationId":"upsertPlan","parameters":[{"name":"planId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlanWriteRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlanResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/api/v1/clauses/{clauseId}":{"get":{"tags":["clauses"],"operationId":"get_4","parameters":[{"name":"clauseId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClauseResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}},"put":{"tags":["clauses"],"operationId":"update_2","parameters":[{"name":"clauseId","in":"path","required":true,"schema":{"type":"string"}},{"name":"If-Match","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateClauseRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClauseResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}},"delete":{"tags":["clauses"],"operationId":"archive_1","parameters":[{"name":"clauseId","in":"path","required":true,"schema":{"type":"string"}},{"name":"If-Match","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"204":{"description":"Cláusula arquivada; resposta sem corpo"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/automations/{automationId}":{"get":{"tags":["automations"],"operationId":"get_5","parameters":[{"name":"automationId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DefinitionResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}},"put":{"tags":["automations"],"operationId":"update_3","parameters":[{"name":"automationId","in":"path","required":true,"schema":{"type":"string"}},{"name":"If-Match","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateDefinitionRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DefinitionResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}},"delete":{"tags":["automations"],"operationId":"archive_2","parameters":[{"name":"automationId","in":"path","required":true,"schema":{"type":"string"}},{"name":"If-Match","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"204":{"description":"Automação arquivada; resposta sem corpo"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/verify/{signatureId}/check":{"post":{"tags":["public-verification-controller"],"summary":"Compara o SHA-256 do PDF recebido com a evidência registrada","operationId":"check","parameters":[{"name":"signatureId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicVerificationCheckRequest"}}},"required":true},"responses":{"200":{"description":"Resultado da comparação de integridade","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicVerificationReport"}}}},"400":{"description":"Hash ou evidência inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[]}},"/sign/{token}/reading-confirmation":{"post":{"tags":["public-signing-controller"],"summary":"Confirma a leitura da revisão exata exibida ao participante","operationId":"confirmReading","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReadingConfirmationRequest"}}}},"responses":{"200":{"description":"Leitura e campos confirmados","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicReadingConfirmation"}}}},"400":{"description":"Revisão, campo ou token inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[]}},"/sign/{token}/qualified/prepare":{"post":{"tags":["public-signing-controller"],"summary":"Prepara a assinatura qualificada para o agente local","operationId":"prepareQualified","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicQualifiedPrepareRequest"}}},"required":true},"responses":{"400":{"description":"Certificado, termo ou solicitação inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"200":{"description":"Operação preparada e grant efêmero emitido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicQualifiedPrepareResponse"}}}}},"security":[]}},"/sign/{token}/qualified/complete":{"post":{"tags":["public-signing-controller"],"summary":"Conclui a assinatura qualificada preparada","operationId":"completeQualified","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicQualifiedCompleteRequest"}}},"required":true},"responses":{"400":{"description":"Operação, assinatura ou termo inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"200":{"description":"Assinatura qualificada registrada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicSignCompletionResponse"}}}}},"security":[]}},"/sign/{token}/qualified/cloud/authorize":{"post":{"tags":["public-signing-controller"],"summary":"Inicia autorização OAuth/PKCE para certificado em nuvem","operationId":"authorizeQualifiedCloud","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicQualifiedCloudAuthorizeRequest"}}},"required":true},"responses":{"400":{"description":"Provedor, consentimento ou estado inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"200":{"description":"Autorização iniciada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorizationStart"}}}},"429":{"$ref":"#/components/responses/PublicRateLimited"},"503":{"$ref":"#/components/responses/PublicAuthUnavailable"}},"security":[]}},"/sign/{token}/otp":{"post":{"tags":["public-signing-controller"],"summary":"Inicia o desafio OTP do participante","operationId":"startOtp","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"400":{"description":"Participante ou solicitação inelegível","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Limite de desafios atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"501":{"description":"Canal OTP não configurado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"200":{"description":"Desafio OTP emitido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicOtpChallengeResponse"}}}},"503":{"description":"Limitador OTP indisponível","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[]}},"/sign/{token}/delegate":{"post":{"tags":["public-signing-controller"],"summary":"Delega a ação a outro participante e revoga o link anterior","operationId":"delegate","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DelegateRequest"}}},"required":true},"responses":{"200":{"description":"Delegação registrada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDelegationResponse"}}}},"400":{"description":"Delegação não permitida ou inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[]}},"/sign/{token}/decline":{"post":{"tags":["public-signing-controller"],"summary":"Registra a recusa auditável do participante","operationId":"decline","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDeclineRequest"}}},"required":true},"responses":{"200":{"description":"Recusa registrada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDeclineResponse"}}}},"400":{"description":"Recusa ou token inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[]}},"/sign/{token}/complete":{"post":{"tags":["public-signing-controller"],"summary":"Conclui a assinatura eletrônica do participante","operationId":"complete","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCompleteRequest"}}},"required":true},"responses":{"200":{"description":"Assinatura registrada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicSignCompletionResponse"}}}},"400":{"description":"OTP, consentimento, campos ou estado inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[]}},"/sign/{token}/biometric":{"post":{"tags":["public-signing-controller"],"operationId":"verifyBiometric","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}},{"name":"activeLivenessChallengeId","in":"query","required":true,"schema":{"type":"string"}},{"name":"consentAccepted","in":"query","required":true,"schema":{"type":"boolean"}},{"name":"consentTermSha256","in":"query","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"required":["identityDocument","identityDocumentBack","liveImage","liveVideo"],"type":"object","properties":{"identityDocument":{"type":"string","format":"binary"},"identityDocumentBack":{"type":"string","format":"binary"},"liveImage":{"type":"string","format":"binary"},"liveVideo":{"type":"string","format":"binary"}}}}}},"responses":{"400":{"description":"Captura ou consentimento inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Limitador indisponível","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"201":{"description":"Verificação processada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBiometricResponse"}}}},"429":{"description":"Limite de captura atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"501":{"description":"Provedor não configurado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[]}},"/sign/{token}/biometric/challenge":{"post":{"tags":["public-signing-controller"],"operationId":"startBiometricLivenessChallenge","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}},{"name":"consentAccepted","in":"query","required":true,"schema":{"type":"boolean"}},{"name":"consentTermSha256","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"503":{"description":"Limitador indisponível","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"400":{"description":"Solicitação inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"501":{"description":"Provedor não configurado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"201":{"description":"Desafio emitido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChallengeView"}}}},"429":{"description":"Limite de desafios atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[]}},"/sign/{token}/action":{"post":{"tags":["public-signing-controller"],"summary":"Conclui aprovação, aceite, ciência ou preenchimento tokenizado","operationId":"participantAction","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicParticipantActionRequest"}}},"required":true},"responses":{"400":{"description":"Ação, consentimento ou campos inválidos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"200":{"description":"Ação registrada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParticipantActionResponse"}}}}},"security":[]}},"/api/v1/validate":{"post":{"tags":["validate"],"summary":"Valida um documento assinado digitalmente","description":"Validação completa de assinaturas PAdES, CAdES, XAdES ou ASiC. Retorna relatório detalhado com status de cada assinatura, cadeia de confiança, validade do carimbo de tempo e erros encontrados.","operationId":"validate","requestBody":{"description":"Documento assinado em Base64 com opções de validação","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateRequest"}}},"required":true},"responses":{"500":{"description":"Falha inesperada durante a validação","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateResponse"}}}},"400":{"description":"Requisição ou Base64 inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateResponse"}}}},"200":{"description":"Relatório de validação concluído","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateResponse"}}}},"422":{"description":"Documento ilegível, sem assinatura ou não suportado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/timestamp":{"post":{"tags":["timestamp"],"summary":"Solicita carimbo de tempo para um hash/documento","description":"Recebe um hash (ou documento completo) e solicita carimbo de tempo à TSA configurada. Retorna o TimeStampToken RFC 3161 em Base64.","operationId":"timestamp","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimestampRequest"}}},"required":true},"responses":{"400":{"description":"Requisição inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"TSA ICP-Brasil não configurada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"A TSA recusou ou não concluiu a solicitação","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"200":{"description":"Carimbo de tempo gerado com sucesso","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TimestampResponse"}}}},"500":{"description":"Erro interno no processamento","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/templates":{"get":{"tags":["templates"],"operationId":"list_1","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TemplateResponse"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}},"post":{"tags":["templates"],"operationId":"create","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTemplateRequest"}}},"required":true},"responses":{"400":{"description":"Definição do modelo inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"201":{"description":"Modelo criado","headers":{"ETag":{"description":"Versão forte do modelo","style":"simple","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplateResponse"}}}},"200":{"description":"Replay idempotente do modelo já criado","headers":{"Idempotency-Replayed":{"description":"Sempre true neste status","style":"simple","schema":{"type":"string","enum":["true"]}},"ETag":{"description":"Versão forte do modelo","style":"simple","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplateResponse"}}}},"409":{"description":"A chave idempotente já foi usada com outro payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/templates/{templateId}/sign-requests":{"post":{"tags":["templates"],"operationId":"createSignRequest","parameters":[{"name":"templateId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateFromTemplateRequest"}}},"required":true},"responses":{"200":{"description":"Solicitação já criada; replay idempotente","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateResponse"}}}},"400":{"description":"Modelo, variáveis ou participantes inválidos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Chave idempotente reutilizada com outro conteúdo","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/templates/{templateId}/render":{"post":{"tags":["templates"],"operationId":"render","parameters":[{"name":"templateId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RenderRequest"}}}},"responses":{"200":{"description":"PDF renderizado","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Modelo ou variáveis inválidos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/templates/{templateId}/import-review/confirm":{"post":{"tags":["templates"],"operationId":"confirmImportReview","parameters":[{"name":"templateId","in":"path","required":true,"schema":{"type":"string"}},{"name":"If-Match","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmImportReviewRequest"}}}},"responses":{"412":{"description":"If-Match obsoleto","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"400":{"description":"Confirmação inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"200":{"description":"Revisão de importação confirmada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplateResponse"}}}},"409":{"description":"Conflito de versão","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/templates/{templateId}/export-docx":{"post":{"tags":["templates-docx"],"operationId":"exportDocx","parameters":[{"name":"templateId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExportRequest"}}}},"responses":{"200":{"description":"Modelo exportado como DOCX","content":{"application/vnd.openxmlformats-officedocument.wordprocessingml.document":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Modelo ou variáveis inválidos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/templates/{templateId}/clone":{"post":{"tags":["templates"],"operationId":"cloneTemplate","parameters":[{"name":"templateId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloneTemplateRequest"}}}},"responses":{"200":{"description":"Replay idempotente do clone","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplateResponse"}}}},"400":{"description":"Clone inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"201":{"description":"Modelo clonado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplateResponse"}}}},"409":{"description":"Conflito de versão ou idempotência","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/templates/preview":{"post":{"tags":["templates"],"operationId":"preview","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreviewTemplateRequest"}}},"required":true},"responses":{"200":{"description":"Prévia PDF do rascunho, sem salvar ou enviar","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Definição ou dados de teste inválidos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/templates/inspect-docx":{"post":{"tags":["templates-docx"],"operationId":"inspectDocx","parameters":[{"name":"name","in":"query","required":false,"schema":{"type":"string"}},{"name":"description","in":"query","required":false,"schema":{"type":"string"}},{"name":"defaultLevel","in":"query","required":false,"schema":{"type":"string","default":"AES"}},{"name":"defaultChannel","in":"query","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"required":["file"],"type":"object","properties":{"file":{"type":"string","format":"binary"}}}}}},"responses":{"200":{"description":"Conteúdo e variáveis extraídos sem persistir modelo","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InspectedTemplateResponse"}}}},"413":{"description":"DOCX excede o limite de 10 MiB","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"400":{"description":"DOCX inválido ou inseguro","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/templates/import-docx":{"post":{"tags":["templates-docx"],"operationId":"importDocx","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}},{"name":"name","in":"query","required":false,"schema":{"type":"string"}},{"name":"description","in":"query","required":false,"schema":{"type":"string"}},{"name":"defaultLevel","in":"query","required":false,"schema":{"type":"string","default":"AES"}},{"name":"defaultChannel","in":"query","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"required":["file"],"type":"object","properties":{"file":{"type":"string","format":"binary"}}}}}},"responses":{"201":{"description":"DOCX importado como modelo","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportedTemplateResponse"}}}},"400":{"description":"DOCX inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"DOCX excede o limite","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Conflito de idempotência","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"200":{"description":"Replay idempotente da importação","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportedTemplateResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/sign-requests":{"get":{"tags":["sign-requests"],"summary":"Lista solicitações recentes do tenant","description":"Retorna no máximo as 100 solicitações mais recentes do tenant autenticado, sem expor links de assinatura.","operationId":"list_2","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/StatusResponse"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}},"post":{"tags":["sign-requests"],"summary":"Cria uma solicitação de assinatura eletrônica","description":"Registra um documento e seus participantes com roteamento sequencial, paralelo ou misto por etapas. Suporta papéis de assinatura, aprovação, aceite, ciência, preenchimento, cópia e observação; SES/AES ou assinatura qualificada; autenticação multifator por participante; campos normalizados; lembretes; TTL; metadados; webhook de conclusão para integrações servidor a servidor. O console não coleta segredos HMAC no fluxo de envio.","operationId":"create_1","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRequest"}}},"required":true},"responses":{"400":{"description":"Requisição inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Idempotency-Key reutilizada com outro conteúdo","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"200":{"description":"Solicitação criada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateResponse"}}}},"402":{"description":"Plano, período comercial ou saldo não autoriza o envio","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/api/v1/sign-requests/{requestId}/signatories/{signatoryId}/biometric":{"post":{"tags":["sign-requests"],"summary":"Cria prova biométrica para um signatário da solicitação","description":"Frente, verso, coleta facial e vídeo do titular são encaminhados ao serviço interno em memória e descartados; somente evidências minimizadas, scores e decisão ficam persistidos.","operationId":"verifyBiometric_1","parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"string"}},{"name":"signatoryId","in":"path","required":true,"schema":{"type":"string"}},{"name":"activeLivenessChallengeId","in":"query","required":true,"schema":{"type":"string"}},{"name":"confirmedFieldIntentHash","in":"query","required":false,"schema":{"type":"string"}},{"name":"consentAccepted","in":"query","required":true,"schema":{"type":"boolean"}},{"name":"consentTermSha256","in":"query","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"required":["identityDocument","identityDocumentBack","liveImage","liveVideo"],"type":"object","properties":{"identityDocument":{"type":"string","format":"binary"},"identityDocumentBack":{"type":"string","format":"binary"},"liveImage":{"type":"string","format":"binary"},"liveVideo":{"type":"string","format":"binary"}}}}}},"responses":{"400":{"description":"Captura ou consentimento inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Limitador indisponível","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Limite de captura atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"501":{"description":"Provedor não configurado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"201":{"description":"Verificação processada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerificationView"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/sign-requests/{requestId}/signatories/{signatoryId}/biometric/challenge":{"post":{"tags":["sign-requests"],"summary":"Emite uma sequência aleatória e efêmera de vivacidade ativa","operationId":"startBiometricLivenessChallenge_1","parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"string"}},{"name":"signatoryId","in":"path","required":true,"schema":{"type":"string"}},{"name":"consentAccepted","in":"query","required":true,"schema":{"type":"boolean"}},{"name":"consentTermSha256","in":"query","required":true,"schema":{"type":"string"}},{"name":"confirmedFieldIntentHash","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"503":{"description":"Limitador indisponível","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"400":{"description":"Solicitação inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"501":{"description":"Provedor não configurado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"201":{"description":"Desafio emitido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChallengeView"}}}},"429":{"description":"Limite de desafios atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/sign-requests/{requestId}/sign":{"post":{"tags":["sign-requests"],"summary":"Assina um documento em uma solicitação existente","description":"O signatário informa seu ID e, para AES, o código OTP. O documento é assinado sobre o PDF atual da solicitação e o estado do signatário é atualizado.","operationId":"sign","parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignActionRequest"}}},"required":true},"responses":{"200":{"description":"Assinatura aplicada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignResultResponse"}}}},"400":{"description":"Requisição, estado ou solicitação inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/sign-requests/{requestId}/qualified/prepare":{"post":{"tags":["sign-requests"],"summary":"Prepara assinatura qualificada com certificado local","description":"Recebe somente o certificado público, congela a revisão do PDF e devolve os bytes a serem assinados pelo Web PKI, agente local ou provedor em nuvem. PIN e chave privada não transitam pela API.","operationId":"prepareQualified_1","parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QualifiedPrepareRequest"}}},"required":true},"responses":{"400":{"description":"Certificado, estado ou solicitação inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"200":{"description":"Operação qualificada preparada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QualifiedPrepareResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/sign-requests/{requestId}/qualified/complete":{"post":{"tags":["sign-requests"],"summary":"Conclui assinatura qualificada com certificado local","description":"Valida o valor criptográfico retornado pelo dispositivo contra a operação preparada e incorpora a assinatura PAdES ao PDF.","operationId":"completeQualified_1","parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QualifiedCompleteRequest"}}},"required":true},"responses":{"400":{"description":"Operação ou assinatura inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"200":{"description":"Assinatura qualificada incorporada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignResultResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/sign-requests/{requestId}/qualified/cloud/sign":{"post":{"tags":["sign-requests"],"summary":"Assina com bearer ICP-Brasil em nuvem (integração legada)","description":"Fluxo servidor-servidor para clientes que já obtiveram uma autorização OAuth de uso único no SafeID, VIDaaS ou BirdID. Exige o aceite e o texto exato do termo. Novas jornadas devem usar /sign/{token}/qualified/cloud/authorize, no qual o bearer nunca chega ao cliente.","operationId":"signQualifiedWithCloud","parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QualifiedCloudSignRequest"}}},"required":true},"responses":{"400":{"description":"Requisição inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Falha no provedor de nuvem","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"200":{"description":"Documento assinado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignResultResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}},"deprecated":true}},"/api/v1/sign-requests/{requestId}/participants/{signatoryId}/resend":{"post":{"tags":["sign-requests"],"summary":"Revoga links antigos e reenvia um novo convite","operationId":"resend","parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"string"}},{"name":"signatoryId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Novo convite emitido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResendResponse"}}}},"400":{"description":"Reenvio indisponível","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/sign-requests/{requestId}/participants/{signatoryId}/decline":{"post":{"tags":["sign-requests"],"summary":"Recusa uma solicitação com motivo auditável","operationId":"decline_1","parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"string"}},{"name":"signatoryId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeclineRequest"}}},"required":true},"responses":{"200":{"description":"Recusa registrada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDeclineResponse"}}}},"400":{"description":"Recusa inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/sign-requests/{requestId}/participants/action":{"post":{"tags":["sign-requests"],"summary":"Conclui aprovação, aceite, ciência ou preenchimento de formulário","operationId":"participantAction_1","parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParticipantActionRequest"}}},"required":true},"responses":{"400":{"description":"Ação inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"200":{"description":"Ação registrada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParticipantActionResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/sign-requests/bulk":{"post":{"tags":["sign-requests"],"summary":"Cria até 100 solicitações em lote","operationId":"createBulk","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkCreateRequest"}}},"required":true},"responses":{"200":{"description":"Lote processado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkCreateResponse"}}}},"409":{"description":"Idempotency-Key reutilizada com outro conteúdo","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Plano, período comercial ou saldo não autoriza o lote","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"400":{"description":"Lote inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/api/v1/sign-electronic":{"post":{"tags":["sign-electronic"],"summary":"Assina um documento eletronicamente (SES/AES)","description":"Aplica uma assinatura eletrônica sem exigir certificado digital do signatário. A identidade é comprovada por fatores de autenticação; o documento é selado com o certificado organizacional em PAdES-B e a trilha de evidências é embutida como anexo PDF. Para AES, inclua otp.proof de uma transação verificada.","operationId":"sign_1","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ElectronicSignRequest"}}},"required":true},"responses":{"400":{"description":"Requisição inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"200":{"description":"Documento assinado eletronicamente","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ElectronicSignResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/reviews":{"get":{"tags":["contract-collaboration"],"operationId":"list_3","parameters":[{"name":"targetType","in":"query","required":true,"schema":{"type":"string","enum":["CONTRACT","TEMPLATE"]}},{"name":"targetId","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ReviewResponse"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}},"post":{"tags":["contract-collaboration"],"operationId":"create_2","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateReviewRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/reviews/{reviewId}/submit":{"post":{"tags":["contract-collaboration"],"operationId":"submit","parameters":[{"name":"reviewId","in":"path","required":true,"schema":{"type":"string"}},{"name":"If-Match","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/reviews/{reviewId}/decision":{"post":{"tags":["contract-collaboration"],"operationId":"decide","parameters":[{"name":"reviewId","in":"path","required":true,"schema":{"type":"string"}},{"name":"If-Match","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewDecisionRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/reviews/{reviewId}/comments":{"post":{"tags":["contract-collaboration"],"operationId":"comment","parameters":[{"name":"reviewId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCommentRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommentResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/platform/tenants":{"get":{"tags":["platform"],"summary":"Lista empresas cadastradas","description":"Exclusivo da chave PLATFORM_ADMIN.","operationId":"listTenants","responses":{"200":{"description":"Empresas cadastradas","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TenantResponse"}}}}},"403":{"description":"Operação restrita","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}},"post":{"tags":["platform"],"summary":"Cadastra uma empresa e emite a chave administrativa inicial uma única vez","operationId":"registerTenant","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTenantRequest"}}},"required":true},"responses":{"400":{"description":"Dados da empresa inválidos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"201":{"description":"Empresa e chave administrativa criadas","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTenantResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/platform/api-keys":{"get":{"tags":["platform"],"summary":"Lista metadados das chaves da empresa autenticada","operationId":"listApiKeys","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ApiKeyResponse"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}},"post":{"tags":["platform"],"summary":"Gera uma chave de integração da empresa autenticada uma única vez","operationId":"createApiKey","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateApiKeyRequest"}}},"required":true},"responses":{"201":{"description":"Chave de integração criada e revelada uma única vez","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateApiKeyResponse"}}}},"400":{"description":"Dados da chave inválidos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/otp/verify":{"post":{"tags":["otp"],"summary":"Verifica o código OTP submetido","description":"Marca a transação como verificada em caso de sucesso. O timestamp retornado deve ser repassado como otp.proof.verifiedAt na chamada posterior a /sign-electronic com nível AES.","operationId":"verify","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OtpVerifyRequest"}}},"required":true},"responses":{"400":{"description":"Requisição inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"200":{"description":"Resultado da verificação","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OtpVerifyResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/otp/send":{"post":{"tags":["otp"],"summary":"Envia um OTP para o destino informado","description":"Em modo de teste, expõe o código aceito para fins de exercício do fluxo AES. Em produção, dispara a entrega real (SMS/WhatsApp) e NÃO retorna o código.","operationId":"send","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OtpSendRequest"}}},"required":true},"responses":{"200":{"description":"OTP enviado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OtpSendResponse"}}}},"400":{"description":"Requisição inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Limite de emissão por destino ou IP atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Limitador OTP sem segredo configurado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/onboarding/organizations":{"post":{"tags":["onboarding"],"summary":"Cria empresa, OWNER, trial e sessão humana inicial","operationId":"register","parameters":[{"name":"Idempotency-Key","in":"header","description":"Chave obrigatória e única para tornar o cadastro idempotente","required":true,"schema":{"maxLength":128,"minLength":1,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterOrganizationRequest"}}},"required":true},"responses":{"201":{"description":"Empresa criada","headers":{"Idempotency-Replayed":{"description":"false para uma criação nova","style":"simple","schema":{"type":"string","enum":["false"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegistrationResponse"}}}},"409":{"description":"Chave idempotente reutilizada com outro payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Cadastro público desabilitado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"200":{"description":"Replay idempotente da empresa já criada","headers":{"Idempotency-Replayed":{"description":"true para um replay","style":"simple","schema":{"type":"string","enum":["true"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegistrationResponse"}}}},"400":{"description":"Cadastro ou Idempotency-Key inválidos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/OnboardingRateLimited"},"503":{"$ref":"#/components/responses/OnboardingUnavailable"}},"security":[]}},"/api/v1/onboarding/email-verification/request":{"post":{"tags":["onboarding"],"summary":"Envia link one-time para confirmar o e-mail antes do cadastro","operationId":"requestEmailVerification","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailVerificationRequest"}}},"required":true},"responses":{"404":{"description":"Cadastro público desabilitado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"400":{"description":"E-mail inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"202":{"description":"Solicitação aceita sem revelar se o e-mail existe","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailVerificationRequestResponse"}}}},"429":{"$ref":"#/components/responses/PublicRateLimited"},"503":{"$ref":"#/components/responses/PublicAuthUnavailable"}},"security":[]}},"/api/v1/onboarding/email-verification/complete":{"post":{"tags":["onboarding"],"summary":"Troca o link one-time por uma prova curta consumível no cadastro","operationId":"completeEmailVerification","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailVerificationCompleteRequest"}}},"required":true},"responses":{"400":{"description":"Token inválido, expirado ou já consumido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Cadastro público desabilitado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"200":{"description":"E-mail confirmado e prova curta emitida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailVerificationCompleteResponse"}}}},"429":{"$ref":"#/components/responses/PublicRateLimited"},"503":{"$ref":"#/components/responses/PublicAuthUnavailable"}},"security":[]}},"/api/v1/identity/sso/providers":{"get":{"tags":["human-identity-controller"],"operationId":"oidcProviders","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OidcProviderView"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}},"post":{"tags":["human-identity-controller"],"operationId":"createOidcProvider","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveOidcProviderRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OidcProviderView"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/identity/invitations":{"get":{"tags":["human-identity-controller"],"operationId":"invitations","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/InvitationView"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}},"post":{"tags":["human-identity-controller"],"operationId":"invite","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateInvitationRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvitationIssued"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/envelopes":{"get":{"tags":["multi-document-envelopes"],"operationId":"list_4","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/EnvelopeSummary"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}},"post":{"tags":["multi-document-envelopes"],"operationId":"create_3","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateEnvelopeRequest"}}},"required":true},"responses":{"201":{"description":"Envelope criado","headers":{"ETag":{"description":"Versão forte do envelope","style":"simple","schema":{"type":"string"}},"Location":{"description":"URL relativa do envelope criado","style":"simple","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnvelopeResponse"}}}},"200":{"description":"Replay idempotente do envelope já criado","headers":{"Idempotency-Replayed":{"description":"Sempre true neste status","style":"simple","schema":{"type":"string","enum":["true"]}},"ETag":{"description":"Versão forte do envelope","style":"simple","schema":{"type":"string"}},"Location":{"description":"URL relativa do envelope","style":"simple","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnvelopeResponse"}}}},"400":{"description":"Envelope inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Conflito idempotente ou de documentos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/envelopes/{envelopeId}/cancel":{"post":{"tags":["multi-document-envelopes"],"operationId":"cancel","parameters":[{"name":"envelopeId","in":"path","required":true,"schema":{"type":"string"}},{"name":"If-Match","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"428":{"description":"If-Match obrigatório","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"200":{"description":"Envelope cancelado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnvelopeResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/documents/upload":{"post":{"tags":["document-controller"],"summary":"Registra um PDF para uso em envelopes e solicitações","operationId":"uploadDocument","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"required":["file"],"type":"object","properties":{"file":{"type":"string","format":"binary"}}}}}},"responses":{"500":{"description":"Falha interna ao processar o PDF","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"400":{"description":"Arquivo ou metadados inválidos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"200":{"description":"Documento registrado ou replay idempotente","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentResponse"}}}},"409":{"description":"Chave idempotente reutilizada com outro arquivo","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"413":{"description":"PDF acima do limite configurado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/contracts":{"get":{"tags":["contracts"],"operationId":"list_5","parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["DRAFT","IN_REVIEW","SENT_FOR_SIGNATURE","ACTIVE","EXPIRED","TERMINATED"]}},{"name":"archived","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":25}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageResponseContractResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}},"post":{"tags":["contracts"],"operationId":"create_4","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WriteContractRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContractResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/contracts/{contractId}/transitions":{"post":{"tags":["contracts"],"operationId":"transition","parameters":[{"name":"contractId","in":"path","required":true,"schema":{"type":"string"}},{"name":"If-Match","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransitionRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContractResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/contracts/{contractId}/sync-signing-status":{"post":{"tags":["contracts"],"operationId":"synchronizeSigningStatus","parameters":[{"name":"contractId","in":"path","required":true,"schema":{"type":"string"}},{"name":"If-Match","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContractResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/contracts/{contractId}/restore":{"post":{"tags":["contracts"],"operationId":"restore","parameters":[{"name":"contractId","in":"path","required":true,"schema":{"type":"string"}},{"name":"If-Match","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContractResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/contracts/{contractId}/obligations":{"get":{"tags":["contracts"],"operationId":"listObligations","parameters":[{"name":"contractId","in":"path","required":true,"schema":{"type":"string"}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["OPEN","IN_PROGRESS","COMPLETED","WAIVED"]}},{"name":"dueBefore","in":"query","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":25}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageResponseObligationResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}},"post":{"tags":["contracts"],"operationId":"createObligation","parameters":[{"name":"contractId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WriteObligationRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ObligationResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/contracts/{contractId}/archive":{"post":{"tags":["contracts"],"operationId":"archive","parameters":[{"name":"contractId","in":"path","required":true,"schema":{"type":"string"}},{"name":"If-Match","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContractResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/contacts":{"get":{"tags":["contacts"],"operationId":"list_6","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ContactResponse"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}},"post":{"tags":["contacts"],"operationId":"create_5","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactRequest"}}},"required":true},"responses":{"200":{"description":"Replay idempotente do contato existente","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactResponse"}}}},"201":{"description":"Contato criado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactResponse"}}}},"409":{"description":"Conflito de idempotência","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/commercial/regularizations":{"get":{"tags":["commercial"],"summary":"Lista as solicitações de regularização do tenant atual","operationId":"regularizations","responses":{"200":{"description":"Solicitações mais recentes","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RegularizationResponse"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}},"post":{"tags":["commercial"],"summary":"Abre solicitação auditável de regularização sem conceder plano ou quota","operationId":"openRegularization","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegularizationCreateRequest"}}},"required":true},"responses":{"409":{"description":"Chave idempotente usada com outro pedido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"200":{"description":"Replay idempotente da solicitação já criada","headers":{"Idempotency-Replayed":{"description":"Sempre true neste status","style":"simple","schema":{"type":"string","enum":["true"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegularizationResponse"}}}},"201":{"description":"Solicitação de regularização criada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegularizationResponse"}}}},"400":{"description":"Plano ou chave idempotente inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/api/v1/commercial/portal":{"post":{"tags":["commercial"],"summary":"Cria sessão no portal do cliente do provedor configurado","operationId":"portal","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PortalRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingSessionResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/api/v1/commercial/checkout":{"post":{"tags":["commercial"],"summary":"Cria checkout somente quando existe adaptador homologado e configurado","operationId":"checkout","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutRequest"}}},"required":true},"responses":{"200":{"description":"Replay idempotente da sessão já criada","headers":{"Idempotency-Replayed":{"description":"Sempre true neste status","style":"simple","schema":{"type":"string","enum":["true"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingSessionResponse"}}}},"503":{"description":"Provedor de cobrança indisponível","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"400":{"description":"Plano, URL ou chave idempotente inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"201":{"description":"Sessão de checkout criada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingSessionResponse"}}}},"409":{"description":"Plano sem mapeamento ou assinatura externa já existente","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/api/v1/commercial/admin/regularizations/{regularizationId}/transitions":{"post":{"tags":["commercial"],"summary":"Avança o estado operacional de uma regularização","description":"Exclusivo de PLATFORM_ADMIN; nunca concede plano, período ou quota","operationId":"transitionRegularization","parameters":[{"name":"regularizationId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegularizationTransitionRequest"}}},"required":true},"responses":{"200":{"description":"Transição aplicada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminRegularizationResponse"}}}},"404":{"description":"Protocolo não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Transição não permitida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"400":{"description":"Destino, responsável ou nota inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/api/v1/clauses":{"get":{"tags":["clauses"],"operationId":"list_7","parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string"}},{"name":"tag","in":"query","required":false,"schema":{"type":"string"}},{"name":"archived","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":25}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageResponseClauseResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}},"post":{"tags":["clauses"],"operationId":"create_6","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateClauseRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClauseResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/clauses/{clauseId}/references":{"post":{"tags":["clauses"],"operationId":"reference","parameters":[{"name":"clauseId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateClauseReferenceRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClauseReferenceResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/biometric/verifications":{"get":{"tags":["biometric-verifications"],"summary":"Lista até 100 verificações pendentes de revisão da própria empresa","operationId":"pendingReview","parameters":[{"name":"decision","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"403":{"description":"Acesso negado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"400":{"description":"Filtro inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"200":{"description":"Verificações pendentes","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/VerificationView"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}},"post":{"tags":["biometric-verifications"],"summary":"Submete frente, verso, imagem facial e vídeo ao provedor biométrico configurado","description":"Identificador do titular, hashes, desafio e consentimento via partes multipart; nenhum CPF integra a URL.","operationId":"verify_1","requestBody":{"content":{"multipart/form-data":{"schema":{"required":["activeLivenessChallengeId","consentAccepted","consentTermSha256","documentSha256","identityDocument","identityDocumentBack","liveImage","liveVideo","subjectDocumentId"],"type":"object","properties":{"identityDocument":{"type":"string","format":"binary"},"identityDocumentBack":{"type":"string","format":"binary"},"liveImage":{"type":"string","format":"binary"},"liveVideo":{"type":"string","format":"binary"},"subjectDocumentId":{"type":"string"},"documentSha256":{"type":"string"},"activeLivenessChallengeId":{"type":"string"},"consentTermSha256":{"type":"string"},"consentAccepted":{"type":"boolean"}}}}}},"responses":{"400":{"description":"Captura ou consentimento inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Acesso negado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Limitador indisponível","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Limite de captura atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"501":{"description":"Provedor não configurado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"201":{"description":"Verificação processada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerificationView"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/biometric/verifications/{verificationId}/status":{"post":{"tags":["biometric-verifications"],"summary":"Consulta uma prova direta vinculada ao titular","description":"O identificador do titular permanece no corpo JSON e não integra a URL.","operationId":"status","parameters":[{"name":"verificationId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DirectStatusRequest"}}},"required":true},"responses":{"200":{"description":"Estado da verificação","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerificationView"}}}},"400":{"description":"Prova indisponível","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"501":{"description":"Provedor não configurado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/biometric/verifications/{verificationId}/review":{"post":{"tags":["biometric-verifications"],"summary":"Rejeita manualmente uma decisão automática REVIEW; aprovação exige nova captura","operationId":"review","parameters":[{"name":"verificationId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewRequest"}}},"required":true},"responses":{"403":{"description":"Acesso negado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"400":{"description":"Revisão inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"200":{"description":"Revisão registrada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerificationView"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/biometric/verifications/challenge":{"post":{"tags":["biometric-verifications"],"summary":"Emite desafio efêmero de vivacidade ativa para uma verificação direta","description":"Recebe o identificador sensível exclusivamente no corpo JSON; nunca na URL.","operationId":"startActiveLivenessChallenge","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DirectChallengeRequest"}}},"required":true},"responses":{"503":{"description":"Limitador indisponível","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"400":{"description":"Solicitação inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"501":{"description":"Provedor não configurado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"201":{"description":"Desafio emitido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChallengeView"}}}},"429":{"description":"Limite de desafios atingido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/automations":{"get":{"tags":["automations"],"summary":"Lista automações ativas, pausadas e em rascunho do tenant","operationId":"list_8","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/DefinitionResponse"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}},"post":{"tags":["automations"],"operationId":"create_7","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DefinitionRequest"}}},"required":true},"responses":{"200":{"description":"Replay idempotente da automação existente","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DefinitionResponse"}}}},"409":{"description":"Conflito idempotente","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"201":{"description":"Automação criada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DefinitionResponse"}}}},"400":{"description":"Definição inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/automations/{automationId}/runs":{"get":{"tags":["automations"],"operationId":"runs","parameters":[{"name":"automationId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RunResponse"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}},"post":{"tags":["automations"],"operationId":"run","parameters":[{"name":"automationId","in":"path","required":true,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunRequest"}}}},"responses":{"422":{"description":"Falha registrada na execução","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Automação inativa ou conflito idempotente","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"200":{"description":"Replay idempotente da execução","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunStartResponse"}}}},"400":{"description":"Entrada inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"201":{"description":"Execução iniciada; links aparecem uma única vez","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunStartResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/automations/{automationId}/runs/{runId}/cancel":{"post":{"tags":["automations"],"operationId":"cancelRun","parameters":[{"name":"automationId","in":"path","required":true,"schema":{"type":"string"}},{"name":"runId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/automations/{automationId}/pause":{"post":{"tags":["automations"],"operationId":"pause","parameters":[{"name":"automationId","in":"path","required":true,"schema":{"type":"string"}},{"name":"If-Match","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DefinitionResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/automations/{automationId}/activate":{"post":{"tags":["automations"],"operationId":"activate","parameters":[{"name":"automationId","in":"path","required":true,"schema":{"type":"string"}},{"name":"If-Match","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DefinitionResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/auth/sso/authorize":{"post":{"tags":["human-auth-controller"],"operationId":"authorizeSso","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OidcAuthorizeRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorizationStart"}}}},"429":{"$ref":"#/components/responses/PublicRateLimited"},"503":{"$ref":"#/components/responses/PublicAuthUnavailable"}},"security":[]}},"/api/v1/auth/session/tenant":{"post":{"tags":["human-auth-controller"],"operationId":"switchTenant","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SwitchTenantRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/auth/session/rotate":{"post":{"tags":["human-auth-controller"],"operationId":"rotate","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/auth/password/reset/request":{"post":{"tags":["human-auth-controller"],"summary":"Solicita um link one-time de recuperação sem revelar se a conta existe","operationId":"requestPasswordReset","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PasswordResetRequest"}}},"required":true},"responses":{"400":{"description":"E-mail ou empresa inválidos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"202":{"description":"Solicitação aceita","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestAccepted"}}}},"429":{"$ref":"#/components/responses/PublicRateLimited"},"503":{"$ref":"#/components/responses/PublicAuthUnavailable"}},"security":[]}},"/api/v1/auth/password/reset/complete":{"post":{"tags":["human-auth-controller"],"summary":"Consome o token one-time, atualiza a senha e revoga as sessões anteriores","operationId":"completePasswordReset","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PasswordResetCompleteRequest"}}},"required":true},"responses":{"400":{"description":"Token inválido, expirado ou senha rejeitada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"204":{"description":"Senha atualizada; resposta sem corpo"},"401":{"description":"Segundo fator obrigatório ou inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"$ref":"#/components/responses/PublicRateLimited"},"503":{"$ref":"#/components/responses/PublicAuthUnavailable"}},"security":[]}},"/api/v1/auth/mfa/totp/enroll":{"post":{"tags":["human-auth-controller"],"operationId":"enrollTotp","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnrollTotpRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TotpEnrollment"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/auth/mfa/totp/confirm":{"post":{"tags":["human-auth-controller"],"operationId":"confirmTotp","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmTotpRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TotpConfirmationResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/auth/mfa/challenge":{"post":{"tags":["human-auth-controller"],"operationId":"completeMfa","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MfaChallengeRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionResponse"}}}},"429":{"$ref":"#/components/responses/PublicRateLimited"},"503":{"$ref":"#/components/responses/PublicAuthUnavailable"}},"security":[]}},"/api/v1/auth/logout":{"post":{"tags":["human-auth-controller"],"operationId":"logout","responses":{"204":{"description":"Operação concluída sem corpo de resposta"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/auth/login":{"post":{"tags":["human-auth-controller"],"operationId":"login","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginResponse"}}}},"429":{"$ref":"#/components/responses/PublicRateLimited"},"503":{"$ref":"#/components/responses/PublicAuthUnavailable"}},"security":[]}},"/api/v1/auth/login/tenant":{"post":{"tags":["human-auth-controller"],"operationId":"selectTenant","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantSelectionRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginResponse"}}}},"429":{"$ref":"#/components/responses/PublicRateLimited"},"503":{"$ref":"#/components/responses/PublicAuthUnavailable"}},"security":[]}},"/api/v1/auth/invitations/accept":{"post":{"tags":["human-auth-controller"],"operationId":"acceptInvitation","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AcceptInvitationRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionResponse"}}}},"429":{"$ref":"#/components/responses/PublicRateLimited"},"503":{"$ref":"#/components/responses/PublicAuthUnavailable"}},"security":[]}},"/api/v1/auth/email/verification/request":{"post":{"tags":["human-auth-controller"],"operationId":"requestEmailVerification_1","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestAccepted"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/auth/email/verification/complete":{"post":{"tags":["human-auth-controller"],"operationId":"completeEmailVerification_1","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailVerificationCompleteRequest"}}},"required":true},"responses":{"204":{"description":"Operação concluída sem corpo de resposta"},"429":{"$ref":"#/components/responses/PublicRateLimited"},"503":{"$ref":"#/components/responses/PublicAuthUnavailable"}},"security":[]}},"/api/v1/approval-workflows":{"get":{"tags":["approvals"],"operationId":"list_10","parameters":[{"name":"targetType","in":"query","required":true,"schema":{"type":"string","enum":["CONTRACT","TEMPLATE"]}},{"name":"targetId","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ApprovalWorkflowResponse"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}},"post":{"tags":["approvals"],"operationId":"create_8","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateApprovalWorkflowRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalWorkflowResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/approval-workflows/{workflowId}/start":{"post":{"tags":["approvals"],"operationId":"start","parameters":[{"name":"workflowId","in":"path","required":true,"schema":{"type":"string"}},{"name":"If-Match","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalWorkflowResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/approval-workflows/{workflowId}/decisions":{"post":{"tags":["approvals"],"operationId":"decide_1","parameters":[{"name":"workflowId","in":"path","required":true,"schema":{"type":"string"}},{"name":"If-Match","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalDecisionRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalWorkflowResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/approval-workflows/{workflowId}/cancel":{"post":{"tags":["approvals"],"operationId":"cancel_1","parameters":[{"name":"workflowId","in":"path","required":true,"schema":{"type":"string"}},{"name":"If-Match","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalWorkflowResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/templates/{templateId}":{"get":{"tags":["templates"],"operationId":"get","parameters":[{"name":"templateId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Modelo encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplateResponse"}}}},"400":{"description":"Identificador inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}},"delete":{"tags":["templates"],"operationId":"delete","parameters":[{"name":"templateId","in":"path","required":true,"schema":{"type":"string"}},{"name":"If-Match","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"428":{"description":"If-Match obrigatório","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"412":{"description":"If-Match obsoleto","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"204":{"description":"Modelo excluído; resposta sem corpo"},"400":{"description":"Modelo ou ETag inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}},"patch":{"tags":["templates"],"operationId":"update_4","parameters":[{"name":"templateId","in":"path","required":true,"schema":{"type":"string"}},{"name":"If-Match","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentTemplatePatchRequest"}}},"required":true},"responses":{"412":{"description":"If-Match obsoleto","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"400":{"description":"Alteração inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"200":{"description":"Modelo atualizado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplateResponse"}}}},"409":{"description":"Conflito de versão","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/sign-requests/{requestId}/participants/{signatoryId}":{"patch":{"tags":["sign-requests"],"summary":"Corrige os dados de um participante pendente","description":"Revoga links anteriores. Um novo link é emitido imediatamente apenas se a etapa do participante já estiver elegível; em etapas futuras, url/sentAt permanecem nulos.","operationId":"correctParticipant","parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"string"}},{"name":"signatoryId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CorrectParticipantRequest"}}},"required":true},"responses":{"200":{"description":"Participante corrigido e link anterior revogado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResendResponse"}}}},"400":{"description":"Participante ou correção inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/platform/tenants/{tenantId}/status":{"patch":{"tags":["platform"],"summary":"Habilita ou desabilita uma empresa sem excluir seus dados","description":"Exclusivo da chave PLATFORM_ADMIN.","operationId":"updateTenantStatus","parameters":[{"name":"tenantId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateTenantStatusRequest"}}},"required":true},"responses":{"200":{"description":"Estado da empresa atualizado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TenantResponse"}}}},"404":{"description":"Empresa não encontrada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Operação restrita","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"400":{"description":"Alteração inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/identity/members/{membershipId}":{"patch":{"tags":["human-identity-controller"],"operationId":"updateMember","parameters":[{"name":"membershipId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateMembershipRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MemberView"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/verify/{signatureId}":{"get":{"tags":["public-verification-controller"],"operationId":"page","parameters":[{"name":"signatureId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"text/html":{"schema":{"type":"string"}}}}},"security":[]}},"/verify/{signatureId}/report":{"get":{"tags":["public-verification-controller"],"summary":"Consulta as evidências públicas vinculadas à assinatura","operationId":"report","parameters":[{"name":"signatureId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Evidência não encontrada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"200":{"description":"Relatório público de evidências","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicVerificationReport"}}}}},"security":[]}},"/sign/{token}":{"get":{"tags":["public-signing-controller"],"operationId":"page_1","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"text/html":{"schema":{"type":"string"}}}}},"security":[]}},"/sign/{token}/status":{"get":{"tags":["public-signing-controller"],"summary":"Acompanha no desktop a ação do participante vinculada ao token","operationId":"continuationStatus","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Estado público mínimo do participante","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicSigningContinuationStatus"}}}},"410":{"description":"Acompanhamento expirado ou indisponível","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[]}},"/sign/{token}/signed-document":{"get":{"tags":["public-signing-controller"],"summary":"Baixa o PDF final pelo link pessoal do signatário","description":"Disponível somente ao token que produziu a assinatura, até 24 horas após a conclusão da solicitação e nunca além do vencimento original do link.","operationId":"signedDocument","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"PDF final concluído","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"410":{"description":"PDF final ou autorização indisponível","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[]}},"/sign/{token}/qualified/config":{"get":{"tags":["public-signing-controller"],"summary":"Consulta os provedores qualificados habilitados para este link","operationId":"qualifiedConfig","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Capacidades qualificadas disponíveis","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicQualifiedConfigResponse"}}}},"400":{"description":"A solicitação não exige certificado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"410":{"description":"Link expirado ou indisponível","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[]}},"/sign/{token}/document":{"get":{"tags":["public-signing-controller"],"operationId":"document","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}},{"name":"download","in":"query","required":false,"schema":{"type":"boolean","default":false}}],"responses":{"410":{"description":"Documento ou link indisponível","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"200":{"description":"PDF corrente da solicitação","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}}},"security":[]}},"/sign/{token}/biometric/{verificationId}":{"get":{"tags":["public-signing-controller"],"operationId":"biometricStatus","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string"}},{"name":"verificationId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"400":{"description":"Prova indisponível","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"501":{"description":"Provedor não configurado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"200":{"description":"Estado público mínimo da verificação","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicBiometricResponse"}}}}},"security":[]}},"/sign/qualified/cloud/callback":{"get":{"tags":["public-signing-controller"],"operationId":"completeQualifiedCloudCallback","parameters":[{"name":"state","in":"query","required":false,"schema":{"type":"string"}},{"name":"code","in":"query","required":false,"schema":{"type":"string"}},{"name":"error","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"text/html":{"schema":{"type":"string"}}}}},"security":[]}},"/api/v1/trust-anchors":{"get":{"tags":["trust-anchors"],"summary":"Lista âncoras de confiança ativas","description":"Retorna lista de âncoras de confiança configuradas: LOTL europeia + raízes ITI ICP-Brasil","operationId":"list","responses":{"200":{"description":"Âncoras ativas","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrustAnchorListResponse"}}}},"500":{"description":"Falha ao consultar âncoras","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/templates/{templateId}/versions":{"get":{"tags":["templates"],"operationId":"versions","parameters":[{"name":"templateId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Revisões imutáveis do modelo","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TemplateRevisionResponse"}}}}},"400":{"description":"Modelo inválido ou indisponível","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/sign-requests/{requestId}":{"get":{"tags":["sign-requests"],"summary":"Consulta o status de uma solicitação de assinatura","description":"Retorna o estado da solicitação, data de expiração e o status de cada signatário.","operationId":"getStatus","parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Status da solicitação","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatusResponse"}}}},"400":{"description":"Identificador inválido ou solicitação não encontrada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}},"delete":{"tags":["sign-requests"],"summary":"Cancela uma solicitação de assinatura pendente","description":"Cancela uma solicitação que ainda não foi concluída. Não é possível cancelar solicitações já concluídas, canceladas ou expiradas.","operationId":"cancel_2","parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Solicitação cancelada com sucesso"},"400":{"description":"Solicitação não encontrada ou não cancelável","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/sign-requests/{requestId}/signed-document":{"get":{"tags":["sign-requests"],"summary":"Baixa o PDF assinado","description":"Disponível somente ao tenant da solicitação após a conclusão.","operationId":"downloadSignedDocument","parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"400":{"description":"Solicitação ainda não concluída ou inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"200":{"description":"PDF assinado","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/reviews/{reviewId}":{"get":{"tags":["contract-collaboration"],"operationId":"get_1","parameters":[{"name":"reviewId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/reviews/{reviewId}/timeline":{"get":{"tags":["contract-collaboration"],"operationId":"timeline","parameters":[{"name":"reviewId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TimelineEventResponse"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/platform/overview":{"get":{"tags":["platform"],"summary":"Resumo do tenant autenticado para o dashboard","operationId":"overview","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OverviewResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/platform/deliveries":{"get":{"tags":["platform"],"summary":"Lista as entregas de e-mail, webhook e mensageria do tenant","operationId":"listDeliveries","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/DeliveryStatus"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/onboarding/config":{"get":{"tags":["onboarding"],"summary":"Informa disponibilidade e versão vigente dos termos do cadastro","operationId":"config","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OnboardingConfigResponse"}}}}},"security":[]}},"/api/v1/identity/members":{"get":{"tags":["human-identity-controller"],"operationId":"members","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MemberView"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/envelopes/{envelopeId}":{"get":{"tags":["multi-document-envelopes"],"operationId":"get_2","parameters":[{"name":"envelopeId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnvelopeResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/envelopes/{envelopeId}/download":{"get":{"tags":["multi-document-envelopes"],"operationId":"download","parameters":[{"name":"envelopeId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"409":{"description":"Envelope ainda não concluído","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"200":{"description":"ZIP com todos os PDFs assinados","content":{"application/zip":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"Envelope não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/documents":{"get":{"tags":["document-controller"],"summary":"Lista os documentos do tenant autenticado","operationId":"listDocuments","responses":{"200":{"description":"Documentos visíveis no tenant","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/DocumentResponse"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/documents/{documentId}":{"get":{"tags":["document-controller"],"summary":"Consulta os metadados de um documento","operationId":"getDocument","parameters":[{"name":"documentId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"404":{"description":"Documento não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"200":{"description":"Metadados do documento","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/documents/{documentId}/status":{"get":{"tags":["document-controller"],"summary":"Consulta o estado de processamento do documento","operationId":"getDocumentStatus","parameters":[{"name":"documentId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Estado do documento","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentStatusResponse"}}}},"404":{"description":"Documento não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/documents/{documentId}/download":{"get":{"tags":["document-controller"],"summary":"Baixa o PDF original ou assinado","operationId":"downloadDocument","parameters":[{"name":"documentId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"PDF do documento","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"500":{"description":"Documento temporariamente indisponível","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Documento não encontrado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/contracts/{contractId}/timeline":{"get":{"tags":["contracts"],"operationId":"timeline_1","parameters":[{"name":"contractId","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":50}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageResponseEventResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/contracts/renewals":{"get":{"tags":["contracts"],"operationId":"renewals","parameters":[{"name":"from","in":"query","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"to","in":"query","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":25}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageResponseContractResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/contracts/obligations/due":{"get":{"tags":["contracts"],"operationId":"dueObligations","parameters":[{"name":"until","in":"query","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":25}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageResponseObligationResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/commercial/usage":{"get":{"tags":["commercial"],"summary":"Consulta consumo e saldo de quotas do período atual","operationId":"usage","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/api/v1/commercial/subscription":{"get":{"tags":["commercial"],"summary":"Consulta plano e assinatura do tenant atual","operationId":"subscription","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscriptionResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/api/v1/commercial/plans":{"get":{"tags":["commercial"],"summary":"Lista o catálogo público para tenants autenticados","operationId":"catalog","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PlanResponse"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/api/v1/commercial/invoices":{"get":{"tags":["commercial"],"summary":"Lista invoices normalizados do tenant","operationId":"invoices","parameters":[{"name":"refresh","in":"query","required":false,"schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceListResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/api/v1/commercial/availability":{"get":{"tags":["commercial"],"summary":"Consulta as ações comerciais realmente disponíveis sem expor configuração","operationId":"availability","responses":{"200":{"description":"Ações comerciais disponíveis","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AvailabilityResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/api/v1/commercial/admin/tenants/{tenantId}/usage":{"get":{"tags":["commercial"],"summary":"Consulta as quotas de um tenant","description":"Exclusivo de PLATFORM_ADMIN","operationId":"adminUsage","parameters":[{"name":"tenantId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/api/v1/commercial/admin/tenants/{tenantId}/invoices":{"get":{"tags":["commercial"],"summary":"Consulta invoices de um tenant","description":"Exclusivo de PLATFORM_ADMIN","operationId":"adminInvoices","parameters":[{"name":"tenantId","in":"path","required":true,"schema":{"type":"string"}},{"name":"refresh","in":"query","required":false,"schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvoiceListResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/api/v1/commercial/admin/regularizations":{"get":{"tags":["commercial"],"summary":"Lista a fila global de regularizações","description":"Exclusivo de PLATFORM_ADMIN; filtros por status e tenant são opcionais","operationId":"allRegularizations","parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["OPEN","ACKNOWLEDGED","RESOLVED","CANCELED"]}},{"name":"tenantId","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":50}}],"responses":{"200":{"description":"Fila operacional mais recente","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AdminRegularizationResponse"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/api/v1/commercial/admin/plans":{"get":{"tags":["commercial"],"summary":"Lista planos ativos e inativos","description":"Exclusivo de PLATFORM_ADMIN","operationId":"allPlans","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PlanResponse"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/api/v1/clauses/{clauseId}/versions":{"get":{"tags":["clauses"],"operationId":"versions_1","parameters":[{"name":"clauseId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ClauseVersionResponse"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/clauses/{clauseId}/timeline":{"get":{"tags":["clauses"],"operationId":"timeline_2","parameters":[{"name":"clauseId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TimelineEventResponse"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/clauses/references":{"get":{"tags":["clauses"],"operationId":"references","parameters":[{"name":"targetType","in":"query","required":true,"schema":{"type":"string","enum":["CONTRACT","TEMPLATE"]}},{"name":"targetId","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ClauseReferenceResponse"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/biometric/verifications/consent-term":{"get":{"tags":["biometric-verifications"],"summary":"Obtém o termo biométrico exato que deve ser apresentado antes da captura","operationId":"consentTerm","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"object"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/biometric/provider-status":{"get":{"tags":["biometric-verifications"],"summary":"Consulta o diagnóstico técnico biométrico para administração da empresa","description":"Requer administrador do tenant ou plataforma; usuários humanos também precisam de SECURITY_MANAGE. Não recebe capturas, não contrata fornecedor e não comprova homologação. Sondagem em cache por até 30 segundos.","operationId":"getBiometricProviderStatus","responses":{"200":{"description":"Diagnóstico técnico e limitações","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BiometricProviderStatus"}}}},"403":{"description":"Acesso administrativo necessário","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/automations/{automationId}/runs/{runId}":{"get":{"tags":["automations"],"operationId":"run_1","parameters":[{"name":"automationId","in":"path","required":true,"schema":{"type":"string"}},{"name":"runId","in":"path","required":true,"schema":{"type":"string"}},{"name":"synchronize","in":"query","required":false,"schema":{"type":"boolean","default":true}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/automations/{automationId}/runs/{runId}/timeline":{"get":{"tags":["automations"],"operationId":"timeline_3","parameters":[{"name":"automationId","in":"path","required":true,"schema":{"type":"string"}},{"name":"runId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RunEventResponse"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/automations/{automationId}/revisions":{"get":{"tags":["automations"],"operationId":"revisions","parameters":[{"name":"automationId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RevisionResponse"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/auth/sso/providers":{"get":{"tags":["human-auth-controller"],"operationId":"discoverSso","parameters":[{"name":"tenant","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PublicOidcProviderView"}}}}},"429":{"$ref":"#/components/responses/PublicRateLimited"},"503":{"$ref":"#/components/responses/PublicAuthUnavailable"}},"security":[]}},"/api/v1/auth/sso/callback":{"get":{"tags":["human-auth-controller"],"operationId":"completeSso","parameters":[{"name":"state","in":"query","required":true,"schema":{"type":"string"}},{"name":"code","in":"query","required":false,"schema":{"type":"string"}},{"name":"error","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginResponse"}}}},"429":{"$ref":"#/components/responses/PublicRateLimited"},"503":{"$ref":"#/components/responses/PublicAuthUnavailable"}},"security":[]}},"/api/v1/auth/sessions":{"get":{"tags":["human-auth-controller"],"operationId":"sessions","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SessionView"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}},"delete":{"tags":["human-auth-controller"],"operationId":"revokeAll","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RevokedSessionsResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/auth/me":{"get":{"tags":["human-auth-controller"],"operationId":"me","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/audit":{"get":{"tags":["audit"],"summary":"Lista eventos de auditoria do tenant","description":"Devolve os eventos mais recentes com o hash encadeado de cada um e o veredito de integridade da cadeia. Limitado a 200 eventos por consulta.","operationId":"list_9","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":50}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/approval-workflows/{workflowId}":{"get":{"tags":["approvals"],"operationId":"get_6","parameters":[{"name":"workflowId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalWorkflowResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/approval-workflows/{workflowId}/timeline":{"get":{"tags":["approvals"],"operationId":"timeline_4","parameters":[{"name":"workflowId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TimelineEventResponse"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/platform/api-keys/{credentialId}":{"delete":{"tags":["platform"],"summary":"Revoga uma chave de integração","operationId":"revokeApiKey","parameters":[{"name":"credentialId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"400":{"description":"Chave inexistente ou não revogável","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"204":{"description":"Chave revogada; resposta sem corpo"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/identity/invitations/{invitationId}":{"delete":{"tags":["human-identity-controller"],"operationId":"revokeInvitation","parameters":[{"name":"invitationId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Operação concluída sem corpo de resposta"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/clauses/references/{referenceId}":{"delete":{"tags":["clauses"],"operationId":"removeReference","parameters":[{"name":"referenceId","in":"path","required":true,"schema":{"type":"string"}},{"name":"If-Match","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"204":{"description":"Referência removida; resposta sem corpo"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}},"/api/v1/auth/mfa/totp":{"delete":{"tags":["human-auth-controller"],"operationId":"disableTotp","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisableTotpRequest"}}},"required":true},"responses":{"204":{"description":"Operação concluída sem corpo de resposta"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"402":{"$ref":"#/components/responses/CommercialQuotaExceeded"}}}}},"components":{"schemas":{"UpdateTenantRequest":{"type":"object","properties":{"name":{"maxLength":160,"minLength":0,"type":"string"},"contactEmail":{"maxLength":254,"minLength":0,"type":"string"}}},"TenantResponse":{"type":"object","properties":{"id":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"contactEmail":{"type":"string"},"enabled":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time"}}},"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}},"CommentResponse":{"type":"object","properties":{"id":{"type":"string"},"reviewId":{"type":"string"},"body":{"type":"string"},"authorCredentialId":{"type":"string"},"resolvedBy":{"type":"string"},"resolvedAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"version":{"type":"integer","format":"int64"}}},"SaveOidcProviderRequest":{"required":["clientId","displayName","issuerUri"],"type":"object","properties":{"displayName":{"maxLength":120,"minLength":0,"type":"string"},"issuerUri":{"maxLength":1000,"minLength":0,"type":"string"},"clientId":{"maxLength":255,"minLength":0,"type":"string"},"clientSecret":{"maxLength":2000,"minLength":0,"type":"string"},"scopes":{"uniqueItems":true,"type":"array","items":{"type":"string"}},"enabled":{"type":"boolean"},"enforceSso":{"type":"boolean"}}},"OidcProviderView":{"type":"object","properties":{"id":{"type":"string"},"displayName":{"type":"string"},"issuerUri":{"type":"string"},"clientId":{"type":"string"},"scopes":{"uniqueItems":true,"type":"array","items":{"type":"string"}},"hasClientSecret":{"type":"boolean"},"enabled":{"type":"boolean"},"enforceSso":{"type":"boolean"},"authorizationAvailable":{"type":"boolean"},"configuredByUserId":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"WriteContractRequest":{"required":["title"],"type":"object","properties":{"title":{"maxLength":255,"minLength":0,"type":"string"},"counterpartyName":{"maxLength":255,"minLength":0,"type":"string"},"counterpartyDocument":{"maxLength":256,"minLength":0,"type":"string"},"documentId":{"pattern":"[0-9a-fA-F-]{36}","type":"string"},"signRequestId":{"pattern":"[0-9a-fA-F-]{36}","type":"string"},"effectiveAt":{"type":"string","format":"date-time"},"expiresAt":{"type":"string","format":"date-time"},"autoRenewal":{"type":"boolean"},"renewalNoticeDays":{"maximum":3650,"minimum":1,"type":"integer","format":"int32"},"ownerEmail":{"maxLength":320,"minLength":0,"type":"string"},"valueMinor":{"type":"integer","format":"int64"},"currency":{"pattern":"[A-Za-z]{3}","type":"string"},"tags":{"maxItems":30,"minItems":0,"type":"array","items":{"type":"string"}},"metadata":{"type":"object","additionalProperties":{"type":"object"}}}},"ContractResponse":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"counterpartyName":{"type":"string"},"counterpartyDocumentMasked":{"type":"string"},"documentId":{"type":"string"},"signRequestId":{"type":"string"},"status":{"type":"string","enum":["DRAFT","IN_REVIEW","SENT_FOR_SIGNATURE","ACTIVE","EXPIRED","TERMINATED"]},"effectiveAt":{"type":"string","format":"date-time"},"expiresAt":{"type":"string","format":"date-time"},"autoRenewal":{"type":"boolean"},"renewalNoticeDays":{"type":"integer","format":"int32"},"ownerEmail":{"type":"string"},"valueMinor":{"type":"integer","format":"int64"},"currency":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"metadata":{"type":"object","additionalProperties":{"type":"object"}},"archivedAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"version":{"type":"integer","format":"int64"}}},"WriteObligationRequest":{"required":["title"],"type":"object","properties":{"title":{"maxLength":255,"minLength":0,"type":"string"},"description":{"maxLength":10000,"minLength":0,"type":"string"},"ownerEmail":{"maxLength":320,"minLength":0,"type":"string"},"dueAt":{"type":"string","format":"date-time"},"status":{"type":"string","enum":["OPEN","IN_PROGRESS","COMPLETED","WAIVED"]}}},"ObligationResponse":{"type":"object","properties":{"id":{"type":"string"},"contractId":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"ownerEmail":{"type":"string"},"dueAt":{"type":"string","format":"date-time"},"status":{"type":"string","enum":["OPEN","IN_PROGRESS","COMPLETED","WAIVED"]},"overdue":{"type":"boolean"},"completedAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"version":{"type":"integer","format":"int64"}}},"ContactRequest":{"required":["channel","destination","document","name"],"type":"object","properties":{"name":{"maxLength":160,"minLength":0,"type":"string"},"company":{"maxLength":160,"minLength":0,"type":"string"},"document":{"maxLength":32,"minLength":0,"type":"string"},"channel":{"type":"string","enum":["EMAIL","WHATSAPP","SMS"]},"destination":{"maxLength":320,"minLength":0,"type":"string"}}},"ContactResponse":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"company":{"type":"string"},"document":{"type":"string"},"documentMasked":{"type":"string"},"channel":{"type":"string","enum":["EMAIL","WHATSAPP","SMS"]},"destination":{"type":"string"},"lastSignedAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"version":{"type":"integer","format":"int64"}}},"SubscriptionWriteRequest":{"required":["planId","status"],"type":"object","properties":{"planId":{"maxLength":64,"minLength":0,"type":"string"},"status":{"type":"string","enum":["TRIALING","ACTIVE","PAST_DUE","PAUSED","INCOMPLETE","CANCELED","EXPIRED"]},"billingProvider":{"maxLength":64,"minLength":0,"type":"string"},"providerCustomerRef":{"maxLength":255,"minLength":0,"type":"string"},"providerSubscriptionRef":{"maxLength":255,"minLength":0,"type":"string"},"currentPeriodStart":{"type":"string","format":"date-time"},"currentPeriodEnd":{"type":"string","format":"date-time"},"trialEndsAt":{"type":"string","format":"date-time"},"cancelAtPeriodEnd":{"type":"boolean"}}},"EntitlementResponse":{"type":"object","properties":{"metric":{"type":"string","enum":["API_CALLS","DOCUMENTS","SIGNATURE_REQUESTS","TEMPLATE_GENERATIONS","CONTRACTS","USERS","STORAGE_BYTES"]},"hardLimit":{"type":"integer","format":"int64"},"unlimited":{"type":"boolean"}}},"PlanResponse":{"type":"object","properties":{"id":{"type":"string"},"displayName":{"type":"string"},"description":{"type":"string"},"currency":{"type":"string"},"priceMinor":{"type":"integer","format":"int64"},"billingInterval":{"type":"string","enum":["MONTHLY","YEARLY"]},"trialDays":{"type":"integer","format":"int32"},"active":{"type":"boolean"},"entitlements":{"type":"array","items":{"$ref":"#/components/schemas/EntitlementResponse"}},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"version":{"type":"integer","format":"int64"}}},"SubscriptionResponse":{"type":"object","properties":{"id":{"type":"string"},"tenantId":{"type":"string"},"plan":{"$ref":"#/components/schemas/PlanResponse"},"status":{"type":"string","enum":["TRIALING","ACTIVE","PAST_DUE","PAUSED","INCOMPLETE","CANCELED","EXPIRED"]},"billingProvider":{"type":"string"},"providerConfigured":{"type":"boolean"},"providerCustomerRef":{"type":"string"},"providerSubscriptionRef":{"type":"string"},"currentPeriodStart":{"type":"string","format":"date-time"},"currentPeriodEnd":{"type":"string","format":"date-time"},"trialStartedAt":{"type":"string","format":"date-time"},"trialEndsAt":{"type":"string","format":"date-time"},"cancelAtPeriodEnd":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"version":{"type":"integer","format":"int64"}}},"EntitlementWriteRequest":{"required":["metric"],"type":"object","properties":{"metric":{"type":"string","enum":["API_CALLS","DOCUMENTS","SIGNATURE_REQUESTS","TEMPLATE_GENERATIONS","CONTRACTS","USERS","STORAGE_BYTES"]},"hardLimit":{"minimum":0,"type":"integer","format":"int64"}}},"PlanWriteRequest":{"required":["billingInterval","currency","displayName","entitlements","id"],"type":"object","properties":{"id":{"pattern":"[a-z0-9][a-z0-9_-]{1,63}","type":"string"},"displayName":{"maxLength":160,"minLength":0,"type":"string"},"description":{"maxLength":1000,"minLength":0,"type":"string"},"currency":{"pattern":"[A-Za-z]{3}","type":"string"},"priceMinor":{"minimum":0,"type":"integer","format":"int64"},"billingInterval":{"type":"string","enum":["MONTHLY","YEARLY"]},"trialDays":{"maximum":365,"minimum":0,"type":"integer","format":"int32"},"active":{"type":"boolean"},"entitlements":{"maxItems":32,"minItems":0,"type":"array","items":{"$ref":"#/components/schemas/EntitlementWriteRequest"}}}},"UpdateClauseRequest":{"required":["bodyText","title"],"type":"object","properties":{"title":{"maxLength":255,"minLength":0,"type":"string"},"description":{"maxLength":1000,"minLength":0,"type":"string"},"bodyText":{"maxLength":200000,"minLength":0,"type":"string"},"tags":{"maxItems":50,"minItems":0,"type":"array","items":{"type":"string"}},"changeSummary":{"maxLength":500,"minLength":0,"type":"string"}}},"ClauseResponse":{"type":"object","properties":{"id":{"type":"string"},"slug":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"currentVersionNumber":{"type":"integer","format":"int32"},"bodyText":{"type":"string"},"archivedAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"version":{"type":"integer","format":"int64"}}},"AutomationRecipient":{"required":["destination","documentId","name"],"type":"object","properties":{"name":{"maxLength":200,"minLength":0,"type":"string"},"documentId":{"maxLength":64,"minLength":0,"type":"string"},"destination":{"maxLength":320,"minLength":0,"type":"string"},"authFactors":{"maxItems":4,"minItems":0,"type":"array","items":{"type":"string"}},"role":{"maxLength":32,"minLength":0,"type":"string"},"routingOrder":{"type":"integer","format":"int32"},"allowDelegation":{"type":"boolean"},"privateMessage":{"maxLength":1000,"minLength":0,"type":"string"}}},"DocumentFieldDto":{"required":["height","label","page","recipientIndex","type","width","x","y"],"type":"object","properties":{"id":{"maxLength":80,"minLength":0,"type":"string"},"type":{"maxLength":32,"minLength":0,"type":"string"},"label":{"maxLength":160,"minLength":0,"type":"string"},"recipientIndex":{"type":"integer","format":"int32"},"page":{"type":"integer","format":"int32"},"x":{"type":"number","format":"double"},"y":{"type":"number","format":"double"},"width":{"type":"number","format":"double"},"height":{"type":"number","format":"double"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"defaultValue":{"maxLength":4000,"minLength":0,"type":"string"},"validationPattern":{"maxLength":200,"minLength":0,"type":"string"},"options":{"maxItems":50,"minItems":0,"type":"array","items":{"type":"string"}}}},"JsonNode":{"type":"object"},"ReminderPolicyDto":{"type":"object","properties":{"enabled":{"type":"boolean"},"firstAfterHours":{"type":"integer","format":"int32"},"intervalHours":{"type":"integer","format":"int32"},"maxReminders":{"type":"integer","format":"int32"}}},"UpdateDefinitionRequest":{"required":["expectedVersion","name","templateId","triggerType"],"type":"object","properties":{"expectedVersion":{"type":"integer","format":"int64"},"name":{"maxLength":160,"minLength":0,"type":"string"},"description":{"maxLength":500,"minLength":0,"type":"string"},"templateId":{"maxLength":36,"minLength":0,"type":"string"},"triggerType":{"type":"string","enum":["MANUAL","API","SCHEDULE"]},"scheduleCron":{"maxLength":120,"minLength":0,"type":"string"},"scheduleZone":{"maxLength":80,"minLength":0,"type":"string"},"defaultVariables":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/JsonNode"}},"defaultRecipients":{"maxItems":100,"minItems":0,"type":"array","items":{"$ref":"#/components/schemas/AutomationRecipient"}},"level":{"maxLength":16,"minLength":0,"type":"string"},"jurisdiction":{"maxLength":32,"minLength":0,"type":"string"},"ttl":{"type":"string","format":"duration","example":"P7D"},"routingMode":{"maxLength":32,"minLength":0,"type":"string"},"fields":{"maxItems":200,"minItems":0,"type":"array","items":{"$ref":"#/components/schemas/DocumentFieldDto"}},"reminders":{"$ref":"#/components/schemas/ReminderPolicyDto"},"tags":{"maxItems":20,"minItems":0,"type":"array","items":{"type":"string"}},"metadata":{"type":"object","additionalProperties":{"type":"string"}}}},"AutomationConfiguration":{"type":"object","properties":{"defaultVariables":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/JsonNode"}},"defaultRecipients":{"type":"array","items":{"$ref":"#/components/schemas/AutomationRecipient"}},"level":{"type":"string"},"jurisdiction":{"type":"string"},"ttlSeconds":{"type":"integer","format":"int64"},"routingMode":{"type":"string"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/DocumentFieldDto"}},"reminders":{"$ref":"#/components/schemas/ReminderPolicyDto"},"tags":{"type":"array","items":{"type":"string"}},"metadata":{"type":"object","additionalProperties":{"type":"string"}}}},"DefinitionResponse":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"templateId":{"type":"string"},"state":{"type":"string","enum":["DRAFT","ACTIVE","PAUSED","ARCHIVED"]},"triggerType":{"type":"string","enum":["MANUAL","API","SCHEDULE"]},"scheduleCron":{"type":"string"},"scheduleZone":{"type":"string"},"nextRunAt":{"type":"string","format":"date-time"},"configuration":{"$ref":"#/components/schemas/AutomationConfiguration"},"version":{"type":"integer","format":"int64"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"PublicVerificationCheckRequest":{"required":["documentSha256"],"type":"object","properties":{"documentSha256":{"pattern":"(?i)[0-9a-f]{64}","type":"string"}}},"PublicVerificationReport":{"type":"object","properties":{"signatureId":{"type":"string"},"title":{"type":"string"},"requestStatus":{"type":"string"},"level":{"type":"string"},"signedAt":{"type":"string"},"sourceDocumentHash":{"type":"string"},"signedDocumentHash":{"type":"string"},"signatureRevisionHash":{"type":"string"},"documentMatches":{"type":"boolean"},"signerName":{"type":"string"},"signerDocumentMasked":{"type":"string"},"authFactors":{"type":"array","items":{"type":"string"}},"identityAssurance":{"type":"string"},"verifiedIdentityAttributes":{"type":"array","items":{"type":"string"}},"consentTermId":{"type":"string"},"consentTermHash":{"type":"string"}}},"PublicReadingConfirmationRequest":{"type":"object","properties":{"placementIds":{"type":"array","items":{"type":"string"}},"fieldValues":{"type":"object","additionalProperties":{"type":"string"}}}},"PublicReadingConfirmation":{"type":"object","properties":{"status":{"type":"string"},"confirmedAt":{"type":"string"},"documentSha256":{"type":"string"},"signaturePlacementIntentSha256":{"type":"string"},"signingFieldIntentSha256":{"type":"string"}}},"PublicQualifiedPrepareRequest":{"required":["certificateBase64","termText"],"type":"object","properties":{"certificateBase64":{"maxLength":32768,"minLength":0,"type":"string"},"certificateChainBase64":{"maxItems":8,"minItems":0,"type":"array","items":{"type":"string"}},"consentAccepted":{"type":"boolean"},"termText":{"maxLength":8000,"minLength":0,"type":"string"},"fieldValues":{"type":"object","additionalProperties":{"type":"string"}}}},"PublicQualifiedPrepareResponse":{"type":"object","properties":{"operationId":{"type":"string"},"toSignBytesBase64":{"type":"string"},"digestAlgorithm":{"type":"string"},"signatureAlgorithm":{"type":"string"},"certificateFingerprint":{"type":"string"},"expiresAt":{"type":"string"},"documentName":{"type":"string"},"localAgentGrant":{"type":"string"}}},"PublicQualifiedCompleteRequest":{"required":["certificateBase64","operationId","signatureBase64","termText"],"type":"object","properties":{"operationId":{"maxLength":128,"minLength":0,"type":"string"},"signatureBase64":{"maxLength":32768,"minLength":0,"type":"string"},"certificateBase64":{"maxLength":32768,"minLength":0,"type":"string"},"certificateChainBase64":{"maxItems":8,"minItems":0,"type":"array","items":{"type":"string"}},"termText":{"maxLength":8000,"minLength":0,"type":"string"},"fieldValues":{"type":"object","additionalProperties":{"type":"string"}}}},"PublicSignCompletionResponse":{"type":"object","properties":{"status":{"type":"string"},"requestId":{"type":"string"},"signatureId":{"type":"string"}}},"PublicQualifiedCloudAuthorizeRequest":{"required":["provider","termText"],"type":"object","properties":{"provider":{"maxLength":32,"minLength":0,"type":"string"},"consentAccepted":{"type":"boolean"},"termText":{"maxLength":8000,"minLength":0,"type":"string"},"loginHint":{"maxLength":32,"minLength":0,"type":"string"},"fieldValues":{"type":"object","additionalProperties":{"type":"string"}}}},"AuthorizationStart":{"type":"object","properties":{"authorizationUrl":{"type":"string"},"expiresAt":{"type":"string"}}},"PublicOtpChallengeResponse":{"type":"object","properties":{"transactionId":{"type":"string"},"channel":{"type":"string"},"codeLength":{"type":"integer","format":"int32"},"resendAfterSeconds":{"type":"integer","format":"int64"},"testCode":{"type":"string"}}},"BiometricProof":{"required":["verificationId"],"type":"object","properties":{"verificationId":{"type":"string"}}},"DelegateRequest":{"required":["destination","documentId","name","termText"],"type":"object","properties":{"name":{"maxLength":200,"minLength":0,"type":"string"},"documentId":{"maxLength":64,"minLength":0,"type":"string"},"destination":{"maxLength":320,"minLength":0,"type":"string"},"dateOfBirth":{"maxLength":10,"minLength":0,"type":"string"},"identityVerificationConsent":{"type":"boolean"},"biometricReferenceSha256":{"pattern":"(?i)[0-9a-f]{64}","type":"string"},"termText":{"maxLength":12000,"minLength":0,"type":"string"},"otpProof":{"$ref":"#/components/schemas/OtpProof"},"biometricProof":{"$ref":"#/components/schemas/BiometricProof"}}},"OtpProof":{"required":["code","transactionId"],"type":"object","properties":{"transactionId":{"type":"string"},"code":{"type":"string"}}},"PublicDelegationResponse":{"type":"object","properties":{"status":{"type":"string"},"requestId":{"type":"string"},"signatoryId":{"type":"string"},"sentAt":{"type":"string"}}},"PublicDeclineRequest":{"required":["reason","termText"],"type":"object","properties":{"reason":{"type":"string"},"termText":{"type":"string"}}},"PublicDeclineResponse":{"type":"object","properties":{"requestId":{"type":"string"},"status":{"type":"string"},"signatoryId":{"type":"string"},"participantStatus":{"type":"string"},"declineReason":{"type":"string"}}},"GeolocationEvidence":{"type":"object","properties":{"consentGranted":{"type":"boolean"},"latitude":{"type":"number","format":"double"},"longitude":{"type":"number","format":"double"},"accuracyMeters":{"type":"number","format":"double"},"capturedAt":{"type":"string","format":"date-time"}}},"PublicCompleteRequest":{"type":"object","properties":{"transactionId":{"type":"string"},"code":{"type":"string"},"consentAccepted":{"type":"boolean"},"signingContext":{"$ref":"#/components/schemas/SigningContext"},"termText":{"type":"string"},"biometricVerificationId":{"type":"string"},"fieldValues":{"type":"object","additionalProperties":{"type":"string"}}}},"SigningContext":{"type":"object","properties":{"geolocation":{"$ref":"#/components/schemas/GeolocationEvidence"}}},"PublicBiometricResponse":{"type":"object","properties":{"verificationId":{"type":"string"},"decision":{"type":"string"},"expiresAt":{"type":"string"},"message":{"type":"string"},"technicalFailure":{"type":"boolean"},"reasonCode":{"type":"string","description":"Categoria pública segura para orientar a recaptura; não contém dados pessoais nem detalhes internos do provedor.","enum":["APPROVED","ANALYSIS_UNAVAILABLE","DOCUMENT_ANALYSIS_UNAVAILABLE","DOCUMENT_FACE_NOT_DETECTED","LIVE_FACE_NOT_DETECTED","VIDEO_FACE_NOT_DETECTED","VIDEO_MULTIPLE_FACES_DETECTED","VIDEO_CONTINUITY_INTERRUPTED","CAPTURE_IMAGE_INVALID","CAPTURE_VIDEO_INVALID","CAPTURE_LIMIT_EXCEEDED","CAPTURE_SESSION_INVALID","MOVEMENT_NOT_CONFIRMED","DOCUMENT_DATA_NOT_CONFIRMED","DOCUMENT_QUALITY_INSUFFICIENT","CAPTURE_INCONCLUSIVE","VERIFICATION_NOT_APPROVED"]}}},"ActionView":{"type":"object","properties":{"order":{"type":"integer","format":"int32"},"code":{"type":"string"},"instruction":{"type":"string"}}},"ChallengeView":{"type":"object","properties":{"challengeId":{"type":"string"},"actions":{"type":"array","items":{"$ref":"#/components/schemas/ActionView"}},"expiresAt":{"type":"string","format":"date-time"},"expiresInSeconds":{"type":"integer","format":"int64"}}},"PublicParticipantActionRequest":{"required":["action","termText"],"type":"object","properties":{"action":{"type":"string"},"consentAccepted":{"type":"boolean"},"termText":{"type":"string"},"fieldValues":{"type":"object","additionalProperties":{"type":"string"}}}},"ParticipantActionResponse":{"type":"object","properties":{"requestId":{"type":"string"},"signatoryId":{"type":"string"},"action":{"type":"string"},"participantStatus":{"type":"string"},"requestStatus":{"type":"string"},"completedAt":{"type":"string"}}},"ValidateRequest":{"required":["documentBase64"],"type":"object","properties":{"documentBase64":{"type":"string","description":"Documento assinado em Base64 (PAdES, CAdES, XAdES ou ASiC)"},"validationLevel":{"type":"string","description":"Nível de validação desejado (B, T, LT, LTA)"},"jurisdiction":{"type":"string","description":"Jurisdição para validação (ICP_BRASIL, EIDAS)"},"validationPolicy":{"type":"string","description":"Política de validação personalizada (opcional)"}}},"SignatureValidationDetail":{"type":"object","properties":{"signatureId":{"type":"string","description":"ID único da assinatura"},"format":{"type":"string","description":"Formato da assinatura (PAdES, CAdES, XAdES, ASiC)"},"level":{"type":"string","description":"Nível de assinatura (B, T, LT, LTA)"},"valid":{"type":"boolean","description":"Se a assinatura é válida"},"signerName":{"type":"string","description":"Nome do signatário"},"issuer":{"type":"string","description":"Emissor do certificado"},"signingTime":{"type":"string","description":"Timestamp da assinatura","format":"date-time"},"subFilter":{"type":"string","description":"SubFilter/algoritmo de assinatura"},"certificateChainPem":{"type":"array","description":"Cadeia de certificados em PEM","items":{"type":"string","description":"Cadeia de certificados em PEM"}},"icpBrasil":{"type":"boolean","description":"Se a cadeia encadeia numa autoridade ICP-Brasil credenciada (critério do VALIDAR do ITI)"},"icpBrasilAnchor":{"type":"string","description":"DN da autoridade ICP-Brasil que ancorou a cadeia"},"platformSeal":{"type":"boolean","description":"Se o documento foi selado pelo selo organizacional desta plataforma (SES/AES marca própria)"}},"description":"Detalhes de cada assinatura encontrada no documento"},"ValidateResponse":{"type":"object","properties":{"valid":{"type":"boolean","description":"Se a validação passou (true) ou falhou (false)"},"signatures":{"type":"array","description":"Detalhes de cada assinatura encontrada no documento","items":{"$ref":"#/components/schemas/SignatureValidationDetail"}},"documentHashSha256":{"type":"string","description":"Hash SHA-256 do documento original (hex)"},"validationPolicy":{"type":"string","description":"Política de validação utilizada"},"timestamp":{"type":"string","description":"Timestamp da validação (ISO-8601)","format":"date-time"},"error":{"type":"string","description":"Motivo da falha quando a validação não pôde ser concluída"}}},"TimestampRequest":{"type":"object","properties":{"hash":{"type":"string","description":"Hash do documento em Base64 (SHA-256, 32 bytes)"},"documentBase64":{"type":"string","description":"Documento completo em Base64 (hash será calculado SHA-256)"},"hashAlgorithm":{"type":"string","description":"Algoritmo de hash (padrão: SHA-256)"}}},"TimestampResponse":{"type":"object","properties":{"timeStampTokenBase64":{"type":"string","description":"TimeStampToken RFC 3161 em Base64 (DER/ASN.1)"},"timestamp":{"type":"string","description":"Timestamp da geração do carimbo (ISO-8601)","format":"date-time"}}},"ConditionalBlock":{"type":"object","properties":{"id":{"type":"string"},"placement":{"type":"string","enum":["BEFORE_BODY","AFTER_BODY"]},"order":{"type":"integer","format":"int32"},"condition":{"$ref":"#/components/schemas/TemplateCondition"},"content":{"type":"string"}}},"CreateTemplateRequest":{"required":["bodyTemplate","defaultLevel","name","titleTemplate"],"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"titleTemplate":{"type":"string"},"bodyTemplate":{"type":"string"},"defaultLevel":{"type":"string"},"defaultChannel":{"type":"string"},"variables":{"type":"array","items":{"$ref":"#/components/schemas/VariableDefinition"}},"conditionalBlocks":{"type":"array","items":{"$ref":"#/components/schemas/ConditionalBlock"}}}},"TemplateCondition":{"type":"object","properties":{"variable":{"type":"string"},"operator":{"type":"string","enum":["EQUALS","NOT_EQUALS","PRESENT","ABSENT","IN"]},"value":{"$ref":"#/components/schemas/JsonNode"}}},"VariableDefinition":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string","enum":["STRING","NUMBER","BOOLEAN","DATE"]},"required":{"type":"boolean"},"defaultValue":{"$ref":"#/components/schemas/JsonNode"},"description":{"type":"string"}}},"TemplateResponse":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"titleTemplate":{"type":"string"},"bodyTemplate":{"type":"string"},"defaultLevel":{"type":"string"},"defaultChannel":{"type":"string"},"version":{"type":"integer","format":"int64"},"variables":{"type":"array","items":{"$ref":"#/components/schemas/VariableDefinition"}},"conditionalBlocks":{"type":"array","items":{"$ref":"#/components/schemas/ConditionalBlock"}},"importReviewStatus":{"type":"string","enum":["NOT_REQUIRED","PENDING","CONFIRMED"]},"importFidelity":{"type":"string","enum":["SUPPORTED_SUBSET","LOSSY_REVIEW_REQUIRED"]},"importWarnings":{"type":"array","items":{"type":"string"}},"importSourceFileName":{"type":"string"},"importReviewedAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"ConsentDto":{"required":["termHash","termId","termText"],"type":"object","properties":{"termId":{"maxLength":128,"minLength":0,"type":"string"},"termHash":{"pattern":"(?i)[0-9a-f]{64}","type":"string"},"termText":{"maxLength":12000,"minLength":0,"type":"string"}}},"CreateFromTemplateRequest":{"required":["jurisdiction","signatories"],"type":"object","properties":{"variables":{"type":"object","additionalProperties":{"type":"object"}},"level":{"type":"string"},"jurisdiction":{"type":"string"},"signatories":{"type":"array","items":{"$ref":"#/components/schemas/SignatoryDto"}},"ttl":{"type":"string","format":"duration","example":"P7D"},"webhookUrl":{"type":"string"},"webhookSecret":{"type":"string"}}},"SignatoryDto":{"required":["name"],"type":"object","properties":{"name":{"maxLength":200,"minLength":0,"type":"string"},"documentId":{"maxLength":64,"minLength":0,"type":"string"},"destination":{"maxLength":320,"minLength":0,"type":"string"},"authFactors":{"maxItems":8,"minItems":0,"type":"array","items":{"type":"string"}},"consent":{"$ref":"#/components/schemas/ConsentDto"},"userIp":{"maxLength":64,"minLength":0,"type":"string"},"userAgent":{"maxLength":1000,"minLength":0,"type":"string"},"dateOfBirth":{"maxLength":10,"minLength":0,"type":"string"},"identityVerificationConsent":{"type":"boolean"},"biometricReferenceSha256":{"pattern":"(?i)[0-9a-f]{64}","type":"string"},"role":{"maxLength":32,"minLength":0,"type":"string"},"routingOrder":{"type":"integer","format":"int32"},"allowDelegation":{"type":"boolean"},"privateMessage":{"maxLength":1000,"minLength":0,"type":"string"}}},"CreateResponse":{"type":"object","properties":{"requestId":{"type":"string"},"signatories":{"type":"array","items":{"$ref":"#/components/schemas/SignatoryStatus"}},"status":{"type":"string"},"expiresAt":{"type":"string"},"signingLinks":{"type":"array","items":{"$ref":"#/components/schemas/SigningLink"}}}},"SignatoryStatus":{"type":"object","properties":{"signatoryId":{"type":"string"},"name":{"type":"string"},"status":{"type":"string"},"destination":{"type":"string"},"signedAt":{"type":"string"},"identityAssurance":{"type":"string"},"signatureId":{"type":"string"},"role":{"type":"string"},"routingOrder":{"type":"integer","format":"int32"},"allowDelegation":{"type":"boolean"},"completedAt":{"type":"string"},"declineReason":{"type":"string"},"reminderCount":{"type":"integer","format":"int32"}}},"SigningLink":{"type":"object","properties":{"signatoryId":{"type":"string"},"url":{"type":"string"}}},"RenderRequest":{"type":"object","properties":{"variables":{"type":"object","additionalProperties":{"type":"object"}}}},"ConfirmImportReviewRequest":{"type":"object","properties":{"expectedVersion":{"type":"integer","format":"int64"}}},"ExportRequest":{"type":"object","properties":{"variables":{"type":"object","additionalProperties":{"type":"object"}}}},"CloneTemplateRequest":{"type":"object","properties":{"name":{"type":"string"},"expectedVersion":{"type":"integer","format":"int64"}}},"PreviewTemplateRequest":{"required":["definition"],"type":"object","properties":{"definition":{"$ref":"#/components/schemas/CreateTemplateRequest"},"variables":{"type":"object","additionalProperties":{"type":"object"}}}},"InspectedTemplateResponse":{"type":"object","properties":{"definition":{"$ref":"#/components/schemas/CreateTemplateRequest"},"sourceFileName":{"type":"string"},"sourceFormat":{"type":"string"},"warnings":{"type":"array","items":{"type":"string"}},"reviewRequired":{"type":"boolean"},"fidelity":{"type":"string","enum":["SUPPORTED_SUBSET","LOSSY_REVIEW_REQUIRED"]}}},"ImportedTemplateResponse":{"type":"object","properties":{"template":{"$ref":"#/components/schemas/TemplateResponse"},"warnings":{"type":"array","items":{"type":"string"}},"sourceFileName":{"type":"string"},"sourceFormat":{"type":"string"},"reviewRequired":{"type":"boolean"},"fidelity":{"type":"string"}}},"CreateRequest":{"required":["documentBase64","jurisdiction","level","signatories","title"],"type":"object","properties":{"title":{"maxLength":255,"minLength":0,"type":"string"},"documentBase64":{"maxLength":8388608,"minLength":0,"type":"string"},"level":{"maxLength":16,"minLength":0,"type":"string"},"jurisdiction":{"maxLength":32,"minLength":0,"type":"string"},"signatories":{"maxItems":100,"minItems":0,"type":"array","items":{"$ref":"#/components/schemas/SignatoryDto"}},"ttl":{"type":"string","format":"duration","example":"P7D"},"webhookUrl":{"maxLength":2048,"minLength":0,"type":"string"},"webhookSecret":{"maxLength":512,"minLength":0,"type":"string"},"routingMode":{"maxLength":32,"minLength":0,"type":"string"},"fields":{"maxItems":200,"minItems":0,"type":"array","items":{"$ref":"#/components/schemas/DocumentFieldDto"}},"reminders":{"$ref":"#/components/schemas/ReminderPolicyDto"},"tags":{"maxItems":20,"minItems":0,"type":"array","items":{"type":"string"}},"metadata":{"type":"object","additionalProperties":{"type":"string"}},"allowDecline":{"type":"boolean"},"locale":{"maxLength":35,"minLength":0,"type":"string"}}},"VerificationView":{"type":"object","properties":{"verificationId":{"type":"string"},"provider":{"type":"string"},"model":{"type":"string"},"identityDocumentValid":{"type":"boolean"},"identityDocumentQualityScore":{"type":"number","format":"double"},"identityDocumentBackValid":{"type":"boolean"},"identityDocumentBackQualityScore":{"type":"number","format":"double"},"liveVideoEvidenceValid":{"type":"boolean"},"liveVideoEvidenceScore":{"type":"number","format":"double"},"activeLivenessValidated":{"type":"boolean"},"activeLivenessScore":{"type":"number","format":"double"},"activeLivenessChallengeId":{"type":"string"},"activeLivenessChallengeDigest":{"type":"string"},"activeLivenessVersion":{"type":"string"},"documentSubjectMatched":{"type":"boolean"},"frontBackConsistent":{"type":"boolean"},"documentDataConsistencyDecision":{"type":"string"},"documentAuthenticityDecision":{"type":"string"},"documentExtractionMethods":{"type":"array","items":{"type":"string"}},"documentExtractionVersion":{"type":"string"},"documentFrontType":{"type":"string"},"documentFrontSide":{"type":"string"},"documentBackType":{"type":"string"},"documentBackSide":{"type":"string"},"providerContract":{"type":"string"},"livenessScore":{"type":"number","format":"double"},"faceMatchScore":{"type":"number","format":"double"},"automatedDecision":{"type":"string","enum":["REVIEW","APPROVED","REJECTED"]},"decision":{"type":"string","enum":["REVIEW","APPROVED","REJECTED"]},"failureCode":{"type":"string","enum":["REQUEST_LIMIT_EXCEEDED","PROVIDER_TIMEOUT","PROVIDER_UNAVAILABLE","PROVIDER_INTERRUPTED","PROVIDER_HTTP_ERROR","DOCUMENT_OCR_TIMEOUT","DOCUMENT_OCR_UNAVAILABLE","DOCUMENT_FACE_NOT_DETECTED","LIVE_FACE_NOT_DETECTED","VIDEO_FACE_NOT_DETECTED","CAPTURE_IMAGE_INVALID","CAPTURE_VIDEO_INVALID","RESPONSE_LIMIT_EXCEEDED","INVALID_PROVIDER_RESPONSE","PROVIDER_TIMESTAMP_INVALID","IMAGE_HASH_MISMATCH","ACTIVE_LIVENESS_CHALLENGE_MISMATCH","ACTIVE_LIVENESS_FAILED","DOCUMENT_IDENTITY_MISMATCH","ACTIVE_FACE_NOT_DETECTED","ACTIVE_MULTIPLE_FACES_DETECTED","ACTIVE_TIMELINE_INVALID","ACTIVE_MOVEMENT_NOT_CONFIRMED","ACTIVE_VIDEO_INVALID","ACTIVE_SCORE_INSUFFICIENT"]},"consentId":{"type":"string"},"consentPurpose":{"type":"string"},"consentVersion":{"type":"string"},"referenceFingerprint":{"type":"string"},"documentBackFingerprint":{"type":"string"},"liveFingerprint":{"type":"string"},"liveVideoFingerprint":{"type":"string"},"processedAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"expiresAt":{"type":"string","format":"date-time"},"consumedAt":{"type":"string","format":"date-time"},"reviewedAt":{"type":"string","format":"date-time"},"reviewBasis":{"type":"string"},"reviewReason":{"type":"string"}}},"SignActionRequest":{"required":["signatoryId"],"type":"object","properties":{"signatoryId":{"maxLength":80,"minLength":0,"type":"string"},"otpProof":{"$ref":"#/components/schemas/OtpProof"},"biometricProof":{"$ref":"#/components/schemas/BiometricProof"},"signingContext":{"$ref":"#/components/schemas/SigningContext"},"fieldValues":{"type":"object","additionalProperties":{"type":"string"}}}},"SignResultResponse":{"type":"object","properties":{"requestId":{"type":"string"},"signatoryId":{"type":"string"},"signatureId":{"type":"string"},"signedDocumentBase64":{"type":"string"},"timestamp":{"type":"string"},"status":{"type":"string"},"certificateChain":{"type":"string"}}},"QualifiedPrepareRequest":{"required":["certificateBase64","signatoryId"],"type":"object","properties":{"signatoryId":{"maxLength":128,"minLength":0,"type":"string"},"certificateBase64":{"maxLength":32768,"minLength":0,"type":"string"},"certificateChainBase64":{"maxItems":8,"minItems":0,"type":"array","items":{"type":"string"}},"fieldValues":{"type":"object","additionalProperties":{"type":"string"}}}},"QualifiedPrepareResponse":{"type":"object","properties":{"operationId":{"type":"string"},"toSignBytesBase64":{"type":"string"},"digestAlgorithm":{"type":"string"},"signatureAlgorithm":{"type":"string"},"certificateFingerprint":{"type":"string"},"expiresAt":{"type":"string"}}},"QualifiedCompleteRequest":{"required":["certificateBase64","operationId","signatoryId","signatureBase64"],"type":"object","properties":{"signatoryId":{"maxLength":128,"minLength":0,"type":"string"},"operationId":{"maxLength":128,"minLength":0,"type":"string"},"signatureBase64":{"maxLength":32768,"minLength":0,"type":"string"},"certificateBase64":{"maxLength":32768,"minLength":0,"type":"string"},"certificateChainBase64":{"maxItems":8,"minItems":0,"type":"array","items":{"type":"string"}},"fieldValues":{"type":"object","additionalProperties":{"type":"string"}}}},"QualifiedCloudSignRequest":{"required":["accessToken","consentAccepted","signatoryId","termText"],"type":"object","properties":{"signatoryId":{"maxLength":128,"minLength":0,"type":"string"},"accessToken":{"maxLength":16384,"minLength":0,"type":"string"},"provider":{"maxLength":32,"minLength":0,"type":"string"},"consentAccepted":{"type":"boolean"},"termText":{"maxLength":8000,"minLength":0,"type":"string"},"fieldValues":{"type":"object","additionalProperties":{"type":"string"}}}},"ResendResponse":{"type":"object","properties":{"requestId":{"type":"string"},"signatoryId":{"type":"string"},"url":{"type":"string"},"sentAt":{"type":"string"}}},"DeclineRequest":{"required":["reason"],"type":"object","properties":{"reason":{"maxLength":1000,"minLength":0,"type":"string"}}},"ParticipantActionRequest":{"required":["action","signatoryId"],"type":"object","properties":{"signatoryId":{"maxLength":80,"minLength":0,"type":"string"},"action":{"maxLength":32,"minLength":0,"type":"string"},"fieldValues":{"type":"object","additionalProperties":{"type":"string"}}}},"BulkCreateRequest":{"required":["requests"],"type":"object","properties":{"requests":{"maxItems":100,"minItems":0,"type":"array","items":{"$ref":"#/components/schemas/CreateRequest"}}}},"BulkCreateResponse":{"type":"object","properties":{"requests":{"type":"array","items":{"$ref":"#/components/schemas/CreateResponse"}},"createdCount":{"type":"integer","format":"int32"}}},"ElectronicSignRequest":{"required":["authFactors","documentBase64","jurisdiction","level","signerDocumentId","signerName"],"type":"object","properties":{"documentBase64":{"maxLength":8388608,"minLength":0,"type":"string"},"level":{"maxLength":16,"minLength":0,"type":"string"},"jurisdiction":{"maxLength":32,"minLength":0,"type":"string"},"authFactors":{"maxItems":8,"minItems":0,"type":"array","items":{"type":"string"}},"signerName":{"maxLength":200,"minLength":0,"type":"string"},"signerDocumentId":{"maxLength":64,"minLength":0,"type":"string"},"consent":{"$ref":"#/components/schemas/ConsentDto"},"otp":{"$ref":"#/components/schemas/OtpProof"},"userIp":{"maxLength":64,"minLength":0,"type":"string"},"userAgent":{"maxLength":1000,"minLength":0,"type":"string"},"dateOfBirth":{"maxLength":10,"minLength":0,"type":"string"},"identityVerificationConsent":{"type":"boolean"},"signingContext":{"$ref":"#/components/schemas/SigningContext"},"biometricVerificationId":{"maxLength":128,"minLength":0,"type":"string"}}},"ElectronicSignResponse":{"type":"object","properties":{"signatureId":{"type":"string"},"signedDocumentBase64":{"type":"string"},"timestamp":{"type":"string","format":"date-time"},"requestedLevel":{"type":"string"},"attainedLevel":{"type":"string"},"jurisdiction":{"type":"string"},"validationStatus":{"type":"string"},"certificateChain":{"type":"array","items":{"type":"string"}},"evidenceJsonBase64":{"type":"string"}}},"CreateReviewRequest":{"required":["originalText","proposedText","targetId","targetType","title"],"type":"object","properties":{"targetType":{"type":"string","enum":["CONTRACT","TEMPLATE"]},"targetId":{"maxLength":36,"minLength":0,"type":"string"},"baseTargetVersion":{"type":"integer","format":"int64"},"title":{"maxLength":255,"minLength":0,"type":"string"},"originalText":{"maxLength":200000,"minLength":0,"type":"string"},"proposedText":{"maxLength":200000,"minLength":0,"type":"string"}}},"ReviewResponse":{"type":"object","properties":{"id":{"type":"string"},"targetType":{"type":"string","enum":["CONTRACT","TEMPLATE"]},"targetId":{"type":"string"},"baseTargetVersion":{"type":"integer","format":"int64"},"title":{"type":"string"},"originalText":{"type":"string"},"proposedText":{"type":"string"},"diff":{"$ref":"#/components/schemas/JsonNode"},"state":{"type":"string","enum":["DRAFT","OPEN","APPROVED","REJECTED","CHANGES_REQUESTED"]},"createdBy":{"type":"string"},"decidedBy":{"type":"string"},"decisionComment":{"type":"string"},"submittedAt":{"type":"string","format":"date-time"},"decidedAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"version":{"type":"integer","format":"int64"},"comments":{"type":"array","items":{"$ref":"#/components/schemas/CommentResponse"}}}},"ReviewDecisionRequest":{"required":["decision"],"type":"object","properties":{"decision":{"type":"string","enum":["APPROVE","REJECT","REQUEST_CHANGES"]},"comment":{"maxLength":2000,"minLength":0,"type":"string"}}},"CreateCommentRequest":{"required":["body"],"type":"object","properties":{"body":{"maxLength":10000,"minLength":0,"type":"string"}}},"CreateTenantRequest":{"required":["adminKeyLabel","contactEmail","name","slug"],"type":"object","properties":{"slug":{"maxLength":80,"minLength":0,"type":"string"},"name":{"maxLength":160,"minLength":0,"type":"string"},"contactEmail":{"maxLength":254,"minLength":0,"type":"string"},"adminKeyLabel":{"maxLength":120,"minLength":0,"type":"string"}}},"ApiKeyResponse":{"type":"object","properties":{"id":{"type":"string"},"prefix":{"type":"string"},"label":{"type":"string"},"role":{"type":"string"},"enabled":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time"},"expiresAt":{"type":"string","format":"date-time"}}},"CreateTenantResponse":{"type":"object","properties":{"tenant":{"$ref":"#/components/schemas/TenantResponse"},"adminCredential":{"$ref":"#/components/schemas/ApiKeyResponse"},"apiKey":{"type":"string"}}},"CreateApiKeyRequest":{"required":["label"],"type":"object","properties":{"label":{"maxLength":120,"minLength":0,"type":"string"},"expiresAt":{"type":"string","format":"date-time"}}},"CreateApiKeyResponse":{"type":"object","properties":{"credential":{"$ref":"#/components/schemas/ApiKeyResponse"},"apiKey":{"type":"string"}}},"OtpVerifyRequest":{"required":["channel","code","documentSha256","signerDocumentId","transactionId"],"type":"object","properties":{"transactionId":{"type":"string"},"code":{"type":"string"},"channel":{"type":"string"},"signerDocumentId":{"type":"string"},"documentSha256":{"pattern":"(?i)^[0-9a-f]{64}$","type":"string"}}},"OtpVerifyResponse":{"type":"object","properties":{"verified":{"type":"boolean"},"verifiedAt":{"type":"string","format":"date-time"},"failureReason":{"type":"string"}}},"OtpSendRequest":{"required":["destination","documentSha256","signerDocumentId"],"type":"object","properties":{"destination":{"type":"string"},"channel":{"type":"string"},"signerDocumentId":{"type":"string"},"documentSha256":{"pattern":"(?i)^[0-9a-f]{64}$","type":"string"}}},"OtpSendResponse":{"type":"object","properties":{"transactionId":{"type":"string"},"channel":{"type":"string"},"testCode":{"type":"string"}}},"RegisterOrganizationRequest":{"required":["contactEmail","countryCode","name","ownerName","password","slug","taxIdentifier","termsVersion"],"type":"object","properties":{"slug":{"maxLength":80,"minLength":2,"pattern":"[a-z0-9](?:[a-z0-9-]{0,78}[a-z0-9])","type":"string"},"name":{"maxLength":160,"minLength":2,"type":"string"},"contactEmail":{"maxLength":254,"minLength":0,"type":"string"},"ownerName":{"maxLength":160,"minLength":2,"type":"string"},"password":{"maxLength":128,"minLength":12,"type":"string"},"countryCode":{"pattern":"[A-Za-z]{2}","type":"string"},"taxIdentifier":{"maxLength":40,"minLength":5,"type":"string"},"acceptedTerms":{"type":"boolean"},"termsVersion":{"maxLength":80,"minLength":2,"type":"string"},"emailVerificationProof":{"maxLength":512,"minLength":0,"type":"string"},"website":{"maxLength":0,"minLength":0,"type":"string"}}},"OnboardingSessionResponse":{"type":"object","properties":{"sessionId":{"type":"string"},"idleExpiresAt":{"type":"string","format":"date-time"},"expiresAt":{"type":"string","format":"date-time"},"mfaVerified":{"type":"boolean"}}},"RegistrationResponse":{"type":"object","properties":{"tenantId":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"contactEmail":{"type":"string"},"ownerUserId":{"type":"string"},"ownerMembershipId":{"type":"string"},"ownerRole":{"type":"string"},"countryCode":{"type":"string"},"taxIdentifier":{"type":"string"},"planId":{"type":"string"},"subscriptionStatus":{"type":"string"},"trialEndsAt":{"type":"string","format":"date-time"},"termsVersion":{"type":"string"},"session":{"$ref":"#/components/schemas/OnboardingSessionResponse"}}},"EmailVerificationRequest":{"required":["email"],"type":"object","properties":{"email":{"maxLength":254,"minLength":0,"type":"string"}}},"EmailVerificationRequestResponse":{"type":"object","properties":{"accepted":{"type":"boolean"},"message":{"type":"string"}}},"EmailVerificationCompleteRequest":{"required":["token"],"type":"object","properties":{"token":{"maxLength":64,"minLength":0,"pattern":"vso_[A-Za-z0-9_-]{43}","type":"string"}}},"EmailVerificationCompleteResponse":{"type":"object","properties":{"email":{"type":"string"},"emailVerificationProof":{"type":"string"},"expiresAt":{"type":"string","format":"date-time"}}},"CreateInvitationRequest":{"required":["email","role"],"type":"object","properties":{"email":{"maxLength":254,"minLength":0,"type":"string"},"role":{"type":"string","enum":["OWNER","ADMIN","MANAGER","MEMBER","VIEWER"]},"permissions":{"uniqueItems":true,"type":"array","items":{"type":"string","enum":["TENANT_READ","TENANT_MANAGE","MEMBERS_READ","MEMBERS_MANAGE","SECURITY_MANAGE","API_KEYS_MANAGE","DOCUMENTS_READ","DOCUMENTS_WRITE","CONTRACTS_READ","CONTRACTS_WRITE","APPROVALS_READ","APPROVALS_WRITE","BILLING_READ","BILLING_MANAGE"]}}}},"InvitationIssued":{"type":"object","properties":{"invitation":{"$ref":"#/components/schemas/InvitationView"},"token":{"type":"string"},"deliveryQueued":{"type":"boolean"}}},"InvitationView":{"type":"object","properties":{"id":{"type":"string"},"email":{"type":"string"},"role":{"type":"string","enum":["OWNER","ADMIN","MANAGER","MEMBER","VIEWER"]},"permissions":{"uniqueItems":true,"type":"array","items":{"type":"string","enum":["TENANT_READ","TENANT_MANAGE","MEMBERS_READ","MEMBERS_MANAGE","SECURITY_MANAGE","API_KEYS_MANAGE","DOCUMENTS_READ","DOCUMENTS_WRITE","CONTRACTS_READ","CONTRACTS_WRITE","APPROVALS_READ","APPROVALS_WRITE","BILLING_READ","BILLING_MANAGE"]}},"state":{"type":"string"},"expiresAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"}}},"CreateEnvelopeRequest":{"required":["documents","jurisdiction","level","signatories","title"],"type":"object","properties":{"title":{"maxLength":255,"minLength":0,"type":"string"},"documents":{"maxItems":20,"minItems":2,"type":"array","items":{"$ref":"#/components/schemas/EnvelopeDocumentRequest"}},"level":{"maxLength":16,"minLength":0,"type":"string"},"jurisdiction":{"maxLength":32,"minLength":0,"type":"string"},"signatories":{"maxItems":100,"minItems":0,"type":"array","items":{"$ref":"#/components/schemas/SignatoryDto"}},"ttl":{"type":"string","format":"duration","example":"P7D"},"webhookUrl":{"maxLength":2048,"minLength":0,"type":"string"},"webhookSecret":{"maxLength":512,"minLength":0,"type":"string"},"routingMode":{"maxLength":32,"minLength":0,"type":"string"},"reminders":{"$ref":"#/components/schemas/ReminderPolicyDto"},"tags":{"maxItems":20,"minItems":0,"type":"array","items":{"type":"string"}},"metadata":{"type":"object","additionalProperties":{"type":"string"}},"allowDecline":{"type":"boolean"},"locale":{"maxLength":35,"minLength":0,"type":"string"}}},"EnvelopeDocumentRequest":{"required":["documentId"],"type":"object","properties":{"documentId":{"maxLength":36,"minLength":0,"type":"string"},"title":{"maxLength":255,"minLength":0,"type":"string"},"fields":{"maxItems":200,"minItems":0,"type":"array","items":{"$ref":"#/components/schemas/DocumentFieldDto"}}}},"EnvelopeItemResponse":{"type":"object","properties":{"itemId":{"type":"string"},"documentId":{"type":"string"},"displayName":{"type":"string"},"position":{"type":"integer","format":"int32"},"signRequestId":{"type":"string"},"status":{"type":"string"},"signingLinks":{"type":"array","items":{"$ref":"#/components/schemas/SigningLink"}}}},"EnvelopeResponse":{"type":"object","properties":{"envelopeId":{"type":"string"},"title":{"type":"string"},"status":{"type":"string"},"documentCount":{"type":"integer","format":"int32"},"documents":{"type":"array","items":{"$ref":"#/components/schemas/EnvelopeItemResponse"}},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"version":{"type":"integer","format":"int64"}}},"DocumentResponse":{"type":"object","properties":{"documentId":{"type":"string"},"fileName":{"type":"string"},"fileSizeBytes":{"type":"integer","format":"int64"},"contentType":{"type":"string"},"status":{"type":"string"},"uploadedAt":{"type":"string"}}},"TransitionRequest":{"required":["targetStatus"],"type":"object","properties":{"targetStatus":{"type":"string","enum":["DRAFT","IN_REVIEW","SENT_FOR_SIGNATURE","ACTIVE","EXPIRED","TERMINATED"]},"reason":{"maxLength":500,"minLength":0,"type":"string"}}},"RegularizationCreateRequest":{"type":"object","properties":{"requestedPlanId":{"maxLength":64,"minLength":0,"type":"string"}}},"RegularizationResponse":{"type":"object","properties":{"id":{"type":"string"},"currentPlanId":{"type":"string"},"requestedPlanId":{"type":"string"},"subscriptionStatus":{"type":"string","enum":["TRIALING","ACTIVE","PAST_DUE","PAUSED","INCOMPLETE","CANCELED","EXPIRED"]},"reasonCode":{"type":"string"},"status":{"type":"string","enum":["OPEN","ACKNOWLEDGED","RESOLVED","CANCELED"]},"acknowledgedAt":{"type":"string","format":"date-time"},"resolvedAt":{"type":"string","format":"date-time"},"canceledAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"PortalRequest":{"required":["returnUrl"],"type":"object","properties":{"provider":{"maxLength":64,"minLength":0,"type":"string"},"returnUrl":{"maxLength":2048,"minLength":0,"type":"string"}}},"BillingSessionResponse":{"type":"object","properties":{"provider":{"type":"string"},"sessionId":{"type":"string"},"url":{"type":"string"},"expiresAt":{"type":"string","format":"date-time"}}},"CheckoutRequest":{"required":["cancelUrl","planId","successUrl"],"type":"object","properties":{"planId":{"maxLength":64,"minLength":0,"type":"string"},"provider":{"maxLength":64,"minLength":0,"type":"string"},"successUrl":{"maxLength":2048,"minLength":0,"type":"string"},"cancelUrl":{"maxLength":2048,"minLength":0,"type":"string"}}},"RegularizationTransitionRequest":{"required":["note","targetStatus"],"type":"object","properties":{"targetStatus":{"type":"string","enum":["OPEN","ACKNOWLEDGED","RESOLVED","CANCELED"]},"responsibleCredentialId":{"maxLength":128,"minLength":0,"pattern":"[A-Za-z0-9][A-Za-z0-9._:@/-]{0,127}","type":"string"},"note":{"maxLength":1000,"minLength":0,"type":"string"}}},"AdminRegularizationResponse":{"type":"object","properties":{"id":{"type":"string"},"tenantId":{"type":"string"},"currentPlanId":{"type":"string"},"requestedPlanId":{"type":"string"},"subscriptionStatus":{"type":"string","enum":["TRIALING","ACTIVE","PAST_DUE","PAUSED","INCOMPLETE","CANCELED","EXPIRED"]},"reasonCode":{"type":"string"},"status":{"type":"string","enum":["OPEN","ACKNOWLEDGED","RESOLVED","CANCELED"]},"requestedByCredentialId":{"type":"string"},"responsibleCredentialId":{"type":"string"},"lastTransitionByCredentialId":{"type":"string"},"operatorNote":{"type":"string"},"acknowledgedAt":{"type":"string","format":"date-time"},"resolvedAt":{"type":"string","format":"date-time"},"canceledAt":{"type":"string","format":"date-time"},"notificationState":{"type":"string","enum":["NOT_CONFIGURED","QUEUED","FAILED"]},"notificationDeliveryId":{"type":"string"},"notificationDetail":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"version":{"type":"integer","format":"int64"}}},"CreateClauseRequest":{"required":["bodyText","slug","title"],"type":"object","properties":{"slug":{"maxLength":120,"minLength":0,"type":"string"},"title":{"maxLength":255,"minLength":0,"type":"string"},"description":{"maxLength":1000,"minLength":0,"type":"string"},"bodyText":{"maxLength":200000,"minLength":0,"type":"string"},"tags":{"maxItems":50,"minItems":0,"type":"array","items":{"type":"string"}},"changeSummary":{"maxLength":500,"minLength":0,"type":"string"}}},"CreateClauseReferenceRequest":{"required":["targetId","targetType"],"type":"object","properties":{"targetType":{"type":"string","enum":["CONTRACT","TEMPLATE"]},"targetId":{"maxLength":36,"minLength":0,"type":"string"},"clauseVersionNumber":{"type":"integer","format":"int32"},"insertionKey":{"maxLength":160,"minLength":0,"type":"string"}}},"ClauseReferenceResponse":{"type":"object","properties":{"id":{"type":"string"},"clauseId":{"type":"string"},"clauseVersionId":{"type":"string"},"targetType":{"type":"string","enum":["CONTRACT","TEMPLATE"]},"targetId":{"type":"string"},"targetVersion":{"type":"integer","format":"int64"},"insertionKey":{"type":"string"},"insertedText":{"type":"string"},"createdBy":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"version":{"type":"integer","format":"int64"}}},"DirectStatusRequest":{"required":["documentSha256","subjectDocumentId"],"type":"object","properties":{"subjectDocumentId":{"type":"string"},"documentSha256":{"type":"string"}}},"ReviewRequest":{"required":["decision","reason","reviewBasis"],"type":"object","properties":{"decision":{"type":"string"},"reviewBasis":{"type":"string"},"reason":{"maxLength":1000,"minLength":10,"type":"string"}}},"DirectChallengeRequest":{"required":["consentAccepted","consentTermSha256","documentSha256","subjectDocumentId"],"type":"object","properties":{"subjectDocumentId":{"type":"string"},"documentSha256":{"type":"string"},"consentAccepted":{"type":"boolean"},"consentTermSha256":{"type":"string"}}},"DefinitionRequest":{"required":["name","templateId","triggerType"],"type":"object","properties":{"name":{"maxLength":160,"minLength":0,"type":"string"},"description":{"maxLength":500,"minLength":0,"type":"string"},"templateId":{"maxLength":36,"minLength":0,"type":"string"},"triggerType":{"type":"string","enum":["MANUAL","API","SCHEDULE"]},"scheduleCron":{"maxLength":120,"minLength":0,"type":"string"},"scheduleZone":{"maxLength":80,"minLength":0,"type":"string"},"defaultVariables":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/JsonNode"}},"defaultRecipients":{"maxItems":100,"minItems":0,"type":"array","items":{"$ref":"#/components/schemas/AutomationRecipient"}},"level":{"maxLength":16,"minLength":0,"type":"string"},"jurisdiction":{"maxLength":32,"minLength":0,"type":"string"},"ttl":{"type":"string","format":"duration","example":"P7D"},"routingMode":{"maxLength":32,"minLength":0,"type":"string"},"fields":{"maxItems":200,"minItems":0,"type":"array","items":{"$ref":"#/components/schemas/DocumentFieldDto"}},"reminders":{"$ref":"#/components/schemas/ReminderPolicyDto"},"tags":{"maxItems":20,"minItems":0,"type":"array","items":{"type":"string"}},"metadata":{"type":"object","additionalProperties":{"type":"string"}}}},"RunRequest":{"type":"object","properties":{"variables":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/JsonNode"}},"recipients":{"maxItems":100,"minItems":0,"type":"array","items":{"$ref":"#/components/schemas/AutomationRecipient"}}}},"RunResponse":{"type":"object","properties":{"id":{"type":"string"},"automationId":{"type":"string"},"automationVersion":{"type":"integer","format":"int64"},"triggerType":{"type":"string","enum":["MANUAL","API","SCHEDULE"]},"status":{"type":"string","enum":["RUNNING","WAITING_SIGNATURE","COMPLETED","DECLINED","CANCELLED","EXPIRED","FAILED"]},"signRequestId":{"type":"string"},"errorCode":{"type":"string"},"errorMessage":{"type":"string"},"startedAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time"},"version":{"type":"integer","format":"int64"}}},"RunStartResponse":{"type":"object","properties":{"run":{"$ref":"#/components/schemas/RunResponse"},"signingLinks":{"type":"array","items":{"$ref":"#/components/schemas/SigningLink"}}}},"OidcAuthorizeRequest":{"required":["providerId","tenant"],"type":"object","properties":{"tenant":{"maxLength":80,"minLength":0,"type":"string"},"providerId":{"maxLength":36,"minLength":0,"type":"string"}}},"SwitchTenantRequest":{"required":["tenantId"],"type":"object","properties":{"tenantId":{"maxLength":36,"minLength":0,"type":"string"}}},"SessionResponse":{"type":"object","properties":{"sessionId":{"type":"string"},"idleExpiresAt":{"type":"string","format":"date-time"},"expiresAt":{"type":"string","format":"date-time"},"mfaVerified":{"type":"boolean"},"persistent":{"type":"boolean"}}},"PasswordResetRequest":{"required":["email"],"type":"object","properties":{"tenant":{"maxLength":80,"minLength":0,"type":"string"},"email":{"maxLength":254,"minLength":0,"type":"string"}}},"RequestAccepted":{"type":"object","properties":{"accepted":{"type":"boolean"}}},"PasswordResetCompleteRequest":{"required":["newPassword","token"],"type":"object","properties":{"token":{"maxLength":128,"minLength":0,"type":"string"},"newPassword":{"maxLength":128,"minLength":12,"type":"string"},"code":{"maxLength":8,"minLength":0,"type":"string"},"recoveryCode":{"maxLength":32,"minLength":0,"type":"string"}}},"EnrollTotpRequest":{"required":["password"],"type":"object","properties":{"password":{"maxLength":128,"minLength":0,"type":"string"}}},"TotpEnrollment":{"type":"object","properties":{"secret":{"type":"string"},"provisioningUri":{"type":"string"},"qrCodeDataUrl":{"type":"string"},"expiresAt":{"type":"string","format":"date-time"}}},"ConfirmTotpRequest":{"required":["code"],"type":"object","properties":{"code":{"pattern":"[0-9]{6}","type":"string"}}},"TotpConfirmationResponse":{"type":"object","properties":{"recoveryCodes":{"type":"array","items":{"type":"string"}},"session":{"$ref":"#/components/schemas/SessionResponse"}}},"MfaChallengeRequest":{"required":["challengeToken"],"type":"object","properties":{"challengeToken":{"maxLength":128,"minLength":0,"type":"string"},"code":{"pattern":"[0-9]{6}","type":"string"},"recoveryCode":{"maxLength":32,"minLength":0,"type":"string"}}},"LoginRequest":{"required":["email","password"],"type":"object","properties":{"tenant":{"maxLength":80,"minLength":0,"type":"string"},"email":{"maxLength":254,"minLength":0,"type":"string"},"password":{"maxLength":128,"minLength":0,"type":"string"},"rememberMe":{"type":"boolean"}}},"LoginResponse":{"type":"object","properties":{"tenantSelectionRequired":{"type":"boolean"},"tenantSelectionToken":{"type":"string"},"tenantSelectionExpiresAt":{"type":"string","format":"date-time"},"tenants":{"type":"array","items":{"$ref":"#/components/schemas/TenantChoice"}},"mfaRequired":{"type":"boolean"},"challengeToken":{"type":"string"},"challengeExpiresAt":{"type":"string","format":"date-time"},"session":{"$ref":"#/components/schemas/SessionResponse"}}},"TenantChoice":{"type":"object","properties":{"id":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"}}},"TenantSelectionRequest":{"required":["challengeToken","tenantId"],"type":"object","properties":{"challengeToken":{"maxLength":128,"minLength":0,"type":"string"},"tenantId":{"maxLength":36,"minLength":0,"type":"string"}}},"AcceptInvitationRequest":{"required":["displayName","password","token"],"type":"object","properties":{"token":{"maxLength":128,"minLength":0,"type":"string"},"displayName":{"maxLength":160,"minLength":0,"type":"string"},"password":{"maxLength":128,"minLength":12,"type":"string"}}},"ApprovalStageRequest":{"required":["approverIds","completionRule","name"],"type":"object","properties":{"name":{"maxLength":160,"minLength":0,"type":"string"},"completionRule":{"type":"string","enum":["ALL","ANY"]},"approverIds":{"maxItems":50,"minItems":0,"type":"array","items":{"type":"string"}}}},"CreateApprovalWorkflowRequest":{"required":["name","stages","targetId","targetType"],"type":"object","properties":{"targetType":{"type":"string","enum":["CONTRACT","TEMPLATE"]},"targetId":{"maxLength":36,"minLength":0,"type":"string"},"targetVersion":{"type":"integer","format":"int64"},"name":{"maxLength":255,"minLength":0,"type":"string"},"stages":{"maxItems":20,"minItems":0,"type":"array","items":{"$ref":"#/components/schemas/ApprovalStageRequest"}}}},"ApprovalAssignmentResponse":{"type":"object","properties":{"id":{"type":"string"},"approverId":{"type":"string"},"state":{"type":"string","enum":["PENDING","APPROVED","REJECTED","CHANGES_REQUESTED","SKIPPED"]},"decisionComment":{"type":"string"},"decidedAt":{"type":"string","format":"date-time"},"version":{"type":"integer","format":"int64"}}},"ApprovalStageResponse":{"type":"object","properties":{"id":{"type":"string"},"stageOrder":{"type":"integer","format":"int32"},"name":{"type":"string"},"completionRule":{"type":"string","enum":["ALL","ANY"]},"approvers":{"type":"array","items":{"$ref":"#/components/schemas/ApprovalAssignmentResponse"}}}},"ApprovalWorkflowResponse":{"type":"object","properties":{"id":{"type":"string"},"targetType":{"type":"string","enum":["CONTRACT","TEMPLATE"]},"targetId":{"type":"string"},"targetVersion":{"type":"integer","format":"int64"},"name":{"type":"string"},"state":{"type":"string","enum":["DRAFT","IN_PROGRESS","APPROVED","REJECTED","CHANGES_REQUESTED","CANCELLED"]},"currentStageOrder":{"type":"integer","format":"int32"},"createdBy":{"type":"string"},"startedAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"version":{"type":"integer","format":"int64"},"stages":{"type":"array","items":{"$ref":"#/components/schemas/ApprovalStageResponse"}}}},"ApprovalDecisionRequest":{"required":["decision"],"type":"object","properties":{"decision":{"type":"string","enum":["APPROVE","REJECT","REQUEST_CHANGES"]},"comment":{"maxLength":2000,"minLength":0,"type":"string"}}},"DocumentTemplatePatchRequest":{"type":"object","properties":{"expectedVersion":{"type":"integer","format":"int64"},"name":{"type":"string"},"description":{"type":"string"},"titleTemplate":{"type":"string"},"bodyTemplate":{"type":"string"},"defaultLevel":{"type":"string"},"defaultChannel":{"type":"string"},"variables":{"type":"array","items":{"$ref":"#/components/schemas/VariableDefinition"}},"conditionalBlocks":{"type":"array","items":{"$ref":"#/components/schemas/ConditionalBlock"}}}},"CorrectParticipantRequest":{"required":["destination","documentId","name"],"type":"object","properties":{"name":{"maxLength":200,"minLength":0,"type":"string"},"documentId":{"maxLength":64,"minLength":0,"type":"string"},"destination":{"maxLength":320,"minLength":0,"type":"string"},"dateOfBirth":{"maxLength":10,"minLength":0,"type":"string"},"identityVerificationConsent":{"type":"boolean"},"biometricReferenceSha256":{"pattern":"(?i)[0-9a-f]{64}","type":"string"}}},"UpdateTenantStatusRequest":{"required":["enabled"],"type":"object","properties":{"enabled":{"type":"boolean"}}},"UpdateMembershipRequest":{"type":"object","properties":{"role":{"type":"string","enum":["OWNER","ADMIN","MANAGER","MEMBER","VIEWER"]},"permissions":{"uniqueItems":true,"type":"array","items":{"type":"string","enum":["TENANT_READ","TENANT_MANAGE","MEMBERS_READ","MEMBERS_MANAGE","SECURITY_MANAGE","API_KEYS_MANAGE","DOCUMENTS_READ","DOCUMENTS_WRITE","CONTRACTS_READ","CONTRACTS_WRITE","APPROVALS_READ","APPROVALS_WRITE","BILLING_READ","BILLING_MANAGE"]}},"enabled":{"type":"boolean"}}},"MemberView":{"type":"object","properties":{"membershipId":{"type":"string"},"userId":{"type":"string"},"email":{"type":"string"},"displayName":{"type":"string"},"userStatus":{"type":"string"},"role":{"type":"string","enum":["OWNER","ADMIN","MANAGER","MEMBER","VIEWER"]},"permissions":{"uniqueItems":true,"type":"array","items":{"type":"string","enum":["TENANT_READ","TENANT_MANAGE","MEMBERS_READ","MEMBERS_MANAGE","SECURITY_MANAGE","API_KEYS_MANAGE","DOCUMENTS_READ","DOCUMENTS_WRITE","CONTRACTS_READ","CONTRACTS_WRITE","APPROVALS_READ","APPROVALS_WRITE","BILLING_READ","BILLING_MANAGE"]}},"enabled":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"PublicSigningContinuationStatus":{"type":"object","properties":{"state":{"type":"string"},"completed":{"type":"boolean"},"participantStatus":{"type":"string"},"requestStatus":{"type":"string"},"expiresAt":{"type":"string"},"message":{"type":"string"}}},"ProviderView":{"type":"object","properties":{"id":{"type":"string"},"displayName":{"type":"string"}}},"PublicQualifiedConfigResponse":{"type":"object","properties":{"localAgentEnabled":{"type":"boolean"},"localAgentEndpoint":{"type":"string"},"localAgentDownloadUrl":{"type":"string"},"cloudProviders":{"type":"array","items":{"$ref":"#/components/schemas/ProviderView"}},"message":{"type":"string"}}},"TrustAnchorInfo":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"source":{"type":"string"},"status":{"type":"string"},"type":{"type":"string"},"expiresAt":{"type":"string"}}},"TrustAnchorListResponse":{"type":"object","properties":{"anchors":{"type":"array","items":{"$ref":"#/components/schemas/TrustAnchorInfo"}}}},"TemplateRevisionResponse":{"type":"object","properties":{"version":{"type":"integer","format":"int64"},"action":{"type":"string","enum":["BASELINE","CREATED","UPDATED","CLONED","QUARANTINED","REVIEWED","DELETED"]},"sourceTemplateId":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"titleTemplate":{"type":"string"},"bodyTemplate":{"type":"string"},"defaultLevel":{"type":"string"},"defaultChannel":{"type":"string"},"variables":{"type":"array","items":{"$ref":"#/components/schemas/VariableDefinition"}},"conditionalBlocks":{"type":"array","items":{"$ref":"#/components/schemas/ConditionalBlock"}},"importReviewStatus":{"type":"string","enum":["NOT_REQUIRED","PENDING","CONFIRMED"]},"importFidelity":{"type":"string","enum":["SUPPORTED_SUBSET","LOSSY_REVIEW_REQUIRED"]},"importWarnings":{"type":"array","items":{"type":"string"}},"importSourceFileName":{"type":"string"},"importReviewedAt":{"type":"string","format":"date-time"},"recordedAt":{"type":"string","format":"date-time"}}},"FieldStatus":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string"},"label":{"type":"string"},"signatoryId":{"type":"string"},"page":{"type":"integer","format":"int32"},"x":{"type":"number","format":"double"},"y":{"type":"number","format":"double"},"width":{"type":"number","format":"double"},"height":{"type":"number","format":"double"},"required":{"type":"boolean"},"readOnly":{"type":"boolean"},"options":{"type":"array","items":{"type":"string"}},"completed":{"type":"boolean"},"completedAt":{"type":"string"}}},"StatusResponse":{"type":"object","properties":{"requestId":{"type":"string"},"title":{"type":"string"},"status":{"type":"string"},"level":{"type":"string"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"},"expiresAt":{"type":"string"},"signatories":{"type":"array","items":{"$ref":"#/components/schemas/SignatoryStatus"}},"routingMode":{"type":"string"},"fields":{"type":"array","items":{"$ref":"#/components/schemas/FieldStatus"}},"reminders":{"$ref":"#/components/schemas/ReminderPolicyDto"},"tags":{"type":"array","items":{"type":"string"}},"metadata":{"type":"object","additionalProperties":{"type":"string"}},"allowDecline":{"type":"boolean"},"locale":{"type":"string"}}},"TimelineEventResponse":{"type":"object","properties":{"id":{"type":"string"},"subjectType":{"type":"string"},"subjectId":{"type":"string"},"eventType":{"type":"string"},"actorCredentialId":{"type":"string"},"details":{"$ref":"#/components/schemas/JsonNode"},"occurredAt":{"type":"string","format":"date-time"}}},"OverviewResponse":{"type":"object","properties":{"tenant":{"$ref":"#/components/schemas/TenantResponse"},"documents":{"type":"integer","format":"int64"},"signingRequests":{"type":"integer","format":"int64"},"pending":{"type":"integer","format":"int64"},"completed":{"type":"integer","format":"int64"},"apiKeys":{"type":"integer","format":"int64"},"credentialRole":{"type":"string"},"credentialId":{"type":"string"},"idempotencyAvailable":{"type":"boolean"},"biometricAvailable":{"type":"boolean"},"emailOtpAvailable":{"type":"boolean"},"smsOtpAvailable":{"type":"boolean"},"whatsappOtpAvailable":{"type":"boolean"}}},"DeliveryStatus":{"type":"object","properties":{"id":{"type":"string"},"channel":{"type":"string"},"destination":{"type":"string"},"eventType":{"type":"string"},"state":{"type":"string"},"attemptCount":{"type":"integer","format":"int32"},"lastError":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"deliveredAt":{"type":"string","format":"date-time"}}},"OnboardingConfigResponse":{"type":"object","properties":{"enabled":{"type":"boolean"},"termsVersion":{"type":"string"},"emailVerificationRequired":{"type":"boolean"}}},"EnvelopeSummary":{"type":"object","properties":{"envelopeId":{"type":"string"},"title":{"type":"string"},"status":{"type":"string"},"documentCount":{"type":"integer","format":"int32"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"version":{"type":"integer","format":"int64"}}},"DocumentStatusResponse":{"type":"object","properties":{"status":{"type":"string"}}},"PageResponseContractResponse":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ContractResponse"}},"page":{"type":"integer","format":"int32"},"size":{"type":"integer","format":"int32"},"totalElements":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int32"}}},"EventResponse":{"type":"object","properties":{"id":{"type":"string"},"contractId":{"type":"string"},"eventType":{"type":"string","enum":["CREATED","UPDATED","STATUS_TRANSITIONED","SIGNING_STATUS_SYNCED","ARCHIVED","RESTORED","OBLIGATION_CREATED","OBLIGATION_UPDATED","OBLIGATION_DELETED","NOTE_ADDED"]},"actorCredentialId":{"type":"string"},"details":{"type":"string"},"occurredAt":{"type":"string","format":"date-time"}}},"PageResponseEventResponse":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/EventResponse"}},"page":{"type":"integer","format":"int32"},"size":{"type":"integer","format":"int32"},"totalElements":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int32"}}},"PageResponseObligationResponse":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ObligationResponse"}},"page":{"type":"integer","format":"int32"},"size":{"type":"integer","format":"int32"},"totalElements":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int32"}}},"UsageItemResponse":{"type":"object","properties":{"metric":{"type":"string","enum":["API_CALLS","DOCUMENTS","SIGNATURE_REQUESTS","TEMPLATE_GENERATIONS","CONTRACTS","USERS","STORAGE_BYTES"]},"used":{"type":"integer","format":"int64"},"hardLimit":{"type":"integer","format":"int64"},"remaining":{"type":"integer","format":"int64"},"unlimited":{"type":"boolean"}}},"UsageResponse":{"type":"object","properties":{"tenantId":{"type":"string"},"planId":{"type":"string"},"status":{"type":"string","enum":["TRIALING","ACTIVE","PAST_DUE","PAUSED","INCOMPLETE","CANCELED","EXPIRED"]},"periodStart":{"type":"string","format":"date-time"},"periodEnd":{"type":"string","format":"date-time"},"items":{"type":"array","items":{"$ref":"#/components/schemas/UsageItemResponse"}}}},"InvoiceListResponse":{"type":"object","properties":{"providerConfigured":{"type":"boolean"},"liveRefreshPerformed":{"type":"boolean"},"invoices":{"type":"array","items":{"$ref":"#/components/schemas/InvoiceResponse"}}}},"InvoiceResponse":{"type":"object","properties":{"id":{"type":"string"},"billingProvider":{"type":"string"},"externalInvoiceId":{"type":"string"},"status":{"type":"string"},"currency":{"type":"string"},"amountDueMinor":{"type":"integer","format":"int64"},"amountPaidMinor":{"type":"integer","format":"int64"},"issuedAt":{"type":"string","format":"date-time"},"dueAt":{"type":"string","format":"date-time"},"paidAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"AvailabilityResponse":{"type":"object","properties":{"tenantId":{"type":"string"},"subscriptionStatus":{"type":"string","enum":["TRIALING","ACTIVE","PAST_DUE","PAUSED","INCOMPLETE","CANCELED","EXPIRED"]},"currentPlanId":{"type":"string"},"checkoutAvailable":{"type":"boolean"},"planChangeAvailable":{"type":"boolean"},"portalAvailable":{"type":"boolean"},"regularizationAvailable":{"type":"boolean"},"recommendedAction":{"type":"string"},"reasonCode":{"type":"string"},"message":{"type":"string"},"providers":{"type":"array","items":{"$ref":"#/components/schemas/BillingProviderAvailabilityResponse"}}}},"BillingProviderAvailabilityResponse":{"type":"object","properties":{"provider":{"type":"string"},"configured":{"type":"boolean"},"checkoutPlanIds":{"type":"array","items":{"type":"string"}},"customerPortalSupported":{"type":"boolean"}}},"PageResponseClauseResponse":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ClauseResponse"}},"page":{"type":"integer","format":"int32"},"size":{"type":"integer","format":"int32"},"totalItems":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int32"}}},"ClauseVersionResponse":{"type":"object","properties":{"id":{"type":"string"},"clauseId":{"type":"string"},"versionNumber":{"type":"integer","format":"int32"},"bodyText":{"type":"string"},"changeSummary":{"type":"string"},"actorCredentialId":{"type":"string"},"createdAt":{"type":"string","format":"date-time"}}},"BiometricOperationalStatus":{"type":"object","properties":{"state":{"type":"string","enum":["NOT_CHECKED","READY","NOT_READY","UNAVAILABLE"]},"checkedAt":{"type":"string","description":"Última sondagem; null para NOT_CHECKED","format":"date-time","nullable":true},"reason":{"type":"string","enum":["NOT_PROBED","TECHNICAL_DEPENDENCIES_READY","TECHNICAL_DEPENDENCIES_NOT_READY","TRANSPORT_UNAVAILABLE","INVALID_STATUS_RESPONSE"]}}},"BiometricProviderStatus":{"type":"object","properties":{"enabled":{"type":"boolean"},"configured":{"type":"boolean"},"configuration":{"type":"string","enum":["DISABLED","NOT_CONFIGURED","AMBIGUOUS","INCOMPATIBLE_CONTRACT","CONFIGURED"]},"adapter":{"type":"string","enum":["NONE","SELF_HOSTED_HTTP","EXTERNAL_ADAPTER_UNASSESSED"]},"requiredContract":{"type":"string","enum":["FRONT_AND_LIVE_IMAGE_V1","FULL_CAPTURE_V2","ACTIVE_LIVENESS_DOCUMENT_IDENTITY_V3"]},"configuredContract":{"type":"string","description":"Contrato declarado pelo adapter selecionado; null quando ausente ou ambíguo","nullable":true,"enum":["FRONT_AND_LIVE_IMAGE_V1","FULL_CAPTURE_V2","ACTIVE_LIVENESS_DOCUMENT_IDENTITY_V3"]},"contractCompatible":{"type":"boolean"},"runtime":{"$ref":"#/components/schemas/BiometricOperationalStatus"},"assurance":{"type":"string","enum":["UNAVAILABLE","COMPLEMENTARY_UNCALIBRATED"]},"independentCalibrationVerified":{"type":"boolean"},"officialDocumentValidationAvailable":{"type":"boolean"},"injectionResistanceEvaluated":{"type":"boolean"},"commercialIntegration":{"type":"string","enum":["NOT_IMPLEMENTED"]},"requirements":{"type":"array","items":{"type":"string","enum":["PROVIDER_CONFIGURATION","UNAMBIGUOUS_PROVIDER_SELECTION","V3_CONTRACT","OPERATIONAL_PROBE","RUNTIME_RECOVERY","INDEPENDENT_CALIBRATION","PAD_AND_INJECTION_EVALUATION","COMMERCIAL_CONTRACT_AND_CREDENTIALS","OFFICIAL_PROVIDER_ADAPTER_AND_HOMOLOGATION"]}},"assuranceRequirements":{"type":"array","items":{"type":"string","enum":["PROVIDER_CONFIGURATION","UNAMBIGUOUS_PROVIDER_SELECTION","V3_CONTRACT","OPERATIONAL_PROBE","RUNTIME_RECOVERY","INDEPENDENT_CALIBRATION","PAD_AND_INJECTION_EVALUATION","COMMERCIAL_CONTRACT_AND_CREDENTIALS","OFFICIAL_PROVIDER_ADAPTER_AND_HOMOLOGATION"]}},"commercialIntegrationRequirements":{"type":"array","items":{"type":"string","enum":["PROVIDER_CONFIGURATION","UNAMBIGUOUS_PROVIDER_SELECTION","V3_CONTRACT","OPERATIONAL_PROBE","RUNTIME_RECOVERY","INDEPENDENT_CALIBRATION","PAD_AND_INJECTION_EVALUATION","COMMERCIAL_CONTRACT_AND_CREDENTIALS","OFFICIAL_PROVIDER_ADAPTER_AND_HOMOLOGATION"]}}},"description":"Prontidão técnica não comprova acurácia, PAD certificado ou autenticidade documental"},"RunEventResponse":{"type":"object","properties":{"eventType":{"type":"string"},"details":{"type":"object","additionalProperties":{"type":"string"}},"recordedAt":{"type":"string","format":"date-time"}}},"RevisionResponse":{"type":"object","properties":{"version":{"type":"integer","format":"int64"},"action":{"type":"string","enum":["CREATED","UPDATED","ACTIVATED","PAUSED","ARCHIVED"]},"name":{"type":"string"},"description":{"type":"string"},"templateId":{"type":"string"},"state":{"type":"string","enum":["DRAFT","ACTIVE","PAUSED","ARCHIVED"]},"triggerType":{"type":"string","enum":["MANUAL","API","SCHEDULE"]},"scheduleCron":{"type":"string"},"scheduleZone":{"type":"string"},"configuration":{"$ref":"#/components/schemas/AutomationConfiguration"},"recordedAt":{"type":"string","format":"date-time"}}},"PublicOidcProviderView":{"type":"object","properties":{"id":{"type":"string"},"displayName":{"type":"string"},"issuerUri":{"type":"string"},"scopes":{"uniqueItems":true,"type":"array","items":{"type":"string"}},"authorizationAvailable":{"type":"boolean"}}},"SessionView":{"type":"object","properties":{"id":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"lastUsedAt":{"type":"string","format":"date-time"},"idleExpiresAt":{"type":"string","format":"date-time"},"expiresAt":{"type":"string","format":"date-time"},"revokedAt":{"type":"string","format":"date-time"},"mfaVerified":{"type":"boolean"},"persistent":{"type":"boolean"},"current":{"type":"boolean"}}},"MeResponse":{"type":"object","properties":{"userId":{"type":"string"},"tenantId":{"type":"string"},"sessionId":{"type":"string"},"permissions":{"uniqueItems":true,"type":"array","items":{"type":"string"}},"email":{"type":"string"},"emailVerified":{"type":"boolean"},"emailVerifiedAt":{"type":"string","format":"date-time"},"mfaEnabled":{"type":"boolean"},"displayName":{"type":"string"},"membershipRole":{"type":"string","enum":["OWNER","ADMIN","MANAGER","MEMBER","VIEWER"]},"tenants":{"type":"array","items":{"$ref":"#/components/schemas/TenantAccessView"}}}},"TenantAccessView":{"type":"object","properties":{"id":{"type":"string"},"slug":{"type":"string"},"name":{"type":"string"},"role":{"type":"string","enum":["OWNER","ADMIN","MANAGER","MEMBER","VIEWER"]},"permissions":{"uniqueItems":true,"type":"array","items":{"type":"string","enum":["TENANT_READ","TENANT_MANAGE","MEMBERS_READ","MEMBERS_MANAGE","SECURITY_MANAGE","API_KEYS_MANAGE","DOCUMENTS_READ","DOCUMENTS_WRITE","CONTRACTS_READ","CONTRACTS_WRITE","APPROVALS_READ","APPROVALS_WRITE","BILLING_READ","BILLING_MANAGE"]}},"current":{"type":"boolean"}}},"AuditEvent":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"operation":{"type":"string"},"documentHash":{"type":"string"},"operationData":{"type":"string"},"signatureLevel":{"type":"string"},"validationResult":{"type":"string"},"certificateDn":{"type":"string"},"eventHash":{"type":"string"},"previousHash":{"type":"string"},"timestamp":{"type":"string","format":"date-time"}}},"AuditResponse":{"type":"object","properties":{"chainIntact":{"type":"boolean"},"count":{"type":"integer","format":"int32"},"events":{"type":"array","items":{"$ref":"#/components/schemas/AuditEvent"}}}},"RevokedSessionsResponse":{"type":"object","properties":{"revokedSessions":{"type":"integer","format":"int32"}}},"DisableTotpRequest":{"required":["password"],"type":"object","properties":{"password":{"maxLength":128,"minLength":0,"type":"string"},"code":{"maxLength":8,"minLength":0,"type":"string"},"recoveryCode":{"maxLength":32,"minLength":0,"type":"string"}}},"BasicError":{"type":"object","properties":{"error":{"type":"string","example":"UNAUTHORIZED"},"message":{"type":"string"}}},"ApiError":{"type":"object","properties":{"error":{"type":"string","example":"COMMERCIAL_QUOTA_EXCEEDED"},"message":{"type":"string"},"details":{"type":"object","additionalProperties":{"type":"string"}}}},"RetryablePublicError":{"type":"object","properties":{"error":{"type":"string","example":"PUBLIC_AUTH_RATE_LIMITED"},"message":{"type":"string"},"retryAfterSeconds":{"minimum":1,"type":"integer","format":"int64"}}}},"responses":{"Unauthorized":{"description":"Credencial ausente, inválida ou expirada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BasicError"}}}},"Forbidden":{"description":"Credencial válida sem permissão para a operação","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BasicError"}}}},"CommercialQuotaExceeded":{"description":"Quota comercial esgotada para uma API key de tenant ou integração","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"PublicRateLimited":{"description":"Limite da rota pública atingido; respeite Retry-After","headers":{"Retry-After":{"description":"Segundos até uma nova tentativa","schema":{"minimum":1,"type":"integer","format":"int64"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RetryablePublicError"}}}},"OnboardingRateLimited":{"description":"Limite de cadastros atingido; respeite Retry-After","headers":{"Retry-After":{"description":"Segundos até uma nova tentativa","schema":{"minimum":1,"type":"integer","format":"int64"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BasicError"}}}},"PublicAuthUnavailable":{"description":"Limitador da autenticação pública temporariamente indisponível","headers":{"Retry-After":{"description":"Segundos até uma nova tentativa","schema":{"minimum":1,"type":"integer","format":"int64"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BasicError"}}}},"OnboardingUnavailable":{"description":"Cadastro público temporariamente indisponível","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BasicError"}}}}},"securitySchemes":{"ApiKey":{"type":"apiKey","description":"API Key para autenticação. Incluir no header: X-API-Key: sua-chave","name":"X-API-Key","in":"header"},"BearerAuth":{"type":"http","description":"Token opaco de sessão humana para clientes não-browser","scheme":"bearer","bearerFormat":"Opaque"},"HumanSessionCookie":{"type":"apiKey","description":"Cookie host-only HttpOnly/Secure emitido pelo login humano","name":"__Host-venue_session","in":"cookie"}}}}