{"openapi":"3.1.0","info":{"title":"Signmos Agent API","version":"1.0.0","description":"Bearer-authenticated personal document automation for Signmos."},"paths":{"/api/v1/commands/{commandId}":{"get":{"operationId":"getAgentCommandStatus","summary":"Poll a human-review command created by this exact personal token","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Pending or terminal human-review command status","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","anyOf":[{"type":"object","properties":{"data":{"type":"object","properties":{"commandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","const":"pending_human_review"},"reviewUrl":{"type":"string","format":"uri"},"statusUrl":{"type":"string","format":"uri"},"expiresAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"notificationStatus":{"type":"string","enum":["sent","fallback","failed"]}},"required":["commandId","status","reviewUrl","statusUrl","expiresAt","notificationStatus"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},{"type":"object","properties":{"data":{"type":"object","properties":{"commandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","enum":["completed","rejected","expired","invalidated","failed"]},"notificationStatus":{"type":"string","enum":["sent","fallback","failed"]},"result":{},"error":{"type":"object","properties":{"code":{"type":"string","enum":["HUMAN_REVIEW_REJECTED","HUMAN_REVIEW_EXPIRED","HUMAN_REVIEW_INVALIDATED","HUMAN_REVIEW_EXECUTION_FAILED"]},"message":{"type":"string"},"retryable":{"type":"boolean","const":false},"recoveryUrl":{"type":"string"}},"required":["code","message","retryable","recoveryUrl"],"additionalProperties":false}},"required":["commandId","status","notificationStatus"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}]}}}},"401":{"description":"Missing, revoked, or invalid Bearer token","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"AGENTIC_TOKEN_REQUIRED"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Measured per-token or defensive per-IP request limit exceeded","headers":{"RateLimit-Limit":{"description":"Active fixed-window request limit","schema":{"type":"integer","minimum":0}},"RateLimit-Remaining":{"description":"Requests remaining in the active window","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"UTC epoch seconds when the active window resets","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}},"parameters":[{"name":"commandId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}]}},"/api/v1/me":{"get":{"operationId":"getAgentIdentity","summary":"Resolve the current verified Agentic identity","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Authenticated identity and safe token metadata","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"principal":{"type":"object","properties":{"email":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"actorType":{"type":"string","const":"agent"}},"required":["email","actorType"],"additionalProperties":false},"token":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string","minLength":1},"hint":{"type":"string","minLength":1},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"lastUsedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["id","name","hint","createdAt","lastUsedAt"],"additionalProperties":false}},"required":["principal","token"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"401":{"description":"Missing, revoked, or invalid Bearer token","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"AGENTIC_TOKEN_REQUIRED"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Measured per-token or defensive per-IP request limit exceeded","headers":{"RateLimit-Limit":{"description":"Active fixed-window request limit","schema":{"type":"integer","minimum":0}},"RateLimit-Remaining":{"description":"Requests remaining in the active window","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"UTC epoch seconds when the active window resets","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/api/v1/documents":{"get":{"operationId":"listAgentDocuments","summary":"List retained documents available to the verified identity","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Role-aware, action-first document catalog","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"identity":{"type":"object","properties":{"email":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}},"required":["email"],"additionalProperties":false},"documents":{"type":"array","items":{"type":"object","properties":{"documentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"title":{"type":"string"},"shortReference":{"type":"string"},"status":{"type":"string","enum":["awaiting_verification","draft","changes_requested","sent","completed","declined","expired","deleted"]},"group":{"type":"string","enum":["drafts","needs_my_action","waiting_on_others","completed","closed"]},"role":{"type":"string","enum":["creator","signer","creator_and_signer"]},"participants":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"email":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"role":{"type":"string","enum":["creator","signer"]}},"required":["name","email","role"],"additionalProperties":false}},"allowedActions":{"type":"array","items":{"type":"string","enum":["resume","sign","review","view_completed","download_final_pdf","cancel","delete"]}},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"activityAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"urls":{"type":"object","properties":{"detail":{"type":"string"},"status":{"type":"string"},"history":{"type":"string"},"finalPdf":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["detail","status","history","finalPdf"],"additionalProperties":false}},"required":["documentId","title","shortReference","status","group","role","participants","allowedActions","createdAt","activityAt","urls"],"additionalProperties":false}},"pagination":{"type":"object","properties":{"page":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"pageSize":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"totalItems":{"type":"integer","minimum":0,"maximum":9007199254740991},"totalPages":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["page","pageSize","totalItems","totalPages"],"additionalProperties":false}},"required":["identity","documents","pagination"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Invalid query","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing, revoked, or invalid Bearer token","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"AGENTIC_TOKEN_REQUIRED"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Document is not visible to this identity","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Final PDF is not ready","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Measured per-token or defensive per-IP request limit exceeded","headers":{"RateLimit-Limit":{"description":"Active fixed-window request limit","schema":{"type":"integer","minimum":0}},"RateLimit-Remaining":{"description":"Requests remaining in the active window","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"UTC epoch seconds when the active window resets","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"502":{"description":"Configured delivery provider rejected the request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"503":{"description":"Final PDF object is temporarily unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}},"parameters":[{"name":"search","in":"query","required":false,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","maxLength":200}},{"name":"role","in":"query","required":false,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["creator","signer","creator_and_signer"]}},{"name":"group","in":"query","required":false,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["drafts","needs_my_action","waiting_on_others","completed","closed"]}},{"name":"status","in":"query","required":false,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","enum":["awaiting_verification","draft","changes_requested","sent","completed","declined","expired"]}},{"name":"page","in":"query","required":false,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}}]},"post":{"operationId":"createAgentSelfSignDocument","summary":"Create a verified self-sign draft","security":[{"bearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"signingMode":{"default":"only_me","type":"string","enum":["only_me","me_and_another_signer"]}},"required":["name","signingMode"],"additionalProperties":false}}}},"responses":{"201":{"description":"Command completed or exact result replayed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"documentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","const":"draft"},"signingMode":{"type":"string","enum":["only_me","me_and_another_signer"]},"sender":{"type":"object","properties":{"name":{"type":"string"},"email":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}},"required":["name","email"],"additionalProperties":false},"allowedActions":{"type":"array","items":{"type":"string"}}},"required":["documentId","status","signingMode","sender","allowedActions"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Invalid query","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing, revoked, or invalid Bearer token","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"AGENTIC_TOKEN_REQUIRED"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Document is not visible to this identity","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Final PDF is not ready","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Measured per-token or defensive per-IP request limit exceeded","headers":{"RateLimit-Limit":{"description":"Active fixed-window request limit","schema":{"type":"integer","minimum":0}},"RateLimit-Remaining":{"description":"Requests remaining in the active window","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"UTC epoch seconds when the active window resets","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"502":{"description":"Configured delivery provider rejected the request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"503":{"description":"Final PDF object is temporarily unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/api/v1/documents/{documentId}":{"get":{"operationId":"getAgentDocument","summary":"Inspect authorized document detail","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Lifecycle, role, retention, actions, and public history","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"document":{"type":"object","properties":{"documentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"title":{"type":"string"},"shortReference":{"type":"string"},"status":{"type":"string","enum":["awaiting_verification","draft","changes_requested","sent","completed","declined","expired","deleted"]},"group":{"type":"string","enum":["drafts","needs_my_action","waiting_on_others","completed","closed"]},"role":{"type":"string","enum":["creator","signer","creator_and_signer"]},"participants":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"email":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"role":{"type":"string","enum":["creator","signer"]}},"required":["name","email","role"],"additionalProperties":false}},"allowedActions":{"type":"array","items":{"type":"string","enum":["resume","sign","review","view_completed","download_final_pdf","cancel","delete"]}},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"activityAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"urls":{"type":"object","properties":{"detail":{"type":"string"},"status":{"type":"string"},"history":{"type":"string"},"finalPdf":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["detail","status","history","finalPdf"],"additionalProperties":false}},"required":["documentId","title","shortReference","status","group","role","participants","allowedActions","createdAt","activityAt","urls"],"additionalProperties":false},"retention":{"type":"object","properties":{"status":{"type":"string","enum":["awaiting_verification","draft","changes_requested","sent","completed","declined","expired","deleted"]},"eligibleAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"eligible":{"type":"boolean"}},"required":["status","eligibleAt","eligible"],"additionalProperties":false},"history":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}]},"occurredAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["type","title","detail","occurredAt"],"additionalProperties":false}},"finalPdf":{"anyOf":[{"type":"object","properties":{"contentType":{"type":"string","const":"application/pdf"},"byteSize":{"type":"integer","minimum":0,"maximum":9007199254740991},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"createdAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]}},"required":["contentType","byteSize","sha256","createdAt"],"additionalProperties":false},{"type":"null"}]}},"required":["document","retention","history","finalPdf"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Invalid query","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing, revoked, or invalid Bearer token","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"AGENTIC_TOKEN_REQUIRED"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Document is not visible to this identity","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Final PDF is not ready","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Measured per-token or defensive per-IP request limit exceeded","headers":{"RateLimit-Limit":{"description":"Active fixed-window request limit","schema":{"type":"integer","minimum":0}},"RateLimit-Remaining":{"description":"Requests remaining in the active window","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"UTC epoch seconds when the active window resets","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"502":{"description":"Configured delivery provider rejected the request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"503":{"description":"Final PDF object is temporarily unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}},"parameters":[{"name":"documentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}]}},"/api/v1/documents/{documentId}/status":{"get":{"operationId":"getAgentDocumentStatus","summary":"Poll authorized document lifecycle status","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Current status and server-derived allowed actions","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"documentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","enum":["awaiting_verification","draft","changes_requested","sent","completed","declined","expired","deleted"]},"group":{"type":"string","enum":["drafts","needs_my_action","waiting_on_others","completed","closed"]},"role":{"type":"string","enum":["creator","signer","creator_and_signer"]},"allowedActions":{"type":"array","items":{"type":"string","enum":["resume","sign","review","view_completed","download_final_pdf","cancel","delete"]}},"finalPdfAvailable":{"type":"boolean"},"participants":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"email":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"role":{"type":"string","enum":["creator","signer"]},"status":{"type":"string","enum":["pending","sent","completed","declined"]}},"required":["name","email","role","status"],"additionalProperties":false}},"retention":{"type":"object","properties":{"status":{"type":"string","enum":["awaiting_verification","draft","changes_requested","sent","completed","declined","expired","deleted"]},"eligibleAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"eligible":{"type":"boolean"}},"required":["status","eligibleAt","eligible"],"additionalProperties":false}},"required":["documentId","status","group","role","allowedActions","finalPdfAvailable","participants","retention"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Invalid query","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing, revoked, or invalid Bearer token","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"AGENTIC_TOKEN_REQUIRED"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Document is not visible to this identity","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Final PDF is not ready","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Measured per-token or defensive per-IP request limit exceeded","headers":{"RateLimit-Limit":{"description":"Active fixed-window request limit","schema":{"type":"integer","minimum":0}},"RateLimit-Remaining":{"description":"Requests remaining in the active window","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"UTC epoch seconds when the active window resets","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"502":{"description":"Configured delivery provider rejected the request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"503":{"description":"Final PDF object is temporarily unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}},"parameters":[{"name":"documentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}]}},"/api/v1/documents/{documentId}/history":{"get":{"operationId":"getAgentDocumentHistory","summary":"Read authorized user-facing document history","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Public lifecycle history without internal security events","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"documentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"history":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}]},"occurredAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"}},"required":["type","title","detail","occurredAt"],"additionalProperties":false}}},"required":["documentId","history"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Invalid query","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing, revoked, or invalid Bearer token","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"AGENTIC_TOKEN_REQUIRED"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Document is not visible to this identity","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Final PDF is not ready","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Measured per-token or defensive per-IP request limit exceeded","headers":{"RateLimit-Limit":{"description":"Active fixed-window request limit","schema":{"type":"integer","minimum":0}},"RateLimit-Remaining":{"description":"Requests remaining in the active window","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"UTC epoch seconds when the active window resets","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"502":{"description":"Configured delivery provider rejected the request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"503":{"description":"Final PDF object is temporarily unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}},"parameters":[{"name":"documentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}]}},"/api/v1/documents/{documentId}/pdf":{"get":{"operationId":"downloadAgentFinalPdf","summary":"Download an authorized completed final PDF","security":[{"bearerAuth":[]}],"parameters":[{"name":"documentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Final PDF bytes","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Invalid query","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing, revoked, or invalid Bearer token","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"AGENTIC_TOKEN_REQUIRED"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Document is not visible to this identity","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Final PDF is not ready","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Measured per-token or defensive per-IP request limit exceeded","headers":{"RateLimit-Limit":{"description":"Active fixed-window request limit","schema":{"type":"integer","minimum":0}},"RateLimit-Remaining":{"description":"Requests remaining in the active window","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"UTC epoch seconds when the active window resets","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"502":{"description":"Configured delivery provider rejected the request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"503":{"description":"Final PDF object is temporarily unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/api/v1/documents/{documentId}/source-pdf":{"put":{"operationId":"uploadAgentSourcePdf","summary":"Upload an initial or revised creator-owned source PDF","security":[{"bearerAuth":[]}],"parameters":[{"name":"documentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Source-Filename","in":"header","required":false,"schema":{"type":"string","maxLength":255}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}}],"requestBody":{"required":true,"content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"responses":{"201":{"description":"Command completed or exact result replayed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"documentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"byteSize":{"type":"integer","minimum":0,"maximum":9007199254740991},"contentType":{"type":"string","const":"application/pdf"},"originalFilename":{"type":"string"},"uploadedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"downloadUrl":{"type":"string"}},"required":["documentId","version","sha256","byteSize","contentType","originalFilename","uploadedAt","downloadUrl"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Invalid query","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing, revoked, or invalid Bearer token","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"AGENTIC_TOKEN_REQUIRED"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Document is not visible to this identity","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Final PDF is not ready","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Measured per-token or defensive per-IP request limit exceeded","headers":{"RateLimit-Limit":{"description":"Active fixed-window request limit","schema":{"type":"integer","minimum":0}},"RateLimit-Remaining":{"description":"Requests remaining in the active window","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"UTC epoch seconds when the active window resets","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"502":{"description":"Configured delivery provider rejected the request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"503":{"description":"Final PDF object is temporarily unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}},"get":{"operationId":"getAgentSourcePdf","summary":"Inspect the authorized current source PDF metadata","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Current source PDF metadata and preparation URL","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"documentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"byteSize":{"type":"integer","minimum":0,"maximum":9007199254740991},"contentType":{"type":"string","const":"application/pdf"},"originalFilename":{"type":"string"},"uploadedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"downloadUrl":{"type":"string"}},"required":["documentId","version","sha256","byteSize","contentType","originalFilename","uploadedAt","downloadUrl"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Invalid query","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing, revoked, or invalid Bearer token","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"AGENTIC_TOKEN_REQUIRED"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Document is not visible to this identity","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Final PDF is not ready","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Measured per-token or defensive per-IP request limit exceeded","headers":{"RateLimit-Limit":{"description":"Active fixed-window request limit","schema":{"type":"integer","minimum":0}},"RateLimit-Remaining":{"description":"Requests remaining in the active window","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"UTC epoch seconds when the active window resets","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"502":{"description":"Configured delivery provider rejected the request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"503":{"description":"Final PDF object is temporarily unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}},"parameters":[{"name":"documentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}]}},"/api/v1/documents/{documentId}/source-pdf/content":{"get":{"operationId":"downloadAgentSourcePdf","summary":"Download the authorized source PDF for preparation","security":[{"bearerAuth":[]}],"parameters":[{"name":"documentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"PDF bytes","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Invalid query","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing, revoked, or invalid Bearer token","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"AGENTIC_TOKEN_REQUIRED"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Document is not visible to this identity","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Final PDF is not ready","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Measured per-token or defensive per-IP request limit exceeded","headers":{"RateLimit-Limit":{"description":"Active fixed-window request limit","schema":{"type":"integer","minimum":0}},"RateLimit-Remaining":{"description":"Requests remaining in the active window","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"UTC epoch seconds when the active window resets","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"502":{"description":"Configured delivery provider rejected the request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"503":{"description":"Final PDF object is temporarily unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/api/v1/documents/{documentId}/signature-profiles":{"post":{"operationId":"createAgentSignatureProfile","summary":"Save a reusable typed or drawn signature with explicit consent","security":[{"bearerAuth":[]}],"parameters":[{"name":"documentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"profile":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"drawn"},"label":{"type":"string","minLength":1,"maxLength":120},"svgPath":{"type":"string","minLength":1},"selected":{"default":true,"type":"boolean"}},"required":["kind","label","svgPath","selected"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"typed"},"label":{"type":"string","minLength":1,"maxLength":120},"typedText":{"type":"string","minLength":1,"maxLength":120},"typedFont":{"default":"serif","type":"string","minLength":1,"maxLength":80},"selected":{"default":true,"type":"boolean"}},"required":["kind","label","typedText","typedFont","selected"],"additionalProperties":false}]},"rememberSignature":{"type":"boolean","const":true}},"required":["profile","rememberSignature"],"additionalProperties":false}}}},"responses":{"201":{"description":"Command completed or exact result replayed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"envelopeId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"createdBy":{"type":"string","minLength":1},"kind":{"type":"string","enum":["drawn","typed"]},"label":{"type":"string","minLength":1},"svgPath":{"anyOf":[{"type":"string"},{"type":"null"}]},"typedText":{"anyOf":[{"type":"string"},{"type":"null"}]},"typedFont":{"anyOf":[{"type":"string"},{"type":"null"}]},"selected":{"type":"boolean"},"createdAt":{"type":"string"}},"required":["id","envelopeId","createdBy","kind","label","svgPath","typedText","typedFont","selected","createdAt"],"additionalProperties":false},{"type":"null"}]}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Invalid query","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing, revoked, or invalid Bearer token","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"AGENTIC_TOKEN_REQUIRED"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Document is not visible to this identity","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Final PDF is not ready","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Measured per-token or defensive per-IP request limit exceeded","headers":{"RateLimit-Limit":{"description":"Active fixed-window request limit","schema":{"type":"integer","minimum":0}},"RateLimit-Remaining":{"description":"Requests remaining in the active window","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"UTC epoch seconds when the active window resets","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"502":{"description":"Configured delivery provider rejected the request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"503":{"description":"Final PDF object is temporarily unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/api/v1/documents/{documentId}/signature-profiles/selected":{"get":{"operationId":"getAgentSelectedSignatureProfile","summary":"Read the latest selected signature for this verified identity","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Selected signature profile or null","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"envelopeId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"createdBy":{"type":"string","minLength":1},"kind":{"type":"string","enum":["drawn","typed"]},"label":{"type":"string","minLength":1},"svgPath":{"anyOf":[{"type":"string"},{"type":"null"}]},"typedText":{"anyOf":[{"type":"string"},{"type":"null"}]},"typedFont":{"anyOf":[{"type":"string"},{"type":"null"}]},"selected":{"type":"boolean"},"createdAt":{"type":"string"}},"required":["id","envelopeId","createdBy","kind","label","svgPath","typedText","typedFont","selected","createdAt"],"additionalProperties":false},{"type":"null"}]}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Invalid query","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing, revoked, or invalid Bearer token","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"AGENTIC_TOKEN_REQUIRED"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Document is not visible to this identity","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Final PDF is not ready","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Measured per-token or defensive per-IP request limit exceeded","headers":{"RateLimit-Limit":{"description":"Active fixed-window request limit","schema":{"type":"integer","minimum":0}},"RateLimit-Remaining":{"description":"Requests remaining in the active window","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"UTC epoch seconds when the active window resets","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"502":{"description":"Configured delivery provider rejected the request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"503":{"description":"Final PDF object is temporarily unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}},"parameters":[{"name":"documentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}]}},"/api/v1/documents/{documentId}/fields":{"get":{"operationId":"listAgentFields","summary":"List creator-managed document fields","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Current safe field assignments and geometry","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"envelopeId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"recipientId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string","enum":["signature","date"]},"page":{"type":"integer","minimum":1,"maximum":9007199254740991},"x":{"type":"integer","minimum":0,"maximum":9007199254740991},"y":{"type":"integer","minimum":0,"maximum":9007199254740991},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"createdAt":{"type":"string"}},"required":["id","envelopeId","recipientId","type","page","x","y","width","height","createdAt"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Invalid query","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing, revoked, or invalid Bearer token","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"AGENTIC_TOKEN_REQUIRED"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Document is not visible to this identity","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Final PDF is not ready","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Measured per-token or defensive per-IP request limit exceeded","headers":{"RateLimit-Limit":{"description":"Active fixed-window request limit","schema":{"type":"integer","minimum":0}},"RateLimit-Remaining":{"description":"Requests remaining in the active window","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"UTC epoch seconds when the active window resets","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"502":{"description":"Configured delivery provider rejected the request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"503":{"description":"Final PDF object is temporarily unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}},"parameters":[{"name":"documentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}]},"post":{"operationId":"placeAgentFields","summary":"Place explicit self-sign signature/date fields","security":[{"bearerAuth":[]}],"parameters":[{"name":"documentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"fields":{"minItems":1,"type":"array","items":{"type":"object","properties":{"recipientId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string","enum":["signature","date"]},"page":{"type":"integer","minimum":1,"maximum":9007199254740991},"x":{"type":"integer","minimum":0,"maximum":9007199254740991},"y":{"type":"integer","minimum":0,"maximum":9007199254740991},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["type","page","x","y","width","height"],"additionalProperties":false}}},"required":["fields"],"additionalProperties":false}}}},"responses":{"201":{"description":"Command completed or exact result replayed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"documentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","enum":["draft","sent"]},"fields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"envelopeId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"recipientId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string","enum":["signature","date"]},"page":{"type":"integer","minimum":1,"maximum":9007199254740991},"x":{"type":"integer","minimum":0,"maximum":9007199254740991},"y":{"type":"integer","minimum":0,"maximum":9007199254740991},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"createdAt":{"type":"string"}},"required":["id","envelopeId","recipientId","type","page","x","y","width","height","createdAt"],"additionalProperties":false}}},"required":["documentId","status","fields"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Invalid query","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing, revoked, or invalid Bearer token","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"AGENTIC_TOKEN_REQUIRED"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Document is not visible to this identity","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Final PDF is not ready","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Measured per-token or defensive per-IP request limit exceeded","headers":{"RateLimit-Limit":{"description":"Active fixed-window request limit","schema":{"type":"integer","minimum":0}},"RateLimit-Remaining":{"description":"Requests remaining in the active window","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"UTC epoch seconds when the active window resets","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"502":{"description":"Configured delivery provider rejected the request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"503":{"description":"Final PDF object is temporarily unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/api/v1/documents/{documentId}/fields/defaults":{"post":{"operationId":"placeAgentDefaultFields","summary":"Place default self-sign signature/date fields","security":[{"bearerAuth":[]}],"parameters":[{"name":"documentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"recipientIds":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"page":{"default":1,"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["page"],"additionalProperties":false}}}},"responses":{"201":{"description":"Command completed or exact result replayed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"documentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","enum":["draft","sent"]},"fields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"envelopeId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"recipientId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string","enum":["signature","date"]},"page":{"type":"integer","minimum":1,"maximum":9007199254740991},"x":{"type":"integer","minimum":0,"maximum":9007199254740991},"y":{"type":"integer","minimum":0,"maximum":9007199254740991},"width":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"height":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"createdAt":{"type":"string"}},"required":["id","envelopeId","recipientId","type","page","x","y","width","height","createdAt"],"additionalProperties":false}}},"required":["documentId","status","fields"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Invalid query","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing, revoked, or invalid Bearer token","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"AGENTIC_TOKEN_REQUIRED"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Document is not visible to this identity","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Final PDF is not ready","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Measured per-token or defensive per-IP request limit exceeded","headers":{"RateLimit-Limit":{"description":"Active fixed-window request limit","schema":{"type":"integer","minimum":0}},"RateLimit-Remaining":{"description":"Requests remaining in the active window","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"UTC epoch seconds when the active window resets","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"502":{"description":"Configured delivery provider rejected the request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"503":{"description":"Final PDF object is temporarily unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/api/v1/documents/{documentId}/signing-task":{"get":{"operationId":"getAgentSigningTask","summary":"Review the Bearer-authorized self-signing task","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Assigned source, fields, and selected signature","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"envelopeId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"recipientId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"signingMode":{"type":"string","enum":["only_me","me_and_another_signer"]},"sourceDocument":{"type":"object","properties":{"version":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"contentType":{"type":"string","const":"application/pdf"},"downloadUrl":{"type":"string","minLength":1}},"required":["version","contentType","downloadUrl"],"additionalProperties":false},"fields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string","enum":["signature","date"]},"page":{"type":"number"},"x":{"type":"number"},"y":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"}},"required":["id","type","page","x","y","width","height"],"additionalProperties":false}},"previewFields":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string","enum":["signature","date"]},"page":{"type":"number"},"x":{"type":"number"},"y":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"},"recipientId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"recipientName":{"type":"string","minLength":1},"value":{"anyOf":[{"type":"string"},{"type":"null"}]},"assignedToCurrentSigner":{"type":"boolean"}},"required":["id","type","page","x","y","width","height","recipientId","recipientName","value","assignedToCurrentSigner"],"additionalProperties":false}},"signaturePreference":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"envelopeId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"createdBy":{"type":"string","minLength":1},"kind":{"type":"string","enum":["drawn","typed"]},"label":{"type":"string","minLength":1},"svgPath":{"anyOf":[{"type":"string"},{"type":"null"}]},"typedText":{"anyOf":[{"type":"string"},{"type":"null"}]},"typedFont":{"anyOf":[{"type":"string"},{"type":"null"}]},"selected":{"type":"boolean"},"createdAt":{"type":"string"}},"required":["id","envelopeId","createdBy","kind","label","svgPath","typedText","typedFont","selected","createdAt"],"additionalProperties":false},{"type":"null"}]}},"required":["envelopeId","recipientId","signingMode","sourceDocument","fields","previewFields","signaturePreference"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Invalid query","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing, revoked, or invalid Bearer token","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"AGENTIC_TOKEN_REQUIRED"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Document is not visible to this identity","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Final PDF is not ready","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Measured per-token or defensive per-IP request limit exceeded","headers":{"RateLimit-Limit":{"description":"Active fixed-window request limit","schema":{"type":"integer","minimum":0}},"RateLimit-Remaining":{"description":"Requests remaining in the active window","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"UTC epoch seconds when the active window resets","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"502":{"description":"Configured delivery provider rejected the request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"503":{"description":"Final PDF object is temporarily unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}},"parameters":[{"name":"documentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}]}},"/api/v1/documents/{documentId}/fields/{fieldId}":{"patch":{"operationId":"repositionAgentSigningField","summary":"Reposition one assigned self-sign field","security":[{"bearerAuth":[]}],"parameters":[{"name":"documentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"fieldId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"page":{"type":"integer","minimum":1,"maximum":9007199254740991},"x":{"type":"integer","minimum":0,"maximum":9007199254740991},"y":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["x","y"],"additionalProperties":false}}}},"responses":{"200":{"description":"Command completed or exact result replayed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"type":{"type":"string","enum":["signature","date"]},"page":{"type":"number"},"x":{"type":"number"},"y":{"type":"number"},"width":{"type":"number"},"height":{"type":"number"}},"required":["id","type","page","x","y","width","height"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Invalid query","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing, revoked, or invalid Bearer token","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"AGENTIC_TOKEN_REQUIRED"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Document is not visible to this identity","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Final PDF is not ready","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Measured per-token or defensive per-IP request limit exceeded","headers":{"RateLimit-Limit":{"description":"Active fixed-window request limit","schema":{"type":"integer","minimum":0}},"RateLimit-Remaining":{"description":"Requests remaining in the active window","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"UTC epoch seconds when the active window resets","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"502":{"description":"Configured delivery provider rejected the request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"503":{"description":"Final PDF object is temporarily unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/api/v1/documents/{documentId}/complete":{"post":{"operationId":"completeAgentSigning","summary":"Request human-reviewed typed or drawn signing using the server date","security":[{"bearerAuth":[]}],"parameters":[{"name":"documentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"signatureName":{"type":"string","minLength":1},"signature":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"typed"},"typedText":{"type":"string","minLength":1,"maxLength":120},"typedFont":{"default":"cursive","type":"string","minLength":1,"maxLength":80}},"required":["kind","typedText","typedFont"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"drawn"},"label":{"default":"Drawn signature","type":"string","minLength":1,"maxLength":120},"svgPath":{"type":"string","minLength":1}},"required":["kind","label","svgPath"],"additionalProperties":false}]},"rememberSignature":{"default":false,"type":"boolean"},"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["rememberSignature"],"additionalProperties":false}}}},"responses":{"200":{"description":"Exact replay of a terminal human-review command","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","anyOf":[{"type":"object","properties":{"data":{"type":"object","properties":{"commandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","const":"pending_human_review"},"reviewUrl":{"type":"string","format":"uri"},"statusUrl":{"type":"string","format":"uri"},"expiresAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"notificationStatus":{"type":"string","enum":["sent","fallback","failed"]}},"required":["commandId","status","reviewUrl","statusUrl","expiresAt","notificationStatus"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},{"type":"object","properties":{"data":{"type":"object","properties":{"commandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","enum":["completed","rejected","expired","invalidated","failed"]},"notificationStatus":{"type":"string","enum":["sent","fallback","failed"]},"result":{},"error":{"type":"object","properties":{"code":{"type":"string","enum":["HUMAN_REVIEW_REJECTED","HUMAN_REVIEW_EXPIRED","HUMAN_REVIEW_INVALIDATED","HUMAN_REVIEW_EXECUTION_FAILED"]},"message":{"type":"string"},"retryable":{"type":"boolean","const":false},"recoveryUrl":{"type":"string"}},"required":["code","message","retryable","recoveryUrl"],"additionalProperties":false}},"required":["commandId","status","notificationStatus"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}]}}}},"202":{"description":"Protected action persisted pending matching-human review","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"commandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","const":"pending_human_review"},"reviewUrl":{"type":"string","format":"uri"},"statusUrl":{"type":"string","format":"uri"},"expiresAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"notificationStatus":{"type":"string","enum":["sent","fallback","failed"]}},"required":["commandId","status","reviewUrl","statusUrl","expiresAt","notificationStatus"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Invalid query","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing, revoked, or invalid Bearer token","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"AGENTIC_TOKEN_REQUIRED"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Document is not visible to this identity","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Final PDF is not ready","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Measured per-token or defensive per-IP request limit exceeded","headers":{"RateLimit-Limit":{"description":"Active fixed-window request limit","schema":{"type":"integer","minimum":0}},"RateLimit-Remaining":{"description":"Requests remaining in the active window","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"UTC epoch seconds when the active window resets","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"502":{"description":"Configured delivery provider rejected the request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"503":{"description":"Final PDF object is temporarily unavailable","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/api/v1/documents/{documentId}/recipients":{"get":{"operationId":"listAgentRecipients","summary":"List creator-managed recipients and current states","security":[{"bearerAuth":[]}],"parameters":[{"name":"documentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Authorized creator projection","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"envelopeId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"},"email":{"type":"string"},"status":{"type":"string","enum":["pending","sent","completed","declined"]},"createdAt":{"type":"string"}},"required":["id","envelopeId","name","email","status","createdAt"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing, revoked, or invalid Bearer token","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"AGENTIC_TOKEN_REQUIRED"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Document or recipient is not visible to this identity","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Lifecycle or idempotency precondition failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Measured per-token or defensive per-IP request limit exceeded","headers":{"RateLimit-Limit":{"description":"Active fixed-window request limit","schema":{"type":"integer","minimum":0}},"RateLimit-Remaining":{"description":"Requests remaining in the active window","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"UTC epoch seconds when the active window resets","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"502":{"description":"Configured delivery provider rejected the invitation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}},"post":{"operationId":"addAgentRecipients","summary":"Add normalized draft recipients within the 10-recipient limit","security":[{"bearerAuth":[]}],"parameters":[{"name":"documentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"recipients":{"minItems":1,"maxItems":10,"type":"array","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"email":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}},"required":["name","email"],"additionalProperties":false}}},"required":["recipients"],"additionalProperties":false}}}},"responses":{"201":{"description":"Command completed or exact result replayed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"envelopeId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"},"email":{"type":"string"},"status":{"type":"string","enum":["pending","sent","completed","declined"]},"createdAt":{"type":"string"}},"required":["id","envelopeId","name","email","status","createdAt"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing, revoked, or invalid Bearer token","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"AGENTIC_TOKEN_REQUIRED"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Document or recipient is not visible to this identity","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Lifecycle or idempotency precondition failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Measured per-token or defensive per-IP request limit exceeded","headers":{"RateLimit-Limit":{"description":"Active fixed-window request limit","schema":{"type":"integer","minimum":0}},"RateLimit-Remaining":{"description":"Requests remaining in the active window","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"UTC epoch seconds when the active window resets","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"502":{"description":"Configured delivery provider rejected the invitation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/api/v1/documents/{documentId}/recipients/{recipientId}":{"patch":{"operationId":"updateAgentRecipient","summary":"Update one partner recipient while the document is draft","security":[{"bearerAuth":[]}],"parameters":[{"name":"documentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"recipientId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"email":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}},"required":["name","email"],"additionalProperties":false}}}},"responses":{"200":{"description":"Command completed or exact result replayed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"envelopeId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"},"email":{"type":"string"},"status":{"type":"string","enum":["pending","sent","completed","declined"]},"createdAt":{"type":"string"}},"required":["id","envelopeId","name","email","status","createdAt"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing, revoked, or invalid Bearer token","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"AGENTIC_TOKEN_REQUIRED"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Document or recipient is not visible to this identity","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Lifecycle or idempotency precondition failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Measured per-token or defensive per-IP request limit exceeded","headers":{"RateLimit-Limit":{"description":"Active fixed-window request limit","schema":{"type":"integer","minimum":0}},"RateLimit-Remaining":{"description":"Requests remaining in the active window","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"UTC epoch seconds when the active window resets","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"502":{"description":"Configured delivery provider rejected the invitation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}},"delete":{"operationId":"deleteAgentRecipient","summary":"Delete one partner recipient while the document is draft","security":[{"bearerAuth":[]}],"parameters":[{"name":"documentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"recipientId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"Command completed or exact result replayed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"envelopeId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"name":{"type":"string"},"email":{"type":"string"},"status":{"type":"string","enum":["pending","sent","completed","declined"]},"createdAt":{"type":"string"}},"required":["id","envelopeId","name","email","status","createdAt"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing, revoked, or invalid Bearer token","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"AGENTIC_TOKEN_REQUIRED"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Document or recipient is not visible to this identity","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Lifecycle or idempotency precondition failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Measured per-token or defensive per-IP request limit exceeded","headers":{"RateLimit-Limit":{"description":"Active fixed-window request limit","schema":{"type":"integer","minimum":0}},"RateLimit-Remaining":{"description":"Requests remaining in the active window","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"UTC epoch seconds when the active window resets","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"502":{"description":"Configured delivery provider rejected the invitation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/api/v1/documents/{documentId}/send":{"post":{"operationId":"sendAgentDocument","summary":"Send a prepared, creator-signed document to eligible partners","security":[{"bearerAuth":[]}],"parameters":[{"name":"documentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false}}}},"responses":{"200":{"description":"Command completed or exact result replayed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"documentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","const":"sent"},"sentBy":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"invitedRecipients":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"email":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}},"required":["id","email"],"additionalProperties":false}},"emailSendCount":{"type":"integer","minimum":0,"maximum":9007199254740991},"allowedActions":{"type":"array","items":{"type":"string"}}},"required":["documentId","status","sentBy","invitedRecipients","emailSendCount","allowedActions"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing, revoked, or invalid Bearer token","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"AGENTIC_TOKEN_REQUIRED"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Document or recipient is not visible to this identity","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Lifecycle or idempotency precondition failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Measured per-token or defensive per-IP request limit exceeded","headers":{"RateLimit-Limit":{"description":"Active fixed-window request limit","schema":{"type":"integer","minimum":0}},"RateLimit-Remaining":{"description":"Requests remaining in the active window","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"UTC epoch seconds when the active window resets","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"502":{"description":"Configured delivery provider rejected the invitation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/api/v1/documents/{documentId}/recipients/{recipientId}/resend":{"post":{"operationId":"resendAgentInvitation","summary":"Issue and deliver a fresh eligible partner invitation","security":[{"bearerAuth":[]}],"parameters":[{"name":"documentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"recipientId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{},"additionalProperties":false}}}},"responses":{"201":{"description":"Command completed or exact result replayed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"documentId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"recipientId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"email":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"emailSendCount":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["documentId","recipientId","email","emailSendCount"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Invalid request","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing, revoked, or invalid Bearer token","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"AGENTIC_TOKEN_REQUIRED"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Document or recipient is not visible to this identity","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Lifecycle or idempotency precondition failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Measured per-token or defensive per-IP request limit exceeded","headers":{"RateLimit-Limit":{"description":"Active fixed-window request limit","schema":{"type":"integer","minimum":0}},"RateLimit-Remaining":{"description":"Requests remaining in the active window","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"UTC epoch seconds when the active window resets","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"502":{"description":"Configured delivery provider rejected the invitation","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/api/v1/documents/{documentId}/change-request":{"post":{"operationId":"requestAgentSigningChanges","summary":"Request creator revision with a required partner comment","security":[{"bearerAuth":[]}],"parameters":[{"name":"documentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"comment":{"type":"string","minLength":1}},"required":["comment"],"additionalProperties":false}}}},"responses":{"200":{"description":"Command completed or exact result replayed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"envelopeId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"recipientId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"recipientStatus":{"type":"string","const":"sent"},"envelopeStatus":{"type":"string","const":"changes_requested"},"allowedActions":{"type":"array","items":{"type":"string"}}},"required":["envelopeId","recipientId","recipientStatus","envelopeStatus","allowedActions"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Invalid decision input","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing, revoked, or invalid Bearer token","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"AGENTIC_TOKEN_REQUIRED"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Verified identity is not the invited partner","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Signing task was not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Signing state or idempotency conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"410":{"description":"Signing task is terminal","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Measured per-token or defensive per-IP request limit exceeded","headers":{"RateLimit-Limit":{"description":"Active fixed-window request limit","schema":{"type":"integer","minimum":0}},"RateLimit-Remaining":{"description":"Requests remaining in the active window","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"UTC epoch seconds when the active window resets","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"502":{"description":"Configured delivery provider rejected the notification","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/api/v1/documents/{documentId}/decline":{"post":{"operationId":"declineAgentSigning","summary":"Decline partner signing with a required reason","security":[{"bearerAuth":[]}],"parameters":[{"name":"documentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"reason":{"type":"string","minLength":1},"comment":{"type":"string","minLength":1}},"required":["reason"],"additionalProperties":false}}}},"responses":{"200":{"description":"Exact replay of a terminal human-review command","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","anyOf":[{"type":"object","properties":{"data":{"type":"object","properties":{"commandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","const":"pending_human_review"},"reviewUrl":{"type":"string","format":"uri"},"statusUrl":{"type":"string","format":"uri"},"expiresAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"notificationStatus":{"type":"string","enum":["sent","fallback","failed"]}},"required":["commandId","status","reviewUrl","statusUrl","expiresAt","notificationStatus"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},{"type":"object","properties":{"data":{"type":"object","properties":{"commandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","enum":["completed","rejected","expired","invalidated","failed"]},"notificationStatus":{"type":"string","enum":["sent","fallback","failed"]},"result":{},"error":{"type":"object","properties":{"code":{"type":"string","enum":["HUMAN_REVIEW_REJECTED","HUMAN_REVIEW_EXPIRED","HUMAN_REVIEW_INVALIDATED","HUMAN_REVIEW_EXECUTION_FAILED"]},"message":{"type":"string"},"retryable":{"type":"boolean","const":false},"recoveryUrl":{"type":"string"}},"required":["code","message","retryable","recoveryUrl"],"additionalProperties":false}},"required":["commandId","status","notificationStatus"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}]}}}},"202":{"description":"Protected action persisted pending matching-human review","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"commandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","const":"pending_human_review"},"reviewUrl":{"type":"string","format":"uri"},"statusUrl":{"type":"string","format":"uri"},"expiresAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"notificationStatus":{"type":"string","enum":["sent","fallback","failed"]}},"required":["commandId","status","reviewUrl","statusUrl","expiresAt","notificationStatus"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Invalid decision input","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing, revoked, or invalid Bearer token","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"AGENTIC_TOKEN_REQUIRED"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"403":{"description":"Verified identity is not the invited partner","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Signing task was not found","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Signing state or idempotency conflict","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"410":{"description":"Signing task is terminal","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Measured per-token or defensive per-IP request limit exceeded","headers":{"RateLimit-Limit":{"description":"Active fixed-window request limit","schema":{"type":"integer","minimum":0}},"RateLimit-Remaining":{"description":"Requests remaining in the active window","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"UTC epoch seconds when the active window resets","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"502":{"description":"Configured delivery provider rejected the notification","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/api/v1/documents/{documentId}/actions":{"post":{"operationId":"controlAgentDocument","summary":"Request human-reviewed cancel, expire, or delete","security":[{"bearerAuth":[]}],"parameters":[{"name":"documentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"action":{"type":"string","enum":["cancel","expire","delete"]}},"required":["action"],"additionalProperties":false}}}},"responses":{"200":{"description":"Exact replay of a terminal human-review command","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","anyOf":[{"type":"object","properties":{"data":{"type":"object","properties":{"commandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","const":"pending_human_review"},"reviewUrl":{"type":"string","format":"uri"},"statusUrl":{"type":"string","format":"uri"},"expiresAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"notificationStatus":{"type":"string","enum":["sent","fallback","failed"]}},"required":["commandId","status","reviewUrl","statusUrl","expiresAt","notificationStatus"],"additionalProperties":false}},"required":["data"],"additionalProperties":false},{"type":"object","properties":{"data":{"type":"object","properties":{"commandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","enum":["completed","rejected","expired","invalidated","failed"]},"notificationStatus":{"type":"string","enum":["sent","fallback","failed"]},"result":{},"error":{"type":"object","properties":{"code":{"type":"string","enum":["HUMAN_REVIEW_REJECTED","HUMAN_REVIEW_EXPIRED","HUMAN_REVIEW_INVALIDATED","HUMAN_REVIEW_EXECUTION_FAILED"]},"message":{"type":"string"},"retryable":{"type":"boolean","const":false},"recoveryUrl":{"type":"string"}},"required":["code","message","retryable","recoveryUrl"],"additionalProperties":false}},"required":["commandId","status","notificationStatus"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}]}}}},"202":{"description":"Protected action persisted pending matching-human review","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"commandId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","const":"pending_human_review"},"reviewUrl":{"type":"string","format":"uri"},"statusUrl":{"type":"string","format":"uri"},"expiresAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"notificationStatus":{"type":"string","enum":["sent","fallback","failed"]}},"required":["commandId","status","reviewUrl","statusUrl","expiresAt","notificationStatus"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Invalid creator command","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing, revoked, or invalid Bearer token","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"AGENTIC_TOKEN_REQUIRED"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Document is not creator-owned or was deleted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Lifecycle or idempotency precondition failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Measured per-token or defensive per-IP request limit exceeded","headers":{"RateLimit-Limit":{"description":"Active fixed-window request limit","schema":{"type":"integer","minimum":0}},"RateLimit-Remaining":{"description":"Requests remaining in the active window","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"UTC epoch seconds when the active window resets","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}},"/api/v1/documents/{documentId}/retention":{"get":{"operationId":"getAgentDocumentRetention","summary":"Inspect creator-only terminal retention eligibility","security":[{"bearerAuth":[]}],"parameters":[{"name":"documentId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Authorized creator result or exact replay","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"object","properties":{"envelopeId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string","enum":["awaiting_verification","draft","changes_requested","sent","completed","declined","expired","deleted"]},"retentionEligibleAt":{"anyOf":[{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},{"type":"null"}]},"retentionEligible":{"type":"boolean"}},"required":["envelopeId","status","retentionEligibleAt","retentionEligible"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}},"400":{"description":"Invalid creator command","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"401":{"description":"Missing, revoked, or invalid Bearer token","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","const":"AGENTIC_TOKEN_REQUIRED"},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Document is not creator-owned or was deleted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"409":{"description":"Lifecycle or idempotency precondition failed","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}},"429":{"description":"Measured per-token or defensive per-IP request limit exceeded","headers":{"RateLimit-Limit":{"description":"Active fixed-window request limit","schema":{"type":"integer","minimum":0}},"RateLimit-Remaining":{"description":"Requests remaining in the active window","schema":{"type":"integer","minimum":0}},"RateLimit-Reset":{"description":"UTC epoch seconds when the active window resets","schema":{"type":"integer","minimum":0}},"Retry-After":{"description":"Seconds to wait before retrying","schema":{"type":"integer","minimum":0}}},"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["AGENT_INVALID_DOCUMENT_QUERY","AGENT_DOCUMENT_NOT_FOUND","AGENT_COMMAND_NOT_FOUND","AGENT_FINAL_PDF_NOT_READY","AGENT_FINAL_PDF_UNAVAILABLE","IDEMPOTENCY_KEY_REQUIRED","IDEMPOTENCY_CONFLICT","IDEMPOTENCY_REQUEST_IN_PROGRESS","AGENT_INVALID_SELF_SIGN_CREATE","AGENT_SELF_SIGN_ACTION_BLOCKED","INVALID_SOURCE_PDF","SOURCE_PDF_TOO_LARGE","DUPLICATE_SOURCE_PDF","ENVELOPE_NOT_DRAFT","AGENT_SOURCE_PDF_UNAVAILABLE","INVALID_SIGNATURE_PROFILE","SIGNATURE_REUSE_CONSENT_REQUIRED","INVALID_FIELDS","SIGNATURE_PLACEHOLDER_LIMIT","AGENT_SIGNING_TASK_NOT_FOUND","INVALID_FIELD_PLACEMENT","FIELD_NOT_FOUND","INVALID_SIGNING_COMPLETION","INVALID_RECIPIENTS","DUPLICATE_RECIPIENT","RECIPIENT_LIMIT_REACHED","RECIPIENT_NOT_FOUND","CREATOR_RECIPIENT_LOCKED","SOURCE_PDF_REQUIRED","PARTNER_RECIPIENT_REQUIRED","RECIPIENT_FIELDS_REQUIRED","CREATOR_SIGNING_REQUIRED","RESEND_NOT_ALLOWED","EMAIL_DELIVERY_FAILED","AGENT_SIGNING_WRONG_IDENTITY","AGENT_SIGNING_INACTIVE","AGENT_SIGNING_COMPLETED","AGENT_SIGNING_CHANGES_REQUESTED","AGENT_SIGNING_DECLINED","AGENT_SIGNING_EXPIRED","AGENT_SIGNING_DELETED","INVALID_CHANGE_REQUEST","INVALID_SIGNING_DECLINE","INVALID_CREATOR_CONTROL","ENVELOPE_ACTION_BLOCKED","AGENT_RATE_LIMITED"]},"message":{"type":"string"},"retryable":{"type":"boolean"},"allowedActions":{"type":"array","items":{"type":"string"}},"recoveryUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"validValues":{"type":"array","items":{"type":"string"}},"fields":{"type":"array","items":{"type":"string"}},"limitBytes":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"limit":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"retryAfter":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"required":["code","message","retryable","allowedActions","recoveryUrl"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"SignmosToken"}}}}