{"openapi":"3.1.0","info":{"title":"Agreebase API","version":"1.0.0"},"paths":{"/health":{"get":{"tags":["meta"],"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response Health Health Get"}}}}}}},"/health/ready":{"get":{"tags":["meta"],"summary":"Health Ready","operationId":"health_ready_health_ready_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/mcp/diagnostics":{"get":{"tags":["meta"],"summary":"Mcp Diagnostics","operationId":"mcp_diagnostics_mcp_diagnostics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/agreements":{"post":{"tags":["agreements"],"summary":"Create Agreement","operationId":"create_agreement_api_v1_agreements_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAgreementRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalAgreementResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerToken":[]},{"APIKey":[]}]}},"/api/v1/agreements/{agr_id}":{"get":{"tags":["agreements"],"summary":"Get Agreement","operationId":"get_agreement_api_v1_agreements__agr_id__get","security":[{"BearerToken":[]},{"APIKey":[]}],"parameters":[{"name":"agr_id","in":"path","required":true,"schema":{"type":"string","title":"Agr Id"}},{"name":"image_representation","in":"query","required":false,"schema":{"enum":["metadata","compatibility_data_uri"],"type":"string","description":"Use compatibility_data_uri only when an older client requires inline SVG.","default":"metadata","title":"Image Representation"},"description":"Use compatibility_data_uri only when an older client requires inline SVG."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalAgreementResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["agreements"],"summary":"Update Agreement Draft","operationId":"update_agreement_draft_api_v1_agreements__agr_id__patch","security":[{"BearerToken":[]},{"APIKey":[]}],"parameters":[{"name":"agr_id","in":"path","required":true,"schema":{"type":"string","title":"Agr Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAgreementRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalAgreementResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agreements/{agr_id}/submit":{"post":{"tags":["agreements"],"summary":"Submit Agreement","operationId":"submit_agreement_api_v1_agreements__agr_id__submit_post","security":[{"BearerToken":[]},{"APIKey":[]}],"parameters":[{"name":"agr_id","in":"path","required":true,"schema":{"type":"string","title":"Agr Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalAgreementResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agreements/{agr_id}/signature-execution":{"post":{"tags":["agreements"],"summary":"Start Or Resume Signature Execution","operationId":"start_or_resume_signature_execution_api_v1_agreements__agr_id__signature_execution_post","security":[{"BearerToken":[]},{"APIKey":[]}],"parameters":[{"name":"agr_id","in":"path","required":true,"schema":{"type":"string","title":"Agr Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalSignatureExecutionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["agreements"],"summary":"Get Signature Execution","operationId":"get_signature_execution_api_v1_agreements__agr_id__signature_execution_get","security":[{"BearerToken":[]},{"APIKey":[]}],"parameters":[{"name":"agr_id","in":"path","required":true,"schema":{"type":"string","title":"Agr Id"}},{"name":"image_representation","in":"query","required":false,"schema":{"enum":["metadata","compatibility_data_uri"],"type":"string","description":"Use compatibility_data_uri only when an older client requires inline SVG.","default":"metadata","title":"Image Representation"},"description":"Use compatibility_data_uri only when an older client requires inline SVG."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalSignatureExecutionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agreements/{agr_id}/signature-execution/methods/{method_type}/start":{"post":{"tags":["agreements"],"summary":"Start Signature Method","operationId":"start_signature_method_api_v1_agreements__agr_id__signature_execution_methods__method_type__start_post","security":[{"BearerToken":[]},{"APIKey":[]}],"parameters":[{"name":"agr_id","in":"path","required":true,"schema":{"type":"string","title":"Agr Id"}},{"name":"method_type","in":"path","required":true,"schema":{"enum":["email_otp","github_gist","x_post","reddit_post","webauthn_passkey","telegram","api_key"],"type":"string","title":"Method Type"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StartSignatureMethodRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalSignatureExecutionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agreements/{agr_id}/signature-execution/methods/{method_type}/submit":{"post":{"tags":["agreements"],"summary":"Submit Signature Method","operationId":"submit_signature_method_api_v1_agreements__agr_id__signature_execution_methods__method_type__submit_post","security":[{"BearerToken":[]},{"APIKey":[]}],"parameters":[{"name":"agr_id","in":"path","required":true,"schema":{"type":"string","title":"Agr Id"}},{"name":"method_type","in":"path","required":true,"schema":{"enum":["email_otp","github_gist","x_post","reddit_post","webauthn_passkey","telegram","api_key"],"type":"string","title":"Method Type"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitSignatureMethodRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalSignatureExecutionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agreements/{agr_id}/signature-execution/methods/{method_type}/refresh":{"post":{"tags":["agreements"],"summary":"Refresh Signature Method","operationId":"refresh_signature_method_api_v1_agreements__agr_id__signature_execution_methods__method_type__refresh_post","security":[{"BearerToken":[]},{"APIKey":[]}],"parameters":[{"name":"agr_id","in":"path","required":true,"schema":{"type":"string","title":"Agr Id"}},{"name":"method_type","in":"path","required":true,"schema":{"enum":["email_otp","github_gist","x_post","reddit_post","webauthn_passkey","telegram","api_key"],"type":"string","title":"Method Type"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/RefreshSignatureMethodRequest"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalSignatureExecutionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agreements/{agr_id}/signature-execution/methods/{method_type}/cancel":{"post":{"tags":["agreements"],"summary":"Cancel Signature Method","operationId":"cancel_signature_method_api_v1_agreements__agr_id__signature_execution_methods__method_type__cancel_post","security":[{"BearerToken":[]},{"APIKey":[]}],"parameters":[{"name":"agr_id","in":"path","required":true,"schema":{"type":"string","title":"Agr Id"}},{"name":"method_type","in":"path","required":true,"schema":{"enum":["email_otp","github_gist","x_post","reddit_post","webauthn_passkey","telegram","api_key"],"type":"string","title":"Method Type"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalSignatureExecutionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agreements/{agr_id}/signature-execution/finalize":{"post":{"tags":["agreements"],"summary":"Finalize Signature Execution","operationId":"finalize_signature_execution_api_v1_agreements__agr_id__signature_execution_finalize_post","security":[{"BearerToken":[]},{"APIKey":[]}],"parameters":[{"name":"agr_id","in":"path","required":true,"schema":{"type":"string","title":"Agr Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/FinalizeSignatureRequest"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalAgreementResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agreements/{agr_id}/decline":{"post":{"tags":["agreements"],"summary":"Decline Agreement","operationId":"decline_agreement_api_v1_agreements__agr_id__decline_post","security":[{"BearerToken":[]},{"APIKey":[]}],"parameters":[{"name":"agr_id","in":"path","required":true,"schema":{"type":"string","title":"Agr Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/DeclineRequest"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalAgreementResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agreements/{agr_id}/participants/{party_id}/resend-invitation":{"post":{"tags":["agreements"],"summary":"Resend Participant Invitation","operationId":"resend_participant_invitation_api_v1_agreements__agr_id__participants__party_id__resend_invitation_post","security":[{"BearerToken":[]},{"APIKey":[]}],"parameters":[{"name":"agr_id","in":"path","required":true,"schema":{"type":"string","title":"Agr Id"}},{"name":"party_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Party Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalAgreementResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agreements/{agr_id}/witnesses/{party_id}/waive":{"post":{"tags":["agreements"],"summary":"Waive Declined Witness","operationId":"waive_declined_witness_api_v1_agreements__agr_id__witnesses__party_id__waive_post","security":[{"BearerToken":[]},{"APIKey":[]}],"parameters":[{"name":"agr_id","in":"path","required":true,"schema":{"type":"string","title":"Agr Id"}},{"name":"party_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Party Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalAgreementResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agreements/{agr_id}/participants/{party_id}/complete-without":{"post":{"tags":["agreements"],"summary":"Complete Without Participant","operationId":"complete_without_participant_api_v1_agreements__agr_id__participants__party_id__complete_without_post","security":[{"BearerToken":[]},{"APIKey":[]}],"parameters":[{"name":"agr_id","in":"path","required":true,"schema":{"type":"string","title":"Agr Id"}},{"name":"party_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Party Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalAgreementResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agreements/{agr_id}/co-notarizers/{party_id}/waive":{"post":{"tags":["agreements"],"summary":"Waive Declined Co Notarizer","operationId":"waive_declined_co_notarizer_api_v1_agreements__agr_id__co_notarizers__party_id__waive_post","security":[{"BearerToken":[]},{"APIKey":[]}],"parameters":[{"name":"agr_id","in":"path","required":true,"schema":{"type":"string","title":"Agr Id"}},{"name":"party_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Party Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalAgreementResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agreements/{agr_id}/witnesses/{party_id}/replace":{"post":{"tags":["agreements"],"summary":"Replace Declined Witness","operationId":"replace_declined_witness_api_v1_agreements__agr_id__witnesses__party_id__replace_post","security":[{"BearerToken":[]},{"APIKey":[]}],"parameters":[{"name":"agr_id","in":"path","required":true,"schema":{"type":"string","title":"Agr Id"}},{"name":"party_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Party Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NamedPartyInput"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalAgreementResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agreements/{agr_id}/rescind":{"post":{"tags":["agreements"],"summary":"Rescind Agreement","operationId":"rescind_agreement_api_v1_agreements__agr_id__rescind_post","security":[{"BearerToken":[]},{"APIKey":[]}],"parameters":[{"name":"agr_id","in":"path","required":true,"schema":{"type":"string","title":"Agr Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalAgreementResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agreements/{agr_id}/amend":{"post":{"tags":["agreements"],"summary":"Amend Agreement","operationId":"amend_agreement_api_v1_agreements__agr_id__amend_post","security":[{"BearerToken":[]},{"APIKey":[]}],"parameters":[{"name":"agr_id","in":"path","required":true,"schema":{"type":"string","title":"Agr Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AmendAgreementRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalAgreementResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agreements/{agr_id}/cancel":{"post":{"tags":["agreements"],"summary":"Cancel Agreement","operationId":"cancel_agreement_api_v1_agreements__agr_id__cancel_post","security":[{"BearerToken":[]},{"APIKey":[]}],"parameters":[{"name":"agr_id","in":"path","required":true,"schema":{"type":"string","title":"Agr Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/CancelAgreementRequest"},{"type":"null"}],"title":"Body"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalAgreementResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agreements/{agr_id}/document":{"get":{"tags":["agreements"],"summary":"Get Agreement Document","operationId":"get_agreement_document_api_v1_agreements__agr_id__document_get","security":[{"BearerToken":[]},{"APIKey":[]}],"parameters":[{"name":"agr_id","in":"path","required":true,"schema":{"type":"string","title":"Agr Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agreements/{agr_id}/card.png":{"get":{"tags":["agreements"],"summary":"Get Agreement Card","operationId":"get_agreement_card_api_v1_agreements__agr_id__card_png_get","security":[{"BearerToken":[]},{"APIKey":[]}],"parameters":[{"name":"agr_id","in":"path","required":true,"schema":{"type":"string","title":"Agr Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agreements/{agr_id}/card-ticket":{"post":{"tags":["agreements"],"summary":"Issue Agreement Card Ticket","description":"Issue a short-lived, single-use URL for the authenticated participant's card.","operationId":"issue_agreement_card_ticket_api_v1_agreements__agr_id__card_ticket_post","security":[{"BearerToken":[]},{"APIKey":[]}],"parameters":[{"name":"agr_id","in":"path","required":true,"schema":{"type":"string","title":"Agr Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShareCardTicketResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agreements/{agr_id}/counter":{"post":{"tags":["agreements"],"summary":"Submit Counter","description":"Submit a counter-proposal (non-initiator parties only).","operationId":"submit_counter_api_v1_agreements__agr_id__counter_post","security":[{"BearerToken":[]},{"APIKey":[]}],"parameters":[{"name":"agr_id","in":"path","required":true,"schema":{"type":"string","title":"Agr Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitCounterRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CounterProposalResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agreements/{agr_id}/counter/{counter_id}":{"get":{"tags":["agreements"],"summary":"Get Counter","description":"Retrieve a counter-proposal by ID. Any party to the agreement may access it.","operationId":"get_counter_api_v1_agreements__agr_id__counter__counter_id__get","security":[{"BearerToken":[]},{"APIKey":[]}],"parameters":[{"name":"agr_id","in":"path","required":true,"schema":{"type":"string","title":"Agr Id"}},{"name":"counter_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Counter Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CounterProposalResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agreements/{agr_id}/counter/{counter_id}/resolve":{"post":{"tags":["agreements"],"summary":"Resolve Counter","description":"Resolve a pending counter-proposal (initiator only).","operationId":"resolve_counter_api_v1_agreements__agr_id__counter__counter_id__resolve_post","security":[{"BearerToken":[]},{"APIKey":[]}],"parameters":[{"name":"agr_id","in":"path","required":true,"schema":{"type":"string","title":"Agr Id"}},{"name":"counter_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Counter Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolveCounterRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalAgreementResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/agreements/{agr_id}/counter/{counter_id}/withdraw":{"post":{"tags":["agreements"],"summary":"Withdraw Counter","description":"Withdraw a pending counter-proposal (the proposing party only).","operationId":"withdraw_counter_api_v1_agreements__agr_id__counter__counter_id__withdraw_post","security":[{"BearerToken":[]},{"APIKey":[]}],"parameters":[{"name":"agr_id","in":"path","required":true,"schema":{"type":"string","title":"Agr Id"}},{"name":"counter_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Counter Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalAgreementResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/declarations":{"post":{"tags":["declarations"],"summary":"Create Declaration","operationId":"create_declaration_api_v1_declarations_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateDeclarationRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalAgreementResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerToken":[]},{"APIKey":[]}]}},"/api/v1/notarizations":{"post":{"tags":["notarizations"],"summary":"Create Notarization","operationId":"create_notarization_api_v1_notarizations_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateNotarizationRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalNotarizationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerToken":[]},{"APIKey":[]}]}},"/api/v1/notarizations/{id_or_ref}":{"get":{"tags":["notarizations"],"summary":"Get Notarization","operationId":"get_notarization_api_v1_notarizations__id_or_ref__get","security":[{"BearerToken":[]},{"APIKey":[]}],"parameters":[{"name":"id_or_ref","in":"path","required":true,"schema":{"type":"string","title":"Id Or Ref"}},{"name":"image_representation","in":"query","required":false,"schema":{"enum":["metadata","compatibility_data_uri"],"type":"string","description":"Use compatibility_data_uri only when an older client requires inline SVG.","default":"metadata","title":"Image Representation"},"description":"Use compatibility_data_uri only when an older client requires inline SVG."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalAgreementResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/notarizations/{id_or_ref}/signature-execution":{"post":{"tags":["notarizations"],"summary":"Start Or Resume Notarization Signature Execution","operationId":"start_or_resume_notarization_signature_execution_api_v1_notarizations__id_or_ref__signature_execution_post","security":[{"BearerToken":[]},{"APIKey":[]}],"parameters":[{"name":"id_or_ref","in":"path","required":true,"schema":{"type":"string","title":"Id Or Ref"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalSignatureExecutionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["notarizations"],"summary":"Get Notarization Signature Execution","operationId":"get_notarization_signature_execution_api_v1_notarizations__id_or_ref__signature_execution_get","security":[{"BearerToken":[]},{"APIKey":[]}],"parameters":[{"name":"id_or_ref","in":"path","required":true,"schema":{"type":"string","title":"Id Or Ref"}},{"name":"image_representation","in":"query","required":false,"schema":{"enum":["metadata","compatibility_data_uri"],"type":"string","description":"Use compatibility_data_uri only when an older client requires inline SVG.","default":"metadata","title":"Image Representation"},"description":"Use compatibility_data_uri only when an older client requires inline SVG."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalSignatureExecutionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/notarizations/{id_or_ref}/signature-execution/finalize":{"post":{"tags":["notarizations"],"summary":"Finalize Notarization Signature Execution","operationId":"finalize_notarization_signature_execution_api_v1_notarizations__id_or_ref__signature_execution_finalize_post","security":[{"BearerToken":[]},{"APIKey":[]}],"parameters":[{"name":"id_or_ref","in":"path","required":true,"schema":{"type":"string","title":"Id Or Ref"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/FinalizeSignatureRequest"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalAgreementResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/notarizations/{id_or_ref}/card.png":{"get":{"tags":["notarizations"],"summary":"Get Notarization Card","operationId":"get_notarization_card_api_v1_notarizations__id_or_ref__card_png_get","security":[{"BearerToken":[]},{"APIKey":[]}],"parameters":[{"name":"id_or_ref","in":"path","required":true,"schema":{"type":"string","title":"Id Or Ref"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/notarizations/{id_or_ref}/card-ticket":{"post":{"tags":["notarizations"],"summary":"Issue Notarization Card Ticket","description":"Issue a short-lived, single-use URL for an authorized notarization participant.","operationId":"issue_notarization_card_ticket_api_v1_notarizations__id_or_ref__card_ticket_post","security":[{"BearerToken":[]},{"APIKey":[]}],"parameters":[{"name":"id_or_ref","in":"path","required":true,"schema":{"type":"string","title":"Id Or Ref"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShareCardTicketResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/verification/request-otp":{"post":{"tags":["verification"],"summary":"Request Otp","operationId":"request_otp_api_v1_verification_request_otp_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OTPRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OTPRequestResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/verification/verify-otp":{"post":{"tags":["verification"],"summary":"Verify Otp","operationId":"verify_otp_api_v1_verification_verify_otp_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OTPVerifyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OTPVerifyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/identity/contact-points":{"get":{"tags":["identity"],"summary":"List Contact Points","description":"List all contact points in the authenticated identity graph. Bearer token only.","operationId":"list_contact_points_api_v1_identity_contact_points_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactPointListResponse"}}}}},"security":[{"BearerToken":[]}]}},"/api/v1/identity/link":{"post":{"tags":["identity"],"summary":"Link Contact Point","description":"Link a new contact point to the authenticated identity. Bearer token only.","operationId":"link_contact_point_api_v1_identity_link_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LinkContactPointRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactPointResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerToken":[]}]}},"/api/v1/identity/agreements":{"get":{"tags":["identity"],"summary":"List Identity Agreements","description":"List agreements for the authenticated identity graph.","operationId":"list_identity_agreements_api_v1_identity_agreements_get","security":[{"BearerToken":[]},{"APIKey":[]}],"parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/inbound/telegram":{"post":{"tags":["inbound"],"summary":"Inbound Telegram","description":"Receives Telegram Bot API updates for signing challenge completion.\nTelegram webhook secret is validated via query parameter or secret-token header.","operationId":"inbound_telegram_api_v1_inbound_telegram_post","parameters":[{"name":"secret","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Secret"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/api-keys":{"get":{"tags":["api-keys"],"summary":"List Api Keys","description":"List all non-revoked API keys for the authenticated identity graph.","operationId":"list_api_keys_api_v1_api_keys_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIKeyListResponse"}}}}},"security":[{"BearerToken":[]}]},"post":{"tags":["api-keys"],"summary":"Create Api Key","description":"Create a new API key. The full key is returned only once.","operationId":"create_api_key_api_v1_api_keys_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAPIKeyRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/APIKeyCreatedSchema"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"BearerToken":[]}]}},"/api/v1/api-keys/{key_id}":{"delete":{"tags":["api-keys"],"summary":"Revoke Api Key","description":"Revoke an API key. Must belong to the authenticated identity.","operationId":"revoke_api_key_api_v1_api_keys__key_id__delete","security":[{"BearerToken":[]}],"parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","format":"uuid4","title":"Key Id"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/artifacts/share-card/{token}":{"get":{"tags":["artifacts"],"summary":"Redeem Share Card","description":"Redeem one opaque, short-lived share-card ticket.","operationId":"redeem_share_card_api_v1_artifacts_share_card__token__get","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","minLength":20,"maxLength":128,"description":"Opaque single-use artifact ticket.","title":"Token"},"description":"Opaque single-use artifact ticket."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/verify/{agr_reference}":{"post":{"tags":["public"],"summary":"Verify Agreement","operationId":"verify_agreement_api_v1_public_verify__agr_reference__post","parameters":[{"name":"agr_reference","in":"path","required":true,"schema":{"type":"string","title":"Agr Reference"}},{"name":"image_representation","in":"query","required":false,"schema":{"enum":["metadata","compatibility_data_uri"],"type":"string","description":"Use compatibility_data_uri only when an older client requires inline SVG.","default":"metadata","title":"Image Representation"},"description":"Use compatibility_data_uri only when an older client requires inline SVG."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyBodyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalVerificationResultResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["public"],"summary":"Get Verification Certificate","operationId":"get_verification_certificate_api_v1_public_verify__agr_reference__get","parameters":[{"name":"agr_reference","in":"path","required":true,"schema":{"type":"string","title":"Agr Reference"}},{"name":"image_representation","in":"query","required":false,"schema":{"enum":["metadata","compatibility_data_uri"],"type":"string","description":"Use compatibility_data_uri only when an older client requires inline SVG.","default":"metadata","title":"Image Representation"},"description":"Use compatibility_data_uri only when an older client requires inline SVG."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalVerificationResultResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/public/agreements/{agr_reference}":{"get":{"tags":["public"],"summary":"Get Public Agreement","operationId":"get_public_agreement_api_v1_public_agreements__agr_reference__get","parameters":[{"name":"agr_reference","in":"path","required":true,"schema":{"type":"string","title":"Agr Reference"}},{"name":"image_representation","in":"query","required":false,"schema":{"enum":["metadata","compatibility_data_uri"],"type":"string","description":"Use compatibility_data_uri only when an older client requires inline SVG.","default":"metadata","title":"Image Representation"},"description":"Use compatibility_data_uri only when an older client requires inline SVG."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalPublicAgreementResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"APIKeyCreatedSchema":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"key_prefix":{"type":"string","title":"Key Prefix","description":"Non-secret key prefix for human identification."},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"scopes":{"items":{"type":"string","enum":["create","retrieve","verify","amend","cancel"]},"type":"array","title":"Scopes","description":"Exact API key scopes granted to this key. Scopes are not hierarchical: `create`, `retrieve`, `verify`, `amend`, and `cancel` must be granted explicitly."},"last_used_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Used At"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"key":{"type":"string","title":"Key","description":"Full API key value. This is returned once at creation time only."}},"type":"object","required":["id","key_prefix","name","scopes","last_used_at","expires_at","created_at","key"],"title":"APIKeyCreatedSchema","description":"Returned only at creation — includes the full key value (not retrievable again)."},"APIKeyListResponse":{"properties":{"api_keys":{"items":{"$ref":"#/components/schemas/APIKeySchema"},"type":"array","title":"Api Keys"}},"type":"object","required":["api_keys"],"title":"APIKeyListResponse"},"APIKeySchema":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"key_prefix":{"type":"string","title":"Key Prefix","description":"Non-secret key prefix for human identification."},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"scopes":{"items":{"type":"string","enum":["create","retrieve","verify","amend","cancel"]},"type":"array","title":"Scopes","description":"Exact API key scopes granted to this key. Scopes are not hierarchical: `create`, `retrieve`, `verify`, `amend`, and `cancel` must be granted explicitly."},"last_used_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Used At"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","key_prefix","name","scopes","last_used_at","expires_at","created_at"],"title":"APIKeySchema"},"AmendAgreementRequest":{"properties":{"body":{"type":"string","maxLength":7000,"minLength":10,"title":"Body"},"amendment_note":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Amendment Note"},"summary":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Summary"}},"type":"object","required":["body"],"title":"AmendAgreementRequest"},"BlockchainRecordResponse":{"properties":{"status":{"type":"string","enum":["pending","retrying","confirmed"],"title":"Status"},"network":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Network"},"tx_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tx Hash"},"block_number":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Block Number"},"explorer_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Explorer Url"},"written_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Written At"},"on_chain_full_text":{"type":"boolean","title":"On Chain Full Text","description":"True when the reconstructed sealed record text was published on chain instead of a hash-only payload."},"on_chain_include_verified_parties":{"type":"boolean","title":"On Chain Include Verified Parties","description":"True when verified signer or witness details were included in the on-chain sealed metadata."},"metadata_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Metadata Hash","description":"Hash of the sealed metadata payload used to derive verification artifacts and the document identicon."},"retry_count":{"type":"integer","title":"Retry Count","default":0},"next_retry_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Retry At"}},"type":"object","required":["status","network","tx_hash","block_number","explorer_url","written_at","on_chain_full_text","on_chain_include_verified_parties"],"title":"BlockchainRecordResponse"},"CancelAgreementRequest":{"properties":{"reason":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Reason"},"summary":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Summary"}},"type":"object","title":"CancelAgreementRequest"},"CoNotarizerInput":{"properties":{"contact_point_type":{"type":"string","const":"email","title":"Contact Point Type","description":"The public REST create/update surfaces currently accept email participants only.","default":"email"},"contact_point_value":{"type":"string","minLength":3,"title":"Contact Point Value","description":"Participant email address. It is normalized to lowercase and `+` aliases are rejected."},"display_name":{"type":"string","maxLength":50,"minLength":1,"title":"Display Name","description":"Human-readable participant name shown in invitations, signature flows, and evidence surfaces."}},"type":"object","required":["contact_point_value","display_name"],"title":"CoNotarizerInput","description":"Email participant who independently signs the same notarization hash."},"ContactPointListResponse":{"properties":{"contact_points":{"items":{"$ref":"#/components/schemas/ContactPointSchema"},"type":"array","title":"Contact Points"}},"type":"object","required":["contact_points"],"title":"ContactPointListResponse"},"ContactPointResponse":{"properties":{"contact_point":{"$ref":"#/components/schemas/ContactPointSchema"}},"type":"object","required":["contact_point"],"title":"ContactPointResponse"},"ContactPointSchema":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"type":{"type":"string","title":"Type","description":"Normalized contact-point type, for example `email`, `telegram`, or a linked social handle."},"value":{"type":"string","title":"Value","description":"Normalized contact-point value."},"value_hash":{"type":"string","title":"Value Hash","description":"SHA-256 hash of the normalized contact-point value."},"first_verified_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"First Verified At"},"last_verified_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Verified At"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","type","value","value_hash","first_verified_at","last_verified_at","created_at"],"title":"ContactPointSchema"},"CounterProposalResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"agreement_id":{"type":"string","format":"uuid","title":"Agreement Id"},"status":{"type":"string","enum":["pending","accepted","partially_accepted","rejected","withdrawn"],"title":"Status"},"proposed_by_contact_point_id":{"type":"string","format":"uuid","title":"Proposed By Contact Point Id"},"raw_input":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Raw Input"},"assisted_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assisted Text"},"proposed_body":{"type":"string","title":"Proposed Body"},"diff_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Diff Summary"},"resolved_body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resolved Body"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"resolved_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Resolved At"}},"type":"object","required":["id","agreement_id","status","proposed_by_contact_point_id","raw_input","assisted_text","proposed_body","diff_summary","resolved_body","created_at","resolved_at"],"title":"CounterProposalResponse"},"CreateAPIKeyRequest":{"properties":{"scopes":{"items":{"type":"string","enum":["create","retrieve","verify","amend","cancel"]},"type":"array","title":"Scopes","description":"Exact scopes to grant. Scopes are not hierarchical: `create`, `retrieve`, `verify`, `amend`, and `cancel` must be granted explicitly."},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"}},"type":"object","required":["scopes"],"title":"CreateAPIKeyRequest"},"CreateAgreementRequest":{"properties":{"type":{"type":"string","enum":["agreement","declaration","witnessed_agreement","notarization"],"title":"Type","default":"agreement"},"title":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Title"},"summary":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Summary"},"body":{"type":"string","maxLength":7000,"minLength":10,"title":"Body","description":"Agreement text. Bodies must be 2-350 normalized words and at most 7,000 characters."},"jurisdiction":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Jurisdiction"},"parties":{"items":{"$ref":"#/components/schemas/NamedPartyInput"},"type":"array","maxItems":14,"title":"Parties","description":"Other agreement parties to invite. Use exact user-provided names and emails. Agreements can have at most 15 signing participants total, including the initiator, so at most 14 non-initiator parties may be supplied."},"witnesses":{"items":{"$ref":"#/components/schemas/NamedPartyInput"},"type":"array","maxItems":5,"title":"Witnesses","description":"Optional witness participants who are asked to sign as witnesses. At most 5 active witnesses may be supplied."},"on_chain_full_text":{"type":"boolean","title":"On Chain Full Text","description":"When true, the reconstructed sealed record text is published on chain instead of a hash-only record."},"on_chain_include_verified_parties":{"type":"boolean","title":"On Chain Include Verified Parties","description":"When true, verified signer or witness details are included in the on-chain sealed metadata. This is more public and should be explicitly acknowledged before finalization."},"lapse_days":{"anyOf":[{"type":"integer","maximum":30.0,"minimum":1.0},{"type":"null"}],"title":"Lapse Days","description":"Optional confirmation expiry override in days. Valid range is 1-30."},"required_signature_method_count":{"type":"integer","enum":[1,2,3],"title":"Required Signature Method Count","description":"Number of distinct signature methods required before a signer may finalize.","default":1}},"type":"object","required":["body","on_chain_full_text","on_chain_include_verified_parties"],"title":"CreateAgreementRequest"},"CreateDeclarationRequest":{"properties":{"title":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Title"},"summary":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Summary"},"body":{"type":"string","maxLength":7000,"minLength":10,"title":"Body","description":"Declaration text. Bodies must be 2-350 normalized words and at most 7,000 characters."},"witnesses":{"items":{"$ref":"#/components/schemas/NamedPartyInput"},"type":"array","maxItems":5,"title":"Witnesses","description":"Optional witness participants who are asked to sign as witnesses. At most 5 active witnesses may be supplied."},"on_chain_full_text":{"type":"boolean","title":"On Chain Full Text","description":"When true, the reconstructed sealed record text is published on chain instead of a hash-only record."},"on_chain_include_verified_parties":{"type":"boolean","title":"On Chain Include Verified Parties","description":"When true, verified signer or witness details are included in the on-chain sealed metadata. This is more public and should be explicitly acknowledged before finalization."},"lapse_days":{"anyOf":[{"type":"integer","maximum":30.0,"minimum":1.0},{"type":"null"}],"title":"Lapse Days","description":"Optional confirmation expiry override in days. Valid range is 1-30."},"required_signature_method_count":{"type":"integer","enum":[1,2,3],"title":"Required Signature Method Count","description":"Number of distinct signature methods required before the declarant or witness may finalize.","default":1}},"type":"object","required":["body","on_chain_full_text","on_chain_include_verified_parties"],"title":"CreateDeclarationRequest"},"CreateNotarizationRequest":{"properties":{"content_type":{"type":"string","enum":["file","text","hash"],"title":"Content Type"},"content_hash":{"type":"string","title":"Content Hash","description":"SHA-256 hash of the exact file bytes or normalized text."},"hash_algorithm":{"type":"string","const":"sha256","title":"Hash Algorithm","default":"sha256"},"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text","description":"Raw text to normalize and record for text notarization."},"filename":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Filename"},"size_bytes":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Size Bytes"},"mime_type":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Mime Type"},"label":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Label"},"text_public":{"type":"boolean","title":"Text Public","default":false},"co_notarizers":{"items":{"$ref":"#/components/schemas/CoNotarizerInput"},"type":"array","maxItems":14,"title":"Co Notarizers"},"signature_mode":{"type":"string","enum":["pending_signature","auto_seal"],"title":"Signature Mode","default":"pending_signature"},"agent_identifier":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Agent Identifier"},"on_chain_include_verified_parties":{"type":"boolean","title":"On Chain Include Verified Parties","default":false},"lapse_days":{"anyOf":[{"type":"integer","maximum":30.0,"minimum":1.0},{"type":"null"}],"title":"Lapse Days"},"required_signature_method_count":{"type":"integer","enum":[1,2,3],"title":"Required Signature Method Count","default":1}},"additionalProperties":false,"type":"object","required":["content_type","content_hash"],"title":"CreateNotarizationRequest"},"DeclineRequest":{"properties":{"reason":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Reason"}},"type":"object","title":"DeclineRequest"},"ExternalAgreementPartyResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"role":{"type":"string","enum":["initiator","party","witness"],"title":"Role"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"contact_point_type":{"type":"string","enum":["email","telegram","unknown"],"title":"Contact Point Type"},"contact_point_value":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Contact Point Value","description":"Populated only on authenticated agreement reads for the relevant identity graph; otherwise null."},"invited_at":{"type":"string","format":"date-time","title":"Invited At"},"confirmed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Confirmed At"},"confirmed_version":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Confirmed Version"},"declined_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Declined At"},"declined_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Declined Reason"},"waived_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Waived At"},"signature_identicon":{"anyOf":[{"$ref":"#/components/schemas/ExternalIdenticonResponse"},{"type":"null"}]}},"type":"object","required":["id","role","display_name","contact_point_type","invited_at","confirmed_at","confirmed_version","declined_at","declined_reason"],"title":"ExternalAgreementPartyResponse"},"ExternalAgreementResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"agr_reference":{"type":"string","title":"Agr Reference"},"type":{"type":"string","enum":["agreement","declaration","witnessed_agreement","notarization"],"title":"Type"},"status":{"type":"string","enum":["draft","pending_confirmation","counter_under_review","sealed","superseded","cancelled_draft","expired","declined","rescinded"],"title":"Status"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"body":{"type":"string","title":"Body"},"body_hash":{"type":"string","title":"Body Hash"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language"},"jurisdiction":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Jurisdiction"},"initiated_via":{"type":"string","title":"Initiated Via"},"current_version":{"type":"integer","title":"Current Version"},"required_signature_method_count":{"type":"integer","enum":[1,2,3],"title":"Required Signature Method Count","description":"Number of distinct signature methods each signer must satisfy before finalization."},"parties":{"items":{"$ref":"#/components/schemas/ExternalAgreementPartyResponse"},"type":"array","title":"Parties"},"active_counter":{"anyOf":[{"$ref":"#/components/schemas/CounterProposalResponse"},{"type":"null"}]},"witness_summary":{"anyOf":[{"$ref":"#/components/schemas/WitnessSummaryResponse"},{"type":"null"}]},"supersedes_agr_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Supersedes Agr Id"},"superseded_by_agr_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Superseded By Agr Id"},"blockchain":{"anyOf":[{"$ref":"#/components/schemas/BlockchainRecordResponse"},{"type":"null"}]},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"},"notarization":{"anyOf":[{"$ref":"#/components/schemas/NotarizationPayloadResponse"},{"type":"null"}]},"llm_analysis":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Llm Analysis"},"initiator_signature":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Initiator Signature"},"ready_for_submission":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Ready For Submission"},"identicon":{"anyOf":[{"$ref":"#/components/schemas/ExternalIdenticonResponse"},{"type":"null"}]},"share_card":{"anyOf":[{"$ref":"#/components/schemas/ExternalShareCardResponse"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","title":"Created At"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"sealed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Sealed At"}},"type":"object","required":["id","agr_reference","type","status","title","body","body_hash","summary","language","jurisdiction","initiated_via","current_version","required_signature_method_count","parties","active_counter","supersedes_agr_id","superseded_by_agr_id","blockchain","metadata","llm_analysis","created_at","expires_at","sealed_at"],"title":"ExternalAgreementResponse"},"ExternalIdenticonResponse":{"properties":{"kind":{"type":"string","enum":["document","signature"],"title":"Kind"},"digest":{"type":"string","title":"Digest"},"short_hash":{"type":"string","title":"Short Hash"},"width":{"type":"integer","title":"Width"},"height":{"type":"integer","title":"Height"},"alt_text":{"type":"string","title":"Alt Text"},"available":{"type":"boolean","title":"Available","default":true},"svg_data_uri":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Svg Data Uri","description":"Compatibility-only SVG data URI. Omitted from normal responses and populated only when compatibility_data_uri is explicitly requested."}},"additionalProperties":false,"type":"object","required":["kind","digest","short_hash","width","height","alt_text"],"title":"ExternalIdenticonResponse"},"ExternalNotarizationResponse":{"properties":{"record":{"$ref":"#/components/schemas/ExternalAgreementResponse"},"signature_execution":{"anyOf":[{"$ref":"#/components/schemas/ExternalSignatureExecutionResponse"},{"type":"null"}]},"next_action":{"anyOf":[{"$ref":"#/components/schemas/NotarizationNextAction"},{"type":"null"}]},"human_step":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Human Step"}},"additionalProperties":false,"type":"object","required":["record"],"title":"ExternalNotarizationResponse"},"ExternalPublicAgreementResponse":{"properties":{"agr_reference":{"type":"string","title":"Agr Reference"},"type":{"type":"string","enum":["agreement","declaration","witnessed_agreement","notarization"],"title":"Type"},"status":{"type":"string","enum":["draft","pending_confirmation","counter_under_review","sealed","superseded","cancelled_draft","expired","declined","rescinded"],"title":"Status"},"sealed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Sealed At"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"party_count":{"type":"integer","title":"Party Count"},"blockchain":{"anyOf":[{"$ref":"#/components/schemas/BlockchainRecordResponse"},{"type":"null"}]},"notarization":{"anyOf":[{"$ref":"#/components/schemas/PublicNotarizationPayloadResponse"},{"type":"null"}]},"identicon":{"anyOf":[{"$ref":"#/components/schemas/ExternalIdenticonResponse"},{"type":"null"}]}},"type":"object","required":["agr_reference","type","status","sealed_at","expires_at","party_count","blockchain"],"title":"ExternalPublicAgreementResponse"},"ExternalShareCardResponse":{"properties":{"filename":{"type":"string","title":"Filename"},"content_type":{"type":"string","title":"Content Type"},"width":{"type":"integer","title":"Width"},"height":{"type":"integer","title":"Height"},"hash":{"type":"string","title":"Hash"},"generated_at":{"type":"string","title":"Generated At"},"available":{"type":"boolean","title":"Available","default":true}},"additionalProperties":false,"type":"object","required":["filename","content_type","width","height","hash","generated_at"],"title":"ExternalShareCardResponse"},"ExternalSignatureExecutionResponse":{"properties":{"session_id":{"type":"string","format":"uuid","title":"Session Id"},"agreement_id":{"type":"string","format":"uuid","title":"Agreement Id"},"agreement_party_id":{"type":"string","format":"uuid","title":"Agreement Party Id"},"actor_contact_point_id":{"type":"string","format":"uuid","title":"Actor Contact Point Id"},"agreement_version":{"type":"integer","title":"Agreement Version"},"channel":{"type":"string","title":"Channel"},"status":{"type":"string","title":"Status"},"required_count":{"type":"integer","title":"Required Count"},"completed_count":{"type":"integer","title":"Completed Count"},"minimum_satisfied":{"type":"boolean","title":"Minimum Satisfied"},"can_finalize":{"type":"boolean","title":"Can Finalize"},"public_party_details_required":{"type":"boolean","title":"Public Party Details Required","default":false},"public_party_details_acknowledgement_required":{"type":"boolean","title":"Public Party Details Acknowledgement Required","default":false},"publication_policy":{"$ref":"#/components/schemas/PublicationPolicy","default":"hash_only"},"publication_policy_acknowledgement_required":{"type":"boolean","title":"Publication Policy Acknowledgement Required","default":false},"finalization_blocker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Finalization Blocker"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"finalized_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Finalized At"},"methods":{"items":{"$ref":"#/components/schemas/SignatureExecutionMethodResponse"},"type":"array","title":"Methods"},"signature_identicon":{"anyOf":[{"$ref":"#/components/schemas/ExternalIdenticonResponse"},{"type":"null"}]}},"type":"object","required":["session_id","agreement_id","agreement_party_id","actor_contact_point_id","agreement_version","channel","status","required_count","completed_count","minimum_satisfied","can_finalize","expires_at","finalized_at","methods"],"title":"ExternalSignatureExecutionResponse"},"ExternalVerificationResultResponse":{"properties":{"verified":{"type":"boolean","title":"Verified"},"record_found":{"type":"boolean","title":"Record Found","default":true},"record_match":{"type":"boolean","title":"Record Match","default":false},"current_authority":{"type":"boolean","title":"Current Authority","default":false},"verdict":{"type":"string","enum":["verified","certificate","matched_superseded","matched_not_sealed","no_match","not_found"],"title":"Verdict","default":"no_match"},"agr_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agr Reference"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"sealed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Sealed At"},"supersedes_agr_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Supersedes Agr Reference"},"superseded_by_agr_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Superseded By Agr Reference"},"submitted_artifact":{"type":"boolean","title":"Submitted Artifact","default":false},"all_submitted_checks_match":{"type":"boolean","title":"All Submitted Checks Match","default":false},"body_hash_match":{"type":"boolean","title":"Body Hash Match"},"content_hash_match":{"type":"boolean","title":"Content Hash Match","default":false},"match_method":{"type":"string","enum":["exact_hash","fingerprint","body_hash","content_hash","document_hash","tx_hash","certificate","none"],"title":"Match Method"},"fingerprint_available":{"type":"boolean","title":"Fingerprint Available"},"fingerprint_match":{"type":"boolean","title":"Fingerprint Match"},"fingerprint_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Fingerprint Score"},"checks":{"anyOf":[{"$ref":"#/components/schemas/VerificationChecksResponse"},{"type":"null"}]},"completion":{"anyOf":[{"$ref":"#/components/schemas/VerificationCompletionResponse"},{"type":"null"}]},"blockchain":{"anyOf":[{"$ref":"#/components/schemas/BlockchainRecordResponse"},{"type":"null"}]},"on_chain_check":{"anyOf":[{"$ref":"#/components/schemas/OnChainCheckResponse"},{"type":"null"}]},"message":{"type":"string","title":"Message"},"identicon":{"anyOf":[{"$ref":"#/components/schemas/ExternalIdenticonResponse"},{"type":"null"}]}},"type":"object","required":["verified","agr_reference","sealed_at","body_hash_match","match_method","fingerprint_available","fingerprint_match","blockchain","message"],"title":"ExternalVerificationResultResponse"},"FinalizeSignatureRequest":{"properties":{"publication_policy_acknowledged":{"type":"boolean","title":"Publication Policy Acknowledged","description":"Required when the selected publication policy will irreversibly publish agreement text or verified-party information.","default":false},"public_party_details_acknowledged":{"type":"boolean","title":"Public Party Details Acknowledged","description":"Required when finalization will publish verified party details in public on-chain metadata.","default":false},"display_name_override":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name Override","description":"Optional signer-supplied display name applied for eligible non-originating signers at finalization."}},"type":"object","title":"FinalizeSignatureRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"LinkContactPointRequest":{"properties":{"new_contact_point_type":{"type":"string","const":"email","title":"New Contact Point Type","description":"New contact-point type to link. Identity linking currently supports email OTP verification."},"new_contact_point_value":{"type":"string","title":"New Contact Point Value","description":"Email address that received the short-lived linking OTP."},"new_contact_point_otp_event_id":{"type":"string","format":"uuid4","title":"New Contact Point Otp Event Id","description":"Verification event identifier returned by the link-contact-point OTP request."},"new_contact_point_otp_code":{"type":"string","title":"New Contact Point Otp Code","description":"Six-digit short-lived OTP code sent to the new contact point."}},"type":"object","required":["new_contact_point_type","new_contact_point_value","new_contact_point_otp_event_id","new_contact_point_otp_code"],"title":"LinkContactPointRequest"},"NamedPartyInput":{"properties":{"contact_point_type":{"type":"string","const":"email","title":"Contact Point Type","description":"The public REST create/update surfaces currently accept email participants only.","default":"email"},"contact_point_value":{"type":"string","minLength":3,"title":"Contact Point Value","description":"Participant email address. It is normalized to lowercase and `+` aliases are rejected."},"display_name":{"type":"string","maxLength":50,"minLength":1,"title":"Display Name","description":"Human-readable participant name shown in invitations, signature flows, and evidence surfaces."}},"type":"object","required":["contact_point_value","display_name"],"title":"NamedPartyInput"},"NotarizationNextAction":{"properties":{"type":{"type":"string","enum":["signature_execution","co_notarizer_signatures_pending"],"title":"Type"},"url":{"type":"string","title":"Url"},"required":{"type":"boolean","title":"Required"},"method":{"anyOf":[{"type":"string","const":"POST"},{"type":"null"}],"title":"Method"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},"additionalProperties":false,"type":"object","required":["type","url","required"],"title":"NotarizationNextAction","description":"Machine-readable pointer to the next REST step after notarization creation."},"NotarizationPayloadResponse":{"properties":{"content_type":{"type":"string","enum":["file","text","hash"],"title":"Content Type"},"hash_algorithm":{"type":"string","const":"sha256","title":"Hash Algorithm","default":"sha256"},"content_hash":{"type":"string","title":"Content Hash","description":"SHA-256 digest of the notarized content, prefixed with `sha256:`."},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label"},"filename":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filename"},"size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Size Bytes"},"mime_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mime Type"},"normalized_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Normalized Text","description":"Normalized notarized text. Present on authenticated reads of text notarizations, and on public reads only when `text_public` is true."},"word_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Word Count"},"character_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Character Count"},"text_public":{"type":"boolean","title":"Text Public","default":false},"agent_identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Identifier"},"signature_mode":{"anyOf":[{"type":"string","enum":["pending_signature","auto_seal"]},{"type":"null"}],"title":"Signature Mode"},"source_metadata_policy":{"anyOf":[{"$ref":"#/components/schemas/NotarizationSourceMetadataPolicy"},{"type":"null"}],"description":"What source metadata Agreebase deliberately excluded."},"auth_context":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Auth Context","description":"Authentication attribution recorded at creation (auth method, contact point, API-key attribution)."}},"type":"object","required":["content_type","content_hash"],"title":"NotarizationPayloadResponse","description":"Full notarization payload for authenticated record responses."},"NotarizationSourceMetadataPolicy":{"properties":{"file_bytes_received":{"type":"boolean","title":"File Bytes Received","default":false},"server_side_file_hashing":{"type":"boolean","title":"Server Side File Hashing","default":false},"excluded_metadata":{"items":{"type":"string"},"type":"array","title":"Excluded Metadata"}},"type":"object","title":"NotarizationSourceMetadataPolicy","description":"Record of what source metadata Agreebase deliberately did not ingest.\n\nHydrated from stored record metadata, so unknown keys from older or newer\npayload revisions are ignored rather than failing reads."},"OTPRequest":{"properties":{"contact_point_type":{"type":"string","const":"email","title":"Contact Point Type","description":"OTP delivery currently supports email contact points only."},"contact_point_value":{"type":"string","title":"Contact Point Value","description":"Email contact point that will receive the short-lived OTP."},"purpose":{"type":"string","enum":["authenticate","confirm_agreement","link_contact_point"],"title":"Purpose","description":"`authenticate` creates a bearer session, `confirm_agreement` supports agreement confirmation, and `link_contact_point` proves control before identity linking."},"agreement_id":{"anyOf":[{"type":"string","format":"uuid4"},{"type":"null"}],"title":"Agreement Id","description":"Agreement identifier for agreement-bound OTP flows. Omit for authentication OTPs."}},"type":"object","required":["contact_point_type","contact_point_value","purpose"],"title":"OTPRequest"},"OTPRequestResponse":{"properties":{"verification_event_id":{"type":"string","format":"uuid","title":"Verification Event Id","description":"Verification event identifier for the OTP ceremony."},"expires_at":{"type":"string","format":"date-time","title":"Expires At","description":"Timestamp when the short-lived OTP expires."},"delivery_method":{"type":"string","const":"email","title":"Delivery Method","description":"Delivery channel used for the OTP."}},"type":"object","required":["verification_event_id","expires_at","delivery_method"],"title":"OTPRequestResponse"},"OTPVerifiedContactPointResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"type":{"type":"string","enum":["email","telegram"],"title":"Type"},"value":{"type":"string","title":"Value"},"value_hash":{"type":"string","title":"Value Hash"},"first_verified_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"First Verified At"},"last_verified_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Verified At"}},"type":"object","required":["id","type","value","value_hash","first_verified_at","last_verified_at"],"title":"OTPVerifiedContactPointResponse"},"OTPVerifyRequest":{"properties":{"verification_event_id":{"type":"string","format":"uuid4","title":"Verification Event Id"},"code":{"type":"string","title":"Code","description":"Six-digit short-lived OTP code from Agreebase."}},"type":"object","required":["verification_event_id","code"],"title":"OTPVerifyRequest"},"OTPVerifyResponse":{"properties":{"token":{"type":"string","title":"Token","description":"Short-lived bearer token returned by successful OTP verification. Use it as `Authorization: Bearer <token>`."},"expires_at":{"type":"string","format":"date-time","title":"Expires At","description":"Timestamp when the bearer token expires."},"contact_point":{"$ref":"#/components/schemas/OTPVerifiedContactPointResponse","description":"Verified contact point resolved by the completed OTP ceremony."}},"type":"object","required":["token","expires_at","contact_point"],"title":"OTPVerifyResponse"},"OnChainCheckResponse":{"properties":{"status":{"type":"string","enum":["match","mismatch","unavailable","not_applicable","error"],"title":"Status"},"tx_hash_match":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Tx Hash Match"},"record_text_hash_match":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Record Text Hash Match"},"message":{"type":"string","title":"Message"}},"type":"object","required":["status","tx_hash_match","record_text_hash_match","message"],"title":"OnChainCheckResponse"},"PublicNotarizationPayloadResponse":{"properties":{"content_type":{"type":"string","enum":["file","text","hash"],"title":"Content Type"},"hash_algorithm":{"type":"string","const":"sha256","title":"Hash Algorithm","default":"sha256"},"content_hash":{"type":"string","title":"Content Hash","description":"SHA-256 digest of the notarized content, prefixed with `sha256:`."},"label":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Label"},"filename":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Filename"},"size_bytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Size Bytes"},"mime_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mime Type"},"normalized_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Normalized Text","description":"Normalized notarized text. Present on authenticated reads of text notarizations, and on public reads only when `text_public` is true."},"word_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Word Count"},"character_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Character Count"},"text_public":{"type":"boolean","title":"Text Public","default":false},"agent_identifier":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agent Identifier"}},"type":"object","required":["content_type","content_hash"],"title":"PublicNotarizationPayloadResponse","description":"Whitelisted notarization payload for public (unauthenticated) responses.\n\nCarries only the advisory fields that `public_notarization_payload`\nexposes; creation attribution and policy fields stay off this model so the\npublic schema cannot name them. Hydrated from stored record metadata, so\nunknown keys from older or newer payload revisions are ignored rather than\nfailing reads; output is always model-driven, so ignored keys can never\nleak into responses."},"PublicationPolicy":{"type":"string","enum":["hash_only","hash_with_verified_parties","full_text","full_text_with_verified_parties"],"title":"PublicationPolicy"},"RefreshSignatureMethodRequest":{"properties":{"finalize_if_ready":{"type":"boolean","title":"Finalize If Ready","description":"When true, immediately attempt finalization after refreshing the method state.","default":false},"public_party_details_acknowledged":{"type":"boolean","title":"Public Party Details Acknowledged","description":"Required before finalization when verified party details will be included in public on-chain metadata.","default":false},"display_name_override":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name Override","description":"Optional signer-supplied display name applied if finalization runs and the signer may override their name."}},"type":"object","title":"RefreshSignatureMethodRequest"},"ResolveCounterRequest":{"properties":{"resolution":{"type":"string","enum":["accepted","partially_accepted","rejected"],"title":"Resolution"},"resolved_body":{"anyOf":[{"type":"string","maxLength":7000,"minLength":10},{"type":"null"}],"title":"Resolved Body"}},"type":"object","required":["resolution"],"title":"ResolveCounterRequest"},"ShareCardTicketResponse":{"properties":{"url":{"type":"string","title":"Url"},"expires_at":{"type":"string","title":"Expires At"},"ttl_seconds":{"type":"integer","title":"Ttl Seconds"},"single_use":{"type":"boolean","const":true,"title":"Single Use","default":true},"filename":{"type":"string","title":"Filename"},"content_type":{"type":"string","title":"Content Type"},"width":{"type":"integer","title":"Width"},"height":{"type":"integer","title":"Height"},"hash":{"type":"string","title":"Hash"},"available":{"type":"boolean","title":"Available","default":true}},"additionalProperties":false,"type":"object","required":["url","expires_at","ttl_seconds","filename","content_type","width","height","hash"],"title":"ShareCardTicketResponse"},"SignatureExecutionMethodResponse":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"method_type":{"type":"string","enum":["email_otp","github_gist","x_post","reddit_post","webauthn_passkey","telegram","api_key"],"title":"Method Type","description":"`email_otp` completes with a short-lived emailed code. `github_gist`, `x_post`, and `reddit_post` complete with public proof URLs. `webauthn_passkey` completes with WebAuthn payload data. `telegram` completes through the Telegram challenge flow. `api_key` is restricted evidence created only by explicit notarization auto-seal flows."},"status":{"type":"string","title":"Status"},"started_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Started At"},"verified_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Verified At"},"cancelled_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Cancelled At"},"public_evidence_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Public Evidence Url"},"public_handle":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Public Handle"},"public_post_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Public Post Id"},"verification_event_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Verification Event Id"},"evidence_payload":{"additionalProperties":true,"type":"object","title":"Evidence Payload"},"proof_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Proof Text","description":"Exact public proof text to post when using GitHub, X, or Reddit proof methods."},"proof_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Proof Title","description":"Exact Reddit post title when the selected proof method requires one."},"proof_expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Proof Expires At","description":"Expiry timestamp for generated public-proof text or challenge material."},"challenge_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Challenge Token"},"submitted_value":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Submitted Value"},"is_required":{"type":"boolean","title":"Is Required","default":false},"can_start":{"type":"boolean","title":"Can Start","default":true},"can_submit":{"type":"boolean","title":"Can Submit","default":false},"can_refresh":{"type":"boolean","title":"Can Refresh","default":false},"can_cancel":{"type":"boolean","title":"Can Cancel","default":false},"available":{"type":"boolean","title":"Available","default":true},"unavailable_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Unavailable Reason"}},"type":"object","required":["id","method_type","status","started_at","verified_at","cancelled_at"],"title":"SignatureExecutionMethodResponse"},"StartSignatureMethodRequest":{"properties":{"input_value":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Input Value","description":"Method-specific input. Use a public proof URL for GitHub, X, or Reddit methods. Leave null for email OTP start."},"finalize_if_ready":{"type":"boolean","title":"Finalize If Ready","description":"When true, immediately attempt finalization after starting the method.","default":false},"public_party_details_acknowledged":{"type":"boolean","title":"Public Party Details Acknowledged","description":"Required before finalization when verified party details will be included in public on-chain metadata.","default":false},"display_name_override":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name Override","description":"Optional signer-supplied display name applied if finalization runs and the signer may override their name."}},"type":"object","title":"StartSignatureMethodRequest"},"SubmitCounterRequest":{"properties":{"raw_input":{"type":"string","maxLength":500,"minLength":10,"title":"Raw Input"},"assisted_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assisted Text"},"proposed_body":{"type":"string","maxLength":7000,"minLength":10,"title":"Proposed Body"},"diff_summary":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Diff Summary"}},"type":"object","required":["raw_input","proposed_body"],"title":"SubmitCounterRequest"},"SubmitSignatureMethodRequest":{"properties":{"code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code","description":"Six-digit short-lived OTP code when submitting the `email_otp` signature method."},"input_value":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Input Value","description":"Method-specific submitted value, usually the resulting public proof URL."},"payload":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Payload","description":"Structured method payload, such as a WebAuthn response object."},"finalize_if_ready":{"type":"boolean","title":"Finalize If Ready","description":"When true, immediately attempt finalization after evidence submission.","default":false},"public_party_details_acknowledged":{"type":"boolean","title":"Public Party Details Acknowledged","description":"Required before finalization when verified party details will be included in public on-chain metadata.","default":false},"display_name_override":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name Override","description":"Optional signer-supplied display name applied if finalization runs and the signer may override their name."}},"type":"object","title":"SubmitSignatureMethodRequest"},"UpdateAgreementRequest":{"properties":{"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"summary":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Summary"},"body":{"anyOf":[{"type":"string","maxLength":7000},{"type":"null"}],"title":"Body"},"jurisdiction":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Jurisdiction"},"parties":{"anyOf":[{"items":{"$ref":"#/components/schemas/NamedPartyInput"},"type":"array","maxItems":14},{"type":"null"}],"title":"Parties","description":"Replacement list of non-initiator signing parties. Agreements can have at most 15 signing participants total, including the initiator, so at most 14 non-initiator parties may be supplied."},"witnesses":{"anyOf":[{"items":{"$ref":"#/components/schemas/NamedPartyInput"},"type":"array","maxItems":5},{"type":"null"}],"title":"Witnesses","description":"Replacement list of witness participants. At most 5 active witnesses may be supplied."},"on_chain_full_text":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"On Chain Full Text","description":"When true, the reconstructed sealed record text is published on chain instead of a hash-only record."},"on_chain_include_verified_parties":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"On Chain Include Verified Parties","description":"When true, verified signer or witness details are included in the on-chain sealed metadata."},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"},"required_signature_method_count":{"anyOf":[{"type":"integer","enum":[1,2,3]},{"type":"null"}],"title":"Required Signature Method Count","description":"Number of distinct signature methods required before a signer may finalize."}},"type":"object","title":"UpdateAgreementRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VerificationCheckResponse":{"properties":{"provided":{"type":"boolean","title":"Provided"},"available":{"type":"boolean","title":"Available"},"match":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Match"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Score"}},"type":"object","required":["provided","available","match"],"title":"VerificationCheckResponse"},"VerificationChecksResponse":{"properties":{"text_exact":{"$ref":"#/components/schemas/VerificationCheckResponse"},"fingerprint":{"$ref":"#/components/schemas/VerificationCheckResponse"},"body_hash":{"$ref":"#/components/schemas/VerificationCheckResponse"},"content_hash":{"$ref":"#/components/schemas/VerificationCheckResponse"},"document_hash":{"$ref":"#/components/schemas/VerificationCheckResponse"},"tx_hash":{"$ref":"#/components/schemas/VerificationCheckResponse"}},"type":"object","required":["text_exact","fingerprint","body_hash","content_hash","document_hash","tx_hash"],"title":"VerificationChecksResponse"},"VerificationCompletionResponse":{"properties":{"sealed":{"type":"boolean","title":"Sealed"},"completed_at":{"type":"string","format":"date-time","title":"Completed At"},"completed_declarant_count":{"type":"integer","title":"Completed Declarant Count"},"completed_signatory_count":{"type":"integer","title":"Completed Signatory Count"},"completed_witness_count":{"type":"integer","title":"Completed Witness Count"},"signature_method_requirement":{"type":"integer","title":"Signature Method Requirement"}},"type":"object","required":["sealed","completed_at","completed_declarant_count","completed_signatory_count","completed_witness_count","signature_method_requirement"],"title":"VerificationCompletionResponse"},"VerifyBodyRequest":{"properties":{"body":{"anyOf":[{"type":"string","minLength":1},{"type":"null"}],"title":"Body","description":"Exact agreement text to compare against the sealed record."},"body_hash":{"anyOf":[{"type":"string","maxLength":80,"minLength":1},{"type":"null"}],"title":"Body Hash","description":"Precomputed body hash to compare against the sealed record."},"content_hash":{"anyOf":[{"type":"string","maxLength":80,"minLength":1},{"type":"null"}],"title":"Content Hash","description":"Precomputed content hash for notarization verification."},"document_hash":{"anyOf":[{"type":"string","maxLength":80,"minLength":1},{"type":"null"}],"title":"Document Hash","description":"Signed document hash to compare against the sealed signed-PDF artifact."},"tx_hash":{"anyOf":[{"type":"string","maxLength":80,"minLength":3},{"type":"null"}],"title":"Tx Hash","description":"Blockchain transaction hash to compare against the stored sealing transaction."}},"type":"object","title":"VerifyBodyRequest"},"WitnessSummaryResponse":{"properties":{"has_witnesses":{"type":"boolean","title":"Has Witnesses"},"pending_count":{"type":"integer","title":"Pending Count"},"confirmed_count":{"type":"integer","title":"Confirmed Count"},"declined_count":{"type":"integer","title":"Declined Count"}},"type":"object","required":["has_witnesses","pending_count","confirmed_count","declined_count"],"title":"WitnessSummaryResponse"}},"securitySchemes":{"BearerToken":{"type":"http","description":"Short-lived token returned by OTP verification.","scheme":"bearer"},"APIKey":{"type":"apiKey","description":"API key returned once by `POST /api/v1/api-keys`.","in":"header","name":"X-API-Key"}}}}