{"openapi":"3.1.0","info":{"title":"x402-signature-service","description":"Send one PDF to one email recipient for simple electronic signature. The service emails the signer, tracks completion, and returns the completed signed PDF. Give an AI agent the missing capability to get human sign-off: submit a contract, NDA or agreement by URL or base64, the recipient signs in the browser (powered by Documenso), and the agent polls a status URL with a one-time bearer token until the signed document is ready for download. Simple electronic signatures (SES) only — no QES/AES, no identity verification, no legal advice. Documents are processed in memory; signer emails are masked in logs.\n\n**Disclaimer:** This MVP facilitates simple electronic signatures through the configured signature provider. Users are responsible for determining whether this signature type is appropriate for their document, jurisdiction, and use case.","contact":{"name":"Paulos / Voiceagenten","email":"paulos@voiceagenten.com"},"version":"1.0.0"},"paths":{"/v1/signature-requests":{"post":{"summary":"Create Signature Request","operationId":"create_signature_request_v1_signature_requests_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}}],"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/signature-requests/{record_id}":{"get":{"summary":"Get Signature Request","operationId":"get_signature_request_v1_signature_requests__record_id__get","parameters":[{"name":"record_id","in":"path","required":true,"schema":{"type":"string","title":"Record Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/signature-requests/{record_id}/document":{"get":{"summary":"Download Signed Document","operationId":"download_signed_document_v1_signature_requests__record_id__document_get","parameters":[{"name":"record_id","in":"path","required":true,"schema":{"type":"string","title":"Record Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/webhooks/documenso":{"post":{"summary":"Documenso Webhook","operationId":"documenso_webhook_webhooks_documenso_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health Health Get"}}}}}}},"/v1/schema":{"get":{"summary":"Schema","description":"Frei abrufbares Schema — erleichtert Agenten die Integration ohne Zahlung.","operationId":"schema_v1_schema_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Schema V1 Schema Get"}}}}}}},"/agent-tool.json":{"get":{"summary":"Agent Tool","description":"LLM-Tool-Definition (JSON-Schema) fuer Tool-Calling-Agenten.","operationId":"agent_tool_agent_tool_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Agent Tool Agent Tool Json Get"}}}}}}},"/":{"get":{"summary":"Landing","operationId":"landing__get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"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"}}}}