{"items":[{"type":"link","label":"Signable API","link":"/openapi","routeSlug":"/openapi","content":{"contentType":"overview","meta":{"name":"Signable API"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"openapi.json","url":"/_bundle/openapi.json?download"},{"kind":"download","label":"openapi.yaml","url":"/_bundle/openapi.yaml?download"}]},{"title":"Overview","titleTranslationKey":"info.title","children":[{"kind":"email","title":"Signable","email":"help@signable.co.uk","label":"help@signable.co.uk","withCopyButton":true,"copyContent":"help@signable.co.uk"},{"kind":"externallink","title":"License","titleTranslationKey":"info.license","label":"Proprietary","url":"https://www.signable.co.uk/terms-conditions/"},{"kind":"externallink","label":"Terms of Service","labelTranslationKey":"info.termsOfService","url":"https://www.signable.co.uk/terms-conditions/"}]},{"title":"Languages","titleTranslationKey":"languages.title","children":[{"kind":"languages","options":[{"key":"curl","title":"curl","lang":"curl"},{"key":"javascript","title":"JavaScript","lang":"JavaScript"},{"key":"node","title":"Node.js","lang":"Node.js"},{"key":"python","title":"Python","lang":"Python"},{"key":"java","title":"Java","lang":"Java"},{"key":"csharp","title":"C#","lang":"C#"},{"key":"php","title":"PHP","lang":"PHP"},{"key":"go","title":"Go","lang":"Go"},{"key":"ruby","title":"Ruby","lang":"Ruby"},{"key":"r","title":"R","lang":"R"},{"key":"payload","title":"Payload","lang":"Payload"}]}]},{"title":"Servers","titleTranslationKey":"servers.title","children":[{"kind":"servers","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"Signable API (1.0.0)","showPageActions":true},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":"The Signable API provides secure and efficient access to Signable's electronic signature platform. With this RESTful API, you can send documents for signature, manage templates, track envelope status, and automate your document workflows from within your own applications."}],"sectionId":"/openapi"}],"sectionId":"/openapi"},{"nodeType":"info-metadata","rows":[{"key":"showLastModified","value":"true"}]}]}]}},{"type":"group","label":"Partners","link":"/openapi/partners","routeSlug":"/openapi/partners","items":[{"label":"List sub-accounts","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/partners/getcompanies","routeSlug":"/openapi/partners/getcompanies","metadata":{"seo":{"title":"List sub-accounts","description":"Returns a paginated list of sub-accounts associated with the Partner account."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getCompanies","name":"List sub-accounts","isWebhook":false,"pointer":"/paths/~1companies/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List sub-accounts","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns a paginated list of sub-accounts associated with the Partner account.\n\nThis endpoint is only available to Signable Partners.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"offset","in":"query","schemaId":"schema_37","description":"The index of the first envelope to retrieve."},{"name":"limit","in":"query","schemaId":"schema_38","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The maximum number of envelopes to return. If more than "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"50"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is requested, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"10"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" will be returned instead."},"children":[]}]}]}]}],"pointer":"/paths/~1companies/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/companies","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"offset","in":"query","required":false,"example":0,"schemaId":"schema_37"},{"name":"limit","in":"query","required":false,"schemaId":"schema_38"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200","401"],"pointer":"/companies","href":"partners/getcompanies","openApiOperationId":"getCompanies","summary":"List sub-accounts"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response containing a list of sub-accounts.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CompanyListResponse","exampleIds":["paths/~1companies/get/responses/200/content/application~1json/examples/success"]}},"schemaId":"components/schemas/CompanyListResponse","exampleIds":["paths/~1companies/get/responses/200/content/application~1json/examples/success"]},{"code":"401","description":"Authentication failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1companies/get/responses/401/content/application~1json/examples/invalidAuth"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1companies/get/responses/401/content/application~1json/examples/invalidAuth"]}],"pointer":"/paths/~1companies/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/CompanyListResponse","exampleIds":["paths/~1companies/get/responses/200/content/application~1json/examples/success"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CompanyListResponse","exampleIds":["paths/~1companies/get/responses/200/content/application~1json/examples/success"]}}},{"code":"401","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1companies/get/responses/401/content/application~1json/examples/invalidAuth"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1companies/get/responses/401/content/application~1json/examples/invalidAuth"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/partners/getcompanies"}],"panels":[]}]},"httpPath":"/companies"},{"label":"Create a sub-account","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/partners/createcompany","routeSlug":"/openapi/partners/createcompany","metadata":{"seo":{"title":"Create a sub-account","description":"Creates a new sub-account under the Partner account."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createCompany","name":"Create a sub-account","isWebhook":false,"pointer":"/paths/~1companies/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a sub-account","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Creates a new sub-account under the Partner account.\n\nThis endpoint is only available to Signable Partners.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CompanyCreateRequest","exampleIds":["paths/~1companies/post/requestBody/content/application~1json/examples/success"]}},"schemaId":"components/schemas/CompanyCreateRequest","exampleIds":["paths/~1companies/post/requestBody/content/application~1json/examples/success"],"pointer":"/paths/~1companies/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/companies","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CompanyCreateRequest","exampleIds":["paths/~1companies/post/requestBody/content/application~1json/examples/success"]}},"responseCodes":["200","400","401"],"pointer":"/companies","href":"partners/createcompany","openApiOperationId":"createCompany","summary":"Create a sub-account"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"schemaId":"components/schemas/CompanyCreateRequest","exampleIds":["paths/~1companies/post/requestBody/content/application~1json/examples/success"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CompanyCreateRequest","exampleIds":["paths/~1companies/post/requestBody/content/application~1json/examples/success"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Sub-account successfully created.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CompanyCreateResponse","exampleIds":["paths/~1companies/post/responses/200/content/application~1json/examples/success"]}},"schemaId":"components/schemas/CompanyCreateResponse","exampleIds":["paths/~1companies/post/responses/200/content/application~1json/examples/success"]},{"code":"400","description":"Invalid sub-account create request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1companies/post/responses/400/content/application~1json/examples/missingCompanyName","paths/~1companies/post/responses/400/content/application~1json/examples/missingUserEmail","paths/~1companies/post/responses/400/content/application~1json/examples/missingUserName","paths/~1companies/post/responses/400/content/application~1json/examples/duplicateUserEmail"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1companies/post/responses/400/content/application~1json/examples/missingCompanyName","paths/~1companies/post/responses/400/content/application~1json/examples/missingUserEmail","paths/~1companies/post/responses/400/content/application~1json/examples/missingUserName","paths/~1companies/post/responses/400/content/application~1json/examples/duplicateUserEmail"]},{"code":"401","description":"Authentication failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1companies/post/responses/401/content/application~1json/examples/invalidAuth"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1companies/post/responses/401/content/application~1json/examples/invalidAuth"]}],"pointer":"/paths/~1companies/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/CompanyCreateResponse","exampleIds":["paths/~1companies/post/responses/200/content/application~1json/examples/success"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CompanyCreateResponse","exampleIds":["paths/~1companies/post/responses/200/content/application~1json/examples/success"]}}},{"code":"400","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1companies/post/responses/400/content/application~1json/examples/missingCompanyName","paths/~1companies/post/responses/400/content/application~1json/examples/missingUserEmail","paths/~1companies/post/responses/400/content/application~1json/examples/missingUserName","paths/~1companies/post/responses/400/content/application~1json/examples/duplicateUserEmail"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1companies/post/responses/400/content/application~1json/examples/missingCompanyName","paths/~1companies/post/responses/400/content/application~1json/examples/missingUserEmail","paths/~1companies/post/responses/400/content/application~1json/examples/missingUserName","paths/~1companies/post/responses/400/content/application~1json/examples/duplicateUserEmail"]}}},{"code":"401","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1companies/post/responses/401/content/application~1json/examples/invalidAuth"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1companies/post/responses/401/content/application~1json/examples/invalidAuth"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/partners/createcompany"}],"panels":[]}]},"httpPath":"/companies"},{"label":"Get a sub-account","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/partners/getcompany","routeSlug":"/openapi/partners/getcompany","metadata":{"seo":{"title":"Get a sub-account","description":"Returns details about a specific sub-account associated with the Partner account."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getCompany","name":"Get a sub-account","isWebhook":false,"pointer":"/paths/~1companies~1{company_id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get a sub-account","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns details about a specific sub-account associated with the Partner account.\n\nThis endpoint is only available to Signable Partners.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"company_id","in":"path","schemaId":"schema_39","description":"Unique identifier of the sub-account.","required":true}],"pointer":"/paths/~1companies~1{company_id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/companies/{company_id}","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[{"name":"company_id","in":"path","required":true,"example":"196735","schemaId":"schema_39"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200","401"],"pointer":"/companies/{company_id}","href":"partners/getcompany","openApiOperationId":"getCompany","summary":"Get a sub-account"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Details of the requested sub-account.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CompanyGetResponse","exampleIds":["paths/~1companies~1{company_id}/get/responses/200/content/application~1json/examples/success"]}},"schemaId":"components/schemas/CompanyGetResponse","exampleIds":["paths/~1companies~1{company_id}/get/responses/200/content/application~1json/examples/success"]},{"code":"401","description":"Authentication failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1companies~1{company_id}/get/responses/401/content/application~1json/examples/invalidAuth"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1companies~1{company_id}/get/responses/401/content/application~1json/examples/invalidAuth"]}],"pointer":"/paths/~1companies~1{company_id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/CompanyGetResponse","exampleIds":["paths/~1companies~1{company_id}/get/responses/200/content/application~1json/examples/success"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CompanyGetResponse","exampleIds":["paths/~1companies~1{company_id}/get/responses/200/content/application~1json/examples/success"]}}},{"code":"401","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1companies~1{company_id}/get/responses/401/content/application~1json/examples/invalidAuth"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1companies~1{company_id}/get/responses/401/content/application~1json/examples/invalidAuth"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/partners/getcompany"}],"panels":[]}]},"httpPath":"/companies/{company_id}"},{"label":"Update a sub-account","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/partners/updatecompany","routeSlug":"/openapi/partners/updatecompany","metadata":{"seo":{"title":"Update a sub-account","description":"Updates details of a specific sub-account associated with the authenticated Partner account."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateCompany","name":"Update a sub-account","isWebhook":false,"pointer":"/paths/~1companies~1{company_id}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a sub-account","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Updates details of a specific sub-account associated with the authenticated Partner account.\n\nThis endpoint is only available to Signable Partners.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"company_id","in":"path","schemaId":"schema_40","description":"Unique identifier of the sub-account to update.","required":true}],"pointer":"/paths/~1companies~1{company_id}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CompanyUpdateRequest","exampleIds":["paths/~1companies~1{company_id}/put/requestBody/content/application~1json/examples/success"]}},"schemaId":"components/schemas/CompanyUpdateRequest","exampleIds":["paths/~1companies~1{company_id}/put/requestBody/content/application~1json/examples/success"],"pointer":"/paths/~1companies~1{company_id}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/companies/{company_id}","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[{"name":"company_id","in":"path","required":true,"example":"214821","schemaId":"schema_40"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CompanyUpdateRequest","exampleIds":["paths/~1companies~1{company_id}/put/requestBody/content/application~1json/examples/success"]}},"responseCodes":["200","401","404"],"pointer":"/companies/{company_id}","href":"partners/updatecompany","openApiOperationId":"updateCompany","summary":"Update a sub-account"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"schemaId":"components/schemas/CompanyUpdateRequest","exampleIds":["paths/~1companies~1{company_id}/put/requestBody/content/application~1json/examples/success"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CompanyUpdateRequest","exampleIds":["paths/~1companies~1{company_id}/put/requestBody/content/application~1json/examples/success"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Sub-account updated successfully.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CompanyUpdateResponse","exampleIds":["paths/~1companies~1{company_id}/put/responses/200/content/application~1json/examples/success"]}},"schemaId":"components/schemas/CompanyUpdateResponse","exampleIds":["paths/~1companies~1{company_id}/put/responses/200/content/application~1json/examples/success"]},{"code":"401","description":"Authentication failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1companies~1{company_id}/put/responses/401/content/application~1json/examples/invalidAuth"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1companies~1{company_id}/put/responses/401/content/application~1json/examples/invalidAuth"]},{"code":"404","description":"Sub-account not found under the authenticated Partner account","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1companies~1{company_id}/put/responses/404/content/application~1json/examples/companyNotFound"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1companies~1{company_id}/put/responses/404/content/application~1json/examples/companyNotFound"]}],"pointer":"/paths/~1companies~1{company_id}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/CompanyUpdateResponse","exampleIds":["paths/~1companies~1{company_id}/put/responses/200/content/application~1json/examples/success"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CompanyUpdateResponse","exampleIds":["paths/~1companies~1{company_id}/put/responses/200/content/application~1json/examples/success"]}}},{"code":"401","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1companies~1{company_id}/put/responses/401/content/application~1json/examples/invalidAuth"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1companies~1{company_id}/put/responses/401/content/application~1json/examples/invalidAuth"]}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1companies~1{company_id}/put/responses/404/content/application~1json/examples/companyNotFound"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1companies~1{company_id}/put/responses/404/content/application~1json/examples/companyNotFound"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/partners/updatecompany"}],"panels":[]}]},"httpPath":"/companies/{company_id}"},{"label":"Delete a sub-account","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/partners/deletecompany","routeSlug":"/openapi/partners/deletecompany","metadata":{"seo":{"title":"Delete a sub-account","description":"Permanently deletes a sub-account (company) from the Partner account."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteCompany","name":"Delete a sub-account","isWebhook":false,"pointer":"/paths/~1companies~1{company_id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete a sub-account","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Permanently deletes a sub-account (company) from the Partner account.\n\nThis operation is irreversible and can only be performed by Signable Partners.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"company_id","in":"path","schemaId":"schema_40","description":"Unique identifier of the sub-account to delete.","required":true}],"pointer":"/paths/~1companies~1{company_id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/companies/{company_id}","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[{"name":"company_id","in":"path","required":true,"example":"214821","schemaId":"schema_40"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200","401","404"],"pointer":"/companies/{company_id}","href":"partners/deletecompany","openApiOperationId":"deleteCompany","summary":"Delete a sub-account"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Sub-account deleted successfully.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CompanyDeleteResponse","exampleIds":["paths/~1companies~1{company_id}/delete/responses/200/content/application~1json/examples/success"]}},"schemaId":"components/schemas/CompanyDeleteResponse","exampleIds":["paths/~1companies~1{company_id}/delete/responses/200/content/application~1json/examples/success"]},{"code":"401","description":"Authentication failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1companies~1{company_id}/delete/responses/401/content/application~1json/examples/invalidAuth"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1companies~1{company_id}/delete/responses/401/content/application~1json/examples/invalidAuth"]},{"code":"404","description":"Sub-account not found under the authenticated Partner account","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1companies~1{company_id}/delete/responses/404/content/application~1json/examples/companyNotFound"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1companies~1{company_id}/delete/responses/404/content/application~1json/examples/companyNotFound"]}],"pointer":"/paths/~1companies~1{company_id}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/CompanyDeleteResponse","exampleIds":["paths/~1companies~1{company_id}/delete/responses/200/content/application~1json/examples/success"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CompanyDeleteResponse","exampleIds":["paths/~1companies~1{company_id}/delete/responses/200/content/application~1json/examples/success"]}}},{"code":"401","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1companies~1{company_id}/delete/responses/401/content/application~1json/examples/invalidAuth"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1companies~1{company_id}/delete/responses/401/content/application~1json/examples/invalidAuth"]}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1companies~1{company_id}/delete/responses/404/content/application~1json/examples/companyNotFound"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1companies~1{company_id}/delete/responses/404/content/application~1json/examples/companyNotFound"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/partners/deletecompany"}],"panels":[]}]},"httpPath":"/companies/{company_id}"},{"label":"View usage for all sub-accounts","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/partners/getcompaniesusage","routeSlug":"/openapi/partners/getcompaniesusage","metadata":{"seo":{"title":"View usage for all sub-accounts","description":"Retrieves usage data for all sub-accounts under a Partner account, including current and previous period comparisons. This endpoint is only available to Signable Partners."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getCompaniesUsage","name":"View usage for all sub-accounts","isWebhook":false,"pointer":"/paths/~1usage/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"View usage for all sub-accounts","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves usage data for all sub-accounts under a Partner account, including current and previous period comparisons.\nThis endpoint is only available to Signable Partners.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"offset","in":"query","schemaId":"schema_37","description":"The index of the first envelope to retrieve."},{"name":"limit","in":"query","schemaId":"schema_38","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The maximum number of envelopes to return. If more than "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"50"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is requested, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"10"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" will be returned instead."},"children":[]}]}]}]},{"name":"calendar","in":"query","schemaId":"schema_41","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Determines how usage periods are calculated. Defaults to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"1"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to return usage periods aligned to calendar months. Set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"0"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to return usage periods aligned to the billing cycle."},"children":[]}]}]}],"deprecated":true}],"pointer":"/paths/~1usage/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/usage","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"offset","in":"query","required":false,"example":0,"schemaId":"schema_37"},{"name":"limit","in":"query","required":false,"schemaId":"schema_38"},{"name":"calendar","in":"query","required":false,"example":1,"schemaId":"schema_41"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200","401"],"pointer":"/usage","href":"partners/getcompaniesusage","openApiOperationId":"getCompaniesUsage","summary":"View usage for all sub-accounts"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Usage data successfully returned.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PartnerUsageResponse","exampleIds":["paths/~1usage/get/responses/200/content/application~1json/examples/success"]}},"schemaId":"components/schemas/PartnerUsageResponse","exampleIds":["paths/~1usage/get/responses/200/content/application~1json/examples/success"]},{"code":"401","description":"Authentication failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1usage/get/responses/401/content/application~1json/examples/invalidAuth"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1usage/get/responses/401/content/application~1json/examples/invalidAuth"]}],"pointer":"/paths/~1usage/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PartnerUsageResponse","exampleIds":["paths/~1usage/get/responses/200/content/application~1json/examples/success"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PartnerUsageResponse","exampleIds":["paths/~1usage/get/responses/200/content/application~1json/examples/success"]}}},{"code":"401","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1usage/get/responses/401/content/application~1json/examples/invalidAuth"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1usage/get/responses/401/content/application~1json/examples/invalidAuth"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/partners/getcompaniesusage"}],"panels":[]}]},"httpPath":"/usage"}],"content":{"contentType":"group","meta":{"name":"Partners"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Partners","showPageActions":true},{"nodeType":"markdoc","content":"Manage partner integrations."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/companies","summary":"List sub-accounts","prefix":{"name":"get","color":"get"},"badges":[],"link":"/partners/getcompanies","deprecated":false},{"title":"/companies","summary":"Create a sub-account","prefix":{"name":"post","color":"post"},"badges":[],"link":"/partners/createcompany","deprecated":false},{"title":"/companies/{company_id}","summary":"Get a sub-account","prefix":{"name":"get","color":"get"},"badges":[],"link":"/partners/getcompany","deprecated":false},{"title":"/companies/{company_id}","summary":"Update a sub-account","prefix":{"name":"put","color":"put"},"badges":[],"link":"/partners/updatecompany","deprecated":false},{"title":"/companies/{company_id}","summary":"Delete a sub-account","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/partners/deletecompany","deprecated":false},{"title":"/usage","summary":"View usage for all sub-accounts","prefix":{"name":"get","color":"get"},"badges":[],"link":"/partners/getcompaniesusage","deprecated":false}]}]}]}]}},{"type":"group","label":"Envelopes","link":"/openapi/envelopes","routeSlug":"/openapi/envelopes","items":[{"label":"List envelopes","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/envelopes/listenvelopes","routeSlug":"/openapi/envelopes/listenvelopes","metadata":{"seo":{"title":"List envelopes","description":"Returns a paginated list of envelopes. You can filter by envelope status or search by title using optional query parameters."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listEnvelopes","name":"List envelopes","isWebhook":false,"pointer":"/paths/~1envelopes/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List envelopes","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns a paginated list of envelopes. You can filter by envelope status or search by title using optional query parameters.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"offset","in":"query","schemaId":"schema_37","description":"The index of the first envelope to retrieve."},{"name":"limit","in":"query","schemaId":"schema_38","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The maximum number of envelopes to return. If more than "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"50"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is requested, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"10"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" will be returned instead."},"children":[]}]}]}]},{"name":"envelope_status","in":"query","schemaId":"schema_42","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filter by a single envelope status. "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"../../envelope-status"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See Envelope status values for more info →"},"children":[]}]}]}]}]},{"name":"q","in":"query","schemaId":"schema_43","description":"Case-insensitive keyword filter on the envelope title. Matches partial words. Null values return unfiltered results.\n"}],"pointer":"/paths/~1envelopes/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/envelopes","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"offset","in":"query","required":false,"example":0,"schemaId":"schema_37"},{"name":"limit","in":"query","required":false,"schemaId":"schema_38"},{"name":"envelope_status","in":"query","schemaId":"schema_42"},{"name":"q","in":"query","schemaId":"schema_43"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200","401"],"pointer":"/envelopes","href":"envelopes/listenvelopes","openApiOperationId":"listEnvelopes","summary":"List envelopes"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"A paginated list of envelopes.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EnvelopeListResponse","exampleIds":["paths/~1envelopes/get/responses/200/content/application~1json/examples/envelopeList"]}},"schemaId":"components/schemas/EnvelopeListResponse","exampleIds":["paths/~1envelopes/get/responses/200/content/application~1json/examples/envelopeList"]},{"code":"401","description":"Authentication failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1envelopes/get/responses/401/content/application~1json/examples/invalidAuth"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1envelopes/get/responses/401/content/application~1json/examples/invalidAuth"]}],"pointer":"/paths/~1envelopes/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/EnvelopeListResponse","exampleIds":["paths/~1envelopes/get/responses/200/content/application~1json/examples/envelopeList"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EnvelopeListResponse","exampleIds":["paths/~1envelopes/get/responses/200/content/application~1json/examples/envelopeList"]}}},{"code":"401","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1envelopes/get/responses/401/content/application~1json/examples/invalidAuth"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1envelopes/get/responses/401/content/application~1json/examples/invalidAuth"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/envelopes/listenvelopes"}],"panels":[]}]},"httpPath":"/envelopes"},{"label":"Send an envelope","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/envelopes/sendenvelope","routeSlug":"/openapi/envelopes/sendenvelope","metadata":{"seo":{"title":"Send an envelope","description":"Creates and queues a new envelope for sending, using one of the following methods for attaching documents:"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"sendEnvelope","name":"Send an envelope","isWebhook":false,"pointer":"/paths/~1envelopes/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Send an envelope","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Creates and queues a new envelope for sending, using one of the following methods for attaching documents:"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Option 1 – Upload or link a document directly in the request body"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Option 2 – Reference a single Signable template"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Option 3 – Reference multiple Signable templates"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"⚠️ "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Only one document input method can be used per request."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_44","exampleIds":["paths/~1envelopes/post/requestBody/content/application~1json/examples/with_document","paths/~1envelopes/post/requestBody/content/application~1json/examples/with_template","paths/~1envelopes/post/requestBody/content/application~1json/examples/with_template_multiple"]}},"schemaId":"schema_44","exampleIds":["paths/~1envelopes/post/requestBody/content/application~1json/examples/with_document","paths/~1envelopes/post/requestBody/content/application~1json/examples/with_template","paths/~1envelopes/post/requestBody/content/application~1json/examples/with_template_multiple"],"pointer":"/paths/~1envelopes/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/envelopes","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"schema_44","exampleIds":["paths/~1envelopes/post/requestBody/content/application~1json/examples/with_document","paths/~1envelopes/post/requestBody/content/application~1json/examples/with_template","paths/~1envelopes/post/requestBody/content/application~1json/examples/with_template_multiple"]}},"responseCodes":["202","400"],"pointer":"/envelopes","href":"envelopes/sendenvelope","openApiOperationId":"sendEnvelope","summary":"Send an envelope"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"schemaId":"schema_44","exampleIds":["paths/~1envelopes/post/requestBody/content/application~1json/examples/with_document","paths/~1envelopes/post/requestBody/content/application~1json/examples/with_template","paths/~1envelopes/post/requestBody/content/application~1json/examples/with_template_multiple"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"schema_44","exampleIds":["paths/~1envelopes/post/requestBody/content/application~1json/examples/with_document","paths/~1envelopes/post/requestBody/content/application~1json/examples/with_template","paths/~1envelopes/post/requestBody/content/application~1json/examples/with_template_multiple"]}},"examples":[{},{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":"Envelope successfully created and queued","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EnvelopeSendResponse","exampleIds":["paths/~1envelopes/post/responses/202/content/application~1json/examples/with_document","paths/~1envelopes/post/responses/202/content/application~1json/examples/with_template","paths/~1envelopes/post/responses/202/content/application~1json/examples/with_template_multiple"]}},"schemaId":"components/schemas/EnvelopeSendResponse","exampleIds":["paths/~1envelopes/post/responses/202/content/application~1json/examples/with_document","paths/~1envelopes/post/responses/202/content/application~1json/examples/with_template","paths/~1envelopes/post/responses/202/content/application~1json/examples/with_template_multiple"]},{"code":"400","description":"Invalid envelope send request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1envelopes/post/responses/400/content/application~1json/examples/invalidRequest"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1envelopes/post/responses/400/content/application~1json/examples/invalidRequest"]}],"pointer":"/paths/~1envelopes/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"202","schemaId":"components/schemas/EnvelopeSendResponse","exampleIds":["paths/~1envelopes/post/responses/202/content/application~1json/examples/with_document","paths/~1envelopes/post/responses/202/content/application~1json/examples/with_template","paths/~1envelopes/post/responses/202/content/application~1json/examples/with_template_multiple"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EnvelopeSendResponse","exampleIds":["paths/~1envelopes/post/responses/202/content/application~1json/examples/with_document","paths/~1envelopes/post/responses/202/content/application~1json/examples/with_template","paths/~1envelopes/post/responses/202/content/application~1json/examples/with_template_multiple"]}}},{"code":"400","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1envelopes/post/responses/400/content/application~1json/examples/invalidRequest"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1envelopes/post/responses/400/content/application~1json/examples/invalidRequest"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/envelopes/sendenvelope"}],"panels":[]}]},"httpPath":"/envelopes"},{"label":"Get envelope details","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/envelopes/getenvelope","routeSlug":"/openapi/envelopes/getenvelope","metadata":{"seo":{"title":"Get envelope details","description":"Returns the full details of a specific envelope, including document data, party information, field data, and envelope history."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getEnvelope","name":"Get envelope details","isWebhook":false,"pointer":"/paths/~1envelopes~1{envelope_fingerprint}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get envelope details","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns the full details of a specific envelope, including document data, party information, field data, and envelope history.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"envelope_fingerprint","in":"path","schemaId":"schema_43","description":"Unique identifier of the envelope.","required":true}],"pointer":"/paths/~1envelopes~1{envelope_fingerprint}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/envelopes/{envelope_fingerprint}","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[{"name":"envelope_fingerprint","in":"path","required":true,"schemaId":"schema_43"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/envelopes/{envelope_fingerprint}","href":"envelopes/getenvelope","openApiOperationId":"getEnvelope","summary":"Get envelope details"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Details of the requested envelope.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EnvelopeDetailResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}/get/responses/200/content/application~1json/examples/envelopeDetails"]}},"schemaId":"components/schemas/EnvelopeDetailResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}/get/responses/200/content/application~1json/examples/envelopeDetails"]}],"pointer":"/paths/~1envelopes~1{envelope_fingerprint}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/EnvelopeDetailResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}/get/responses/200/content/application~1json/examples/envelopeDetails"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EnvelopeDetailResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}/get/responses/200/content/application~1json/examples/envelopeDetails"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/envelopes/getenvelope"}],"panels":[]}]},"httpPath":"/envelopes/{envelope_fingerprint}"},{"label":"Delete an envelope","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/envelopes/deleteenvelope","routeSlug":"/openapi/envelopes/deleteenvelope","metadata":{"seo":{"title":"Delete an envelope","description":"Deletes an envelope. Only available for envelopes in draft, signed, expired or cancelled status. No notification email is sent to signers when an envelope is deleted."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteEnvelope","name":"Delete an envelope","isWebhook":false,"pointer":"/paths/~1envelopes~1{envelope_fingerprint}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete an envelope","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Deletes an envelope. Only available for envelopes in "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"draft"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"signed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expired"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cancelled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" status. No notification email is sent to signers when an envelope is deleted."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"envelope_fingerprint","in":"path","schemaId":"schema_43","description":"The unique identifier of the envelope.","required":true}],"pointer":"/paths/~1envelopes~1{envelope_fingerprint}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/envelopes/{envelope_fingerprint}","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[{"name":"envelope_fingerprint","in":"path","required":true,"schemaId":"schema_43"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/envelopes/{envelope_fingerprint}","href":"envelopes/deleteenvelope","openApiOperationId":"deleteEnvelope","summary":"Delete an envelope"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Envelope successfully deleted","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EnvelopeDeleteResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}/delete/responses/200/content/application~1json/examples/success"]}},"schemaId":"components/schemas/EnvelopeDeleteResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}/delete/responses/200/content/application~1json/examples/success"]}],"pointer":"/paths/~1envelopes~1{envelope_fingerprint}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/EnvelopeDeleteResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}/delete/responses/200/content/application~1json/examples/success"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EnvelopeDeleteResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}/delete/responses/200/content/application~1json/examples/success"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/envelopes/deleteenvelope"}],"panels":[]}]},"httpPath":"/envelopes/{envelope_fingerprint}"},{"label":"Send envelope reminder","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/envelopes/remindenvelope","routeSlug":"/openapi/envelopes/remindenvelope","metadata":{"seo":{"title":"Send envelope reminder","description":"Sends a reminder email to all outstanding signing parties for the specified envelope. If automatic reminders are enabled, this also resets the countdown timer for the next scheduled reminder."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"remindEnvelope","name":"Send envelope reminder","isWebhook":false,"pointer":"/paths/~1envelopes~1{envelope_fingerprint}~1remind/put","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Send envelope reminder","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Sends a reminder email to all outstanding signing parties for the specified envelope. If automatic reminders are enabled, this also resets the countdown timer for the next scheduled reminder.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"envelope_fingerprint","in":"path","schemaId":"schema_43","description":"The unique identifier of the envelope to remind signers for.","required":true}],"pointer":"/paths/~1envelopes~1{envelope_fingerprint}~1remind/put/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/envelopes/{envelope_fingerprint}/remind","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[{"name":"envelope_fingerprint","in":"path","required":true,"schemaId":"schema_43"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200","400","401","404"],"pointer":"/envelopes/{envelope_fingerprint}/remind","href":"envelopes/remindenvelope","openApiOperationId":"remindEnvelope","summary":"Send envelope reminder"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Reminder successfully triggered","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EnvelopeRemindResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1remind/put/responses/200/content/application~1json/examples/success"]}},"schemaId":"components/schemas/EnvelopeRemindResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1remind/put/responses/200/content/application~1json/examples/success"]},{"code":"400","description":"Envelope cannot be reminded in its current status","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1remind/put/responses/400/content/application~1json/examples/wrongStatus"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1remind/put/responses/400/content/application~1json/examples/wrongStatus"]},{"code":"401","description":"Authentication failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1remind/put/responses/401/content/application~1json/examples/invalidAuth"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1remind/put/responses/401/content/application~1json/examples/invalidAuth"]},{"code":"404","description":"Envelope not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1remind/put/responses/404/content/application~1json/examples/unknownEnvelope"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1remind/put/responses/404/content/application~1json/examples/unknownEnvelope"]}],"pointer":"/paths/~1envelopes~1{envelope_fingerprint}~1remind/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/EnvelopeRemindResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1remind/put/responses/200/content/application~1json/examples/success"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EnvelopeRemindResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1remind/put/responses/200/content/application~1json/examples/success"]}}},{"code":"400","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1remind/put/responses/400/content/application~1json/examples/wrongStatus"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1remind/put/responses/400/content/application~1json/examples/wrongStatus"]}}},{"code":"401","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1remind/put/responses/401/content/application~1json/examples/invalidAuth"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1remind/put/responses/401/content/application~1json/examples/invalidAuth"]}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1remind/put/responses/404/content/application~1json/examples/unknownEnvelope"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1remind/put/responses/404/content/application~1json/examples/unknownEnvelope"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/envelopes/remindenvelope"}],"panels":[]}]},"httpPath":"/envelopes/{envelope_fingerprint}/remind"},{"label":"Cancel an envelope","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/envelopes/cancelenvelope","routeSlug":"/openapi/envelopes/cancelenvelope","metadata":{"seo":{"title":"Cancel an envelope","description":"Cancels a sent envelope. A cancellation email will be sent to all signing parties, and the envelope will no longer be available for signing."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"cancelEnvelope","name":"Cancel an envelope","isWebhook":false,"pointer":"/paths/~1envelopes~1{envelope_fingerprint}~1cancel/put","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Cancel an envelope","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Cancels a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sent"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" envelope. A cancellation email will be sent to all signing parties, and the envelope will no longer be available for signing."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"envelope_fingerprint","in":"path","schemaId":"schema_43","description":"The unique identifier of the envelope to cancel.","required":true}],"pointer":"/paths/~1envelopes~1{envelope_fingerprint}~1cancel/put/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/envelopes/{envelope_fingerprint}/cancel","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[{"name":"envelope_fingerprint","in":"path","required":true,"schemaId":"schema_43"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200","400","401","404"],"pointer":"/envelopes/{envelope_fingerprint}/cancel","href":"envelopes/cancelenvelope","openApiOperationId":"cancelEnvelope","summary":"Cancel an envelope"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Envelope successfully cancelled","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EnvelopeCancelResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1cancel/put/responses/200/content/application~1json/examples/success"]}},"schemaId":"components/schemas/EnvelopeCancelResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1cancel/put/responses/200/content/application~1json/examples/success"]},{"code":"400","description":"Envelope cannot be cancelled in its current status","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1cancel/put/responses/400/content/application~1json/examples/wrongStatus"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1cancel/put/responses/400/content/application~1json/examples/wrongStatus"]},{"code":"401","description":"Authentication failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1cancel/put/responses/401/content/application~1json/examples/invalidAuth"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1cancel/put/responses/401/content/application~1json/examples/invalidAuth"]},{"code":"404","description":"Envelope not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1cancel/put/responses/404/content/application~1json/examples/unknownEnvelope"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1cancel/put/responses/404/content/application~1json/examples/unknownEnvelope"]}],"pointer":"/paths/~1envelopes~1{envelope_fingerprint}~1cancel/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/EnvelopeCancelResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1cancel/put/responses/200/content/application~1json/examples/success"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EnvelopeCancelResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1cancel/put/responses/200/content/application~1json/examples/success"]}}},{"code":"400","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1cancel/put/responses/400/content/application~1json/examples/wrongStatus"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1cancel/put/responses/400/content/application~1json/examples/wrongStatus"]}}},{"code":"401","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1cancel/put/responses/401/content/application~1json/examples/invalidAuth"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1cancel/put/responses/401/content/application~1json/examples/invalidAuth"]}}},{"code":"404","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1cancel/put/responses/404/content/application~1json/examples/unknownEnvelope"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1cancel/put/responses/404/content/application~1json/examples/unknownEnvelope"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/envelopes/cancelenvelope"}],"panels":[]}]},"httpPath":"/envelopes/{envelope_fingerprint}/cancel"},{"label":"Expire an envelope","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/envelopes/expireenvelope","routeSlug":"/openapi/envelopes/expireenvelope","metadata":{"seo":{"title":"Expire an envelope","description":"Expires a sent envelope, preventing any further signing interaction. No notification email is sent to signers when an envelope expires."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"expireEnvelope","name":"Expire an envelope","isWebhook":false,"pointer":"/paths/~1envelopes~1{envelope_fingerprint}~1expire/put","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Expire an envelope","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Expires a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"sent"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" envelope, preventing any further signing interaction. No notification email is sent to signers when an envelope expires."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"envelope_fingerprint","in":"path","schemaId":"schema_43","description":"The unique identifier of the envelope.","required":true}],"pointer":"/paths/~1envelopes~1{envelope_fingerprint}~1expire/put/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/envelopes/{envelope_fingerprint}/expire","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[{"name":"envelope_fingerprint","in":"path","required":true,"schemaId":"schema_43"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/envelopes/{envelope_fingerprint}/expire","href":"envelopes/expireenvelope","openApiOperationId":"expireEnvelope","summary":"Expire an envelope"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Envelope successfully expired","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EnvelopeExpireResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1expire/put/responses/200/content/application~1json/examples/success"]}},"schemaId":"components/schemas/EnvelopeExpireResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1expire/put/responses/200/content/application~1json/examples/success"]}],"pointer":"/paths/~1envelopes~1{envelope_fingerprint}~1expire/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/EnvelopeExpireResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1expire/put/responses/200/content/application~1json/examples/success"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EnvelopeExpireResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1expire/put/responses/200/content/application~1json/examples/success"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/envelopes/expireenvelope"}],"panels":[]}]},"httpPath":"/envelopes/{envelope_fingerprint}/expire"},{"label":"Update an envelope party","deprecated":false,"httpVerb":"patch","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/envelopes/updateenvelopeparty","routeSlug":"/openapi/envelopes/updateenvelopeparty","metadata":{"seo":{"title":"Update an envelope party","description":"Updates an envelope party email address and/or title."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateEnvelopeParty","name":"Update an envelope party","isWebhook":false,"pointer":"/paths/~1envelopes~1{envelope_fingerprint}~1parties~1{party_id}/patch","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update an envelope party","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Updates an envelope party email address and/or title."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"⚠️ "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" Maximum 5 successful updates in total per party (in any combination of email and title)."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"envelope_fingerprint","in":"path","schemaId":"schema_45","description":"The unique identifier of the envelope containing the party.","required":true},{"name":"party_id","in":"path","schemaId":"schema_46","description":"The unique ID of the party to update.","required":true}],"pointer":"/paths/~1envelopes~1{envelope_fingerprint}~1parties~1{party_id}/patch/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/EnvelopePartyUpdateRequest","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1parties~1{party_id}/patch/requestBody/content/application~1json/examples/default"]}},"schemaId":"components/schemas/EnvelopePartyUpdateRequest","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1parties~1{party_id}/patch/requestBody/content/application~1json/examples/default"],"pointer":"/paths/~1envelopes~1{envelope_fingerprint}~1parties~1{party_id}/patch/requestBody","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"At least one of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"party_email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"party_title"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must be provided and must differ from the current value."},"children":[]}]}]}]}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PATCH","path":"/envelopes/{envelope_fingerprint}/parties/{party_id}","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[{"name":"envelope_fingerprint","in":"path","required":true,"example":"584ea8b41b0d4c17a96b967433b211e6","schemaId":"schema_45"},{"name":"party_id","in":"path","required":true,"example":1234567,"schemaId":"schema_46"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/EnvelopePartyUpdateRequest","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1parties~1{party_id}/patch/requestBody/content/application~1json/examples/default"]}},"responseCodes":["200"],"pointer":"/envelopes/{envelope_fingerprint}/parties/{party_id}","href":"envelopes/updateenvelopeparty","openApiOperationId":"updateEnvelopeParty","summary":"Update an envelope party"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"schemaId":"components/schemas/EnvelopePartyUpdateRequest","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1parties~1{party_id}/patch/requestBody/content/application~1json/examples/default"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/EnvelopePartyUpdateRequest","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1parties~1{party_id}/patch/requestBody/content/application~1json/examples/default"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Party updated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EnvelopePartyUpdateResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1parties~1{party_id}/patch/responses/200/content/application~1json/examples/default"]}},"schemaId":"components/schemas/EnvelopePartyUpdateResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1parties~1{party_id}/patch/responses/200/content/application~1json/examples/default"]}],"pointer":"/paths/~1envelopes~1{envelope_fingerprint}~1parties~1{party_id}/patch/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/EnvelopePartyUpdateResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1parties~1{party_id}/patch/responses/200/content/application~1json/examples/default"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EnvelopePartyUpdateResponse","exampleIds":["paths/~1envelopes~1{envelope_fingerprint}~1parties~1{party_id}/patch/responses/200/content/application~1json/examples/default"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/envelopes/updateenvelopeparty"}],"panels":[]}]},"httpPath":"/envelopes/{envelope_fingerprint}/parties/{party_id}"}],"content":{"contentType":"group","meta":{"name":"Envelopes"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Envelopes","showPageActions":true},{"nodeType":"markdoc","content":"Send, track, and manage documents for e-signature."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/envelopes","summary":"List envelopes","prefix":{"name":"get","color":"get"},"badges":[],"link":"/envelopes/listenvelopes","deprecated":false},{"title":"/envelopes","summary":"Send an envelope","prefix":{"name":"post","color":"post"},"badges":[],"link":"/envelopes/sendenvelope","deprecated":false},{"title":"/envelopes/{envelope_fingerprint}","summary":"Get envelope details","prefix":{"name":"get","color":"get"},"badges":[],"link":"/envelopes/getenvelope","deprecated":false},{"title":"/envelopes/{envelope_fingerprint}","summary":"Delete an envelope","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/envelopes/deleteenvelope","deprecated":false},{"title":"/envelopes/{envelope_fingerprint}/remind","summary":"Send envelope reminder","prefix":{"name":"put","color":"put"},"badges":[],"link":"/envelopes/remindenvelope","deprecated":false},{"title":"/envelopes/{envelope_fingerprint}/cancel","summary":"Cancel an envelope","prefix":{"name":"put","color":"put"},"badges":[],"link":"/envelopes/cancelenvelope","deprecated":false},{"title":"/envelopes/{envelope_fingerprint}/expire","summary":"Expire an envelope","prefix":{"name":"put","color":"put"},"badges":[],"link":"/envelopes/expireenvelope","deprecated":false},{"title":"/envelopes/{envelope_fingerprint}/parties/{party_id}","summary":"Update an envelope party","prefix":{"name":"patch","color":"patch"},"badges":[],"link":"/envelopes/updateenvelopeparty","deprecated":false}]}]}]}]}},{"type":"group","label":"Templates","link":"/openapi/templates","routeSlug":"/openapi/templates","items":[{"label":"List templates","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/templates/listtemplates","routeSlug":"/openapi/templates/listtemplates","metadata":{"seo":{"title":"List templates","description":"Retrieves a paginated list of all templates available in your account."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listTemplates","name":"List templates","isWebhook":false,"pointer":"/paths/~1templates/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List templates","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves a paginated list of all templates available in your account.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"offset","in":"query","schemaId":"schema_37","description":"The index of the first envelope to retrieve."},{"name":"limit","in":"query","schemaId":"schema_38","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The maximum number of envelopes to return. If more than "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"50"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is requested, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"10"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" will be returned instead."},"children":[]}]}]}]}],"pointer":"/paths/~1templates/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/templates","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"offset","in":"query","required":false,"example":0,"schemaId":"schema_37"},{"name":"limit","in":"query","required":false,"schemaId":"schema_38"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/templates","href":"templates/listtemplates","openApiOperationId":"listTemplates","summary":"List templates"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Templates list returned successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TemplatesListResponse","exampleIds":["paths/~1templates/get/responses/200/content/application~1json/examples/default"]}},"schemaId":"components/schemas/TemplatesListResponse","exampleIds":["paths/~1templates/get/responses/200/content/application~1json/examples/default"]}],"pointer":"/paths/~1templates/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/TemplatesListResponse","exampleIds":["paths/~1templates/get/responses/200/content/application~1json/examples/default"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TemplatesListResponse","exampleIds":["paths/~1templates/get/responses/200/content/application~1json/examples/default"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/templates/listtemplates"}],"panels":[]}]},"httpPath":"/templates"},{"label":"Get template","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/templates/gettemplate","routeSlug":"/openapi/templates/gettemplate","metadata":{"seo":{"title":"Get template","description":"Retrieves metadata and configuration for a single template."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getTemplate","name":"Get template","isWebhook":false,"pointer":"/paths/~1templates~1{template_fingerprint}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get template","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves metadata and configuration for a single template."},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"template_fingerprint","in":"path","schemaId":"schema_47","description":"The unique fingerprint of the template","required":true}],"pointer":"/paths/~1templates~1{template_fingerprint}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/templates/{template_fingerprint}","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[{"name":"template_fingerprint","in":"path","required":true,"example":"b786a173554cc06371248caf0b250704","schemaId":"schema_47"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/templates/{template_fingerprint}","href":"templates/gettemplate","openApiOperationId":"getTemplate","summary":"Get template"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Template details returned successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TemplateGetResponse","exampleIds":["paths/~1templates~1{template_fingerprint}/get/responses/200/content/application~1json/examples/default"]}},"schemaId":"components/schemas/TemplateGetResponse","exampleIds":["paths/~1templates~1{template_fingerprint}/get/responses/200/content/application~1json/examples/default"]}],"pointer":"/paths/~1templates~1{template_fingerprint}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/TemplateGetResponse","exampleIds":["paths/~1templates~1{template_fingerprint}/get/responses/200/content/application~1json/examples/default"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TemplateGetResponse","exampleIds":["paths/~1templates~1{template_fingerprint}/get/responses/200/content/application~1json/examples/default"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/templates/gettemplate"}],"panels":[]}]},"httpPath":"/templates/{template_fingerprint}"},{"label":"Delete a template","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/templates/deletetemplate","routeSlug":"/openapi/templates/deletetemplate","metadata":{"seo":{"title":"Delete a template","description":"Deletes a template by its fingerprint."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteTemplate","name":"Delete a template","isWebhook":false,"pointer":"/paths/~1templates~1{template_fingerprint}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete a template","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Deletes a template by its fingerprint."},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"template_fingerprint","in":"path","schemaId":"schema_48","description":"The unique fingerprint of the template to delete","required":true}],"pointer":"/paths/~1templates~1{template_fingerprint}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/templates/{template_fingerprint}","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[{"name":"template_fingerprint","in":"path","required":true,"example":"e0b3a9cbd4a6ff2cb57cfca161a39309","schemaId":"schema_48"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/templates/{template_fingerprint}","href":"templates/deletetemplate","openApiOperationId":"deleteTemplate","summary":"Delete a template"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Template deleted successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TemplateDeleteResponse","exampleIds":["paths/~1templates~1{template_fingerprint}/delete/responses/200/content/application~1json/examples/default"]}},"schemaId":"components/schemas/TemplateDeleteResponse","exampleIds":["paths/~1templates~1{template_fingerprint}/delete/responses/200/content/application~1json/examples/default"]}],"pointer":"/paths/~1templates~1{template_fingerprint}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/TemplateDeleteResponse","exampleIds":["paths/~1templates~1{template_fingerprint}/delete/responses/200/content/application~1json/examples/default"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TemplateDeleteResponse","exampleIds":["paths/~1templates~1{template_fingerprint}/delete/responses/200/content/application~1json/examples/default"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/templates/deletetemplate"}],"panels":[]}]},"httpPath":"/templates/{template_fingerprint}"}],"content":{"contentType":"group","meta":{"name":"Templates"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Templates","showPageActions":true},{"nodeType":"markdoc","content":"Create and reuse predefined document templates."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/templates","summary":"List templates","prefix":{"name":"get","color":"get"},"badges":[],"link":"/templates/listtemplates","deprecated":false},{"title":"/templates/{template_fingerprint}","summary":"Get template","prefix":{"name":"get","color":"get"},"badges":[],"link":"/templates/gettemplate","deprecated":false},{"title":"/templates/{template_fingerprint}","summary":"Delete a template","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/templates/deletetemplate","deprecated":false}]}]}]}]}},{"type":"group","label":"Contacts","link":"/openapi/contacts","routeSlug":"/openapi/contacts","items":[{"label":"List contacts","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/contacts/listcontacts","routeSlug":"/openapi/contacts/listcontacts","metadata":{"seo":{"title":"List contacts","description":"Retrieves a paginated list of all contacts. Use offset and limit query parameters to control pagination."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listContacts","name":"List contacts","isWebhook":false,"pointer":"/paths/~1contacts/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List contacts","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retrieves a paginated list of all contacts. Use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"offset"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"limit"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" query parameters to control pagination."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"offset","in":"query","schemaId":"schema_37","description":"The index of the first envelope to retrieve."},{"name":"limit","in":"query","schemaId":"schema_38","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The maximum number of envelopes to return. If more than "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"50"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is requested, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"10"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" will be returned instead."},"children":[]}]}]}]}],"pointer":"/paths/~1contacts/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/contacts","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"offset","in":"query","required":false,"example":0,"schemaId":"schema_37"},{"name":"limit","in":"query","required":false,"schemaId":"schema_38"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200","401"],"pointer":"/contacts","href":"contacts/listcontacts","openApiOperationId":"listContacts","summary":"List contacts"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Contact list returned successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ContactsListResponse","exampleIds":["paths/~1contacts/get/responses/200/content/application~1json/examples/default"]}},"schemaId":"components/schemas/ContactsListResponse","exampleIds":["paths/~1contacts/get/responses/200/content/application~1json/examples/default"]},{"code":"401","description":"Authentication failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1contacts/get/responses/401/content/application~1json/examples/missingOrBlankAuth","paths/~1contacts/get/responses/401/content/application~1json/examples/invalidAuth"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1contacts/get/responses/401/content/application~1json/examples/missingOrBlankAuth","paths/~1contacts/get/responses/401/content/application~1json/examples/invalidAuth"]}],"pointer":"/paths/~1contacts/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ContactsListResponse","exampleIds":["paths/~1contacts/get/responses/200/content/application~1json/examples/default"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ContactsListResponse","exampleIds":["paths/~1contacts/get/responses/200/content/application~1json/examples/default"]}}},{"code":"401","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1contacts/get/responses/401/content/application~1json/examples/missingOrBlankAuth","paths/~1contacts/get/responses/401/content/application~1json/examples/invalidAuth"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1contacts/get/responses/401/content/application~1json/examples/missingOrBlankAuth","paths/~1contacts/get/responses/401/content/application~1json/examples/invalidAuth"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/contacts/listcontacts"}],"panels":[]}]},"httpPath":"/contacts"},{"label":"Create a contact","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/contacts/createcontact","routeSlug":"/openapi/contacts/createcontact","metadata":{"seo":{"title":"Create a contact","description":"Adds a new contact to your contact list. Invalid contact_email values are currently returned as the same error used for a missing email address."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createContact","name":"Create a contact","isWebhook":false,"pointer":"/paths/~1contacts/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a contact","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Adds a new contact to your contact list. Invalid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"contact_email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" values are currently returned as the same error used for a missing email address."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ContactCreateRequest","exampleIds":["paths/~1contacts/post/requestBody/content/application~1json/examples/default"]}},"schemaId":"components/schemas/ContactCreateRequest","exampleIds":["paths/~1contacts/post/requestBody/content/application~1json/examples/default"],"pointer":"/paths/~1contacts/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/contacts","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/ContactCreateRequest","exampleIds":["paths/~1contacts/post/requestBody/content/application~1json/examples/default"]}},"responseCodes":["200","400","401"],"pointer":"/contacts","href":"contacts/createcontact","openApiOperationId":"createContact","summary":"Create a contact"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"schemaId":"components/schemas/ContactCreateRequest","exampleIds":["paths/~1contacts/post/requestBody/content/application~1json/examples/default"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ContactCreateRequest","exampleIds":["paths/~1contacts/post/requestBody/content/application~1json/examples/default"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Contact created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ContactCreateResponse","exampleIds":["paths/~1contacts/post/responses/200/content/application~1json/examples/default"]}},"schemaId":"components/schemas/ContactCreateResponse","exampleIds":["paths/~1contacts/post/responses/200/content/application~1json/examples/default"]},{"code":"400","description":"Invalid contact create request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1contacts/post/responses/400/content/application~1json/examples/missingContactName","paths/~1contacts/post/responses/400/content/application~1json/examples/missingBody","paths/~1contacts/post/responses/400/content/application~1json/examples/malformedJson","paths/~1contacts/post/responses/400/content/application~1json/examples/missingContactEmail","paths/~1contacts/post/responses/400/content/application~1json/examples/invalidContactEmail","paths/~1contacts/post/responses/400/content/application~1json/examples/duplicateContactEmail"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1contacts/post/responses/400/content/application~1json/examples/missingContactName","paths/~1contacts/post/responses/400/content/application~1json/examples/missingBody","paths/~1contacts/post/responses/400/content/application~1json/examples/malformedJson","paths/~1contacts/post/responses/400/content/application~1json/examples/missingContactEmail","paths/~1contacts/post/responses/400/content/application~1json/examples/invalidContactEmail","paths/~1contacts/post/responses/400/content/application~1json/examples/duplicateContactEmail"]},{"code":"401","description":"Authentication failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1contacts/post/responses/401/content/application~1json/examples/missingOrBlankAuth","paths/~1contacts/post/responses/401/content/application~1json/examples/invalidAuth"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1contacts/post/responses/401/content/application~1json/examples/missingOrBlankAuth","paths/~1contacts/post/responses/401/content/application~1json/examples/invalidAuth"]}],"pointer":"/paths/~1contacts/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ContactCreateResponse","exampleIds":["paths/~1contacts/post/responses/200/content/application~1json/examples/default"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ContactCreateResponse","exampleIds":["paths/~1contacts/post/responses/200/content/application~1json/examples/default"]}}},{"code":"400","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1contacts/post/responses/400/content/application~1json/examples/missingContactName","paths/~1contacts/post/responses/400/content/application~1json/examples/missingBody","paths/~1contacts/post/responses/400/content/application~1json/examples/malformedJson","paths/~1contacts/post/responses/400/content/application~1json/examples/missingContactEmail","paths/~1contacts/post/responses/400/content/application~1json/examples/invalidContactEmail","paths/~1contacts/post/responses/400/content/application~1json/examples/duplicateContactEmail"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1contacts/post/responses/400/content/application~1json/examples/missingContactName","paths/~1contacts/post/responses/400/content/application~1json/examples/missingBody","paths/~1contacts/post/responses/400/content/application~1json/examples/malformedJson","paths/~1contacts/post/responses/400/content/application~1json/examples/missingContactEmail","paths/~1contacts/post/responses/400/content/application~1json/examples/invalidContactEmail","paths/~1contacts/post/responses/400/content/application~1json/examples/duplicateContactEmail"]}}},{"code":"401","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1contacts/post/responses/401/content/application~1json/examples/missingOrBlankAuth","paths/~1contacts/post/responses/401/content/application~1json/examples/invalidAuth"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1contacts/post/responses/401/content/application~1json/examples/missingOrBlankAuth","paths/~1contacts/post/responses/401/content/application~1json/examples/invalidAuth"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/contacts/createcontact"}],"panels":[]}]},"httpPath":"/contacts"},{"label":"Get a contact","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/contacts/getcontact","routeSlug":"/openapi/contacts/getcontact","metadata":{"seo":{"title":"Get a contact","description":"Retrieves details of a single contact by contact_id."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getContact","name":"Get a contact","isWebhook":false,"pointer":"/paths/~1contacts~1{contact_id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get a contact","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retrieves details of a single contact by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"contact_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"contact_id","in":"path","schemaId":"schema_49","description":"The unique ID of the contact","required":true}],"pointer":"/paths/~1contacts~1{contact_id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/contacts/{contact_id}","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[{"name":"contact_id","in":"path","required":true,"example":17224150,"schemaId":"schema_49"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200","401","404"],"pointer":"/contacts/{contact_id}","href":"contacts/getcontact","openApiOperationId":"getContact","summary":"Get a contact"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Contact details returned successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ContactGetResponse","exampleIds":["paths/~1contacts~1{contact_id}/get/responses/200/content/application~1json/examples/default"]}},"schemaId":"components/schemas/ContactGetResponse","exampleIds":["paths/~1contacts~1{contact_id}/get/responses/200/content/application~1json/examples/default"]},{"code":"401","description":"Authentication failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1contacts~1{contact_id}/get/responses/401/content/application~1json/examples/missingOrBlankAuth","paths/~1contacts~1{contact_id}/get/responses/401/content/application~1json/examples/invalidAuth"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1contacts~1{contact_id}/get/responses/401/content/application~1json/examples/missingOrBlankAuth","paths/~1contacts~1{contact_id}/get/responses/401/content/application~1json/examples/invalidAuth"]},{"code":"404","description":"Contact not found, or route not found for a non-numeric contact ID","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_50","exampleIds":["paths/~1contacts~1{contact_id}/get/responses/404/content/application~1json/examples/contactNotFound","paths/~1contacts~1{contact_id}/get/responses/404/content/application~1json/examples/nonNumericContactId"]}},"schemaId":"schema_50","exampleIds":["paths/~1contacts~1{contact_id}/get/responses/404/content/application~1json/examples/contactNotFound","paths/~1contacts~1{contact_id}/get/responses/404/content/application~1json/examples/nonNumericContactId"]}],"pointer":"/paths/~1contacts~1{contact_id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ContactGetResponse","exampleIds":["paths/~1contacts~1{contact_id}/get/responses/200/content/application~1json/examples/default"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ContactGetResponse","exampleIds":["paths/~1contacts~1{contact_id}/get/responses/200/content/application~1json/examples/default"]}}},{"code":"401","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1contacts~1{contact_id}/get/responses/401/content/application~1json/examples/missingOrBlankAuth","paths/~1contacts~1{contact_id}/get/responses/401/content/application~1json/examples/invalidAuth"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1contacts~1{contact_id}/get/responses/401/content/application~1json/examples/missingOrBlankAuth","paths/~1contacts~1{contact_id}/get/responses/401/content/application~1json/examples/invalidAuth"]}}},{"code":"404","schemaId":"schema_50","exampleIds":["paths/~1contacts~1{contact_id}/get/responses/404/content/application~1json/examples/contactNotFound","paths/~1contacts~1{contact_id}/get/responses/404/content/application~1json/examples/nonNumericContactId"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_50","exampleIds":["paths/~1contacts~1{contact_id}/get/responses/404/content/application~1json/examples/contactNotFound","paths/~1contacts~1{contact_id}/get/responses/404/content/application~1json/examples/nonNumericContactId"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/contacts/getcontact"}],"panels":[]}]},"httpPath":"/contacts/{contact_id}"},{"label":"Update a contact","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/contacts/updatecontact","routeSlug":"/openapi/contacts/updatecontact","metadata":{"seo":{"title":"Update a contact","description":"Updates a contact's name or email address. The API supports partial updates: send contact_name, contact_email, or both."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateContact","name":"Update a contact","isWebhook":false,"pointer":"/paths/~1contacts~1{contact_id}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a contact","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Updates a contact's name or email address. The API supports partial updates: send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"contact_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"contact_email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or both."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"contact_id","in":"path","schemaId":"schema_49","required":true}],"pointer":"/paths/~1contacts~1{contact_id}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ContactUpdateRequest","exampleIds":["paths/~1contacts~1{contact_id}/put/requestBody/content/application~1json/examples/default"]}},"schemaId":"components/schemas/ContactUpdateRequest","exampleIds":["paths/~1contacts~1{contact_id}/put/requestBody/content/application~1json/examples/default"],"pointer":"/paths/~1contacts~1{contact_id}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/contacts/{contact_id}","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[{"name":"contact_id","in":"path","required":true,"example":17224150,"schemaId":"schema_49"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/ContactUpdateRequest","exampleIds":["paths/~1contacts~1{contact_id}/put/requestBody/content/application~1json/examples/default"]}},"responseCodes":["200","400","401","404"],"pointer":"/contacts/{contact_id}","href":"contacts/updatecontact","openApiOperationId":"updateContact","summary":"Update a contact"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"schemaId":"components/schemas/ContactUpdateRequest","exampleIds":["paths/~1contacts~1{contact_id}/put/requestBody/content/application~1json/examples/default"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ContactUpdateRequest","exampleIds":["paths/~1contacts~1{contact_id}/put/requestBody/content/application~1json/examples/default"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Contact updated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ContactUpdateResponse","exampleIds":["paths/~1contacts~1{contact_id}/put/responses/200/content/application~1json/examples/default"]}},"schemaId":"components/schemas/ContactUpdateResponse","exampleIds":["paths/~1contacts~1{contact_id}/put/responses/200/content/application~1json/examples/default"]},{"code":"400","description":"Invalid contact update request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1contacts~1{contact_id}/put/responses/400/content/application~1json/examples/missingBody","paths/~1contacts~1{contact_id}/put/responses/400/content/application~1json/examples/malformedJson"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1contacts~1{contact_id}/put/responses/400/content/application~1json/examples/missingBody","paths/~1contacts~1{contact_id}/put/responses/400/content/application~1json/examples/malformedJson"]},{"code":"401","description":"Authentication failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1contacts~1{contact_id}/put/responses/401/content/application~1json/examples/missingOrBlankAuth","paths/~1contacts~1{contact_id}/put/responses/401/content/application~1json/examples/invalidAuth"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1contacts~1{contact_id}/put/responses/401/content/application~1json/examples/missingOrBlankAuth","paths/~1contacts~1{contact_id}/put/responses/401/content/application~1json/examples/invalidAuth"]},{"code":"404","description":"Contact not found, or route not found for a non-numeric contact ID","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_50","exampleIds":["paths/~1contacts~1{contact_id}/put/responses/404/content/application~1json/examples/contactNotFound","paths/~1contacts~1{contact_id}/put/responses/404/content/application~1json/examples/nonNumericContactId"]}},"schemaId":"schema_50","exampleIds":["paths/~1contacts~1{contact_id}/put/responses/404/content/application~1json/examples/contactNotFound","paths/~1contacts~1{contact_id}/put/responses/404/content/application~1json/examples/nonNumericContactId"]}],"pointer":"/paths/~1contacts~1{contact_id}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ContactUpdateResponse","exampleIds":["paths/~1contacts~1{contact_id}/put/responses/200/content/application~1json/examples/default"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ContactUpdateResponse","exampleIds":["paths/~1contacts~1{contact_id}/put/responses/200/content/application~1json/examples/default"]}}},{"code":"400","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1contacts~1{contact_id}/put/responses/400/content/application~1json/examples/missingBody","paths/~1contacts~1{contact_id}/put/responses/400/content/application~1json/examples/malformedJson"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1contacts~1{contact_id}/put/responses/400/content/application~1json/examples/missingBody","paths/~1contacts~1{contact_id}/put/responses/400/content/application~1json/examples/malformedJson"]}}},{"code":"401","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1contacts~1{contact_id}/put/responses/401/content/application~1json/examples/missingOrBlankAuth","paths/~1contacts~1{contact_id}/put/responses/401/content/application~1json/examples/invalidAuth"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1contacts~1{contact_id}/put/responses/401/content/application~1json/examples/missingOrBlankAuth","paths/~1contacts~1{contact_id}/put/responses/401/content/application~1json/examples/invalidAuth"]}}},{"code":"404","schemaId":"schema_50","exampleIds":["paths/~1contacts~1{contact_id}/put/responses/404/content/application~1json/examples/contactNotFound","paths/~1contacts~1{contact_id}/put/responses/404/content/application~1json/examples/nonNumericContactId"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_50","exampleIds":["paths/~1contacts~1{contact_id}/put/responses/404/content/application~1json/examples/contactNotFound","paths/~1contacts~1{contact_id}/put/responses/404/content/application~1json/examples/nonNumericContactId"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/contacts/updatecontact"}],"panels":[]}]},"httpPath":"/contacts/{contact_id}"},{"label":"Delete a contact","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/contacts/deletecontact","routeSlug":"/openapi/contacts/deletecontact","metadata":{"seo":{"title":"Delete a contact","description":"Deletes a contact by their contact_id."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteContact","name":"Delete a contact","isWebhook":false,"pointer":"/paths/~1contacts~1{contact_id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete a contact","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Deletes a contact by their "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"contact_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"contact_id","in":"path","schemaId":"schema_49","required":true}],"pointer":"/paths/~1contacts~1{contact_id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/contacts/{contact_id}","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[{"name":"contact_id","in":"path","required":true,"example":17224150,"schemaId":"schema_49"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200","401","404"],"pointer":"/contacts/{contact_id}","href":"contacts/deletecontact","openApiOperationId":"deleteContact","summary":"Delete a contact"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Contact deleted successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ContactDeleteResponse","exampleIds":["paths/~1contacts~1{contact_id}/delete/responses/200/content/application~1json/examples/default"]}},"schemaId":"components/schemas/ContactDeleteResponse","exampleIds":["paths/~1contacts~1{contact_id}/delete/responses/200/content/application~1json/examples/default"]},{"code":"401","description":"Authentication failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1contacts~1{contact_id}/delete/responses/401/content/application~1json/examples/missingOrBlankAuth","paths/~1contacts~1{contact_id}/delete/responses/401/content/application~1json/examples/invalidAuth"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1contacts~1{contact_id}/delete/responses/401/content/application~1json/examples/missingOrBlankAuth","paths/~1contacts~1{contact_id}/delete/responses/401/content/application~1json/examples/invalidAuth"]},{"code":"404","description":"Contact not found, or route not found for a non-numeric contact ID","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_50","exampleIds":["paths/~1contacts~1{contact_id}/delete/responses/404/content/application~1json/examples/contactNotFound","paths/~1contacts~1{contact_id}/delete/responses/404/content/application~1json/examples/nonNumericContactId"]}},"schemaId":"schema_50","exampleIds":["paths/~1contacts~1{contact_id}/delete/responses/404/content/application~1json/examples/contactNotFound","paths/~1contacts~1{contact_id}/delete/responses/404/content/application~1json/examples/nonNumericContactId"]}],"pointer":"/paths/~1contacts~1{contact_id}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ContactDeleteResponse","exampleIds":["paths/~1contacts~1{contact_id}/delete/responses/200/content/application~1json/examples/default"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ContactDeleteResponse","exampleIds":["paths/~1contacts~1{contact_id}/delete/responses/200/content/application~1json/examples/default"]}}},{"code":"401","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1contacts~1{contact_id}/delete/responses/401/content/application~1json/examples/missingOrBlankAuth","paths/~1contacts~1{contact_id}/delete/responses/401/content/application~1json/examples/invalidAuth"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1contacts~1{contact_id}/delete/responses/401/content/application~1json/examples/missingOrBlankAuth","paths/~1contacts~1{contact_id}/delete/responses/401/content/application~1json/examples/invalidAuth"]}}},{"code":"404","schemaId":"schema_50","exampleIds":["paths/~1contacts~1{contact_id}/delete/responses/404/content/application~1json/examples/contactNotFound","paths/~1contacts~1{contact_id}/delete/responses/404/content/application~1json/examples/nonNumericContactId"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_50","exampleIds":["paths/~1contacts~1{contact_id}/delete/responses/404/content/application~1json/examples/contactNotFound","paths/~1contacts~1{contact_id}/delete/responses/404/content/application~1json/examples/nonNumericContactId"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/contacts/deletecontact"}],"panels":[]}]},"httpPath":"/contacts/{contact_id}"},{"label":"List envelopes for a contact","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/contacts/listcontactenvelopes","routeSlug":"/openapi/contacts/listcontactenvelopes","metadata":{"seo":{"title":"List envelopes for a contact","description":"Returns a paginated list of all envelopes that the contact is a recipient of. Each envelope includes basic metadata such as its current status, timestamps, and optional signed PDF link."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listContactEnvelopes","name":"List envelopes for a contact","isWebhook":false,"pointer":"/paths/~1contacts~1{contact_id}~1envelopes/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List envelopes for a contact","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns a paginated list of all envelopes that the contact is a recipient of. Each envelope includes basic metadata such as its current status, timestamps, and optional signed PDF link.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"contact_id","in":"path","schemaId":"schema_51","description":"The unique ID of the contact","required":true}],"pointer":"/paths/~1contacts~1{contact_id}~1envelopes/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"offset","in":"query","schemaId":"schema_37","description":"The index of the first envelope to retrieve."},{"name":"limit","in":"query","schemaId":"schema_38","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The maximum number of envelopes to return. If more than "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"50"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is requested, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"10"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" will be returned instead."},"children":[]}]}]}]}],"pointer":"/paths/~1contacts~1{contact_id}~1envelopes/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/contacts/{contact_id}/envelopes","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[{"name":"contact_id","in":"path","required":true,"example":17225983,"schemaId":"schema_51"}],"query":[{"name":"offset","in":"query","required":false,"example":0,"schemaId":"schema_37"},{"name":"limit","in":"query","required":false,"schemaId":"schema_38"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200","401","404"],"pointer":"/contacts/{contact_id}/envelopes","href":"contacts/listcontactenvelopes","openApiOperationId":"listContactEnvelopes","summary":"List envelopes for a contact"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"List of envelopes the contact is associated with","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ContactEnvelopesListResponse","exampleIds":["paths/~1contacts~1{contact_id}~1envelopes/get/responses/200/content/application~1json/examples/default"]}},"schemaId":"components/schemas/ContactEnvelopesListResponse","exampleIds":["paths/~1contacts~1{contact_id}~1envelopes/get/responses/200/content/application~1json/examples/default"]},{"code":"401","description":"Authentication failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1contacts~1{contact_id}~1envelopes/get/responses/401/content/application~1json/examples/missingOrBlankAuth","paths/~1contacts~1{contact_id}~1envelopes/get/responses/401/content/application~1json/examples/invalidAuth"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1contacts~1{contact_id}~1envelopes/get/responses/401/content/application~1json/examples/missingOrBlankAuth","paths/~1contacts~1{contact_id}~1envelopes/get/responses/401/content/application~1json/examples/invalidAuth"]},{"code":"404","description":"Contact has no envelopes, or route not found for a non-numeric contact ID","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_50","exampleIds":["paths/~1contacts~1{contact_id}~1envelopes/get/responses/404/content/application~1json/examples/noContactEnvelopes","paths/~1contacts~1{contact_id}~1envelopes/get/responses/404/content/application~1json/examples/nonNumericContactId"]}},"schemaId":"schema_50","exampleIds":["paths/~1contacts~1{contact_id}~1envelopes/get/responses/404/content/application~1json/examples/noContactEnvelopes","paths/~1contacts~1{contact_id}~1envelopes/get/responses/404/content/application~1json/examples/nonNumericContactId"]}],"pointer":"/paths/~1contacts~1{contact_id}~1envelopes/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ContactEnvelopesListResponse","exampleIds":["paths/~1contacts~1{contact_id}~1envelopes/get/responses/200/content/application~1json/examples/default"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ContactEnvelopesListResponse","exampleIds":["paths/~1contacts~1{contact_id}~1envelopes/get/responses/200/content/application~1json/examples/default"]}}},{"code":"401","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1contacts~1{contact_id}~1envelopes/get/responses/401/content/application~1json/examples/missingOrBlankAuth","paths/~1contacts~1{contact_id}~1envelopes/get/responses/401/content/application~1json/examples/invalidAuth"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1contacts~1{contact_id}~1envelopes/get/responses/401/content/application~1json/examples/missingOrBlankAuth","paths/~1contacts~1{contact_id}~1envelopes/get/responses/401/content/application~1json/examples/invalidAuth"]}}},{"code":"404","schemaId":"schema_50","exampleIds":["paths/~1contacts~1{contact_id}~1envelopes/get/responses/404/content/application~1json/examples/noContactEnvelopes","paths/~1contacts~1{contact_id}~1envelopes/get/responses/404/content/application~1json/examples/nonNumericContactId"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_50","exampleIds":["paths/~1contacts~1{contact_id}~1envelopes/get/responses/404/content/application~1json/examples/noContactEnvelopes","paths/~1contacts~1{contact_id}~1envelopes/get/responses/404/content/application~1json/examples/nonNumericContactId"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/contacts/listcontactenvelopes"}],"panels":[]}]},"httpPath":"/contacts/{contact_id}/envelopes"}],"content":{"contentType":"group","meta":{"name":"Contacts"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Contacts","showPageActions":true},{"nodeType":"markdoc","content":"Manage contact details for signers and stakeholders."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/contacts","summary":"List contacts","prefix":{"name":"get","color":"get"},"badges":[],"link":"/contacts/listcontacts","deprecated":false},{"title":"/contacts","summary":"Create a contact","prefix":{"name":"post","color":"post"},"badges":[],"link":"/contacts/createcontact","deprecated":false},{"title":"/contacts/{contact_id}","summary":"Get a contact","prefix":{"name":"get","color":"get"},"badges":[],"link":"/contacts/getcontact","deprecated":false},{"title":"/contacts/{contact_id}","summary":"Update a contact","prefix":{"name":"put","color":"put"},"badges":[],"link":"/contacts/updatecontact","deprecated":false},{"title":"/contacts/{contact_id}","summary":"Delete a contact","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/contacts/deletecontact","deprecated":false},{"title":"/contacts/{contact_id}/envelopes","summary":"List envelopes for a contact","prefix":{"name":"get","color":"get"},"badges":[],"link":"/contacts/listcontactenvelopes","deprecated":false}]}]}]}]}},{"type":"group","label":"Users","link":"/openapi/users","routeSlug":"/openapi/users","items":[{"label":"List users","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/users/listusers","routeSlug":"/openapi/users/listusers","metadata":{"seo":{"title":"List users","description":"Retrieves a paginated list of all users in your account. You can control pagination using the offset and limit query parameters."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listUsers","name":"List users","isWebhook":false,"pointer":"/paths/~1users/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List users","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retrieves a paginated list of all users in your account. You can control pagination using the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"offset"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"limit"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" query parameters."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"offset","in":"query","schemaId":"schema_37","description":"The index of the first envelope to retrieve."},{"name":"limit","in":"query","schemaId":"schema_38","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The maximum number of envelopes to return. If more than "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"50"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is requested, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"10"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" will be returned instead."},"children":[]}]}]}]}],"pointer":"/paths/~1users/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/users","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"offset","in":"query","required":false,"example":0,"schemaId":"schema_37"},{"name":"limit","in":"query","required":false,"schemaId":"schema_38"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/users","href":"users/listusers","openApiOperationId":"listUsers","summary":"List users"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Users list returned successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/UsersListResponse","exampleIds":["paths/~1users/get/responses/200/content/application~1json/examples/default"]}},"schemaId":"components/schemas/UsersListResponse","exampleIds":["paths/~1users/get/responses/200/content/application~1json/examples/default"]}],"pointer":"/paths/~1users/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/UsersListResponse","exampleIds":["paths/~1users/get/responses/200/content/application~1json/examples/default"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/UsersListResponse","exampleIds":["paths/~1users/get/responses/200/content/application~1json/examples/default"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/users/listusers"}],"panels":[]}]},"httpPath":"/users"},{"label":"Create a user","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/users/createuser","routeSlug":"/openapi/users/createuser","metadata":{"seo":{"title":"Create a user","description":"Adds a new user to your account. You must provide the user’s name, email address, and their role ID."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createUser","name":"Create a user","isWebhook":false,"pointer":"/paths/~1users/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a user","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Adds a new user to your account. You must provide the user’s name, email address, and their role ID."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UserCreateRequest","exampleIds":["paths/~1users/post/requestBody/content/application~1json/examples/default"]}},"schemaId":"components/schemas/UserCreateRequest","exampleIds":["paths/~1users/post/requestBody/content/application~1json/examples/default"],"pointer":"/paths/~1users/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/users","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UserCreateRequest","exampleIds":["paths/~1users/post/requestBody/content/application~1json/examples/default"]}},"responseCodes":["200"],"pointer":"/users","href":"users/createuser","openApiOperationId":"createUser","summary":"Create a user"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"schemaId":"components/schemas/UserCreateRequest","exampleIds":["paths/~1users/post/requestBody/content/application~1json/examples/default"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UserCreateRequest","exampleIds":["paths/~1users/post/requestBody/content/application~1json/examples/default"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"User created successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/UserCreateResponse","exampleIds":["paths/~1users/post/responses/200/content/application~1json/examples/default"]}},"schemaId":"components/schemas/UserCreateResponse","exampleIds":["paths/~1users/post/responses/200/content/application~1json/examples/default"]}],"pointer":"/paths/~1users/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/UserCreateResponse","exampleIds":["paths/~1users/post/responses/200/content/application~1json/examples/default"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/UserCreateResponse","exampleIds":["paths/~1users/post/responses/200/content/application~1json/examples/default"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/users/createuser"}],"panels":[]}]},"httpPath":"/users"},{"label":"Get a user","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/users/getuser","routeSlug":"/openapi/users/getuser","metadata":{"seo":{"title":"Get a user","description":"Retrieves the details of a single user by their unique user_id. The response includes the user's name, email, role, and timestamps."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getUser","name":"Get a user","isWebhook":false,"pointer":"/paths/~1users~1{user_id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get a user","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retrieves the details of a single user by their unique "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"user_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The response includes the user's name, email, role, and timestamps."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"user_id","in":"path","schemaId":"schema_52","description":"The unique ID of the user to retrieve","required":true}],"pointer":"/paths/~1users~1{user_id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/users/{user_id}","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[{"name":"user_id","in":"path","required":true,"example":836499,"schemaId":"schema_52"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/users/{user_id}","href":"users/getuser","openApiOperationId":"getUser","summary":"Get a user"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"User details returned successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/UserGetResponse","exampleIds":["paths/~1users~1{user_id}/get/responses/200/content/application~1json/examples/default"]}},"schemaId":"components/schemas/UserGetResponse","exampleIds":["paths/~1users~1{user_id}/get/responses/200/content/application~1json/examples/default"]}],"pointer":"/paths/~1users~1{user_id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/UserGetResponse","exampleIds":["paths/~1users~1{user_id}/get/responses/200/content/application~1json/examples/default"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/UserGetResponse","exampleIds":["paths/~1users~1{user_id}/get/responses/200/content/application~1json/examples/default"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/users/getuser"}],"panels":[]}]},"httpPath":"/users/{user_id}"},{"label":"Update a user","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/users/updateuser","routeSlug":"/openapi/users/updateuser","metadata":{"seo":{"title":"Update a user","description":"Updates a user by user_id."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateUser","name":"Update a user","isWebhook":false,"pointer":"/paths/~1users~1{user_id}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a user","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Updates a user by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"user_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supports partial updates. You can send "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"user_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"user_email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or both. You can also include "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"role_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You must provide at least one of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"user_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"user_email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you omit a field, its existing value is preserved."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"user_id","in":"path","schemaId":"schema_53","description":"The unique ID of the user to update","required":true}],"pointer":"/paths/~1users~1{user_id}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UserUpdateRequest","exampleIds":["paths/~1users~1{user_id}/put/requestBody/content/application~1json/examples/userNameOnly","paths/~1users~1{user_id}/put/requestBody/content/application~1json/examples/userEmailOnly","paths/~1users~1{user_id}/put/requestBody/content/application~1json/examples/userNameAndUserEmail","paths/~1users~1{user_id}/put/requestBody/content/application~1json/examples/fullPayload"]}},"schemaId":"components/schemas/UserUpdateRequest","exampleIds":["paths/~1users~1{user_id}/put/requestBody/content/application~1json/examples/userNameOnly","paths/~1users~1{user_id}/put/requestBody/content/application~1json/examples/userEmailOnly","paths/~1users~1{user_id}/put/requestBody/content/application~1json/examples/userNameAndUserEmail","paths/~1users~1{user_id}/put/requestBody/content/application~1json/examples/fullPayload"],"pointer":"/paths/~1users~1{user_id}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/users/{user_id}","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[{"name":"user_id","in":"path","required":true,"example":837154,"schemaId":"schema_53"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UserUpdateRequest","exampleIds":["paths/~1users~1{user_id}/put/requestBody/content/application~1json/examples/userNameOnly","paths/~1users~1{user_id}/put/requestBody/content/application~1json/examples/userEmailOnly","paths/~1users~1{user_id}/put/requestBody/content/application~1json/examples/userNameAndUserEmail","paths/~1users~1{user_id}/put/requestBody/content/application~1json/examples/fullPayload"]}},"responseCodes":["200","400"],"pointer":"/users/{user_id}","href":"users/updateuser","openApiOperationId":"updateUser","summary":"Update a user"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"schemaId":"components/schemas/UserUpdateRequest","exampleIds":["paths/~1users~1{user_id}/put/requestBody/content/application~1json/examples/userNameOnly","paths/~1users~1{user_id}/put/requestBody/content/application~1json/examples/userEmailOnly","paths/~1users~1{user_id}/put/requestBody/content/application~1json/examples/userNameAndUserEmail","paths/~1users~1{user_id}/put/requestBody/content/application~1json/examples/fullPayload"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UserUpdateRequest","exampleIds":["paths/~1users~1{user_id}/put/requestBody/content/application~1json/examples/userNameOnly","paths/~1users~1{user_id}/put/requestBody/content/application~1json/examples/userEmailOnly","paths/~1users~1{user_id}/put/requestBody/content/application~1json/examples/userNameAndUserEmail","paths/~1users~1{user_id}/put/requestBody/content/application~1json/examples/fullPayload"]}},"examples":[{},{},{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"User updated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/UserUpdateResponse","exampleIds":["paths/~1users~1{user_id}/put/responses/200/content/application~1json/examples/default"]}},"schemaId":"components/schemas/UserUpdateResponse","exampleIds":["paths/~1users~1{user_id}/put/responses/200/content/application~1json/examples/default"]},{"code":"400","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Invalid request. For example, sending "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"role_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on its own returns error code "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"10104"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" because at least one of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"user_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"user_email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" must also be supplied."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_54","exampleIds":["paths/~1users~1{user_id}/put/responses/400/content/application~1json/examples/roleIdOnly"]}},"schemaId":"schema_54","exampleIds":["paths/~1users~1{user_id}/put/responses/400/content/application~1json/examples/roleIdOnly"]}],"pointer":"/paths/~1users~1{user_id}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/UserUpdateResponse","exampleIds":["paths/~1users~1{user_id}/put/responses/200/content/application~1json/examples/default"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/UserUpdateResponse","exampleIds":["paths/~1users~1{user_id}/put/responses/200/content/application~1json/examples/default"]}}},{"code":"400","schemaId":"schema_54","exampleIds":["paths/~1users~1{user_id}/put/responses/400/content/application~1json/examples/roleIdOnly"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"schema_54","exampleIds":["paths/~1users~1{user_id}/put/responses/400/content/application~1json/examples/roleIdOnly"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/users/updateuser"}],"panels":[]}]},"httpPath":"/users/{user_id}"},{"label":"Delete a user","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/users/deleteuser","routeSlug":"/openapi/users/deleteuser","metadata":{"seo":{"title":"Delete a user","description":"Removes a user from your account using their user_id. The response confirms the deletion and includes the user's basic details."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteUser","name":"Delete a user","isWebhook":false,"pointer":"/paths/~1users~1{user_id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete a user","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Removes a user from your account using their "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"user_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The response confirms the deletion and includes the user's basic details."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"user_id","in":"path","schemaId":"schema_53","description":"The unique ID of the user to delete","required":true}],"pointer":"/paths/~1users~1{user_id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/users/{user_id}","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[{"name":"user_id","in":"path","required":true,"example":837154,"schemaId":"schema_53"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/users/{user_id}","href":"users/deleteuser","openApiOperationId":"deleteUser","summary":"Delete a user"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"User deleted successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/UserDeleteResponse","exampleIds":["paths/~1users~1{user_id}/delete/responses/200/content/application~1json/examples/default"]}},"schemaId":"components/schemas/UserDeleteResponse","exampleIds":["paths/~1users~1{user_id}/delete/responses/200/content/application~1json/examples/default"]}],"pointer":"/paths/~1users~1{user_id}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/UserDeleteResponse","exampleIds":["paths/~1users~1{user_id}/delete/responses/200/content/application~1json/examples/default"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/UserDeleteResponse","exampleIds":["paths/~1users~1{user_id}/delete/responses/200/content/application~1json/examples/default"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/users/deleteuser"}],"panels":[]}]},"httpPath":"/users/{user_id}"}],"content":{"contentType":"group","meta":{"name":"Users"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Users","showPageActions":true},{"nodeType":"markdoc","content":"Control user accounts and roles."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/users","summary":"List users","prefix":{"name":"get","color":"get"},"badges":[],"link":"/users/listusers","deprecated":false},{"title":"/users","summary":"Create a user","prefix":{"name":"post","color":"post"},"badges":[],"link":"/users/createuser","deprecated":false},{"title":"/users/{user_id}","summary":"Get a user","prefix":{"name":"get","color":"get"},"badges":[],"link":"/users/getuser","deprecated":false},{"title":"/users/{user_id}","summary":"Update a user","prefix":{"name":"put","color":"put"},"badges":[],"link":"/users/updateuser","deprecated":false},{"title":"/users/{user_id}","summary":"Delete a user","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/users/deleteuser","deprecated":false}]}]}]}]}},{"type":"group","label":"Branding","link":"/openapi/branding","routeSlug":"/openapi/branding","items":[{"label":"Get branding settings","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/branding/getbranding","routeSlug":"/openapi/branding/getbranding","metadata":{"seo":{"title":"Get branding settings","description":"Returns your company's current branding settings, including any uploaded logo and primary colour. These settings control how Signable emails and signing pages appear to your signers."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getBranding","name":"Get branding settings","isWebhook":false,"pointer":"/paths/~1branding/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get branding settings","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Returns your company's current branding settings, including any uploaded logo and primary colour. These settings control how Signable emails and signing pages appear to your signers.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/branding","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/branding","href":"branding/getbranding","openApiOperationId":"getBranding","summary":"Get branding settings"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Branding settings returned successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BrandingResponse","exampleIds":["paths/~1branding/get/responses/200/content/application~1json/examples/default"]}},"schemaId":"components/schemas/BrandingResponse","exampleIds":["paths/~1branding/get/responses/200/content/application~1json/examples/default"]}],"pointer":"/paths/~1branding/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/BrandingResponse","exampleIds":["paths/~1branding/get/responses/200/content/application~1json/examples/default"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BrandingResponse","exampleIds":["paths/~1branding/get/responses/200/content/application~1json/examples/default"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/branding/getbranding"}],"panels":[]}]},"httpPath":"/branding"},{"label":"Update branding settings","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/branding/updatebranding","routeSlug":"/openapi/branding/updatebranding","metadata":{"seo":{"title":"Update branding settings","description":"Update your account's branding settings. This includes the logo and the primary colour used on emails and signing pages."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateBranding","name":"Update branding settings","isWebhook":false,"pointer":"/paths/~1branding/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update branding settings","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Update your account's branding settings. This includes the logo and the primary colour used on emails and signing pages.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/BrandingPutRequest","exampleIds":["paths/~1branding/put/requestBody/content/application~1json/examples/default"]}},"schemaId":"components/schemas/BrandingPutRequest","exampleIds":["paths/~1branding/put/requestBody/content/application~1json/examples/default"],"pointer":"/paths/~1branding/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/branding","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/BrandingPutRequest","exampleIds":["paths/~1branding/put/requestBody/content/application~1json/examples/default"]}},"responseCodes":["200"],"pointer":"/branding","href":"branding/updatebranding","openApiOperationId":"updateBranding","summary":"Update branding settings"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"schemaId":"components/schemas/BrandingPutRequest","exampleIds":["paths/~1branding/put/requestBody/content/application~1json/examples/default"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/BrandingPutRequest","exampleIds":["paths/~1branding/put/requestBody/content/application~1json/examples/default"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Branding updated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BrandingPutResponse","exampleIds":["paths/~1branding/put/responses/200/content/application~1json/examples/default"]}},"schemaId":"components/schemas/BrandingPutResponse","exampleIds":["paths/~1branding/put/responses/200/content/application~1json/examples/default"]}],"pointer":"/paths/~1branding/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/BrandingPutResponse","exampleIds":["paths/~1branding/put/responses/200/content/application~1json/examples/default"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BrandingPutResponse","exampleIds":["paths/~1branding/put/responses/200/content/application~1json/examples/default"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/branding/updatebranding"}],"panels":[]}]},"httpPath":"/branding"},{"label":"List branding emails","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/branding/getbrandingemails","routeSlug":"/openapi/branding/getbrandingemails","metadata":{"seo":{"title":"List branding emails","description":"List branding emails"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getBrandingEmails","name":"List branding emails","isWebhook":false,"pointer":"/paths/~1branding~1emails/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List branding emails","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/branding/emails","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/branding/emails","href":"branding/getbrandingemails","openApiOperationId":"getBrandingEmails","summary":"List branding emails"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"A list of branding email templates","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BrandingEmailsResponse","exampleIds":["paths/~1branding~1emails/get/responses/200/content/application~1json/examples/success"]}},"schemaId":"components/schemas/BrandingEmailsResponse","exampleIds":["paths/~1branding~1emails/get/responses/200/content/application~1json/examples/success"]}],"pointer":"/paths/~1branding~1emails/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/BrandingEmailsResponse","exampleIds":["paths/~1branding~1emails/get/responses/200/content/application~1json/examples/success"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BrandingEmailsResponse","exampleIds":["paths/~1branding~1emails/get/responses/200/content/application~1json/examples/success"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/branding/getbrandingemails"}],"panels":[]}]},"httpPath":"/branding/emails"},{"label":"Get a branding email","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/branding/getsinglebrandingemail","routeSlug":"/openapi/branding/getsinglebrandingemail","metadata":{"seo":{"title":"Get a branding email","description":"Retrieves a single branding email template"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getSingleBrandingEmail","name":"Get a branding email","isWebhook":false,"pointer":"/paths/~1branding~1emails~1{branding_email_type}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get a branding email","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves a single branding email template"},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"branding_email_type","in":"path","schemaId":"schema_55","description":"The type of branding email to retrieve","required":true}],"pointer":"/paths/~1branding~1emails~1{branding_email_type}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/branding/emails/{branding_email_type}","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[{"name":"branding_email_type","in":"path","required":true,"example":"email-cancelled","schemaId":"schema_55"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/branding/emails/{branding_email_type}","href":"branding/getsinglebrandingemail","openApiOperationId":"getSingleBrandingEmail","summary":"Get a branding email"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"A single branding email template","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BrandingEmailSingleResponse","exampleIds":["paths/~1branding~1emails~1{branding_email_type}/get/responses/200/content/application~1json/examples/success"]}},"schemaId":"components/schemas/BrandingEmailSingleResponse","exampleIds":["paths/~1branding~1emails~1{branding_email_type}/get/responses/200/content/application~1json/examples/success"]}],"pointer":"/paths/~1branding~1emails~1{branding_email_type}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/BrandingEmailSingleResponse","exampleIds":["paths/~1branding~1emails~1{branding_email_type}/get/responses/200/content/application~1json/examples/success"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BrandingEmailSingleResponse","exampleIds":["paths/~1branding~1emails~1{branding_email_type}/get/responses/200/content/application~1json/examples/success"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/branding/getsinglebrandingemail"}],"panels":[]}]},"httpPath":"/branding/emails/{branding_email_type}"},{"label":"Update a branding email","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/branding/updatebrandingemail","routeSlug":"/openapi/branding/updatebrandingemail","metadata":{"seo":{"title":"Update a branding email","description":"You can include variables like {company name} and {contract title} in your email body to personalise content. See the full list of supported variables →"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateBrandingEmail","name":"Update a branding email","isWebhook":false,"pointer":"/paths/~1branding~1emails~1{branding_email_type}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a branding email","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"You can include variables like "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{company name}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"{contract title}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in your email body to personalise content. "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"../email-variables"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See the full list of supported variables →"},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"branding_email_type","in":"path","schemaId":"schema_55","description":"The type of branding email to update","required":true}],"pointer":"/paths/~1branding~1emails~1{branding_email_type}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/BrandingEmailPutRequest","exampleIds":["paths/~1branding~1emails~1{branding_email_type}/put/requestBody/content/application~1json/examples/default"]}},"schemaId":"components/schemas/BrandingEmailPutRequest","exampleIds":["paths/~1branding~1emails~1{branding_email_type}/put/requestBody/content/application~1json/examples/default"],"pointer":"/paths/~1branding~1emails~1{branding_email_type}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/branding/emails/{branding_email_type}","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[{"name":"branding_email_type","in":"path","required":true,"example":"email-cancelled","schemaId":"schema_55"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/BrandingEmailPutRequest","exampleIds":["paths/~1branding~1emails~1{branding_email_type}/put/requestBody/content/application~1json/examples/default"]}},"responseCodes":["200"],"pointer":"/branding/emails/{branding_email_type}","href":"branding/updatebrandingemail","openApiOperationId":"updateBrandingEmail","summary":"Update a branding email"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"schemaId":"components/schemas/BrandingEmailPutRequest","exampleIds":["paths/~1branding~1emails~1{branding_email_type}/put/requestBody/content/application~1json/examples/default"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/BrandingEmailPutRequest","exampleIds":["paths/~1branding~1emails~1{branding_email_type}/put/requestBody/content/application~1json/examples/default"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Branding email successfully updated","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BrandingEmailPutResponse","exampleIds":["paths/~1branding~1emails~1{branding_email_type}/put/responses/200/content/application~1json/examples/default"]}},"schemaId":"components/schemas/BrandingEmailPutResponse","exampleIds":["paths/~1branding~1emails~1{branding_email_type}/put/responses/200/content/application~1json/examples/default"]}],"pointer":"/paths/~1branding~1emails~1{branding_email_type}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/BrandingEmailPutResponse","exampleIds":["paths/~1branding~1emails~1{branding_email_type}/put/responses/200/content/application~1json/examples/default"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BrandingEmailPutResponse","exampleIds":["paths/~1branding~1emails~1{branding_email_type}/put/responses/200/content/application~1json/examples/default"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/branding/updatebrandingemail"}],"panels":[]}]},"httpPath":"/branding/emails/{branding_email_type}"}],"content":{"contentType":"group","meta":{"name":"Branding"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Branding","showPageActions":true},{"nodeType":"markdoc","content":"Customize visual and branding settings for emails."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/branding","summary":"Get branding settings","prefix":{"name":"get","color":"get"},"badges":[],"link":"/branding/getbranding","deprecated":false},{"title":"/branding","summary":"Update branding settings","prefix":{"name":"put","color":"put"},"badges":[],"link":"/branding/updatebranding","deprecated":false},{"title":"/branding/emails","summary":"List branding emails","prefix":{"name":"get","color":"get"},"badges":[],"link":"/branding/getbrandingemails","deprecated":false},{"title":"/branding/emails/{branding_email_type}","summary":"Get a branding email","prefix":{"name":"get","color":"get"},"badges":[],"link":"/branding/getsinglebrandingemail","deprecated":false},{"title":"/branding/emails/{branding_email_type}","summary":"Update a branding email","prefix":{"name":"put","color":"put"},"badges":[],"link":"/branding/updatebrandingemail","deprecated":false}]}]}]}]}},{"type":"group","label":"Settings","link":"/openapi/settings","routeSlug":"/openapi/settings","items":[{"label":"Get company settings","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/settings/listsettings","routeSlug":"/openapi/settings/listsettings","metadata":{"seo":{"title":"Get company settings","description":"Your Signable account settings control how documents are delivered, signed, and managed across your team.This section of the API lets you retrieve and update your company's signing preferences, email notification rules, signature formats, and more—giving you full control over how your documents behave.Settings can be accessed via the API or in the Signable web app under Company Settings > Preferences."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listSettings","name":"Get company settings","isWebhook":false,"pointer":"/paths/~1settings/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get company settings","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Your Signable account settings control how documents are delivered, signed, and managed across your team."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This section of the API lets you retrieve and update your company's signing preferences, email notification rules, signature formats, and more—giving you full control over how your documents behave."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Settings can be accessed via the API or in the Signable web app under Company Settings > "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://signable.app/company-settings/preferences"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Preferences"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/settings","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200","401"],"pointer":"/settings","href":"settings/listsettings","openApiOperationId":"listSettings","summary":"Get company settings"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Company settings returned successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SettingsResponse","exampleIds":["paths/~1settings/get/responses/200/content/application~1json/examples/default"]}},"schemaId":"components/schemas/SettingsResponse","exampleIds":["paths/~1settings/get/responses/200/content/application~1json/examples/default"]},{"code":"401","description":"Authentication failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1settings/get/responses/401/content/application~1json/examples/missingAuth","paths/~1settings/get/responses/401/content/application~1json/examples/invalidAuth"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1settings/get/responses/401/content/application~1json/examples/missingAuth","paths/~1settings/get/responses/401/content/application~1json/examples/invalidAuth"]}],"pointer":"/paths/~1settings/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/SettingsResponse","exampleIds":["paths/~1settings/get/responses/200/content/application~1json/examples/default"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SettingsResponse","exampleIds":["paths/~1settings/get/responses/200/content/application~1json/examples/default"]}}},{"code":"401","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1settings/get/responses/401/content/application~1json/examples/missingAuth","paths/~1settings/get/responses/401/content/application~1json/examples/invalidAuth"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1settings/get/responses/401/content/application~1json/examples/missingAuth","paths/~1settings/get/responses/401/content/application~1json/examples/invalidAuth"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/settings/listsettings"}],"panels":[]}]},"httpPath":"/settings"},{"label":"Update company settings","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/settings/updatesettings","routeSlug":"/openapi/settings/updatesettings","metadata":{"seo":{"title":"Update company settings","description":"Update your company's settings. If no valid update can be applied, the API returns the current settings without making changes."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateSettings","name":"Update company settings","isWebhook":false,"pointer":"/paths/~1settings/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update company settings","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Update your company's settings. If no valid update can be applied, the API returns the current settings without making changes.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":false,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateSettingsRequest","exampleIds":["paths/~1settings/put/requestBody/content/application~1json/examples/default"]}},"schemaId":"components/schemas/UpdateSettingsRequest","exampleIds":["paths/~1settings/put/requestBody/content/application~1json/examples/default"],"pointer":"/paths/~1settings/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/settings","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/UpdateSettingsRequest","exampleIds":["paths/~1settings/put/requestBody/content/application~1json/examples/default"]}},"responseCodes":["200","400","401"],"pointer":"/settings","href":"settings/updatesettings","openApiOperationId":"updateSettings","summary":"Update company settings"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"schemaId":"components/schemas/UpdateSettingsRequest","exampleIds":["paths/~1settings/put/requestBody/content/application~1json/examples/default"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/UpdateSettingsRequest","exampleIds":["paths/~1settings/put/requestBody/content/application~1json/examples/default"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Settings updated successfully, or current settings returned when no update is applied.\n","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/UpdateSettingsResponse","exampleIds":["paths/~1settings/put/responses/200/content/application~1json/examples/updated"]}},"schemaId":"components/schemas/UpdateSettingsResponse","exampleIds":["paths/~1settings/put/responses/200/content/application~1json/examples/updated"]},{"code":"400","description":"Invalid settings update request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1settings/put/responses/400/content/application~1json/examples/invalidAcceptedSignatureFormat"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1settings/put/responses/400/content/application~1json/examples/invalidAcceptedSignatureFormat"]},{"code":"401","description":"Authentication failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1settings/put/responses/401/content/application~1json/examples/missingAuth","paths/~1settings/put/responses/401/content/application~1json/examples/invalidAuth"]}},"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1settings/put/responses/401/content/application~1json/examples/missingAuth","paths/~1settings/put/responses/401/content/application~1json/examples/invalidAuth"]}],"pointer":"/paths/~1settings/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/UpdateSettingsResponse","exampleIds":["paths/~1settings/put/responses/200/content/application~1json/examples/updated"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/UpdateSettingsResponse","exampleIds":["paths/~1settings/put/responses/200/content/application~1json/examples/updated"]}}},{"code":"400","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1settings/put/responses/400/content/application~1json/examples/invalidAcceptedSignatureFormat"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1settings/put/responses/400/content/application~1json/examples/invalidAcceptedSignatureFormat"]}}},{"code":"401","schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1settings/put/responses/401/content/application~1json/examples/missingAuth","paths/~1settings/put/responses/401/content/application~1json/examples/invalidAuth"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ErrorResponse","exampleIds":["paths/~1settings/put/responses/401/content/application~1json/examples/missingAuth","paths/~1settings/put/responses/401/content/application~1json/examples/invalidAuth"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/settings/updatesettings"}],"panels":[]}]},"httpPath":"/settings"}],"content":{"contentType":"group","meta":{"name":"Settings"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Settings","showPageActions":true},{"nodeType":"markdoc","content":"Configure account-wide preferences and defaults."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/settings","summary":"Get company settings","prefix":{"name":"get","color":"get"},"badges":[],"link":"/settings/listsettings","deprecated":false},{"title":"/settings","summary":"Update company settings","prefix":{"name":"put","color":"put"},"badges":[],"link":"/settings/updatesettings","deprecated":false}]}]}]}]}},{"type":"group","label":"Webhooks","link":"/openapi/webhooks","routeSlug":"/openapi/webhooks","items":[{"label":"List webhooks","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/webhooks/listwebhooks","routeSlug":"/openapi/webhooks/listwebhooks","metadata":{"seo":{"title":"List webhooks","description":"Retrieves a paginated list of all webhooks currently registered to receive event notifications. Supports offset and limit for pagination. Webhooks include metadata about creation, update, and suspension state."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"listWebhooks","name":"List webhooks","isWebhook":false,"pointer":"/paths/~1webhooks/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"List webhooks","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Retrieves a paginated list of all webhooks currently registered to receive event notifications. Supports offset and limit for pagination. Webhooks include metadata about creation, update, and suspension state.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"offset","in":"query","schemaId":"schema_56","description":"Pagination offset"},{"name":"limit","in":"query","schemaId":"schema_57","description":"Number of webhooks to return"}],"pointer":"/paths/~1webhooks/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/webhooks","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[],"query":[{"name":"offset","in":"query","required":false,"example":0,"schemaId":"schema_56"},{"name":"limit","in":"query","required":false,"example":10,"schemaId":"schema_57"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/webhooks","href":"webhooks/listwebhooks","openApiOperationId":"listWebhooks","summary":"List webhooks"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successfully returned a list of webhooks","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WebhookListResponse","exampleIds":["paths/~1webhooks/get/responses/200/content/application~1json/examples/default"]}},"schemaId":"components/schemas/WebhookListResponse","exampleIds":["paths/~1webhooks/get/responses/200/content/application~1json/examples/default"]}],"pointer":"/paths/~1webhooks/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/WebhookListResponse","exampleIds":["paths/~1webhooks/get/responses/200/content/application~1json/examples/default"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WebhookListResponse","exampleIds":["paths/~1webhooks/get/responses/200/content/application~1json/examples/default"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/webhooks/listwebhooks"}],"panels":[]}]},"httpPath":"/webhooks"},{"label":"Create a webhook","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/webhooks/createwebhook","routeSlug":"/openapi/webhooks/createwebhook","metadata":{"seo":{"title":"Create a webhook","description":"Registers a new webhook that will be triggered when a specific event occurs. You must provide a valid webhook_url and a supported webhook_type. The created webhook will immediately be eligible to receive matching notifications."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createWebhook","name":"Create a webhook","isWebhook":false,"pointer":"/paths/~1webhooks/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create a webhook","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Registers a new webhook that will be triggered when a specific event occurs. You must provide a valid "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"webhook_url"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and a supported "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"webhook_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The created webhook will immediately be eligible to receive matching notifications."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/WebhookRequest","exampleIds":["paths/~1webhooks/post/requestBody/content/application~1json/examples/default"]}},"schemaId":"components/schemas/WebhookRequest","exampleIds":["paths/~1webhooks/post/requestBody/content/application~1json/examples/default"],"pointer":"/paths/~1webhooks/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/webhooks","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/WebhookRequest","exampleIds":["paths/~1webhooks/post/requestBody/content/application~1json/examples/default"]}},"responseCodes":["200"],"pointer":"/webhooks","href":"webhooks/createwebhook","openApiOperationId":"createWebhook","summary":"Create a webhook"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"schemaId":"components/schemas/WebhookRequest","exampleIds":["paths/~1webhooks/post/requestBody/content/application~1json/examples/default"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/WebhookRequest","exampleIds":["paths/~1webhooks/post/requestBody/content/application~1json/examples/default"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Webhook successfully created","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WebhookPostResponse","exampleIds":["paths/~1webhooks/post/responses/200/content/application~1json/examples/createdWebhook"]}},"schemaId":"components/schemas/WebhookPostResponse","exampleIds":["paths/~1webhooks/post/responses/200/content/application~1json/examples/createdWebhook"],"headers":{"Location":{"description":"The URL of the newly created webhook resource","schema":{"type":"string","format":"uri"}}},"headerSchemaId":"schema_58"}],"pointer":"/paths/~1webhooks/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/WebhookPostResponse","exampleIds":["paths/~1webhooks/post/responses/200/content/application~1json/examples/createdWebhook"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WebhookPostResponse","exampleIds":["paths/~1webhooks/post/responses/200/content/application~1json/examples/createdWebhook"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/webhooks/createwebhook"}],"panels":[]}]},"httpPath":"/webhooks"},{"label":"Get a webhook","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/webhooks/getwebhook","routeSlug":"/openapi/webhooks/getwebhook","metadata":{"seo":{"title":"Get a webhook","description":"Retrieves details of a specific webhook by its unique webhook_id. The response includes the current status and metadata of the webhook."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getWebhook","name":"Get a webhook","isWebhook":false,"pointer":"/paths/~1webhooks~1{webhook_id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get a webhook","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Retrieves details of a specific webhook by its unique "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"webhook_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The response includes the current status and metadata of the webhook."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"webhook_id","in":"path","schemaId":"schema_59","description":"The ID of the webhook to retrieve","required":true}],"pointer":"/paths/~1webhooks~1{webhook_id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/webhooks/{webhook_id}","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[{"name":"webhook_id","in":"path","required":true,"example":152691,"schemaId":"schema_59"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/webhooks/{webhook_id}","href":"webhooks/getwebhook","openApiOperationId":"getWebhook","summary":"Get a webhook"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Webhook details returned successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WebhookGetResponse","exampleIds":["paths/~1webhooks~1{webhook_id}/get/responses/200/content/application~1json/examples/default"]}},"schemaId":"components/schemas/WebhookGetResponse","exampleIds":["paths/~1webhooks~1{webhook_id}/get/responses/200/content/application~1json/examples/default"]}],"pointer":"/paths/~1webhooks~1{webhook_id}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/WebhookGetResponse","exampleIds":["paths/~1webhooks~1{webhook_id}/get/responses/200/content/application~1json/examples/default"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WebhookGetResponse","exampleIds":["paths/~1webhooks~1{webhook_id}/get/responses/200/content/application~1json/examples/default"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/webhooks/getwebhook"}],"panels":[]}]},"httpPath":"/webhooks/{webhook_id}"},{"label":"Update a webhook","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/webhooks/updatewebhook","routeSlug":"/openapi/webhooks/updatewebhook","metadata":{"seo":{"title":"Update a webhook","description":"Updates the webhook identified by webhook_id. The request body may include webhook_url, webhook_type, or both."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"updateWebhook","name":"Update a webhook","isWebhook":false,"pointer":"/paths/~1webhooks~1{webhook_id}/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Update a webhook","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Updates the webhook identified by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"webhook_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The request body may include "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"webhook_url"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"webhook_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or both."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"webhook_id","in":"path","schemaId":"schema_59","description":"The ID of the webhook to update","required":true}],"pointer":"/paths/~1webhooks~1{webhook_id}/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/WebhookUpdateRequest","exampleIds":["paths/~1webhooks~1{webhook_id}/put/requestBody/content/application~1json/examples/webhookUrlOnly","paths/~1webhooks~1{webhook_id}/put/requestBody/content/application~1json/examples/webhookTypeOnly","paths/~1webhooks~1{webhook_id}/put/requestBody/content/application~1json/examples/bothFields"]}},"schemaId":"components/schemas/WebhookUpdateRequest","exampleIds":["paths/~1webhooks~1{webhook_id}/put/requestBody/content/application~1json/examples/webhookUrlOnly","paths/~1webhooks~1{webhook_id}/put/requestBody/content/application~1json/examples/webhookTypeOnly","paths/~1webhooks~1{webhook_id}/put/requestBody/content/application~1json/examples/bothFields"],"pointer":"/paths/~1webhooks~1{webhook_id}/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/webhooks/{webhook_id}","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[{"name":"webhook_id","in":"path","required":true,"example":152691,"schemaId":"schema_59"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/WebhookUpdateRequest","exampleIds":["paths/~1webhooks~1{webhook_id}/put/requestBody/content/application~1json/examples/webhookUrlOnly","paths/~1webhooks~1{webhook_id}/put/requestBody/content/application~1json/examples/webhookTypeOnly","paths/~1webhooks~1{webhook_id}/put/requestBody/content/application~1json/examples/bothFields"]}},"responseCodes":["200"],"pointer":"/webhooks/{webhook_id}","href":"webhooks/updatewebhook","openApiOperationId":"updateWebhook","summary":"Update a webhook"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"schemaId":"components/schemas/WebhookUpdateRequest","exampleIds":["paths/~1webhooks~1{webhook_id}/put/requestBody/content/application~1json/examples/webhookUrlOnly","paths/~1webhooks~1{webhook_id}/put/requestBody/content/application~1json/examples/webhookTypeOnly","paths/~1webhooks~1{webhook_id}/put/requestBody/content/application~1json/examples/bothFields"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/WebhookUpdateRequest","exampleIds":["paths/~1webhooks~1{webhook_id}/put/requestBody/content/application~1json/examples/webhookUrlOnly","paths/~1webhooks~1{webhook_id}/put/requestBody/content/application~1json/examples/webhookTypeOnly","paths/~1webhooks~1{webhook_id}/put/requestBody/content/application~1json/examples/bothFields"]}},"examples":[{},{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Webhook updated successfully","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WebhookPutResponse","exampleIds":["paths/~1webhooks~1{webhook_id}/put/responses/200/content/application~1json/examples/updated"]}},"schemaId":"components/schemas/WebhookPutResponse","exampleIds":["paths/~1webhooks~1{webhook_id}/put/responses/200/content/application~1json/examples/updated"]}],"pointer":"/paths/~1webhooks~1{webhook_id}/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/WebhookPutResponse","exampleIds":["paths/~1webhooks~1{webhook_id}/put/responses/200/content/application~1json/examples/updated"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WebhookPutResponse","exampleIds":["paths/~1webhooks~1{webhook_id}/put/responses/200/content/application~1json/examples/updated"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/webhooks/updatewebhook"}],"panels":[]}]},"httpPath":"/webhooks/{webhook_id}"},{"label":"Delete a webhook","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/openapi/webhooks/deletewebhook","routeSlug":"/openapi/webhooks/deletewebhook","metadata":{"seo":{"title":"Delete a webhook","description":"Deletes the webhook identified by webhook_id. Once removed, the webhook will no longer receive event notifications."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteWebhook","name":"Delete a webhook","isWebhook":false,"pointer":"/paths/~1webhooks~1{webhook_id}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete a webhook","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Deletes the webhook identified by "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"webhook_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Once removed, the webhook will no longer receive event notifications."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"webhook_id","in":"path","schemaId":"schema_59","description":"The ID of the webhook to delete","required":true}],"pointer":"/paths/~1webhooks~1{webhook_id}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/webhooks/{webhook_id}","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[{"name":"webhook_id","in":"path","required":true,"example":152691,"schemaId":"schema_59"}],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"responseCodes":["200"],"pointer":"/webhooks/{webhook_id}","href":"webhooks/deletewebhook","openApiOperationId":"deleteWebhook","summary":"Delete a webhook"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Webhook successfully deleted","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WebhookDeleteResponse","exampleIds":["paths/~1webhooks~1{webhook_id}/delete/responses/200/content/application~1json/examples/deleted"]}},"schemaId":"components/schemas/WebhookDeleteResponse","exampleIds":["paths/~1webhooks~1{webhook_id}/delete/responses/200/content/application~1json/examples/deleted"]}],"pointer":"/paths/~1webhooks~1{webhook_id}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/WebhookDeleteResponse","exampleIds":["paths/~1webhooks~1{webhook_id}/delete/responses/200/content/application~1json/examples/deleted"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WebhookDeleteResponse","exampleIds":["paths/~1webhooks~1{webhook_id}/delete/responses/200/content/application~1json/examples/deleted"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/webhooks/deletewebhook"}],"panels":[]}]},"httpPath":"/webhooks/{webhook_id}"}],"content":{"contentType":"group","meta":{"name":"Webhooks"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Webhooks","showPageActions":true},{"nodeType":"markdoc","content":"Create, read, update, and delete Webhook subscriptions."}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/webhooks","summary":"List webhooks","prefix":{"name":"get","color":"get"},"badges":[],"link":"/webhooks/listwebhooks","deprecated":false},{"title":"/webhooks","summary":"Create a webhook","prefix":{"name":"post","color":"post"},"badges":[],"link":"/webhooks/createwebhook","deprecated":false},{"title":"/webhooks/{webhook_id}","summary":"Get a webhook","prefix":{"name":"get","color":"get"},"badges":[],"link":"/webhooks/getwebhook","deprecated":false},{"title":"/webhooks/{webhook_id}","summary":"Update a webhook","prefix":{"name":"put","color":"put"},"badges":[],"link":"/webhooks/updatewebhook","deprecated":false},{"title":"/webhooks/{webhook_id}","summary":"Delete a webhook","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/webhooks/deletewebhook","deprecated":false}]}]}]}]}},{"type":"group","label":"Webhook Events","link":"/openapi/webhook-events","routeSlug":"/openapi/webhook-events","items":[{"label":"Envelope sent","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":true,"type":"link","link":"/openapi/webhook-events/receivesendenvelopewebhook","routeSlug":"/openapi/webhook-events/receivesendenvelopewebhook","metadata":{"seo":{"title":"Envelope sent","description":"This webhook is triggered after an envelope has been successfully processed and sent. It delivers information about the envelope, the recipient, any additional metadata, and a download URL."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"receiveSendEnvelopeWebhook","name":"Envelope sent","isWebhook":true,"pointer":"/paths/send-envelope/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Envelope sent","isWebhook":true,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"This webhook is triggered after an envelope has been successfully processed and sent. It delivers information about the envelope, the recipient, any additional metadata, and a download URL.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/x-www-form-urlencoded"],"mediaTypeSchemas":{"application/x-www-form-urlencoded":{"schemaId":"schema_60","exampleIds":["paths/send-envelope/post/requestBody/content/application~1x-www-form-urlencoded/example"]}},"schemaId":"schema_60","exampleIds":["paths/send-envelope/post/requestBody/content/application~1x-www-form-urlencoded/example"],"pointer":"/paths/send-envelope/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"webhook","method":"POST","path":"send-envelope","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/x-www-form-urlencoded":{"schemaId":"schema_60","exampleIds":["paths/send-envelope/post/requestBody/content/application~1x-www-form-urlencoded/example"]}},"responseCodes":["200"],"pointer":"send-envelope","href":"webhook-events/receivesendenvelopewebhook","openApiOperationId":"receiveSendEnvelopeWebhook","summary":"Envelope sent"},"isWebhook":true,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"schemaId":"schema_60","exampleIds":["paths/send-envelope/post/requestBody/content/application~1x-www-form-urlencoded/example"],"mediaTypes":["application/x-www-form-urlencoded"],"mediaTypeSchemas":{"application/x-www-form-urlencoded":{"schemaId":"schema_60","exampleIds":["paths/send-envelope/post/requestBody/content/application~1x-www-form-urlencoded/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Acknowledge receipt"}],"pointer":"/paths/send-envelope/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/webhook-events/receivesendenvelopewebhook"}],"panels":[]}]},"httpPath":"send-envelope"},{"label":"Envelope signed","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":true,"type":"link","link":"/openapi/webhook-events/receivesignedenvelopewebhook","routeSlug":"/openapi/webhook-events/receivesignedenvelopewebhook","metadata":{"seo":{"title":"Envelope signed","description":"This webhook is triggered when a recipient completes signing an envelope. It includes detailed information about the envelope, signer, documents, custom fields, and signature fingerprint."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"receiveSignedEnvelopeWebhook","name":"Envelope signed","isWebhook":true,"pointer":"/paths/signed-envelope/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Envelope signed","isWebhook":true,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"This webhook is triggered when a recipient completes signing an envelope. It includes detailed information about the envelope, signer, documents, custom fields, and signature fingerprint.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/x-www-form-urlencoded"],"mediaTypeSchemas":{"application/x-www-form-urlencoded":{"schemaId":"schema_61","exampleIds":["paths/signed-envelope/post/requestBody/content/application~1x-www-form-urlencoded/example"]}},"schemaId":"schema_61","exampleIds":["paths/signed-envelope/post/requestBody/content/application~1x-www-form-urlencoded/example"],"pointer":"/paths/signed-envelope/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"webhook","method":"POST","path":"signed-envelope","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/x-www-form-urlencoded":{"schemaId":"schema_61","exampleIds":["paths/signed-envelope/post/requestBody/content/application~1x-www-form-urlencoded/example"]}},"responseCodes":["200"],"pointer":"signed-envelope","href":"webhook-events/receivesignedenvelopewebhook","openApiOperationId":"receiveSignedEnvelopeWebhook","summary":"Envelope signed"},"isWebhook":true,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"schemaId":"schema_61","exampleIds":["paths/signed-envelope/post/requestBody/content/application~1x-www-form-urlencoded/example"],"mediaTypes":["application/x-www-form-urlencoded"],"mediaTypeSchemas":{"application/x-www-form-urlencoded":{"schemaId":"schema_61","exampleIds":["paths/signed-envelope/post/requestBody/content/application~1x-www-form-urlencoded/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Acknowledge receipt"}],"pointer":"/paths/signed-envelope/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/webhook-events/receivesignedenvelopewebhook"}],"panels":[]}]},"httpPath":"signed-envelope"},{"label":"Envelope cancelled","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":true,"type":"link","link":"/openapi/webhook-events/receivecancelledenvelopewebhook","routeSlug":"/openapi/webhook-events/receivecancelledenvelopewebhook","metadata":{"seo":{"title":"Envelope cancelled","description":"This webhook is triggered when an envelope is cancelled before completion. It includes the envelope fingerprint, user details, and any metadata associated with the envelope."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"receiveCancelledEnvelopeWebhook","name":"Envelope cancelled","isWebhook":true,"pointer":"/paths/cancelled-envelope/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Envelope cancelled","isWebhook":true,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"This webhook is triggered when an envelope is cancelled before completion. It includes the envelope fingerprint, user details, and any metadata associated with the envelope.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/x-www-form-urlencoded"],"mediaTypeSchemas":{"application/x-www-form-urlencoded":{"schemaId":"schema_62","exampleIds":["paths/cancelled-envelope/post/requestBody/content/application~1x-www-form-urlencoded/example"]}},"schemaId":"schema_62","exampleIds":["paths/cancelled-envelope/post/requestBody/content/application~1x-www-form-urlencoded/example"],"pointer":"/paths/cancelled-envelope/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"webhook","method":"POST","path":"cancelled-envelope","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/x-www-form-urlencoded":{"schemaId":"schema_62","exampleIds":["paths/cancelled-envelope/post/requestBody/content/application~1x-www-form-urlencoded/example"]}},"responseCodes":["200"],"pointer":"cancelled-envelope","href":"webhook-events/receivecancelledenvelopewebhook","openApiOperationId":"receiveCancelledEnvelopeWebhook","summary":"Envelope cancelled"},"isWebhook":true,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"schemaId":"schema_62","exampleIds":["paths/cancelled-envelope/post/requestBody/content/application~1x-www-form-urlencoded/example"],"mediaTypes":["application/x-www-form-urlencoded"],"mediaTypeSchemas":{"application/x-www-form-urlencoded":{"schemaId":"schema_62","exampleIds":["paths/cancelled-envelope/post/requestBody/content/application~1x-www-form-urlencoded/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Acknowledge receipt"}],"pointer":"/paths/cancelled-envelope/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/webhook-events/receivecancelledenvelopewebhook"}],"panels":[]}]},"httpPath":"cancelled-envelope"},{"label":"Envelope expired","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":true,"type":"link","link":"/openapi/webhook-events/receiveexpiredenvelopewebhook","routeSlug":"/openapi/webhook-events/receiveexpiredenvelopewebhook","metadata":{"seo":{"title":"Envelope expired","description":"This webhook is triggered when an envelope expires. It includes basic information about the envelope and the recipient."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"receiveExpiredEnvelopeWebhook","name":"Envelope expired","isWebhook":true,"pointer":"/paths/expired-envelope/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Envelope expired","isWebhook":true,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"This webhook is triggered when an envelope expires. It includes basic information about the envelope and the recipient.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/x-www-form-urlencoded"],"mediaTypeSchemas":{"application/x-www-form-urlencoded":{"schemaId":"schema_63"}},"schemaId":"schema_63","pointer":"/paths/expired-envelope/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"webhook","method":"POST","path":"expired-envelope","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/x-www-form-urlencoded":{"schemaId":"schema_63"}},"responseCodes":["200"],"pointer":"expired-envelope","href":"webhook-events/receiveexpiredenvelopewebhook","openApiOperationId":"receiveExpiredEnvelopeWebhook","summary":"Envelope expired"},"isWebhook":true,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"schemaId":"schema_63","mediaTypes":["application/x-www-form-urlencoded"],"mediaTypeSchemas":{"application/x-www-form-urlencoded":{"schemaId":"schema_63"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Acknowledge receipt"}],"pointer":"/paths/expired-envelope/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/webhook-events/receiveexpiredenvelopewebhook"}],"panels":[]}]},"httpPath":"expired-envelope"},{"label":"Envelope signed and complete","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":true,"type":"link","link":"/openapi/webhook-events/receivesignedenvelopecompletewebhook","routeSlug":"/openapi/webhook-events/receivesignedenvelopecompletewebhook","metadata":{"seo":{"title":"Envelope signed and complete","description":"This webhook is triggered when all required parties have completed signing an envelope. It includes the envelope fingerprint, documents, any captured field data, and a download link."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"receiveSignedEnvelopeCompleteWebhook","name":"Envelope signed and complete","isWebhook":true,"pointer":"/paths/signed-envelope-complete/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Envelope signed and complete","isWebhook":true,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"This webhook is triggered when all required parties have completed signing an envelope. It includes the envelope fingerprint, documents, any captured field data, and a download link.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/x-www-form-urlencoded"],"mediaTypeSchemas":{"application/x-www-form-urlencoded":{"schemaId":"schema_64","exampleIds":["paths/signed-envelope-complete/post/requestBody/content/application~1x-www-form-urlencoded/example"]}},"schemaId":"schema_64","exampleIds":["paths/signed-envelope-complete/post/requestBody/content/application~1x-www-form-urlencoded/example"],"pointer":"/paths/signed-envelope-complete/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"webhook","method":"POST","path":"signed-envelope-complete","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/x-www-form-urlencoded":{"schemaId":"schema_64","exampleIds":["paths/signed-envelope-complete/post/requestBody/content/application~1x-www-form-urlencoded/example"]}},"responseCodes":["200"],"pointer":"signed-envelope-complete","href":"webhook-events/receivesignedenvelopecompletewebhook","openApiOperationId":"receiveSignedEnvelopeCompleteWebhook","summary":"Envelope signed and complete"},"isWebhook":true,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"schemaId":"schema_64","exampleIds":["paths/signed-envelope-complete/post/requestBody/content/application~1x-www-form-urlencoded/example"],"mediaTypes":["application/x-www-form-urlencoded"],"mediaTypeSchemas":{"application/x-www-form-urlencoded":{"schemaId":"schema_64","exampleIds":["paths/signed-envelope-complete/post/requestBody/content/application~1x-www-form-urlencoded/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Acknowledge receipt"}],"pointer":"/paths/signed-envelope-complete/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/webhook-events/receivesignedenvelopecompletewebhook"}],"panels":[]}]},"httpPath":"signed-envelope-complete"},{"label":"Envelope rejected","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":true,"type":"link","link":"/openapi/webhook-events/receiverejectedenvelopewebhook","routeSlug":"/openapi/webhook-events/receiverejectedenvelopewebhook","metadata":{"seo":{"title":"Envelope rejected","description":"This webhook is triggered when a recipient rejects an envelope. It includes details about the envelope, the rejecting contact, and relevant metadata."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"receiveRejectedEnvelopeWebhook","name":"Envelope rejected","isWebhook":true,"pointer":"/paths/rejected-envelope/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Envelope rejected","isWebhook":true,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"This webhook is triggered when a recipient rejects an envelope. It includes details about the envelope, the rejecting contact, and relevant metadata.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/x-www-form-urlencoded"],"mediaTypeSchemas":{"application/x-www-form-urlencoded":{"schemaId":"schema_65"}},"schemaId":"schema_65","pointer":"/paths/rejected-envelope/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"webhook","method":"POST","path":"rejected-envelope","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/x-www-form-urlencoded":{"schemaId":"schema_65"}},"responseCodes":["200"],"pointer":"rejected-envelope","href":"webhook-events/receiverejectedenvelopewebhook","openApiOperationId":"receiveRejectedEnvelopeWebhook","summary":"Envelope rejected"},"isWebhook":true,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"schemaId":"schema_65","mediaTypes":["application/x-www-form-urlencoded"],"mediaTypeSchemas":{"application/x-www-form-urlencoded":{"schemaId":"schema_65"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Acknowledge receipt"}],"pointer":"/paths/rejected-envelope/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/webhook-events/receiverejectedenvelopewebhook"}],"panels":[]}]},"httpPath":"rejected-envelope"},{"label":"Envelope opened","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":true,"type":"link","link":"/openapi/webhook-events/receiveopenedenvelopewebhook","routeSlug":"/openapi/webhook-events/receiveopenedenvelopewebhook","metadata":{"seo":{"title":"Envelope opened","description":"This webhook is triggered when a recipient opens an envelope. It includes basic information about the envelope, the recipient, and associated documents."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"receiveOpenedEnvelopeWebhook","name":"Envelope opened","isWebhook":true,"pointer":"/paths/opened-envelope/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Envelope opened","isWebhook":true,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"This webhook is triggered when a recipient opens an envelope. It includes basic information about the envelope, the recipient, and associated documents.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/x-www-form-urlencoded"],"mediaTypeSchemas":{"application/x-www-form-urlencoded":{"schemaId":"schema_66"}},"schemaId":"schema_66","pointer":"/paths/opened-envelope/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"webhook","method":"POST","path":"opened-envelope","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/x-www-form-urlencoded":{"schemaId":"schema_66"}},"responseCodes":["200"],"pointer":"opened-envelope","href":"webhook-events/receiveopenedenvelopewebhook","openApiOperationId":"receiveOpenedEnvelopeWebhook","summary":"Envelope opened"},"isWebhook":true,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"schemaId":"schema_66","mediaTypes":["application/x-www-form-urlencoded"],"mediaTypeSchemas":{"application/x-www-form-urlencoded":{"schemaId":"schema_66"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Acknowledge receipt"}],"pointer":"/paths/opened-envelope/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/webhook-events/receiveopenedenvelopewebhook"}],"panels":[]}]},"httpPath":"opened-envelope"},{"label":"Envelope email bounced","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":true,"type":"link","link":"/openapi/webhook-events/receivebouncedenvelopewebhook","routeSlug":"/openapi/webhook-events/receivebouncedenvelopewebhook","metadata":{"seo":{"title":"Envelope email bounced","description":"Triggered when an email to a signer fails to deliver."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"receiveBouncedEnvelopeWebhook","name":"Envelope email bounced","isWebhook":true,"pointer":"/paths/bounced-envelope/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Envelope email bounced","isWebhook":true,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"Triggered when an email to a signer fails to deliver.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/x-www-form-urlencoded"],"mediaTypeSchemas":{"application/x-www-form-urlencoded":{"schemaId":"schema_67"}},"schemaId":"schema_67","pointer":"/paths/bounced-envelope/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"webhook","method":"POST","path":"bounced-envelope","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/x-www-form-urlencoded":{"schemaId":"schema_67"}},"responseCodes":["200"],"pointer":"bounced-envelope","href":"webhook-events/receivebouncedenvelopewebhook","openApiOperationId":"receiveBouncedEnvelopeWebhook","summary":"Envelope email bounced"},"isWebhook":true,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"schemaId":"schema_67","mediaTypes":["application/x-www-form-urlencoded"],"mediaTypeSchemas":{"application/x-www-form-urlencoded":{"schemaId":"schema_67"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Acknowledge receipt"}],"pointer":"/paths/bounced-envelope/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/webhook-events/receivebouncedenvelopewebhook"}],"panels":[]}]},"httpPath":"bounced-envelope"},{"label":"Envelope send failed","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":true,"type":"link","link":"/openapi/webhook-events/receivesendenvelopefailedwebhook","routeSlug":"/openapi/webhook-events/receivesendenvelopefailedwebhook","metadata":{"seo":{"title":"Envelope send failed","description":"This webhook is triggered when an envelope fails to send."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"receiveSendEnvelopeFailedWebhook","name":"Envelope send failed","isWebhook":true,"pointer":"/paths/send-envelope-failed/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Envelope send failed","isWebhook":true,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"This webhook is triggered when an envelope fails to send.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/x-www-form-urlencoded"],"mediaTypeSchemas":{"application/x-www-form-urlencoded":{"schemaId":"schema_68"}},"schemaId":"schema_68","pointer":"/paths/send-envelope-failed/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"webhook","method":"POST","path":"send-envelope-failed","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/x-www-form-urlencoded":{"schemaId":"schema_68"}},"responseCodes":["200"],"pointer":"send-envelope-failed","href":"webhook-events/receivesendenvelopefailedwebhook","openApiOperationId":"receiveSendEnvelopeFailedWebhook","summary":"Envelope send failed"},"isWebhook":true,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"schemaId":"schema_68","mediaTypes":["application/x-www-form-urlencoded"],"mediaTypeSchemas":{"application/x-www-form-urlencoded":{"schemaId":"schema_68"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Acknowledge receipt"}],"pointer":"/paths/send-envelope-failed/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/webhook-events/receivesendenvelopefailedwebhook"}],"panels":[]}]},"httpPath":"send-envelope-failed"},{"label":"Widget completed (Awaiting verification)","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":true,"type":"link","link":"/openapi/webhook-events/receiveverifyenvelopewidgetwebhook","routeSlug":"/openapi/webhook-events/receiveverifyenvelopewidgetwebhook","metadata":{"seo":{"title":"Widget completed (Awaiting verification)","description":"This webhook is triggered when a recipient signs an envelope via the widget, but has not yet verified. It includes contact and document details."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"receiveVerifyEnvelopeWidgetWebhook","name":"Widget completed (Awaiting verification)","isWebhook":true,"pointer":"/paths/verify-envelope-widget/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Widget completed (Awaiting verification)","isWebhook":true,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"This webhook is triggered when a recipient signs an envelope via the widget, but has not yet verified. It includes contact and document details.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/x-www-form-urlencoded"],"mediaTypeSchemas":{"application/x-www-form-urlencoded":{"schemaId":"schema_69"}},"schemaId":"schema_69","pointer":"/paths/verify-envelope-widget/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"webhook","method":"POST","path":"verify-envelope-widget","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/x-www-form-urlencoded":{"schemaId":"schema_69"}},"responseCodes":["200"],"pointer":"verify-envelope-widget","href":"webhook-events/receiveverifyenvelopewidgetwebhook","openApiOperationId":"receiveVerifyEnvelopeWidgetWebhook","summary":"Widget completed (Awaiting verification)"},"isWebhook":true,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"schemaId":"schema_69","mediaTypes":["application/x-www-form-urlencoded"],"mediaTypeSchemas":{"application/x-www-form-urlencoded":{"schemaId":"schema_69"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Acknowledge receipt"}],"pointer":"/paths/verify-envelope-widget/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/webhook-events/receiveverifyenvelopewidgetwebhook"}],"panels":[]}]},"httpPath":"verify-envelope-widget"},{"label":"Widget signature verified","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":true,"type":"link","link":"/openapi/webhook-events/receiveverifiedenvelopewidgetwebhook","routeSlug":"/openapi/webhook-events/receiveverifiedenvelopewidgetwebhook","metadata":{"seo":{"title":"Widget signature verified","description":"This webhook is triggered when a recipient verifies their signed envelope through the verification email. It includes details about the contact, documents, and verification."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"receiveVerifiedEnvelopeWidgetWebhook","name":"Widget signature verified","isWebhook":true,"pointer":"/paths/verified-envelope-widget/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Widget signature verified","isWebhook":true,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"This webhook is triggered when a recipient verifies their signed envelope through the verification email.  It includes details about the contact, documents, and verification.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/x-www-form-urlencoded"],"mediaTypeSchemas":{"application/x-www-form-urlencoded":{"schemaId":"schema_70"}},"schemaId":"schema_70","pointer":"/paths/verified-envelope-widget/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"webhook","method":"POST","path":"verified-envelope-widget","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/x-www-form-urlencoded":{"schemaId":"schema_70"}},"responseCodes":["200"],"pointer":"verified-envelope-widget","href":"webhook-events/receiveverifiedenvelopewidgetwebhook","openApiOperationId":"receiveVerifiedEnvelopeWidgetWebhook","summary":"Widget signature verified"},"isWebhook":true,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"schemaId":"schema_70","mediaTypes":["application/x-www-form-urlencoded"],"mediaTypeSchemas":{"application/x-www-form-urlencoded":{"schemaId":"schema_70"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Acknowledge receipt"}],"pointer":"/paths/verified-envelope-widget/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/webhook-events/receiveverifiedenvelopewidgetwebhook"}],"panels":[]}]},"httpPath":"verified-envelope-widget"},{"label":"Template added","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":true,"type":"link","link":"/openapi/webhook-events/receiveaddtemplatewebhook","routeSlug":"/openapi/webhook-events/receiveaddtemplatewebhook","metadata":{"seo":{"title":"Template added","description":"This webhook is triggered when a new template is added to the account. It includes basic information about the template, including its title and fingerprint."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"receiveAddTemplateWebhook","name":"Template added","isWebhook":true,"pointer":"/paths/add-template/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Template added","isWebhook":true,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"This webhook is triggered when a new template is added to the account. It includes basic information about the template, including its title and fingerprint.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/x-www-form-urlencoded"],"mediaTypeSchemas":{"application/x-www-form-urlencoded":{"schemaId":"schema_71"}},"schemaId":"schema_71","pointer":"/paths/add-template/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"webhook","method":"POST","path":"add-template","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/x-www-form-urlencoded":{"schemaId":"schema_71"}},"responseCodes":["200"],"pointer":"add-template","href":"webhook-events/receiveaddtemplatewebhook","openApiOperationId":"receiveAddTemplateWebhook","summary":"Template added"},"isWebhook":true,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"schemaId":"schema_71","mediaTypes":["application/x-www-form-urlencoded"],"mediaTypeSchemas":{"application/x-www-form-urlencoded":{"schemaId":"schema_71"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Acknowledge receipt"}],"pointer":"/paths/add-template/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/webhook-events/receiveaddtemplatewebhook"}],"panels":[]}]},"httpPath":"add-template"},{"label":"Contact added","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":true,"type":"link","link":"/openapi/webhook-events/receiveaddcontactwebhook","routeSlug":"/openapi/webhook-events/receiveaddcontactwebhook","metadata":{"seo":{"title":"Contact added","description":"This webhook is triggered when a new contact is added to the account. It includes basic information about the contact and the company that added them."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"receiveAddContactWebhook","name":"Contact added","isWebhook":true,"pointer":"/paths/add-contact/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Contact added","isWebhook":true,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"This webhook is triggered when a new contact is added to the account. It includes basic information about the contact and the company that added them.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/x-www-form-urlencoded"],"mediaTypeSchemas":{"application/x-www-form-urlencoded":{"schemaId":"schema_72"}},"schemaId":"schema_72","pointer":"/paths/add-contact/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"webhook","method":"POST","path":"add-contact","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/x-www-form-urlencoded":{"schemaId":"schema_72"}},"responseCodes":["200"],"pointer":"add-contact","href":"webhook-events/receiveaddcontactwebhook","openApiOperationId":"receiveAddContactWebhook","summary":"Contact added"},"isWebhook":true,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"schemaId":"schema_72","mediaTypes":["application/x-www-form-urlencoded"],"mediaTypeSchemas":{"application/x-www-form-urlencoded":{"schemaId":"schema_72"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Acknowledge receipt"}],"pointer":"/paths/add-contact/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/webhook-events/receiveaddcontactwebhook"}],"panels":[]}]},"httpPath":"add-contact"},{"label":"User added","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":true,"type":"link","link":"/openapi/webhook-events/receiveadduserwebhook","routeSlug":"/openapi/webhook-events/receiveadduserwebhook","metadata":{"seo":{"title":"User added","description":"This webhook is triggered when a new user is added to the account. It includes identifying information about the user and their assigned role."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"receiveAddUserWebhook","name":"User added","isWebhook":true,"pointer":"/paths/add-user/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"User added","isWebhook":true,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"This webhook is triggered when a new user is added to the account.  It includes identifying information about the user and their assigned role.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"basicAuth","scopes":[],"type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/x-www-form-urlencoded"],"mediaTypeSchemas":{"application/x-www-form-urlencoded":{"schemaId":"schema_73"}},"schemaId":"schema_73","pointer":"/paths/add-user/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"webhook","method":"POST","path":"add-user","servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"basicAuth","type":"http","scheme":"basic"}],"scopes":[]}],"requestBody":{"application/x-www-form-urlencoded":{"schemaId":"schema_73"}},"responseCodes":["200"],"pointer":"add-user","href":"webhook-events/receiveadduserwebhook","openApiOperationId":"receiveAddUserWebhook","summary":"User added"},"isWebhook":true,"hideReplay":false,"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}],"schemaId":"schema_73","mediaTypes":["application/x-www-form-urlencoded"],"mediaTypeSchemas":{"application/x-www-form-urlencoded":{"schemaId":"schema_73"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Acknowledge receipt"}],"pointer":"/paths/add-user/post/responses"}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/webhook-events/receiveadduserwebhook"}],"panels":[]}]},"httpPath":"add-user"}],"content":{"contentType":"group","meta":{"name":"Webhook Events"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Webhook Events","showPageActions":true},{"nodeType":"markdoc","content":"Definitions for asynchronous event payloads sent by Signable."}],"panels":[{"children":[{"kind":"group-items","title":"Webhooks","titleTranslationKey":"webhooks","items":[{"title":"send-envelope","summary":"Envelope sent","prefix":{"name":"post","color":"post"},"badges":[],"link":"/webhook-events/receivesendenvelopewebhook","deprecated":false},{"title":"signed-envelope","summary":"Envelope signed","prefix":{"name":"post","color":"post"},"badges":[],"link":"/webhook-events/receivesignedenvelopewebhook","deprecated":false},{"title":"cancelled-envelope","summary":"Envelope cancelled","prefix":{"name":"post","color":"post"},"badges":[],"link":"/webhook-events/receivecancelledenvelopewebhook","deprecated":false},{"title":"expired-envelope","summary":"Envelope expired","prefix":{"name":"post","color":"post"},"badges":[],"link":"/webhook-events/receiveexpiredenvelopewebhook","deprecated":false},{"title":"signed-envelope-complete","summary":"Envelope signed and complete","prefix":{"name":"post","color":"post"},"badges":[],"link":"/webhook-events/receivesignedenvelopecompletewebhook","deprecated":false},{"title":"rejected-envelope","summary":"Envelope rejected","prefix":{"name":"post","color":"post"},"badges":[],"link":"/webhook-events/receiverejectedenvelopewebhook","deprecated":false},{"title":"opened-envelope","summary":"Envelope opened","prefix":{"name":"post","color":"post"},"badges":[],"link":"/webhook-events/receiveopenedenvelopewebhook","deprecated":false},{"title":"bounced-envelope","summary":"Envelope email bounced","prefix":{"name":"post","color":"post"},"badges":[],"link":"/webhook-events/receivebouncedenvelopewebhook","deprecated":false},{"title":"send-envelope-failed","summary":"Envelope send failed","prefix":{"name":"post","color":"post"},"badges":[],"link":"/webhook-events/receivesendenvelopefailedwebhook","deprecated":false},{"title":"verify-envelope-widget","summary":"Widget completed (Awaiting verification)","prefix":{"name":"post","color":"post"},"badges":[],"link":"/webhook-events/receiveverifyenvelopewidgetwebhook","deprecated":false},{"title":"verified-envelope-widget","summary":"Widget signature verified","prefix":{"name":"post","color":"post"},"badges":[],"link":"/webhook-events/receiveverifiedenvelopewidgetwebhook","deprecated":false},{"title":"add-template","summary":"Template added","prefix":{"name":"post","color":"post"},"badges":[],"link":"/webhook-events/receiveaddtemplatewebhook","deprecated":false},{"title":"add-contact","summary":"Contact added","prefix":{"name":"post","color":"post"},"badges":[],"link":"/webhook-events/receiveaddcontactwebhook","deprecated":false},{"title":"add-user","summary":"User added","prefix":{"name":"post","color":"post"},"badges":[],"link":"/webhook-events/receiveadduserwebhook","deprecated":false}]}]}]}]}}],"store":{"schemaStore":{"components/schemas/Company":{"id":"components/schemas/Company","kind":"json-schema","title":"Company","data":{"type":"object","description":"Represents an individual sub-account created under a Partner account.","required":["company_id","company_name","company_email","company_api_key","company_created"],"properties":{"company_id":{"type":"string","example":"196735","description":"Unique identifier for the sub-account."},"company_name":{"type":"string","example":"ExampleSubAccount_1","description":"The display name of the sub-account."},"company_email":{"type":"string","format":"email","example":"abby+1@signable.co.uk","description":"The registered email address associated with the sub-account."},"company_api_key":{"type":"string","example":"9c66b129752046***********","description":"The API key used to authenticate as this sub-account."},"company_created":{"type":"string","format":"date-time","example":"2024-09-03T09:03:12+0000","description":"The date and time when the sub-account was created."}}}},"components/schemas/CompanyListResponse":{"id":"components/schemas/CompanyListResponse","kind":"json-schema","title":"CompanyListResponse","data":{"type":"object","description":"Represents a paginated list of sub-accounts associated with a Partner account.","required":["http","offset","limit","total_companies","companies"],"properties":{"http":{"type":"integer","example":200,"description":"HTTP status code indicating the result of the API request."},"offset":{"type":"integer","example":0,"description":"The number of items skipped before starting to collect the result set."},"limit":{"type":"integer","example":10,"description":"The maximum number of sub-accounts returned in the current response."},"total_companies":{"type":"string","example":"2","description":"The total number of sub-accounts available to the authenticated Partner."},"companies":{"type":"array","description":"A list of sub-accounts returned in the current response.","items":{"$ref":"#/components/schemas/Company"}}}}},"components/schemas/ErrorResponse":{"id":"components/schemas/ErrorResponse","kind":"json-schema","title":"ErrorResponse","data":{"type":"object","required":["http","code","message"],"additionalProperties":false,"properties":{"http":{"type":"integer","example":400},"code":{"type":"integer","example":10050},"message":{"type":"string","example":"The request could not be completed."},"company":{"type":["string","null"],"example":null},"url":{"type":["string","null"],"example":"https://developer.signable.co.uk/errors/error-10002"},"detail":{"type":["string","null"],"example":null}}}},"components/schemas/CompanyCreateRequest":{"id":"components/schemas/CompanyCreateRequest","kind":"json-schema","title":"CompanyCreateRequest","data":{"type":"object","required":["company_name","user_name","user_email"],"properties":{"company_name":{"type":"string","example":"Example Inc","description":"The name of the new sub-account."},"user_name":{"type":"string","example":"Abby Signs","description":"The full name of the initial user for the sub-account."},"user_email":{"type":"string","format":"email","example":"abby@example.com","description":"The email address of the user to be created within the sub-account."}}}},"components/schemas/CompanyCreateResponse":{"id":"components/schemas/CompanyCreateResponse","kind":"json-schema","title":"CompanyCreateResponse","data":{"type":"object","required":["http","message","href","company_id","company_name","company_email","api_key","user_id","user_name","user_email","user_href","company_added"],"properties":{"http":{"type":"integer","example":200,"description":"HTTP status code indicating the result of the request."},"message":{"type":"string","example":"Example Inc has been added as a company","description":"A confirmation message."},"href":{"type":"string","format":"uri","example":"https://api.signable.co.uk/v1/companies/214821","description":"URL to the newly created sub-account resource."},"company_id":{"type":"string","example":"214821","description":"Unique identifier of the newly created sub-account."},"company_name":{"type":"string","example":"Example Inc","description":"Name of the newly created sub-account."},"company_email":{"type":"string","format":"email","example":"abby@example.com","description":"Registered email address for the sub-account."},"api_key":{"type":"string","example":"9c66b129752046***********","description":"API key associated with the sub-account."},"user_id":{"type":"string","example":"838931","description":"ID of the user created within the sub-account."},"user_name":{"type":"string","example":"Abby Signs","description":"Full name of the user created in the sub-account."},"user_email":{"type":"string","format":"email","example":"abby@example.com","description":"Email address of the created user."},"user_href":{"type":"string","format":"uri","example":"https://api.signable.co.uk/v1/users/838931","description":"URL to the created user resource."},"company_added":{"type":"string","format":"date-time","example":"2025-07-21T08:16:51+0000","description":"Timestamp when the sub-account was created."}}}},"components/schemas/CompanyUsage":{"id":"components/schemas/CompanyUsage","kind":"json-schema","title":"CompanyUsage","data":{"type":"object","description":"Represents document usage for a sub-account in a specific month and year.","properties":{"month":{"type":"string","example":"July","description":"The calendar month this usage relates to."},"year":{"type":"string","example":"2025","description":"The year this usage relates to."},"sent":{"type":"string","example":"1","description":"The number of documents sent during the specified month."}}}},"components/schemas/CompanyGetResponse":{"id":"components/schemas/CompanyGetResponse","kind":"json-schema","title":"CompanyGetResponse","data":{"allOf":[{"type":"object","required":["http"],"properties":{"http":{"type":"integer","description":"HTTP status code of the response.","example":200}}},{"$ref":"#/components/schemas/Company"},{"type":"object","required":["company_usage"],"properties":{"company_usage":{"type":"array","description":"Monthly usage summary for the sub-account.","items":{"$ref":"#/components/schemas/CompanyUsage"}}}}]}},"components/schemas/CompanyUpdateRequest":{"id":"components/schemas/CompanyUpdateRequest","kind":"json-schema","title":"CompanyUpdateRequest","data":{"type":"object","description":"Payload to update a sub-account. At least one property must be provided.","properties":{"company_name":{"type":"string","example":"Apple Tree Ltd","description":"New name of the sub-account."},"company_email":{"type":"string","format":"email","example":"abby@appletree.com","description":"New email address of the sub-account."}},"anyOf":[{"required":["company_name"]},{"required":["company_email"]}]}},"components/schemas/CompanyUpdateResponse":{"id":"components/schemas/CompanyUpdateResponse","kind":"json-schema","title":"CompanyUpdateResponse","data":{"type":"object","required":["http","message","href","company_id","company_name","company_email","company_updated"],"properties":{"http":{"type":"integer","example":200,"description":"HTTP status code indicating the result of the request."},"message":{"type":"string","example":"Apple Tree Ltd has been updated.","description":"Confirmation message indicating the update was successful."},"href":{"type":"string","format":"uri","example":"https://api.signable.co.uk/v1/company/214821","description":"URL to the updated sub-account resource."},"company_id":{"type":"integer","example":214821,"description":"Unique identifier of the updated sub-account."},"company_name":{"type":"string","example":"Apple Tree Ltd","description":"Updated name of the sub-account."},"company_email":{"type":"string","format":"email","example":"abby@appletree.com","description":"Updated email address of the sub-account."},"company_updated":{"type":"string","format":"date-time","example":"2025-07-21T08:30:27+0000","description":"Timestamp of when the sub-account was last updated."}}}},"components/schemas/CompanyDeleteResponse":{"id":"components/schemas/CompanyDeleteResponse","kind":"json-schema","title":"CompanyDeleteResponse","data":{"type":"object","required":["http","message","company_id","company_name","company_email"],"properties":{"http":{"type":"integer","example":200,"description":"HTTP status code indicating the result of the request."},"message":{"type":"string","example":"Apple Tree Ltd has been removed.","description":"Confirmation message indicating that the sub-account has been deleted."},"company_id":{"type":"string","example":"214821","description":"Identifier of the deleted sub-account."},"company_name":{"type":"string","example":"Apple Tree Ltd","description":"Name of the deleted sub-account."},"company_email":{"type":"string","format":"email","example":"abby@appletree.com","description":"Email address of the deleted sub-account."}}}},"components/schemas/PartnerUsageSummary":{"id":"components/schemas/PartnerUsageSummary","kind":"json-schema","title":"PartnerUsageSummary","data":{"type":"object","required":["company_id","company_name","current_usage","previous_usage","company_created"],"properties":{"company_id":{"type":"string","example":"196735","description":"Unique identifier of the sub-account."},"company_name":{"type":"string","example":"ExampleSubAccount_1","description":"Name of the sub-account."},"current_usage":{"type":"string","example":"1","description":"Number of documents sent in the current reporting period."},"previous_usage":{"type":"string","example":"6","description":"Number of documents sent in the previous reporting period."},"company_created":{"type":"string","format":"date-time","example":"2024-09-03T09:03:12+0000","description":"Timestamp when the sub-account was created."}}}},"components/schemas/PartnerUsageResponse":{"id":"components/schemas/PartnerUsageResponse","kind":"json-schema","title":"PartnerUsageResponse","data":{"type":"object","required":["http","offset","limit","total_companies","current_start_date","current_end_date","previous_start_date","previous_end_date","companies"],"properties":{"http":{"type":"integer","example":200,"description":"HTTP status code of the response."},"offset":{"type":"integer","example":0,"description":"Number of sub-accounts skipped before the returned result set."},"limit":{"type":"integer","example":10,"description":"Maximum number of sub-accounts returned in the response."},"total_companies":{"type":"string","example":"2","description":"Total number of sub-accounts available."},"current_start_date":{"type":"string","format":"date-time","example":"2024-12-01T00:00:00+0000","description":"Start of the current reporting period."},"current_end_date":{"type":"string","format":"date-time","example":"2025-01-01T00:00:00+0000","description":"End of the current reporting period."},"previous_start_date":{"type":"string","format":"date-time","example":"2024-11-01T00:00:00+0000","description":"Start of the previous reporting period."},"previous_end_date":{"type":"string","format":"date-time","example":"2024-12-01T00:00:00+0000","description":"End of the previous reporting period."},"companies":{"type":"array","description":"List of usage stats per sub-account.","items":{"$ref":"#/components/schemas/PartnerUsageSummary"}}}}},"components/schemas/EnvelopeUnsignedSummary":{"id":"components/schemas/EnvelopeUnsignedSummary","kind":"json-schema","title":"EnvelopeUnsignedSummary","data":{"type":"object","required":["envelope_fingerprint","envelope_title","envelope_status","envelope_redirect_url","envelope_created","envelope_sent","envelope_processed","envelope_all_at_once_enabled","envelope_requires_otp"],"properties":{"envelope_fingerprint":{"type":"string","description":"Unique identifier for the envelope.","example":"584ea8b41b0d4c17a96b967433b211e6"},"envelope_title":{"type":"string","description":"The title of the envelope.","example":"Another Test"},"envelope_status":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Current status of the envelope. "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"../../envelope-status"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See Envelope status values for more info →"},"children":[]}]}]}]}],"enum":["processing","failed","draft","sent","signed","cancelled","expired","rejected","verify"],"example":"draft"},"envelope_redirect_url":{"type":["string","null"],"description":"Redirect URL after signing. If no redirect is set, this may be null or an empty string \"\".","example":"https://www.example.com"},"envelope_created":{"type":"string","format":"date-time","description":"Timestamp when the envelope was created (ISO 8601).","example":"2025-07-07T11:30:27+0000"},"envelope_sent":{"type":["string","null"],"format":"date-time","description":"Timestamp when the envelope was sent. Null if not yet sent.","example":null},"envelope_processed":{"type":["string","null"],"format":"date-time","description":"Timestamp when the envelope was processed. Null if not yet processed.","example":null},"envelope_all_at_once_enabled":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If true, the envelope is sent to all parties at the same time. If false, the envelope is sent to parties one at a time, starting with the first."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For more info on \"One at a time\" signing sequence, see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://help.signable.app/article/191-setting-the-signing-sequence"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Setting the signing sequence"},"children":[]}]}]}]}],"example":true},"envelope_requires_otp":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indicates whether one or more parties on this envelope require one-time-password (OTP) verification. Check each party's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"party_mobile_last4"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" value to see which parties require OTP."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For more info on OTPs, see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"https://help.signable.app/article/208-adding-a-one-time-password-to-an-envelope"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Enabling Two-Factor Authentication for Signers"},"children":[]}]}]}]}],"example":false}}}},"components/schemas/EnvelopePartyBase":{"id":"components/schemas/EnvelopePartyBase","kind":"json-schema","title":"EnvelopePartyBase","data":{"type":"object","required":["party_id","party_title","party_mobile_last4","party_password"],"properties":{"party_id":{"type":"string","description":"Unique identifier for the party in the envelope.","example":"45631119"},"party_title":{"type":"string","description":"Label for the party, typically their name.","example":"Abby Signable"},"party_mobile_last4":{"type":["string","null"],"description":"Last 4 digits of the party's mobile number. A non-null value indicates OTP verification is required for this party.\n","example":null},"party_password":{"type":["string","null"],"description":"Password assigned for accessing the envelope, if applicable.","example":"Test123"}}}},"components/schemas/EnvelopeParty":{"id":"components/schemas/EnvelopeParty","kind":"json-schema","title":"EnvelopeParty","data":{"allOf":[{"$ref":"#/components/schemas/EnvelopePartyBase"}]}},"components/schemas/EnvelopeSignedSummary":{"id":"components/schemas/EnvelopeSignedSummary","kind":"json-schema","title":"EnvelopeSignedSummary","data":{"allOf":[{"$ref":"#/components/schemas/EnvelopeUnsignedSummary"},{"type":"object","description":"Summary information about a signed envelope.","required":["envelope_parties"],"properties":{"envelope_parties":{"type":"array","items":{"$ref":"#/components/schemas/EnvelopeParty"}},"envelope_signed_pdf":{"type":["string","null"],"format":"uri","description":"Present when the envelope is signed. Returns a PDF file for single-document envelopes, or a ZIP file containing PDFs for multi-document envelopes.","example":"https://api.signableapi.com/shareable/envelope?t=71afe41f-b99f-42e7-9a06-7f4070df010f"}}}]}},"components/schemas/EnvelopeListResponse":{"id":"components/schemas/EnvelopeListResponse","kind":"json-schema","title":"EnvelopeListResponse","data":{"type":"object","required":["http","offset","limit","total_envelopes","envelopes"],"properties":{"http":{"type":"integer","description":"HTTP status code of the response.","example":200},"offset":{"type":"integer","description":"The index of the first envelope in the result set.","example":0},"limit":{"type":"integer","description":"The number of envelopes returned in this response.","example":10},"total_envelopes":{"type":"string","description":"The total number of envelopes matching the query.","example":"3"},"envelopes":{"type":"array","items":{"$ref":"#/components/schemas/EnvelopeSignedSummary"}}}}},"components/schemas/EnvelopeSendResponse":{"id":"components/schemas/EnvelopeSendResponse","kind":"json-schema","title":"EnvelopeSendResponse","data":{"type":"object","required":["http","message","href","envelope_title","envelope_fingerprint","envelope_queued","envelope_parties"],"properties":{"http":{"type":"integer","description":"HTTP status code indicating success.","example":202},"message":{"type":"string","description":"A human-readable message confirming the envelope is queued.","example":"Your envelope with title Ashbrook Road 10/06/25 will be processed and sent out."},"href":{"type":"string","format":"uri","description":"URL to retrieve envelope details.","example":"https://api.signable.co.uk/v1/envelopes/584ea8b41b0d4c17a96b967433b211e6"},"envelope_title":{"type":"string","description":"Title of the envelope that was submitted.","example":"Ashbrook Road 10/06/25"},"envelope_fingerprint":{"type":"string","description":"Unique identifier (hash) for the envelope.","example":"584ea8b41b0d4c17a96b967433b211e6"},"envelope_signing_embed":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An embeddable HTML "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"<iframe>"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" snippet that renders the signing page within"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"your application."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This field is "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"only returned if embed signing has been enabled on your"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"account"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" by the Signable Support team. For more information see "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"/guides/embedded-signing/embedded"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Embedded Signing"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"⚠️ "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Notes"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This field is only returned in the POST response, it will not be"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"returned in GET "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"/envelopes/{envelope_fingerprint}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}],"example":"<iframe src=\"https://sign.signable.app/#yXqPrm7HVOaiQUNM4NZI34BocfDWB69lf68lHq90R0s\" width=\"100%\" height=\"95%\" frameborder=\"0\" style=\"border: 0; overflow: hidden\"></iframe>\n"},"envelope_password_protect":{"type":"boolean","description":"Indicates if password protection was enabled on the envelope.","example":false},"envelope_requires_otp":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indicates whether one or more parties require one-time-password verification. Check each party's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"party_mobile_last4"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" value to see which parties require OTP."},"children":[]}]}]}],"example":true},"envelope_redirect_url":{"type":"string","format":"uri","description":"URL the signer will be redirected to after completing the envelope.","example":"https://www.example.com"},"envelope_queued":{"type":"string","format":"date-time","description":"Timestamp when the envelope was successfully queued.","example":"2025-07-16T09:58:21+0000"},"envelope_all_at_once_enabled":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether the envelope was sent to all parties simultaneously ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") or sequentially ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"false"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"example":false},"envelope_parties":{"type":"array","description":"List of parties associated with the envelope, including signer and copy recipients.","items":{"type":"object","properties":{"party_id":{"type":"string","description":"Unique identifier for the party.","example":"45831671"},"party_title":{"type":"string","description":"Name of the party.","example":"Alex Mitchell"},"party_mobile_last4":{"type":["string","null"],"description":"Last 4 digits of the party's mobile number. A non-null value indicates OTP verification is required for this party.\n","example":"5678"},"party_password":{"type":["string","null"],"description":"Password for party access if password protection was enabled.","example":null}}}}}}},"components/schemas/EnvelopeDetailParty":{"id":"components/schemas/EnvelopeDetailParty","kind":"json-schema","title":"EnvelopeDetailParty","data":{"allOf":[{"$ref":"#/components/schemas/EnvelopePartyBase"},{"type":"object","required":["contact_id","contact_email","party_status","party_signature_type","party_role"],"properties":{"contact_id":{"type":"string","description":"ID of the contact linked to the party.","example":"17225983"},"contact_email":{"type":"string","description":"Email address of the party.","example":"abby@signable.co.uk"},"party_status":{"type":"string","enum":["pending","in progress","signed"],"description":"Status of the party's signing progress.","example":"in progress"},"party_signature_type":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indicates how the party will sign the envelope. Only "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"remote"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" value is supported."},"children":[]}]}]}],"const":"remote","example":"remote"},"party_role":{"type":"string","enum":["signer","copy"],"description":"Role of the party, they are either a signer or they are copied into the document with read-only permission.","example":"signer"}}}]}},"components/schemas/EnvelopeField":{"id":"components/schemas/EnvelopeField","kind":"json-schema","title":"EnvelopeField","data":{"type":"object","required":["field_id","field_title","field_type","field_value","party_id"],"properties":{"field_id":{"type":"string","description":"Unique identifier for the field.","example":"452902787"},"field_title":{"type":"string","description":"The label or title of the field.","example":"First Name"},"field_type":{"type":"string","enum":["text","date","checkbox","upload","dropdown"],"description":"Type of the field. Signature fields are not returned.","example":"text"},"field_value":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Value filled in the field. May be empty. For "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"upload"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" fields, this contains a temporary uploaded file URL. Upload URLs are valid for 24 hours; after they expire, make another API request to retrieve fresh download links."},"children":[]}]}]}],"example":"Abby Sackson"},"party_id":{"type":"string","description":"ID of the party this field is assigned to.","example":"45631119"},"field_merge":{"type":["string","null"],"description":"Merge field label used to pre-fill values.","example":"Sender Name"}}}},"components/schemas/EnvelopeDocument":{"id":"components/schemas/EnvelopeDocument","kind":"json-schema","title":"EnvelopeDocument","data":{"type":"object","required":["document_fingerprint","document_title","document_page_total","document_pdf_url","document_thumbnails","document_pages","document_fields"],"properties":{"document_fingerprint":{"type":"string","description":"Unique identifier for the document.","example":"8ab4248168761318178b5c747c643a27"},"document_title":{"type":"string","description":"Title of the document.","example":"Sample Tenancy Contract"},"document_page_total":{"type":"string","description":"Total number of pages in the document.","example":"2"},"document_pdf_url":{"type":"string","format":"uri","description":"Direct download link to the original PDF.","example":"https://docs.signable.co.uk/original/8ab4248168761318178b5c747c643a27.pdf"},"document_thumbnails":{"type":"array","description":"List of thumbnail image URLs for the document pages.","items":{"type":"string","format":"uri"},"example":["https://docs.signable.co.uk/small/8ab4248168761318178b5c747c643a27-0.jpg","https://docs.signable.co.uk/small/8ab4248168761318178b5c747c643a27-1.jpg"]},"document_pages":{"type":"array","description":"List of full-size image URLs for the document pages.","items":{"type":"string","format":"uri"},"example":["https://docs.signable.co.uk/large/8ab4248168761318178b5c747c643a27-0.jpg","https://docs.signable.co.uk/large/8ab4248168761318178b5c747c643a27-1.jpg"]},"document_fields":{"type":"array","description":"List of fields assigned to parties in the document.","items":{"$ref":"#/components/schemas/EnvelopeField"}},"document_signed_pdf":{"type":["string","null"],"format":"uri","description":"Direct download link to the signed PDF (if the envelope is signed).","example":"https://api.signableapi.com/shareable/envelope?t=71afe41f-b99f-42e7-9a06-7f4070df010f"}}}},"components/schemas/EnvelopeHistoryEvent":{"id":"components/schemas/EnvelopeHistoryEvent","kind":"json-schema","title":"EnvelopeHistoryEvent","data":{"type":"object","required":["history_detail","history_ip","history_user_agent","history_date"],"properties":{"history_detail":{"type":"string","description":"Description of the event that occurred.","example":"Sent the envelope to Abby Signable (abby@signable.co.uk) for signing"},"history_ip":{"type":"string","description":"IP address from where the action was triggered.","example":"147.147.97.34"},"history_user_agent":{"type":"string","description":"Browser or device info from where the event occurred.","example":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0 Safari/537.36"},"history_date":{"type":"string","format":"date-time","description":"Date and time when the event occurred.","example":"2025-07-08T15:02:48+0000"}}}},"components/schemas/EnvelopeDetailResponse":{"id":"components/schemas/EnvelopeDetailResponse","kind":"json-schema","title":"EnvelopeDetailResponse","data":{"allOf":[{"$ref":"#/components/schemas/EnvelopeUnsignedSummary"},{"type":"object","required":["http","envelope_parties","envelope_documents","envelope_history"],"properties":{"http":{"type":"integer","description":"HTTP status code of the response.","example":200},"envelope_parties":{"type":"array","items":{"$ref":"#/components/schemas/EnvelopeDetailParty"}},"envelope_documents":{"type":"array","items":{"$ref":"#/components/schemas/EnvelopeDocument"}},"envelope_signed_pdf":{"type":["string","null"],"format":"uri","description":"Present when the envelope is signed. Returns a PDF file for single-document envelopes, or a ZIP file containing PDFs for multi-document envelopes.","example":"https://api.signableapi.com/shareable/envelope?t=71afe41f-b99f-42e7-9a06-7f4070df010f"},"envelope_history":{"type":"array","items":{"$ref":"#/components/schemas/EnvelopeHistoryEvent"}},"envelope_meta":{"type":"object","description":"Optional metadata to associate with the envelope. These key-value pairs are stored by Signable and returned in the response and all envelope related webhooks. Useful for attaching internal IDs, status flags, tags, or any contextual information relevant to your system.\n","additionalProperties":true,"example":{"internal_id":"ABC123","VIP":false}}}}]}},"components/schemas/EnvelopeDeleteResponse":{"id":"components/schemas/EnvelopeDeleteResponse","kind":"json-schema","title":"EnvelopeDeleteResponse","data":{"type":"object","required":["http","message","envelope_fingerprint","envelope_title","envelope_status"],"properties":{"http":{"type":"integer","example":200,"description":"HTTP status code of the response."},"message":{"type":"string","example":"The envelope has been deleted","description":"Human-readable confirmation message."},"envelope_fingerprint":{"type":"string","example":"584ea8b41b0d4c17a96b967433b211e6","description":"Unique identifier for the deleted envelope."},"envelope_title":{"type":"string","example":"Industrial Contract","description":"Title of the envelope at the time of deletion."},"envelope_status":{"type":"string","const":"deleted","description":"The new status of the envelope after deletion.","example":"deleted"}}}},"components/schemas/EnvelopeRemindResponse":{"id":"components/schemas/EnvelopeRemindResponse","kind":"json-schema","title":"EnvelopeRemindResponse","data":{"type":"object","required":["http","message","envelope_fingerprint","envelope_title","envelope_all_at_once_enabled"],"properties":{"http":{"type":"integer","example":200,"description":"HTTP status code of the response."},"message":{"type":"string","example":"The signing parties for this envelope have been reminded.","description":"Human-readable status message."},"envelope_fingerprint":{"type":"string","example":"584ea8b41b0d4c17a96b967433b211e6","description":"Unique fingerprint of the envelope."},"envelope_title":{"type":"string","example":"17 John Street Tenancy Contract - 25th Jun 2025","description":"The title of the envelope at the time of the reminder."},"envelope_all_at_once_enabled":{"type":"boolean","example":true,"description":"Indicates if the envelope is configured for all-at-once signing."}}}},"components/schemas/EnvelopeCancelResponse":{"id":"components/schemas/EnvelopeCancelResponse","kind":"json-schema","title":"EnvelopeCancelResponse","data":{"type":"object","required":["http","message","envelope_fingerprint","envelope_title","envelope_status","envelope_processed"],"properties":{"http":{"type":"integer","example":200,"description":"HTTP status code of the response."},"message":{"type":"string","example":"The envelope has been cancelled","description":"Human-readable confirmation message."},"envelope_fingerprint":{"type":"string","example":"584ea8b41b0d4c17a96b967433b211e6","description":"Unique identifier for the cancelled envelope."},"envelope_title":{"type":"string","example":"Contract Settlement","description":"Title of the envelope at the time of cancellation."},"envelope_status":{"type":"string","const":"cancelled","description":"The new status of the envelope after cancellation.","example":"cancelled"},"envelope_processed":{"type":"string","format":"date-time","example":"2025-07-14T13:34:34+0000","description":"Timestamp when the cancellation was processed."}}}},"components/schemas/EnvelopeExpireResponse":{"id":"components/schemas/EnvelopeExpireResponse","kind":"json-schema","title":"EnvelopeExpireResponse","data":{"type":"object","required":["http","message","envelope_fingerprint","envelope_title","envelope_status"],"properties":{"http":{"type":"integer","example":200,"description":"HTTP status code of the response."},"message":{"type":"string","example":"The envelope has been expired","description":"Human-readable confirmation message."},"envelope_fingerprint":{"type":"string","example":"584ea8b41b0d4c17a96b967433b211e6","description":"Unique identifier for the expired envelope."},"envelope_title":{"type":"string","example":"Test Envelope","description":"Title of the envelope at the time of expiration."},"envelope_status":{"type":"string","const":"expired","description":"The new status of the envelope after expiration.","example":"expired"}}}},"components/schemas/EnvelopePartyUpdateRequest":{"id":"components/schemas/EnvelopePartyUpdateRequest","kind":"json-schema","title":"EnvelopePartyUpdateRequest","data":{"type":"object","required":[],"properties":{"party_email":{"type":"string","format":"email","description":"The new email address for the party.\n","example":"abby+updated@signable.co.uk"},"party_title":{"type":"string","description":"The new title for the party.\n","example":"Abby"}}}},"components/schemas/EnvelopePartyUpdateResponse":{"id":"components/schemas/EnvelopePartyUpdateResponse","kind":"json-schema","title":"EnvelopePartyUpdateResponse","data":{"type":"object","properties":{"http":{"type":"integer","description":"HTTP status code of the response.","example":200},"party_id":{"type":"integer","description":"The unique ID of the updated party.","example":1234567},"party_title":{"type":"string","description":"The updated title of the party.","example":"Abby"},"party_email":{"type":"string","format":"email","description":"The updated email address of the party.","example":"abby+updated@signable.co.uk"},"party_role":{"type":"string","description":"The role of the party in the envelope.","example":"signer"}}}},"components/schemas/MergeField":{"id":"components/schemas/MergeField","kind":"json-schema","title":"MergeField","data":{"type":"object","properties":{"field_id":{"type":"string","description":"Internal field identifier.","example":"450927743"},"field_merge":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A short label for the merge field, shown to the sender during the \"Add fields & preview\" step when preparing an envelope for sending."},"children":[]}]}]}],"example":"Name of Sender"},"field_type":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This will always be "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"text"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", due to merge functionality only being available for text field type."},"children":[]}]}]}],"const":"text","example":"text"}}}},"components/schemas/TemplateParty":{"id":"components/schemas/TemplateParty","kind":"json-schema","title":"TemplateParty","data":{"type":"object","properties":{"party_id":{"type":"string","example":"20459705"},"party_name":{"type":"string","example":"Party"},"party_merge_fields":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Template fields that can optionally be pre-filled with text by the sender to personalise the document before sending."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If a merge field is filled in during sending, it will appear as read-only for the signer."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If left empty, the signer associated with the party ID in this object will be able to complete the field themselves."},"children":[]}]}]}]}],"items":{"$ref":"#/components/schemas/MergeField"}}}}},"components/schemas/TemplateSummary":{"id":"components/schemas/TemplateSummary","kind":"json-schema","title":"TemplateSummary","data":{"type":"object","properties":{"template_id":{"type":"string","description":"Internal identifier.","example":"53690003"},"template_fingerprint":{"type":"string","description":"The unique ID used to identify this template.","example":"b786a173554cc06371248caf0b250704"},"template_title":{"type":"string","description":"The name of the template.","example":"Sample Contract"},"template_page_total":{"type":"string","description":"The total number of pages in the template.","example":"1"},"template_in_progress":{"type":"string","description":"The number of envelopes currently in progress that use this template.","example":"3"},"template_parties_total":{"type":"string","description":"The number of signing parties included in the template.","example":"1"},"template_widget_url":{"type":"string","format":"uri","description":"The direct URL to the hosted signing widget for this template.","example":"https://sign.signable.app/#/widget/VG7Tsd3y6X"},"template_widget_embed":{"type":"string","description":"A script snippet for embedding the signing widget into a webpage.","example":"<iframe src='https://sign.signable.app/#/widget/VG7Tsd3y6X' frameborder='0' style='border:0;width:100%;height:100vh;' scrolling='yes'></iframe>"},"template_pdf_url":{"type":"string","format":"uri","description":"A direct link to download the original uploaded PDF used in the template.","example":"https://docs.signable.co.uk/original/b786a173554cc06371248caf0b250704.pdf"},"template_thumbnails":{"type":"array","items":{"type":"string","format":"uri"},"description":"An array of URLs to thumbnail images for each page of the template."},"template_pages":{"type":"array","items":{"type":"string","format":"uri"},"description":"An array of URLs to full-size images of each page in the template."},"template_uploaded":{"type":"string","format":"date-time","description":"The date and time the template was uploaded (in ISO 8601 format).","example":"2025-07-01T08:40:38+0000"},"template_parties":{"type":"array","items":{"$ref":"#/components/schemas/TemplateParty"},"description":"A list of the parties assigned to the template, including the merge fields linked to each party."}}}},"components/schemas/TemplatesListResponse":{"id":"components/schemas/TemplatesListResponse","kind":"json-schema","title":"TemplatesListResponse","data":{"type":"object","properties":{"http":{"type":"integer","example":200},"offset":{"type":"integer","example":0},"limit":{"type":"integer","example":10},"total_templates":{"type":"string","example":"1"},"templates":{"type":"array","items":{"$ref":"#/components/schemas/TemplateSummary"}}}}},"components/schemas/TemplateGetResponse":{"id":"components/schemas/TemplateGetResponse","kind":"json-schema","title":"TemplateGetResponse","data":{"allOf":[{"type":"object","properties":{"http":{"type":"integer","example":200}}},{"$ref":"#/components/schemas/TemplateSummary"}]}},"components/schemas/TemplateDeleteResponse":{"id":"components/schemas/TemplateDeleteResponse","kind":"json-schema","title":"TemplateDeleteResponse","data":{"type":"object","properties":{"http":{"type":"integer","example":200},"message":{"type":"string","example":"Sample Tenancy Contract has been removed from your template list."},"template_id":{"type":"string","example":"53890528"},"tempate_fingerprint":{"type":"string","example":"e0b3a9cbd4a6ff2cb57cfca161a39309"},"tempate_title":{"type":"string","example":"Sample Tenancy Contract"}}}},"components/schemas/Contact":{"id":"components/schemas/Contact","kind":"json-schema","title":"Contact","data":{"type":"object","properties":{"contact_id":{"type":"string","example":"17224073"},"contact_name":{"type":"string","example":"Buffy The Vampire Slayer"},"contact_email":{"type":"string","format":"email","example":"buffy@sunnydale.com"},"contact_outstanding_documents":{"type":"string","example":"0"},"contact_created":{"type":"string","format":"date-time","example":"2025-07-07T09:54:08+0000"}}}},"components/schemas/ContactsListResponse":{"id":"components/schemas/ContactsListResponse","kind":"json-schema","title":"ContactsListResponse","data":{"type":"object","properties":{"http":{"type":"integer","example":200},"offset":{"type":"integer","example":0},"limit":{"type":"integer","example":50},"total_contacts":{"type":"string","example":"3"},"next":{"type":"string","format":"uri","description":"Returned when another page of contacts is available.","example":"https://api.signable.co.uk/v1/contacts?offset=50&limit=50"},"contacts":{"type":"array","items":{"$ref":"#/components/schemas/Contact"}}}}},"components/schemas/ContactCreateRequest":{"id":"components/schemas/ContactCreateRequest","kind":"json-schema","title":"ContactCreateRequest","data":{"type":"object","required":["contact_name","contact_email"],"properties":{"contact_name":{"type":"string","example":"Hanz Zimmer"},"contact_email":{"type":"string","format":"email","example":"hanz.zimmer@music.com"}}}},"components/schemas/ContactCreateResponse":{"id":"components/schemas/ContactCreateResponse","kind":"json-schema","title":"ContactCreateResponse","data":{"type":"object","properties":{"http":{"type":"integer","example":200},"message":{"type":"string","example":"Hanz Zimmer has been added to your contact list."},"href":{"type":"string","format":"uri","example":"https://api.signable.co.uk/v1/contacts/17224150"},"contact_id":{"type":"string","example":"17224150"},"contact_name":{"type":"string","example":"Hanz Zimmer"},"contact_email":{"type":"string","format":"email","example":"hanz.zimmer@music.com"},"contact_created":{"type":"string","format":"date-time","example":"2025-07-07T09:57:39+0000"}}}},"components/schemas/ContactGetResponse":{"id":"components/schemas/ContactGetResponse","kind":"json-schema","title":"ContactGetResponse","data":{"type":"object","properties":{"http":{"type":"integer","example":200},"contact_id":{"type":"integer","example":17224150},"contact_name":{"type":"string","example":"Hanz Zimmer"},"contact_email":{"type":"string","format":"email","example":"hanz.zimmer@music.com"},"contact_outstanding_documents":{"type":"string","example":"0"},"contact_created":{"type":"string","format":"date-time","example":"2025-07-07T09:57:39+0000"}}}},"components/schemas/RouteNotFoundResponse":{"id":"components/schemas/RouteNotFoundResponse","kind":"json-schema","title":"RouteNotFoundResponse","data":{"type":"object","required":["message"],"additionalProperties":false,"properties":{"message":{"type":"string","example":"The route v1/contacts/abc could not be found."}}}},"components/schemas/ContactUpdateRequest":{"id":"components/schemas/ContactUpdateRequest","kind":"json-schema","title":"ContactUpdateRequest","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Provide at least one of "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"contact_name"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"contact_email"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The API accepts partial updates."},"children":[]}]}]}],"anyOf":[{"required":["contact_name"]},{"required":["contact_email"]}],"properties":{"contact_name":{"type":"string","example":"Nemo"},"contact_email":{"type":"string","description":"Email address to store for the contact.","example":"nemo@coralreef.com"}}}},"components/schemas/ContactUpdateResponse":{"id":"components/schemas/ContactUpdateResponse","kind":"json-schema","title":"ContactUpdateResponse","data":{"type":"object","properties":{"http":{"type":"integer","example":200},"message":{"type":"string","example":"Nemo has been updated in your contact list."},"href":{"type":"string","format":"uri","example":"https://api.signable.co.uk/v1/contacts/17224150"},"contact_id":{"type":"integer","example":17224150},"contact_name":{"type":"string","example":"Nemo"},"contact_email":{"type":"string","format":"email","example":"nemo@coralreef.com"},"contact_updated":{"type":"string","format":"date-time","example":"2025-07-07T09:59:25+0000"}}}},"components/schemas/ContactDeleteResponse":{"id":"components/schemas/ContactDeleteResponse","kind":"json-schema","title":"ContactDeleteResponse","data":{"type":"object","properties":{"http":{"type":"integer","example":200},"message":{"type":"string","example":"Nemo has been removed from your contact list."},"contact_id":{"type":"integer","example":17224150},"contact_name":{"type":"string","example":"Nemo"},"contact_email":{"type":"string","format":"email","example":"nemo@coralreef.com"}}}},"components/schemas/ContactEnvelopeSummary":{"id":"components/schemas/ContactEnvelopeSummary","kind":"json-schema","title":"ContactEnvelopeSummary","data":{"type":"object","properties":{"envelope_fingerprint":{"type":"string","example":"584ea8b41b0d4c17a96b967433b211e6"},"envelope_title":{"type":"string","example":"Another Test"},"envelope_status":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Current status of the envelope. "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"../../envelope-status"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"See Envelope status values for more info →"},"children":[]}]}]}]}],"enum":["processing","failed","draft","sent","signed","cancelled","expired","rejected","verify"],"example":"draft"},"envelope_created":{"type":"string","format":"date-time","example":"2025-07-07T11:30:27+0000"},"envelope_sent":{"type":["string","null"],"format":"date-time","example":null},"envelope_processed":{"type":["string","null"],"format":"date-time","example":null},"envelope_signed_pdf":{"type":["string","null"],"format":"uri","description":"Returned when a signed PDF link is available.","example":"https://api.signableapi.com/shareable/envelope?t=403cebcc-60ec-4cc2-b7d6-753fb7d5c662"}}}},"components/schemas/ContactEnvelopesListResponse":{"id":"components/schemas/ContactEnvelopesListResponse","kind":"json-schema","title":"ContactEnvelopesListResponse","data":{"type":"object","properties":{"http":{"type":"integer","example":200},"offset":{"type":"integer","example":0},"limit":{"type":"integer","example":10},"total_envelopes":{"type":"string","example":"3"},"envelopes":{"type":"array","items":{"$ref":"#/components/schemas/ContactEnvelopeSummary"}}}}},"components/schemas/User":{"id":"components/schemas/User","kind":"json-schema","title":"User","data":{"type":"object","properties":{"user_id":{"type":"string","example":"836499"},"role_id":{"type":"string","example":"3"},"user_name":{"type":"string","example":"Abby Loves Signable"},"user_email":{"type":"string","format":"email","example":"abby+010725@signable.co.uk"},"user_added":{"type":"string","format":"date-time","example":"2025-07-01T08:40:38+0000"},"user_last_updated":{"type":"string","format":"date-time","example":"2025-07-07T07:57:54+0000"}}}},"components/schemas/UsersListResponse":{"id":"components/schemas/UsersListResponse","kind":"json-schema","title":"UsersListResponse","data":{"type":"object","properties":{"http":{"type":"integer","example":200},"offset":{"type":"integer","example":0},"limit":{"type":"integer","example":50},"total_users":{"type":"string","description":"Total number of users (returned as a string)","example":"2"},"users":{"type":"array","items":{"$ref":"#/components/schemas/User"}}}}},"components/schemas/UserCreateRequest":{"id":"components/schemas/UserCreateRequest","kind":"json-schema","title":"UserCreateRequest","data":{"type":"object","required":["user_name","user_email","role_id"],"properties":{"user_name":{"type":"string","example":"Abby Example"},"user_email":{"type":"string","format":"email","example":"abby+example@wearedom.com"},"role_id":{"type":"string","enum":["1","2","3"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Role assigned to the user:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"1\" = User"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"2\" = Admin"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"3\" = Super-Admin"},"children":[]}]}]}]}],"example":"2"}}}},"components/schemas/UserCreateResponse":{"id":"components/schemas/UserCreateResponse","kind":"json-schema","title":"UserCreateResponse","data":{"type":"object","properties":{"http":{"type":"integer","example":200},"message":{"type":"string","example":"Abby Example has been added to your user list."},"href":{"type":"string","format":"uri","example":"https://api.signable.co.uk/v1/users/837146"},"user_id":{"type":"string","example":"837146"},"role_id":{"type":"string","enum":["1","2","3"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Role assigned to the user:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"1\" = User"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"2\" = Admin"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"3\" = Super-Admin"},"children":[]}]}]}]}],"example":"1"},"user_name":{"type":"string","example":"Abby Example"},"user_email":{"type":"string","format":"email","example":"abby+example@wearedom.com"},"user_added":{"type":"string","format":"date-time","example":"2025-07-07T08:06:49+0000"}}}},"components/schemas/UserGetResponse":{"id":"components/schemas/UserGetResponse","kind":"json-schema","title":"UserGetResponse","data":{"type":"object","properties":{"http":{"type":"integer","example":200},"user_id":{"type":"integer","example":836499},"role_id":{"type":"string","enum":["1","2","3"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Role assigned to the user:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"1\" = User"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"2\" = Admin"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"3\" = Super-Admin"},"children":[]}]}]}]}],"example":"3"},"user_name":{"type":"string","example":"Abby Loves Signable"},"user_email":{"type":"string","format":"email","example":"abby+010725@signable.co.uk"},"user_added":{"type":"string","format":"date-time","example":"2025-07-01T08:40:38+0000"},"user_last_updated":{"type":"string","format":"date-time","example":"2025-07-07T07:57:54+0000"}}}},"components/schemas/UserUpdateRequest":{"id":"components/schemas/UserUpdateRequest","kind":"json-schema","title":"UserUpdateRequest","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supplying "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"role_id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" on its own is not valid."},"children":[]}]}]}],"properties":{"user_name":{"type":"string","example":"Abby Smith","description":"New name for the user."},"user_email":{"type":"string","format":"email","example":"abby+jackson@signable.co.uk","description":"New email address for the user."},"role_id":{"type":"string","enum":["1","2","3"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Role assigned to the user:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"1\" = User"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"2\" = Admin"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"3\" = Super-Admin"},"children":[]}]}]}]}],"example":"1"}},"anyOf":[{"required":["user_name"]},{"required":["user_email"]}]}},"components/schemas/UserUpdateResponse":{"id":"components/schemas/UserUpdateResponse","kind":"json-schema","title":"UserUpdateResponse","data":{"type":"object","properties":{"http":{"type":"integer","example":200},"message":{"type":"string","example":"Abby Smith has been updated in your user list."},"href":{"type":"string","format":"uri","example":"https://api.signable.co.uk/v1/users/837154"},"user_id":{"type":"integer","example":837154},"role_id":{"type":"string","enum":["1","2","3"],"example":"1"},"user_name":{"type":"string","example":"Abby Smith"},"user_email":{"type":"string","format":"email","example":"abby+jackson@signable.co.uk"},"user_updated":{"type":"string","format":"date-time","example":"2025-07-07T08:38:54+0000"}}}},"components/schemas/UserDeleteResponse":{"id":"components/schemas/UserDeleteResponse","kind":"json-schema","title":"UserDeleteResponse","data":{"type":"object","properties":{"http":{"type":"integer","example":200},"message":{"type":"string","example":"Abby Smith has been removed from your user list."},"user_id":{"type":"integer","example":837154},"role_id":{"type":"string","enum":["1","2","3"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Role previously assigned to the deleted user:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"1\" = User"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"2\" = Admin"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"\"3\" = Super-Admin"},"children":[]}]}]}]}],"example":"1"},"user_email":{"type":"string","format":"email","example":"abby+jackson@signable.co.uk"},"user_name":{"type":"string","example":"Abby Smith"}}}},"components/schemas/WebhookListItem":{"id":"components/schemas/WebhookListItem","kind":"json-schema","title":"WebhookListItem","data":{"type":"object","required":["webhook_id","webhook_url","webhook_type","webhook_created","webhook_updated","webhook_suspended"],"properties":{"webhook_id":{"type":"string","description":"Unique identifier of the webhook","example":"132223"},"webhook_url":{"type":"string","format":"uri","description":"The URL to which webhook events are sent","example":"https://example.com"},"webhook_type":{"type":"string","description":"The type of event the webhook listens for","enum":["send-envelope","signed-envelope","cancelled-envelope","rejected-envelope","bounced-envelope","add-user","add-contact","opened-envelope","add-template","all","signed-envelope-complete","verify-envelope-widget","signed-envelope-widget","send-envelope-failed"],"example":"send-envelope"},"webhook_created":{"type":"string","format":"date-time","description":"Timestamp when the webhook was created","example":"2025-06-23T17:15:01+0000"},"webhook_updated":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When the webhook was last updated","example":null},"webhook_suspended":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When the webhook was suspended (or null if active)","example":null}}}},"components/schemas/WebhookListResponse":{"id":"components/schemas/WebhookListResponse","kind":"json-schema","title":"WebhookListResponse","data":{"type":"object","required":["http","offset","limit","total_webhooks","webhooks"],"properties":{"http":{"type":"integer","example":200},"offset":{"type":"integer","example":10},"limit":{"type":"integer","example":10},"total_webhooks":{"type":"string","example":"44"},"next":{"type":"string","format":"uri","example":"https://api.signable.co.uk/v1/webhooks?offset=10&limit=10"},"webhooks":{"type":"array","items":{"$ref":"#/components/schemas/WebhookListItem"}}}}},"components/schemas/WebhookRequest":{"id":"components/schemas/WebhookRequest","kind":"json-schema","title":"WebhookRequest","data":{"type":"object","required":["webhook_url","webhook_type"],"properties":{"webhook_url":{"type":"string","format":"uri","description":"The callback URL where webhook events will be sent.","example":"https://example.com"},"webhook_type":{"type":"string","description":"The event type to subscribe to.\n","enum":["send-envelope","signed-envelope","cancelled-envelope","rejected-envelope","bounced-envelope","add-user","add-contact","opened-envelope","add-template","all","signed-envelope-complete","verify-envelope-widget","signed-envelope-widget","send-envelope-failed"],"example":"send-envelope"}}}},"components/schemas/WebhookPostResponse":{"id":"components/schemas/WebhookPostResponse","kind":"json-schema","title":"WebhookPostResponse","data":{"type":"object","required":["http","message","href","webhook_id","webhook_url","webhook_type","webhook_created"],"properties":{"http":{"type":"integer","description":"HTTP status code","example":200},"message":{"type":"string","description":"Confirmation message about the webhook creation","example":"The webhook (https://example.com) has been created"},"href":{"type":"string","format":"uri","description":"API resource URL for the newly created webhook","example":"https://api.signable.co.uk/v1/webhooks/152691"},"webhook_id":{"type":"string","description":"Unique identifier for the created webhook","example":"152691"},"webhook_url":{"type":"string","format":"uri","description":"The callback URL registered for the webhook","example":"https://example.com"},"webhook_type":{"type":"string","description":"The event type the webhook is subscribed to","enum":["send-envelope","signed-envelope","cancelled-envelope","rejected-envelope","bounced-envelope","add-user","add-contact","opened-envelope","add-template","all","signed-envelope-complete","verify-envelope-widget","signed-envelope-widget","send-envelope-failed"],"example":"all"},"webhook_created":{"type":"string","format":"date-time","description":"The timestamp when the webhook was created","example":"2025-06-23T17:15:01+0000"}}}},"components/schemas/WebhookGetResponse":{"id":"components/schemas/WebhookGetResponse","kind":"json-schema","title":"WebhookGetResponse","data":{"type":"object","required":["http","webhook_id","webhook_url","webhook_type","webhook_created","webhook_updated","webhook_suspended"],"properties":{"http":{"type":"integer","description":"HTTP status code","example":200},"webhook_id":{"type":"integer","description":"Unique identifier of the webhook","example":152691},"webhook_url":{"type":"string","format":"uri","description":"The URL to which webhook events are sent","example":"https://example.com"},"webhook_type":{"type":"string","description":"Type of event the webhook listens for","enum":["send-envelope","signed-envelope","cancelled-envelope","rejected-envelope","bounced-envelope","add-user","add-contact","opened-envelope","add-template","all","signed-envelope-complete","verify-envelope-widget","signed-envelope-widget","send-envelope-failed"],"example":"all"},"webhook_created":{"type":"string","format":"date-time","description":"Timestamp when the webhook was created","example":"2025-06-23T17:15:01+0000"},"webhook_updated":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Timestamp when the webhook was last updated","example":null},"webhook_suspended":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"Whether the webhook is currently suspended","example":null}}}},"components/schemas/WebhookUpdateRequest":{"id":"components/schemas/WebhookUpdateRequest","kind":"json-schema","title":"WebhookUpdateRequest","data":{"type":"object","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Payload to update a webhook. Provide "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"webhook_url"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"webhook_type"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or both."},"children":[]}]}]}],"properties":{"webhook_url":{"type":"string","format":"uri","description":"The callback URL where webhook events will be sent.","example":"https://example.com"},"webhook_type":{"type":"string","description":"The event type to subscribe to.\n","enum":["send-envelope","signed-envelope","cancelled-envelope","rejected-envelope","bounced-envelope","add-user","add-contact","opened-envelope","add-template","all","signed-envelope-complete","verify-envelope-widget","signed-envelope-widget","send-envelope-failed"],"example":"send-envelope"}},"anyOf":[{"required":["webhook_url"]},{"required":["webhook_type"]}]}},"components/schemas/WebhookPutResponse":{"id":"components/schemas/WebhookPutResponse","kind":"json-schema","title":"WebhookPutResponse","data":{"type":"object","required":["http","message","href","webhook_id","webhook_secret","webhook_url","webhook_type","webhook_updated"],"properties":{"http":{"type":"integer","example":200},"message":{"type":"string","example":"The webhook with ID 152691 has been updated"},"href":{"type":"string","format":"uri","example":"https://api.signable.co.uk/v1/webhooks/152691"},"webhook_id":{"type":"integer","example":152691},"webhook_secret":{"type":"string","description":"Secret used to verify webhook payload signatures.","example":"whsec_example_redacted"},"webhook_url":{"type":"string","format":"uri","example":"https://abby-example.com"},"webhook_type":{"type":"string","enum":["send-envelope","signed-envelope","cancelled-envelope","rejected-envelope","bounced-envelope","add-user","add-contact","opened-envelope","add-template","all","signed-envelope-complete","verify-envelope-widget","signed-envelope-widget","send-envelope-failed"],"example":"all"},"webhook_updated":{"type":"string","format":"date-time","example":"2025-06-24T09:32:55+0000"}}}},"components/schemas/WebhookDeleteResponse":{"id":"components/schemas/WebhookDeleteResponse","kind":"json-schema","title":"WebhookDeleteResponse","data":{"type":"object","required":["http","message","webhook_id","webhook_url","webhook_type"],"properties":{"http":{"type":"integer","description":"HTTP status code","example":200},"message":{"type":"string","description":"Descriptive message confirming the webhook was removed","example":"The webhook (https://abby-example.com) has been removed from your account."},"webhook_id":{"type":"integer","description":"Unique identifier of the deleted webhook","example":152691},"webhook_url":{"type":"string","format":"uri","description":"The URL of the deleted webhook","example":"https://abby-example.com"},"webhook_type":{"type":"string","description":"Type of event the deleted webhook was subscribed to","enum":["send-envelope","signed-envelope","cancelled-envelope","rejected-envelope","bounced-envelope","add-user","add-contact","opened-envelope","add-template","all","signed-envelope-complete","verify-envelope-widget","signed-envelope-widget","send-envelope-failed"],"example":"all"}}}},"components/schemas/BrandingResponse":{"id":"components/schemas/BrandingResponse","kind":"json-schema","title":"BrandingResponse","data":{"type":"object","required":["http","branding_logo","branding_colour"],"properties":{"http":{"type":"integer","description":"HTTP status code","example":200},"branding_logo":{"type":["string","null"],"format":"uri","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A public URL to your uploaded logo (shown on emails and signing pages). Returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if no logo is uploaded."},"children":[]}]}]}],"example":"https://www.signable.co.uk/signable.png"},"branding_colour":{"type":["string","null"],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The primary hex colour used for branding emails and signing pages."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if no branding colour is set."},"children":[]}]}]}],"example":"#0095E6"}}}},"components/schemas/BrandingPutRequest":{"id":"components/schemas/BrandingPutRequest","kind":"json-schema","title":"BrandingPutRequest","data":{"type":"object","properties":{"branding_logo_url":{"type":["string","null"],"format":"uri","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A public URL to your logo. This will be shown on emails and the signing page. Set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to remove the current logo."},"children":[]}]}]}],"example":"https://upload.wikimedia.org/wikipedia/commons/7/70/Example.png"},"branding_colour":{"type":"string","pattern":"^#[0-9A-Fa-f]{6}$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The hex colour code (e.g. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"#0095E6"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") used for branded emails and signing pages."},"children":[]}]}]}],"example":"#558caa"}},"required":["branding_logo_url","branding_colour"]}},"components/schemas/BrandingPutResponse":{"id":"components/schemas/BrandingPutResponse","kind":"json-schema","title":"BrandingPutResponse","data":{"type":"object","required":["http","message","branding_logo","branding_colour"],"properties":{"http":{"type":"integer","description":"HTTP status code","example":200},"message":{"type":"string","description":"A success message confirming the update","example":"Branding options have been updated."},"branding_logo":{"type":["string","null"],"format":"uri","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The final logo URL now active for your account. Will be "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if none is set."},"children":[]}]}]}],"example":"https://assets.signable.co.uk/company-logo/213690-1751360856.png"},"branding_colour":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The hex code now being used for branding emails and signing pages. Will be "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"null"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" if none is set."},"children":[]}]}]}],"example":"#558CAA"}}}},"components/schemas/BrandingEmail":{"id":"components/schemas/BrandingEmail","kind":"json-schema","title":"BrandingEmail","data":{"type":"object","required":["branding_email_type","branding_email_subject","branding_email_content","branding_email_content_plain","branding_email_updated"],"properties":{"branding_email_type":{"type":"string","description":"Type of the branding email template","enum":["email-cancelled","email-rejected","email-reminder","email-reminder-password","email-send","email-send-password","email-signed","email-widget-verify"],"example":"email-cancelled"},"branding_email_subject":{"type":"string","description":"Subject line with variables","example":"{company name} has cancelled a document"},"branding_email_content":{"type":"string","description":"HTML version of the email template","example":"<body style=...>...</body>"},"branding_email_content_plain":{"type":"string","description":"Plain text version of the email","example":"{company name} has cancelled the {contract title} document."},"branding_email_updated":{"type":"string","format":"date-time","description":"Last updated timestamp (ISO 8601)","example":"2025-07-01T08:40:38+0000"}}}},"components/schemas/BrandingEmailsResponse":{"id":"components/schemas/BrandingEmailsResponse","kind":"json-schema","title":"BrandingEmailsResponse","data":{"type":"object","required":["http","branding_emails"],"properties":{"http":{"type":"integer","example":200},"branding_emails":{"type":"array","items":{"$ref":"#/components/schemas/BrandingEmail"}}}}},"components/schemas/BrandingEmailSingleResponse":{"id":"components/schemas/BrandingEmailSingleResponse","kind":"json-schema","title":"BrandingEmailSingleResponse","data":{"allOf":[{"type":"object","required":["http"],"properties":{"http":{"type":"integer","example":200}}},{"$ref":"#/components/schemas/BrandingEmail"}]}},"components/schemas/BrandingEmailPutRequest":{"id":"components/schemas/BrandingEmailPutRequest","kind":"json-schema","title":"BrandingEmailPutRequest","data":{"type":"object","description":"Request to update branding email attributes.","properties":{"branding_email_subject":{"type":"string","description":"The subject line for the email","example":"{company name} has cancelled a test document"},"branding_email_content":{"type":"string","description":"The HTML content of the email","example":"<body style='font-family:Arial;'>...</body>"},"branding_email_content_plain":{"type":"string","description":"The plain text content of the email","example":"Your document from {company name} has been cancelled."}}}},"components/schemas/BrandingEmailPutResponse":{"id":"components/schemas/BrandingEmailPutResponse","kind":"json-schema","title":"BrandingEmailPutResponse","data":{"type":"object","required":["http","message","branding_email_type","branding_email_subject","branding_email_content","branding_email_content_plain","branding_email_updated"],"properties":{"http":{"type":"integer","example":200},"message":{"type":"string","example":"email-cancelled email has been updated."},"branding_email_type":{"type":"string","enum":["email-cancelled","email-rejected","email-reminder","email-reminder-password","email-send","email-send-password","email-signed","email-widget-verify"],"example":null},"branding_email_subject":{"type":"string","example":"{company name} has cancelled a test document"},"branding_email_content":{"type":"string","description":"HTML version of the updated email","example":"<body style=\"font-family:Arial,Helvetica,sans-serif;\">\n...\n</body>\n"},"branding_email_content_plain":{"type":"string","description":"Plain text version of the updated email","example":"A document previously sent...\n"},"branding_email_updated":{"type":"string","format":"date-time","example":"2025-07-02T11:44:32+0000"}}}},"components/schemas/SettingsFields":{"id":"components/schemas/SettingsFields","kind":"json-schema","title":"SettingsFields","data":{"type":"object","description":"Common company settings shared across settings GET and PUT operations.","properties":{"setting_signature_more_info":{"type":"boolean","description":"If enabled, the signature will display the signer name and timestamp under each signature block on the generated Envelope PDF.\n","example":true},"setting_signature_format_default":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Which signature format is offered by default. Accepted values: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"drawn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"typed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"upload"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"typed"},"setting_signature_format_accepted":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Comma-separated list of signature formats your account accepts. Valid values: "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"drawn"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"typed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"upload"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"typed,drawn,upload"},"setting_email_pdf_attach":{"type":"boolean","description":"If enabled, a PDF copy of the envelope will be attached to emails sent to recipients. If disabled, recipients must instead use a link in the email to view and download the envelope.\n","example":true},"setting_email_pdf_attach_sender":{"type":"boolean","description":"If enabled, a PDF copy of the signed envelope will be attached to the sign-complete notification email sent to your company email address. If disabled, the envelope must be downloaded from the app.\n","example":true},"setting_email_envelope_open":{"type":"boolean","description":"If enabled, an email notification will be sent when someone opens the envelope.\n","example":true},"setting_email_main_email":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If enabled, notifications (signed, rejected, cancelled) are sent to your company’s main email address."},"children":[]}]}]}],"example":true},"setting_email_return_address_user":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If enabled, the \"Return Email\" will be set to the user who sent the envelope, rather than the main company email. If disabled, the \"Return Email\" will be set to your main company email address. Regardless of this property, emails will always be sent from document@signable.co.uk."},"children":[]}]}]}],"example":true},"setting_signing_consumer_regulations_act":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Enables "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"http://www.legislation.gov.uk/uksi/2013/3134/pdfs/uksi_20133134_en.pdf"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Consumer Contract Regulations 2013 compliance"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for your account. Only set this to 'Yes' if you believe that you need this enabled. This setting will change some of the terminology on the signing page to become compliant with this Act."},"children":[]}]}]}],"example":false},"setting_signing_tooltips":{"type":"boolean","deprecated":true,"description":"If enabled, tooltip hints will be shown when a signer attempts to sign a document.\n","example":false},"setting_signing_questions":{"type":"boolean","description":"If enabled, signers can send you questions or comments directly from the signing page.\n","example":true},"setting_pdf_audit_trail_hide":{"type":"boolean","description":"If enabled, all party email addresses and mobile numbers will be hidden on the signing page and PDF certificate audit trail.\n","example":true},"setting_all_at_once_default":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If enabled, envelopes are sent to all parties simultaneously by default (all-at-once signing). If disabled, envelopes are sent to the first party only (one-at-a-time signing). Default is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"true"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":true}}}},"components/schemas/SettingsResponse":{"id":"components/schemas/SettingsResponse","kind":"json-schema","title":"SettingsResponse","data":{"allOf":[{"type":"object","properties":{"http":{"type":"integer","example":200}}},{"$ref":"#/components/schemas/SettingsFields"}]}},"components/schemas/UpdateSettingsRequest":{"id":"components/schemas/UpdateSettingsRequest","kind":"json-schema","title":"UpdateSettingsRequest","data":{"allOf":[{"$ref":"#/components/schemas/SettingsFields"}]}},"components/schemas/UpdateSettingsResponse":{"id":"components/schemas/UpdateSettingsResponse","kind":"json-schema","title":"UpdateSettingsResponse","data":{"allOf":[{"type":"object","properties":{"http":{"type":"integer","example":200},"message":{"type":"string","example":"Signable Ltd settings have been updated."},"href":{"type":"string","format":"uri","example":"https://api.signable.co.uk/v1/companies/32275"},"company_id":{"type":"string","example":"32275"},"company_name":{"type":"string","example":"Signable Ltd"}}},{"$ref":"#/components/schemas/SettingsFields"}]}},"schema_37":{"kind":"json-schema","data":{"type":"integer","example":0,"default":0},"id":"schema_37"},"schema_38":{"kind":"json-schema","data":{"type":"integer","minimum":1,"maximum":50,"default":10},"id":"schema_38"},"schema_39":{"kind":"json-schema","data":{"type":"string","example":"196735"},"id":"schema_39"},"schema_40":{"kind":"json-schema","data":{"type":"string","example":"214821"},"id":"schema_40"},"schema_41":{"kind":"json-schema","data":{"type":"integer","enum":[0,1],"example":1},"id":"schema_41"},"schema_42":{"kind":"json-schema","data":{"type":"string","enum":["processing","failed","draft","sent","signed","cancelled","expired","rejected","verify"]},"id":"schema_42"},"schema_43":{"kind":"json-schema","data":{"type":"string"},"id":"schema_43"},"schema_44":{"kind":"json-schema","data":{"oneOf":[{"type":"object","title":"Send Doc Request","required":["envelope_title","envelope_parties","envelope_documents"],"properties":{"envelope_title":{"type":"string","description":"Title of the envelope.","example":"Ashbrook Road 10/06/25"},"user_id":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ID of the user sending the envelope. If omitted, it won’t be linked to a user and email notifications will be sent to the company email address."},"children":[]}]}]}],"example":838180},"envelope_redirect_url":{"type":"string","format":"uri","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Where to redirect the signer after completion. Defaults to Signable’s confirmation page if not provided."},"children":[]}]}]}],"example":"https://www.example.com"},"envelope_all_at_once_enabled":{"type":"boolean","description":"If true, sends to all parties at once. If false, sends sequentially (one-at-a-time).\n","example":false},"envelope_requires_otp":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Enables one-time-password (OTP) signing for all signers. Requires "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"party_mobile"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This field has been deprecated in place of OTP per party,  see envelope_parties[].party_mobile for more information."},"children":[]}]}]}],"example":true,"deprecated":true},"envelope_password_protect":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Enables password protection. System generates a password or use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"party_password"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" per party."},"children":[]}]}]}],"example":false},"envelope_auto_expire_hours":{"type":"integer","minimum":12,"description":"Number of hours before the envelope expires automatically.","example":144},"envelope_auto_remind_hours":{"type":"integer","minimum":12,"description":"Frequency in hours for automatic reminder emails to signers.","example":72},"envelope_meta":{"type":"object","description":"Custom metadata stored alongside the envelope.","additionalProperties":true,"example":{"internal_id":"ABC123","VIP":false}},"envelope_parties":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List of parties involved in the envelope."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Each party can be a signer or a copy recipient."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"envelope_all_at_once_enabled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"false"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", signers will be notified sequentially based on the order they appear in this array."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Copy recipients (with role "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"copy"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") are notified only after all signers have completed their actions."},"children":[]}]}]}],"items":{"type":"object","required":["party_name","party_email","party_role"],"properties":{"party_name":{"type":"string","description":"Full name of the party.","example":"Abby Signers"},"party_email":{"type":"string","format":"email","description":"Email address of the party.","example":"abby@signable.co.uk"},"party_role":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Role tag corresponding to tags in the document, or 'copy' for non-signing parties. Signer tags "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"must"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" start with the string "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"signer"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"signer1"},"party_message":{"type":"string","description":"Optional message included in the email sent to the party.","example":"Please sign as soon as you can."},"party_mobile":{"type":"string","description":"Mobile number in E.164 format. Provide this for a signing party to require one-time-password (OTP) verification for that party. Do not provide this for copy recipients.","example":"+447712345678"},"party_password":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Custom password for accessing the envelope (used only if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"envelope_password_protect"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is true)."},"children":[]}]}]}],"example":"secret123"}}}},"envelope_documents":{"type":"array","description":"List of documents to be sent in the envelope. Each record must either include a URL to the file, or a combination of base64-encoded content and filename.","items":{"oneOf":[{"type":"object","title":"Document URL","required":["document_title","document_url"],"properties":{"document_title":{"type":"string","description":"Title of the document for internal use and audit trail.","example":"Test Agreement"},"document_url":{"type":"string","format":"uri","description":"URL to the hosted document (PDF, Word, or Excel).","example":"https://yellow-della-30.tiiny.site/Tenancy-Contract-2025-v2.pdf"}}},{"type":"object","title":"Base64 file","required":["document_title","document_file_content","document_file_name"],"properties":{"document_title":{"type":"string","description":"Title of the document for internal use and audit trail.","example":"Test Agreement"},"document_file_content":{"type":"string","format":"byte","description":"Base64-encoded file content.","example":"JVBERi0xLjQKJdPr6...Zgo2MDE3MwolJUVPRgo="},"document_file_name":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Filename with extension, only "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":".pdf"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":".docx"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":".xlsx"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are accepted."},"children":[]}]}]}],"example":"contract.pdf"}}}]}}}},{"type":"object","title":"Send Template Request","required":["envelope_title","envelope_parties","envelope_documents"],"properties":{"envelope_title":{"type":"string","description":"Title of the envelope.","example":"Melbourne Road 23/06/25"},"user_id":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ID of the user sending the envelope. If omitted, it won’t be linked to a user and email notifications will be sent to the company email address."},"children":[]}]}]}],"example":819622},"envelope_redirect_url":{"type":"string","format":"uri","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Where to redirect the signer after completion. Defaults to Signable’s confirmation page if not provided."},"children":[]}]}]}],"example":"https://www.example.com"},"envelope_all_at_once_enabled":{"type":"boolean","description":"If true, sends to all parties at once. If false, sends sequentially (one-at-a-time).\n","example":true},"envelope_requires_otp":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Enables one-time-password (OTP) signing for all signers. Requires "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"party_mobile"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This field has been deprecated in place of OTP per party,  see envelope_parties[].party_mobile for more information."},"children":[]}]}]}],"example":true,"deprecated":true},"envelope_password_protect":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Enables password protection. System generates a password or use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"party_password"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" per party."},"children":[]}]}]}],"example":false},"envelope_auto_expire_hours":{"type":"integer","description":"Number of hours until the envelope expires.","example":144},"envelope_auto_remind_hours":{"type":"integer","description":"Frequency in hours to send signer reminders.","example":72},"envelope_meta":{"type":"object","description":"Custom metadata stored alongside the envelope.","additionalProperties":true,"example":{"internal_id":"ABC123","VIP":false}},"envelope_parties":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List of parties involved in the envelope. Each party can be a signer or a copy recipient. If "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"envelope_all_at_once_enabled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"false"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", signers will be notified sequentially based on the order they appear in this array. Copy recipients (with role "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"copy"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") are notified only after all signers have completed their actions."},"children":[]}]}]}],"items":{"type":"object","required":["party_name","party_email","party_role","party_id"],"properties":{"party_name":{"type":"string","example":"Alex Mitchell"},"party_email":{"type":"string","format":"email","example":"abby+alex@signable.co.uk"},"party_id":{"type":"string","description":"ID of the party as defined in the template.","example":"20748256"},"party_role":{"type":"string","enum":["signer","copy"],"description":"Role in the document.","example":"signer"},"party_message":{"type":"string","description":"Optional message included in the email sent to the party.","example":"Hello Alex, Please review and sign."},"party_mobile":{"type":"string","description":"Mobile number in E.164 format. Provide this for a signing party to require one-time-password (OTP) verification for that party. Do not provide this for copy recipients.","example":"+447712345678"},"party_password":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Custom password for accessing the envelope (used only if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"envelope_password_protect"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is true)."},"children":[]}]}]}],"example":"secret123"}}}},"envelope_documents":{"type":"array","items":{"type":"object","required":["document_title","document_template_fingerprint"],"properties":{"document_title":{"type":"string","example":"TC 2025 v2"},"document_template_fingerprint":{"type":"string","description":"Unique identifier of the Signable template to use.","example":"28f9add86f25028df2eee9adee866aba"},"document_merge_fields":{"type":"array","description":"Values to populate merge fields within the template.","items":{"type":"object","required":["field_id","field_value"],"properties":{"field_id":{"type":"string","description":"ID of the merge field as defined in the template.","example":"454958773"},"field_value":{"type":"string","description":"Text value to populate the merge field in the envelope.","example":"Note that breakables are not included in rent cost"}}}}}}}}},{"type":"object","title":"Send Multiple Templates Request","required":["envelope_title","envelope_parties","envelope_documents"],"properties":{"envelope_title":{"type":"string","description":"Title of the envelope.","example":"Barnsley Road 21/04/25"},"user_id":{"type":"integer","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ID of the user sending the envelope. If omitted, it won’t be linked to a user and email notifications will be sent to the company email address."},"children":[]}]}]}],"example":819622},"envelope_redirect_url":{"type":"string","format":"uri","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Where to redirect the signer after completion. Defaults to Signable’s confirmation page if not provided."},"children":[]}]}]}],"example":"https://www.example.com"},"envelope_all_at_once_enabled":{"type":"boolean","description":"If true, sends to all parties at once. If false, sends sequentially (one-at-a-time).\n","example":true},"envelope_requires_otp":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Enables one-time-password (OTP) signing for all signers. Requires "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"party_mobile"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This field has been deprecated in place of OTP per party,  see envelope_parties[].party_mobile for more information."},"children":[]}]}]}],"example":true,"deprecated":true},"envelope_password_protect":{"type":"boolean","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Enables password protection. System generates a password or use "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"party_password"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" per party."},"children":[]}]}]}],"example":false},"envelope_auto_expire_hours":{"type":"integer","description":"Number of hours until the envelope expires.","example":144},"envelope_auto_remind_hours":{"type":"integer","description":"Frequency in hours to send signer reminders.","example":72},"envelope_meta":{"type":"object","description":"Custom metadata stored alongside the envelope.","additionalProperties":true,"example":{"internal_id":"ABC123","VIP":false}},"envelope_parties":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"List of parties involved in the envelope. Each party can be a signer or a copy recipient. If "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"envelope_all_at_once_enabled"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is set to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"false"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", signers will be notified sequentially based on the order they appear in this array. Copy recipients (with role "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"copy"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") are notified only after all signers have completed their actions."},"children":[]}]}]}],"items":{"type":"object","required":["party_name","party_email","party_role","party_documents"],"properties":{"party_name":{"type":"string","example":"Alex Mitchell"},"party_email":{"type":"string","format":"email","example":"abby+alex@signable.co.uk"},"party_documents":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A list of documents that this party is assigned to within the envelope. Signing parties are assigned one or more documents. Copy recipients (with role "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"copy"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") are not assigned documents and must send an empty array."},"children":[]}]}]}],"oneOf":[{"title":"Signing Party","type":"array","minItems":1,"description":"For signing parties, an array of one or more document assignments.\n","items":{"type":"object","required":["party_id","document_template_fingerprint"],"properties":{"party_id":{"type":"string","description":"The unique ID of the party as defined in the associated Signable template. This is used to map the envelope party to their role in a specific document.\n","example":"20748256"},"document_template_fingerprint":{"type":"string","description":"The fingerprint of the document template the party should be assigned to. This allows fine-grained control over which parties are included in which documents when sending from a multi-document template.\n","example":"28f9add86f25028df2eee9adee866aba"}}}},{"title":"Copy Party","type":"array","maxItems":0,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For copy recipients (role "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"copy"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"), an empty array ("},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"[]"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}]}]},"party_role":{"type":"string","enum":["signer","copy"],"description":"Role in the document.","example":"signer"},"party_message":{"type":"string","description":"Optional message included in the email sent to the party.","example":"Hello Alex, Please review and sign."},"party_mobile":{"type":"string","description":"Mobile number in E.164 format. Provide this for a signing party to require one-time-password (OTP) verification for that party. Do not provide this for copy recipients.","example":"+447712345678"},"party_password":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Custom password for accessing the envelope (used only if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"envelope_password_protect"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is true)."},"children":[]}]}]}],"example":"secret123"}}}},"envelope_documents":{"type":"array","items":{"type":"object","required":["document_title","document_template_fingerprint"],"properties":{"document_title":{"type":"string","example":"TC 2025 v2"},"document_template_fingerprint":{"type":"string","description":"Unique identifier of the Signable template to use.","example":"28f9add86f25028df2eee9adee866aba"},"document_merge_fields":{"type":"array","description":"Values to populate merge fields within the template.","items":{"type":"object","required":["field_id","field_value"],"properties":{"field_id":{"type":"string","description":"ID of the merge field as defined in the template.","example":"454958773"},"field_value":{"type":"string","description":"Text value to populate the merge field in the envelope.","example":"Note that breakables are not included in rent cost"}}}}}}}}}]},"id":"schema_44"},"schema_45":{"kind":"json-schema","data":{"type":"string","example":"584ea8b41b0d4c17a96b967433b211e6"},"id":"schema_45"},"schema_46":{"kind":"json-schema","data":{"type":"integer","example":1234567},"id":"schema_46"},"schema_47":{"kind":"json-schema","data":{"type":"string","example":"b786a173554cc06371248caf0b250704"},"id":"schema_47"},"schema_48":{"kind":"json-schema","data":{"type":"string","example":"e0b3a9cbd4a6ff2cb57cfca161a39309"},"id":"schema_48"},"schema_49":{"kind":"json-schema","data":{"type":"integer","example":17224150},"id":"schema_49"},"schema_50":{"kind":"json-schema","data":{"oneOf":[{"$ref":"#/components/schemas/ErrorResponse"},{"$ref":"#/components/schemas/RouteNotFoundResponse"}]},"id":"schema_50"},"schema_51":{"kind":"json-schema","data":{"type":"integer","example":17225983},"id":"schema_51"},"schema_52":{"kind":"json-schema","data":{"type":"integer","example":836499},"id":"schema_52"},"schema_53":{"kind":"json-schema","data":{"type":"integer","example":837154},"id":"schema_53"},"schema_54":{"kind":"json-schema","data":{"type":"object","properties":{"http":{"type":"integer","example":400},"code":{"type":"integer","example":10104},"message":{"type":"string","example":"The user name and email are missing. Please make sure at least one of them is provided."}}},"id":"schema_54"},"schema_55":{"kind":"json-schema","data":{"type":"string","enum":["email-cancelled","email-rejected","email-reminder","email-reminder-password","email-send","email-send-password","email-signed","email-widget-verify"],"example":"email-cancelled"},"id":"schema_55"},"schema_56":{"kind":"json-schema","data":{"type":"integer","example":0},"id":"schema_56"},"schema_57":{"kind":"json-schema","data":{"type":"integer","example":10},"id":"schema_57"},"schema_58":{"kind":"json-schema","data":{"type":"object","properties":{"Location":{"type":"string","format":"uri","description":"The URL of the newly created webhook resource"}}},"id":"schema_58"},"schema_59":{"kind":"json-schema","data":{"type":"integer","example":152691},"id":"schema_59"},"schema_60":{"kind":"json-schema","data":{"type":"object","properties":{"envelope_fingerprint":{"type":"string","description":"A string representing the envelope that was sent","example":"584ea8b41b0d4c17a96b967433b211e6"},"envelope_documents":{"type":"string","description":"A JSON string representing the documents within the envelope","example":"[{\"document_title\":\"Untitled document\",\"document_fingerprint\":\"584ea8b41b0d4c17a96b967433b211e6\",\"document_pdf\":\"https://api.signableapi.com/shareable/document?t=03cbb315-4f68-400d-a5cc-c2884996d061\",\"document_download\":\"https://api.signableapi.com/shareable/document?t=03cbb315-4f68-400d-a5cc-c2884996d061\"}]"},"envelope_download":{"type":"string","format":"uri","description":"A URL to download the envelope contents","example":"https://api.signableapi.com/shareable/envelope?t=03cbb315-4f68-400d-a5cc-c2884996d061"},"contact_id":{"type":"integer","description":"The ID of the contact the envelope was sent to","example":14029945},"contact_name":{"type":"string","description":"The name of the contact the envelope was sent to","example":"Abby Smith"},"contact_email":{"type":"string","format":"email","description":"The email address of the contact the envelope was sent to","example":"abby@signable.co.uk"},"action":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The action taken. Defaults to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"send-envelope"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"send-envelope"},"action_date":{"type":"string","format":"date-time","description":"The UTC timestamp of when the action occurred","example":"2025-06-20T15:50:10+00:00"},"envelope_meta":{"type":"string","description":"A JSON string of any meta information added when sending the envelope","example":""},"envelope_signing_embed":{"type":"string","description":"An iframe URL for embedded signing, if enabled","example":"<iframe src=\"https://sign.signable.app/#2KnUUnVQTxtkpV8rmWqem9qXpvaTU2hYLHHyQD7WtdQ\" width=\"100%\" height=\"95%\" frameborder=\"0\" style=\"border: 0; overflow: hidden\"></iframe>"}},"required":["envelope_fingerprint","envelope_documents","envelope_download","contact_id","contact_name","contact_email","action","action_date"]},"id":"schema_60"},"schema_61":{"kind":"json-schema","data":{"type":"object","properties":{"envelope_fingerprint":{"type":"string","description":"A string of the signed envelope","example":"584ea8b41b0d4c17a96b967433b211e6"},"envelope_documents":{"type":"string","description":"JSON string of the documents within the envelope","example":"[{\"document_title\":\"Make Tests\",\"document_fingerprint\":\"584ea8b41b0d4c17a96b967433b211e6\",\"document_pdf\":\"https://api.signableapi.com/shareable/document?t=03cbb315-4f68-400d-a5cc-c2884996d061\",\"document_download\":\"https://api.signableapi.com/shareable/document?t=03cbb315-4f68-400d-a5cc-c2884996d061\"}]"},"envelope_fields":{"type":"string","description":"JSON string of completed fields in the envelope","example":"[{\"field_id\":458946901,\"field_name\":\"Untitled\",\"field_type\":\"text\",\"field_value\":\"1st Aug\"},{\"field_id\":458946905,\"field_name\":\"Untitled\",\"field_type\":\"text\",\"field_value\":\"hiousfdjp\"}]"},"envelope_download":{"type":"string","format":"uri","description":"URL to download the full signed envelope","example":"https://api.signableapi.com/shareable/envelope?t=03cbb315-4f68-400d-a5cc-c2884996d061"},"contact_id":{"type":"integer","description":"ID of the signer","example":7418454},"contact_name":{"type":"string","description":"Name of the signer","example":"Abby"},"contact_email":{"type":"string","format":"email","description":"Email address of the signer","example":"abby@signable.co.uk"},"company_id":{"type":"integer","description":"ID of the sub-account (company) the envelope belongs to","example":64034},"user_id":{"type":"integer","description":"Internal user ID associated with the signing action","example":267199},"signature_fingerprint":{"type":"string","description":"Unique fingerprint identifying the signature event","example":"584ea8b41b0d4c17a96b967433b211e6"},"client_ip":{"type":"string","format":"ipv4","description":"IP address of the device used to sign","example":"65.179.58.205"},"envelope_meta":{"type":"string","description":"A JSON string of any additional metadata attached to the envelope","example":""},"action":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The action taken. Defaults to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"signed-envelope"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"signed-envelope"},"action_date":{"type":"string","format":"date-time","description":"UTC timestamp of when the signing occurred","example":"2025-08-01T14:37:47+00:00"}},"required":["envelope_fingerprint","envelope_documents","envelope_fields","envelope_download","contact_id","contact_name","contact_email","action","action_date","signature_fingerprint","user_id","client_ip","company_id"]},"id":"schema_61"},"schema_62":{"kind":"json-schema","data":{"type":"object","properties":{"envelope_fingerprint":{"type":"string","description":"A string representing the cancelled envelope","example":"584ea8b41b0d4c17a96b967433b211e6"},"envelope_title":{"type":"string","description":"The title of the cancelled envelope","example":"tagstest - Copy"},"action":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The action taken. Defaults to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"cancelled-envelope"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"cancelled-envelope"},"action_date":{"type":"string","format":"date-time","description":"The UTC timestamp of when the envelope was cancelled","example":"2025-08-06T12:59:03+00:00"},"envelope_meta":{"type":"string","description":"A JSON string of any meta information associated with the envelope","example":""},"company_id":{"type":"integer","description":"The ID of the company linked to the envelope","example":64034},"user_id":{"type":"integer","description":"The ID of the user who cancelled the envelope","example":267199},"client_ip":{"type":"string","format":"ipv4","description":"The IP address of the user or system that triggered the cancellation","example":"203.0.113.42"}},"required":["envelope_fingerprint","envelope_title","action","action_date","company_id","user_id","client_ip"]},"id":"schema_62"},"schema_63":{"kind":"json-schema","data":{"type":"object","properties":{"envelope_fingerprint":{"type":"string","description":"A string identifying the expired envelope","example":"584ea8b41b0d4c17a96b967433b211e6"},"envelope_title":{"type":"string","description":"The title of the expired envelope","example":"tagstest - Copy"},"user_id":{"type":"integer","description":"The ID of the user associated with this event","example":267199},"action":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The action taken. Defaults to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expired-envelope"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"expired-envelope"},"action_date":{"type":"string","format":"date-time","description":"The UTC timestamp of when the envelope expired","example":"2025-08-07T10:14:26+00:00"},"company_id":{"type":"integer","description":"The ID of the company that owns the envelope","example":64034}},"required":["envelope_fingerprint","envelope_title","user_id","action","action_date","company_id"]},"id":"schema_63"},"schema_64":{"kind":"json-schema","data":{"type":"object","properties":{"envelope_fingerprint":{"type":"string","description":"A string representing the signed envelope","example":"584ea8b41b0d4c17a96b967433b211e6"},"envelope_documents":{"type":"string","description":"A JSON string representing the signed documents within the envelope","example":"[{\"document_title\":\"Word Doc\",\"document_fingerprint\":\"584ea8b41b0d4c17a96b967433b211e6\",\"document_pdf\":\"https://api.signableapi.com/shareable/document?t=03cbb315-4f68-400d-a5cc-c2884996d061\",\"document_download\":\"https://api.signableapi.com/shareable/document?t=03cbb315-4f68-400d-a5cc-c2884996d061\"}]"},"envelope_download":{"type":"string","format":"uri","description":"A URL to download the completed envelope","example":"https://api.signableapi.com/shareable/envelope?t=03cbb315-4f68-400d-a5cc-c2884996d061"},"envelope_fields":{"type":"string","description":"A JSON string of captured field values within the envelope","example":"[{\"field_id\":460133805,\"field_name\":\"Untitled\",\"field_type\":\"text\",\"field_value\":\"Test\"}]"},"envelope_meta":{"type":"string","description":"A JSON string of any meta information associated with the envelope","example":""},"action":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The action taken. Defaults to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"signed-envelope-complete"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"signed-envelope-complete"},"action_date":{"type":"string","format":"date-time","description":"The UTC timestamp of when the envelope was fully signed","example":"2025-08-07T10:14:33+00:00"},"company_id":{"type":"integer","description":"The ID of the company associated with the envelope","example":64034},"user_id":{"type":"integer","description":"The ID of the user who sent or owns the envelope","example":267199},"client_ip":{"type":"string","format":"ipv4","description":"The IP address of the client that triggered the completion","example":"203.0.113.17"}},"required":["envelope_fingerprint","envelope_documents","envelope_download","envelope_fields","action","action_date","company_id","user_id","client_ip"]},"id":"schema_64"},"schema_65":{"kind":"json-schema","data":{"type":"object","properties":{"action":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The action taken. Defaults to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rejected-envelope"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"rejected-envelope"},"action_date":{"type":"string","format":"date-time","description":"The UTC timestamp of when the action occurred","example":"2025-08-07T11:10:39+00:00"},"envelope_fingerprint":{"type":"string","description":"A string representing the rejected envelope","example":"584ea8b41b0d4c17a96b967433b211e6"},"document_id":{"type":"integer","description":"The ID of the document that was rejected","example":0},"document_title":{"type":"string","description":"The title of the rejected document","example":"Word Doc"},"contact_id":{"type":"integer","description":"The ID of the contact who rejected the envelope","example":7418454},"contact_name":{"type":"string","description":"The name of the contact who rejected the envelope","example":"Abby"},"contact_email":{"type":"string","format":"email","description":"The email address of the contact who rejected the envelope","example":"abby@signable.co.uk"},"signature_fingerprint":{"type":"string","description":"A fingerprint identifying the signature session that triggered the rejection","example":"584ea8b41b0d4c17a96b967433b211e6"},"envelope_meta":{"type":"string","description":"A JSON string of any meta information added to the envelope","example":""},"client_ip":{"type":"string","format":"ipv4","description":"The IP address from which the rejection was submitted","example":"203.0.113.42"}},"required":["action","action_date","envelope_fingerprint","document_id","document_title","contact_id","contact_name","contact_email","signature_fingerprint","client_ip"]},"id":"schema_65"},"schema_66":{"kind":"json-schema","data":{"type":"object","properties":{"action":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The action taken. Defaults to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"opened-envelope"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"opened-envelope"},"action_date":{"type":"string","format":"date-time","description":"The UTC timestamp of when the envelope was opened","example":"2025-08-07T10:14:26+00:00"},"company_id":{"type":"integer","description":"The ID of the company that owns the envelope","example":64034},"contact_id":{"type":"integer","description":"The ID of the contact who opened the envelope","example":7418454},"contact_name":{"type":"string","description":"The name of the contact who opened the envelope","example":"Abby"},"contact_email":{"type":"string","format":"email","description":"The email address of the contact who opened the envelope","example":"abby@signable.co.uk"},"envelope_fingerprint":{"type":"string","description":"A string identifying the opened envelope","example":"584ea8b41b0d4c17a96b967433b211e6"},"envelope_documents":{"type":"string","description":"A stringified JSON array of documents in the envelope","example":"[{\"document_title\":\"Blank Word Doc\",\"document_fingerprint\":\"584ea8b41b0d4c17a96b967433b211e6\",\"document_pdf\":\"https://api.signableapi.com/shareable/document?t=03cbb315-4f68-400d-a5cc-c2884996d061\",\"document_download\":\"https://api.signableapi.com/shareable/document?t=03cbb315-4f68-400d-a5cc-c2884996d061\"}]"},"envelope_download":{"type":"string","format":"uri","description":"A download link for the entire envelope","example":"https://api.signableapi.com/shareable/envelope?t=03cbb315-4f68-400d-a5cc-c2884996d061"},"envelope_meta":{"type":"string","description":"A JSON string of any meta information added to the envelope","example":""},"user_id":{"type":"integer","description":"The ID of the user associated with this event","example":267199},"client_ip":{"type":"string","format":"ipv4","description":"The IP address from which the envelope was opened","example":"203.0.113.106"}},"required":["action","action_date","company_id","contact_id","contact_name","contact_email","envelope_fingerprint","envelope_documents","envelope_download","user_id","client_ip"]},"id":"schema_66"},"schema_67":{"kind":"json-schema","data":{"type":"object","properties":{"action":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The action taken. Defaults to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"bounced-envelope"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"bounced-envelope"},"action_date":{"type":"string","format":"date-time","description":"The UTC timestamp of when the email bounced","example":"2025-08-07T11:33:03+00:00"},"company_id":{"type":"integer","description":"The ID of the company that owns the envelope","example":64034},"envelope_bounce_email":{"type":"string","format":"email","description":"The email address that bounced","example":"abby@singable.co.uk"},"envelope_bounce_reason":{"type":"string","description":"The reason the email failed to deliver","example":"unable to get mx info: failed to get IPs from PTR record: lookup <nil>: unrecognized address"},"envelope_bounce_url":{"type":"string","format":"uri","description":"A link to view the bounce details","example":"https://app.signable.co.uk/envelope/bounce/584ea8b41b0d4c17a96b967433b211e6/584ea8b41b0d4c17a96b967433b211e6"},"envelope_fingerprint":{"type":"string","description":"A string identifying the bounced envelope","example":"584ea8b41b0d4c17a96b967433b211e6"},"client_ip":{"type":"string","format":"ipv4","description":"The IP address from which the bounce originated","example":"198.51.100.36"}},"required":["action","action_date","company_id","envelope_bounce_email","envelope_bounce_reason","envelope_bounce_url","envelope_fingerprint","client_ip"]},"id":"schema_67"},"schema_68":{"kind":"json-schema","data":{"type":"object","properties":{"action":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The action taken. Defaults to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"send-envelope-failed"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"send-envelope-failed"},"action_date":{"type":"string","format":"date-time","description":"The UTC timestamp of when the action occurred","example":"2026-03-19T12:39:54+00:00"},"envelope_fingerprint":{"type":"string","description":"A string representing the failed envelope","example":"821e2c9cb2203dec82279efabc4c65633"},"envelope_meta":{"type":"string","description":"A JSON string of any meta information added to the envelope","example":""},"client_ip":{"type":"string","format":"ipv4","description":"The IP address from which the failed envelope was submitted","example":"203.0.113.42"}},"required":["action","action_date","envelope_fingerprint","client_ip"]},"id":"schema_68"},"schema_69":{"kind":"json-schema","data":{"type":"object","properties":{"action":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The action taken. Defaults to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"verify-envelope-widget"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"verify-envelope-widget"},"action_date":{"type":"string","format":"date-time","description":"The UTC timestamp of when the envelope was signed","example":"2025-08-07T11:32:54+00:00"},"company_id":{"type":"integer","description":"The ID of the company that owns the envelope","example":64034},"contact_id":{"type":"integer","description":"The ID of the contact who signed the envelope","example":8117397},"contact_name":{"type":"string","description":"The name of the contact who signed the envelope","example":"Abby"},"contact_email":{"type":"string","format":"email","description":"The email address of the contact who signed the envelope","example":"abby@signable.co.uk"},"envelope_fingerprint":{"type":"string","description":"A string identifying the signed envelope","example":"584ea8b41b0d4c17a96b967433b211e6"},"envelope_documents":{"type":"string","description":"A stringified JSON array of documents in the envelope","example":"[{\"document_fingerprint\":\"584ea8b41b0d4c17a96b967433b211e6\",\"document_title\":\"Word Doc\",\"document_download\":\"https://api.signableapi.com/shareable/document?t=03cbb315-4f68-400d-a5cc-c2884996d061\"}]"},"envelope_meta":{"type":"string","description":"A JSON string of any meta information added to the envelope","example":"{\"envelope_title\":\"Word Doc\"}"},"user_id":{"type":"integer","description":"The ID of the user associated with this event","example":0},"client_ip":{"type":"string","format":"ipv4","description":"The IP address from which the envelope was signed","example":"203.0.113.123"}},"required":["action","action_date","company_id","contact_id","contact_name","contact_email","envelope_fingerprint","envelope_documents","user_id","client_ip"]},"id":"schema_69"},"schema_70":{"kind":"json-schema","data":{"type":"object","properties":{"action":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The action taken. Defaults to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"verified-envelope-widget"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"verified-envelope-widget"},"action_date":{"type":"string","format":"date-time","description":"The UTC timestamp of when the envelope was verified","example":"2025-08-07T12:10:48+00:00"},"company_id":{"type":"integer","description":"The ID of the company that owns the envelope","example":64034},"contact_id":{"type":"integer","description":"The ID of the contact who verified the envelope","example":8117397},"contact_name":{"type":"string","description":"The name of the contact who verified the envelope","example":"Abby"},"contact_email":{"type":"string","format":"email","description":"The email address of the contact who verified the envelope","example":"abby@signable.co.uk"},"envelope_fingerprint":{"type":"string","description":"A string identifying the verified envelope","example":"584ea8b41b0d4c17a96b967433b211e6"},"envelope_documents":{"type":"string","description":"A stringified JSON array of documents in the envelope","example":"[{\"document_title\":\"Word Doc\",\"document_fingerprint\":\"584ea8b41b0d4c17a96b967433b211e6\",\"document_pdf\":\"https://api.signableapi.com/shareable/document?t=03cbb315-4f68-400d-a5cc-c2884996d061\",\"document_download\":\"https://api.signableapi.com/shareable/document?t=03cbb315-4f68-400d-a5cc-c2884996d061\"}]"},"envelope_download":{"type":"string","format":"uri","description":"A download link for the entire envelope","example":"https://api.signableapi.com/shareable/envelope?t=03cbb315-4f68-400d-a5cc-c2884996d061"},"envelope_fields":{"type":"string","description":"A stringified JSON array of fields completed during verification","example":"[{\"field_id\":460176431,\"field_name\":\"Untitled\",\"field_type\":\"text\",\"field_value\":\"Abby\"}]"},"envelope_meta":{"type":"string","description":"A JSON string of any meta information added to the envelope","example":"{\"envelope_title\":\"Word Doc\"}"},"signature_fingerprint":{"type":"string","description":"A string identifying the verification applied","example":"584ea8b41b0d4c17a96b967433b211e6"},"client_ip":{"type":"string","format":"ipv4","description":"The IP address from which the envelope was verified","example":"203.0.113.124"}},"required":["action","action_date","company_id","contact_id","contact_name","contact_email","envelope_fingerprint","envelope_documents","envelope_download","signature_fingerprint","client_ip"]},"id":"schema_70"},"schema_71":{"kind":"json-schema","data":{"type":"object","properties":{"action":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The action taken. Defaults to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"add-template"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"add-template"},"action_date":{"type":"string","format":"date-time","description":"The UTC timestamp of when the template was added","example":"2025-08-07T12:36:56+00:00"},"company_id":{"type":"integer","description":"The ID of the company that added the template","example":64034},"template_fingerprint":{"type":"string","description":"A string identifying the newly added template","example":"584ea8b41b0d4c17a96b967433b211e6"},"template_title":{"type":"string","description":"The title of the added template","example":"Signable Contract"},"template_page_total":{"type":"integer","description":"The number of pages in the template","example":5},"template_pages":{"type":"array","description":"An array of page metadata (if available)","items":{"type":"object"}},"template_thumbnails":{"type":"array","description":"An array of thumbnail URLs (if available)","items":{"type":"string","format":"uri"}},"client_ip":{"type":"string","format":"ipv4","description":"The IP address from which the template was added","example":"203.0.113.150"}},"required":["action","action_date","company_id","template_fingerprint","template_title","template_page_total","template_pages","template_thumbnails","client_ip"]},"id":"schema_71"},"schema_72":{"kind":"json-schema","data":{"type":"object","properties":{"action":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The action taken. Defaults to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"add-contact"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"add-contact"},"action_date":{"type":"string","format":"date-time","description":"The UTC timestamp of when the contact was added","example":"2025-08-07T12:41:52+00:00"},"company_id":{"type":"integer","description":"The ID of the company that added the contact","example":64034},"contact_id":{"type":"integer","description":"The ID of the newly added contact","example":17499057},"contact_name":{"type":"string","description":"The name of the contact","example":"Abby"},"contact_email":{"type":"string","format":"email","description":"The email address of the contact","example":"abby@signable.co.uk"},"client_ip":{"type":"string","format":"ipv4","description":"The IP address from which the contact was added","example":"203.0.113.150"}},"required":["action","action_date","company_id","contact_id","contact_name","contact_email","client_ip"]},"id":"schema_72"},"schema_73":{"kind":"json-schema","data":{"type":"object","properties":{"action":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The action taken. Defaults to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"add-user"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"example":"add-user"},"action_date":{"type":"string","format":"date-time","description":"The UTC timestamp of when the user was added","example":"2025-08-07T13:03:39+00:00"},"company_id":{"type":"integer","description":"The ID of the company the user was added to","example":215769},"user_id":{"type":"integer","description":"The ID of the new user","example":840786},"user_name":{"type":"string","description":"The name of the new user","example":"Abby"},"user_email":{"type":"string","format":"email","description":"The email address of the new user","example":"abby@signable.co.uk"},"role":{"type":"string","description":"The assigned role of the new user","example":"user"},"client_ip":{"type":"string","format":"ipv4","description":"The IP address from which the user was added","example":"203.0.113.150"}},"required":["action","action_date","company_id","user_id","user_name","user_email","role","client_ip"]},"id":"schema_73"}},"exampleStore":{"components/examples/CompanyListResponseExample":{"id":"components/examples/CompanyListResponseExample","value":{"http":200,"offset":0,"limit":10,"total_companies":"2","companies":[{"company_id":"196735","company_name":"ExampleSubAccount_1","company_email":"abby+1@signable.co.uk","company_api_key":"9c66b129752046***********","company_created":"2024-09-03T09:03:12+0000"},{"company_id":"196737","company_name":"ExampleSubAccount_2","company_email":"abby+2@signable.co.uk","company_api_key":"1v64g56ds98577***********","company_created":"2024-09-03T09:08:49+0000"}]},"summary":"An example paginated list of sub-accounts."},"components/examples/CompanyCreateRequestExample":{"id":"components/examples/CompanyCreateRequestExample","value":{"company_name":"Example Inc","user_name":"Abby Signs","user_email":"abby@example.com"},"summary":"Example create sub-account request"},"components/examples/CompanyCreateResponseExample":{"id":"components/examples/CompanyCreateResponseExample","value":{"http":200,"message":"Example Inc has been added as a company","href":"https://api.signable.co.uk/v1/companies/214821","company_id":"214821","company_name":"Example Inc","company_email":"abby@example.com","api_key":"9c66b129752046***********","user_id":"838931","user_name":"Abby Signs","user_email":"abby@example.com","user_href":"https://api.signable.co.uk/v1/users/838931","company_added":"2025-07-21T08:16:51+0000"},"summary":"Example response for successfully creating a sub-account"},"components/examples/CompanyGetResponseExample":{"id":"components/examples/CompanyGetResponseExample","value":{"http":200,"company_id":196735,"company_name":"ExampleSubAccount_1","company_email":"abby+1@signable.co.uk","company_api_key":"9c66b129752046***********","company_created":"2024-09-03T09:03:12+0000","company_usage":[{"month":"July","year":"2025","sent":"1"}]},"summary":"An example paginated list of a single sub-account."},"components/examples/CompanyUpdateRequestExample":{"id":"components/examples/CompanyUpdateRequestExample","value":{"company_name":"Apple Tree Ltd","company_email":"abby@appletree.com"},"summary":"Example update sub-account request"},"components/examples/CompanyUpdateResponseExample":{"id":"components/examples/CompanyUpdateResponseExample","value":{"http":200,"message":"Apple Tree Ltd has been updated.","href":"https://api.signable.co.uk/v1/company/214821","company_id":214821,"company_name":"Apple Tree Ltd","company_email":"abby@appletree.com","company_updated":"2025-07-21T08:30:27+0000"},"summary":"Example response for updating a sub-account"},"components/examples/CompanyDeleteResponseExample":{"id":"components/examples/CompanyDeleteResponseExample","value":{"http":200,"message":"Apple Tree Ltd has been removed.","company_id":214821,"company_name":"Apple Tree Ltd","company_email":"abby@appletree.com"},"summary":"Example response for successful deletion"},"components/examples/PartnerUsageResponseExample":{"id":"components/examples/PartnerUsageResponseExample","value":{"http":200,"offset":0,"limit":10,"total_companies":"2","current_start_date":"2025-07-01T00:00:00+0000","current_end_date":"2025-08-01T00:00:00+0000","previous_start_date":"2025-06-01T00:00:00+0000","previous_end_date":"2025-07-01T00:00:00+0000","companies":[{"company_id":"196735","company_name":"ExampleSubAccount_1","current_usage":"1","previous_usage":"0","company_created":"2024-09-03T09:03:12+0000"},{"company_id":"196737","company_name":"ExampleSubAccount_2","current_usage":"6","previous_usage":"15","company_created":"2024-09-03T09:08:49+0000"}]},"summary":"Example usage data across 2 sub-accounts"},"components/examples/EnvelopeListResponseExample":{"id":"components/examples/EnvelopeListResponseExample","value":{"http":200,"offset":0,"limit":10,"total_envelopes":"3","envelopes":[{"envelope_fingerprint":"584ea8b41b0d4c17a96b967433b211e6","envelope_title":"Another Test","envelope_status":"draft","envelope_redirect_url":"","envelope_created":"2025-07-07T11:30:27+0000","envelope_sent":null,"envelope_processed":null,"envelope_all_at_once_enabled":true,"envelope_requires_otp":false,"envelope_parties":[{"party_id":"45583378","party_title":"Abby Test","party_mobile_last4":null,"party_password":null}]},{"envelope_fingerprint":"84b6334b5e5249a78e7ae3f4bba33068","envelope_title":"2nd Test","envelope_status":"signed","envelope_redirect_url":"","envelope_created":"2025-07-07T11:27:44+0000","envelope_sent":"2025-07-07T11:29:31+0000","envelope_processed":"2025-07-07T11:30:09+0000","envelope_all_at_once_enabled":true,"envelope_requires_otp":false,"envelope_parties":[{"party_id":"45583236","party_title":"Abby Test","party_mobile_last4":null,"party_password":null}],"envelope_signed_pdf":"https://api.signableapi.com/shareable/envelope?t=03cbb315-4f68-400d-a5cc-c2884996d061"},{"envelope_fingerprint":"2a965d809ca943fb98ca71d3c7c98af5","envelope_title":"Test Envelope","envelope_status":"signed","envelope_redirect_url":"","envelope_created":"2025-07-07T10:30:02+0000","envelope_sent":"2025-07-07T11:26:20+0000","envelope_processed":"2025-07-07T11:27:20+0000","envelope_all_at_once_enabled":true,"envelope_requires_otp":false,"envelope_parties":[{"party_id":"45583038","party_title":"Jane Doe","party_mobile_last4":null,"party_password":null}],"envelope_signed_pdf":"https://api.signableapi.com/shareable/envelope?t=1ea41464-40ae-4638-b004-5ca1c8143318"}]},"summary":"An example paginated list of envelopes"},"components/examples/EnvelopeSendDocRequestExample":{"id":"components/examples/EnvelopeSendDocRequestExample","value":{"envelope_title":"Singer Road 23/06/25","user_id":838180,"envelope_redirect_url":"https://www.example.com","envelope_all_at_once_enabled":false,"envelope_password_protect":false,"envelope_auto_expire_hours":144,"envelope_auto_remind_hours":72,"envelope_meta":{"internal_id":"ABC123","VIP":false},"envelope_parties":[{"party_name":"Alex Mitchell","party_email":"abby+alex@signable.co.uk","party_role":"signer2","party_message":"Hello Alex, Please review and sign","party_mobile":"+447712345678"},{"party_name":"Abby Signers","party_email":"abby@signable.co.uk","party_role":"signer1","party_message":"Hello, Please sign pronto!","party_mobile":"+447712345678"},{"party_name":"Spectator","party_email":"abby+spectator@signable.co.uk","party_role":"copy","party_message":"Hello Alex, Please have a read"},{"party_name":"Tim Matthews","party_email":"abby@signable.co.uk","party_role":"signer3","party_message":"Hello, Please sign pronto!","party_mobile":"+447712345678"}],"envelope_documents":[{"document_url":"https://yellow-della-30.tiiny.site/Tenancy-Contract-2025-v2.pdf","document_title":"Test Agreement"},{"document_title":"Validation Contract","document_file_name":"ValidationContract.pdf","document_file_content":"JVBERi0xLjQKJdPr6...Zgo2MDE3MwolJUVPRgo="}]},"summary":"Example send envelope (using document) request"},"components/examples/EnvelopeSendTemplateRequestExample":{"id":"components/examples/EnvelopeSendTemplateRequestExample","value":{"envelope_title":"Melbourne Road 23/06/25","user_id":819622,"envelope_redirect_url":"https://www.example.com","envelope_all_at_once_enabled":true,"envelope_password_protect":false,"envelope_auto_expire_hours":144,"envelope_auto_remind_hours":72,"envelope_meta":{"internal_id":"ABC123","VIP":false},"envelope_parties":[{"party_name":"Alex Mitchell","party_email":"abby+alex@signable.co.uk","party_id":"20748256","party_role":"signer","party_message":"Hello Alex, Please review and sign","party_mobile":"+447712345678"},{"party_name":"Abby Signers","party_email":"abby@signable.co.uk","party_id":"20748255","party_role":"signer","party_message":"Hello, Please sign pronto!","party_mobile":"+447712345678"},{"party_name":"Spectator","party_email":"abby+spectator@signable.co.uk","party_id":"20750393","party_role":"copy","party_message":"Hello Maisy, Please have a read"}],"envelope_documents":[{"document_title":"TC 2025 v2","document_template_fingerprint":"28f9add86f25028df2eee9adee866aba","document_merge_fields":[{"field_id":"454958773","field_value":"Note that breakables are not included in rent cost"}]}]},"summary":"Example send envelope (using single template) request"},"components/examples/EnvelopeSendTemplateMultipleRequestExample":{"id":"components/examples/EnvelopeSendTemplateMultipleRequestExample","value":{"envelope_title":"Barnsley Road 21/04/25","user_id":819622,"envelope_redirect_url":"https://www.example.com","envelope_all_at_once_enabled":true,"envelope_password_protect":false,"envelope_auto_expire_hours":144,"envelope_auto_remind_hours":72,"envelope_meta":{"internal_id":"ABC123","VIP":false},"envelope_parties":[{"party_name":"Alex Mitchell","party_email":"abby+alex@signable.co.uk","party_role":"signer","party_message":"Hello Alex, Please review and sign","party_mobile":"+447712345678","party_documents":[{"party_id":"20748256","document_template_fingerprint":"28f9add86f25028df2eee9adee866aba"}]},{"party_name":"Abby Signers","party_email":"abby@signable.co.uk","party_role":"signer","party_message":"Hello, Please sign pronto!","party_mobile":"+447712345678","party_documents":[{"party_id":"20748265","document_template_fingerprint":"88d2c9e8dc4a69ce1cd97ac1684f3e45"},{"party_id":"20748255","document_template_fingerprint":"28f9add86f25028df2eee9adee866aba"}]},{"party_name":"Spectator","party_email":"abby+spectator@signable.co.uk","party_role":"copy","party_message":"Hello Maisy, Please have a read","party_documents":[]}],"envelope_documents":[{"document_title":"TC 2025 v2","document_template_fingerprint":"28f9add86f25028df2eee9adee866aba","document_merge_fields":[{"field_id":"454958773","field_value":"Note that breakables are not included in rent cost"}]},{"document_title":"TC 2025 v3","document_template_fingerprint":"88d2c9e8dc4a69ce1cd97ac1684f3e45"}]},"summary":"Example send envelope (using multiple templates) successful response"},"components/examples/EnvelopeSendDocResponseExample":{"id":"components/examples/EnvelopeSendDocResponseExample","value":{"http":202,"message":"Your envelope with title Singer Road 23/06/25 will be processed and sent out.","href":"https://api.signable.co.uk/v1/envelopes/584ea8b41b0d4c17a96b967433b211e6","envelope_title":"Singer Road 23/06/25","envelope_fingerprint":"584ea8b41b0d4c17a96b967433b211e6","envelope_password_protect":false,"envelope_requires_otp":true,"envelope_redirect_url":"https://www.example.com","envelope_queued":"2025-07-16T14:39:02+0000","envelope_all_at_once_enabled":false,"envelope_parties":[{"party_id":"45849370","party_title":"Alex Mitchell","party_mobile_last4":"5678","party_password":null},{"party_id":"45849371","party_title":"Abby Signers","party_mobile_last4":"5678","party_password":null},{"party_id":"45849372","party_title":"Spectator","party_mobile_last4":null,"party_password":null},{"party_id":"45849373","party_title":"Tim Matthews","party_mobile_last4":"5678","party_password":null}]},"summary":"Example send envelope (using document) successful response"},"components/examples/EnvelopeSendTemplateResponseExample":{"id":"components/examples/EnvelopeSendTemplateResponseExample","value":{"http":202,"message":"Your envelope with title Melbourne Road 23/06/25 will be processed and sent out.","href":"https://api.signable.co.uk/v1/envelopes/584ea8b41b0d4c17a96b967433b211e6","envelope_title":"Melbourne Road 23/06/25","envelope_fingerprint":"584ea8b41b0d4c17a96b967433b211e6","envelope_signing_embed":"<iframe src=\"https://sign.signable.app/#yXqPrm7HVOaiQUNM4NZI34BocfDWB69lf68lHq90R0s\" width=\"100%\" height=\"95%\" frameborder=\"0\" style=\"border: 0; overflow: hidden\"></iframe>","envelope_password_protect":false,"envelope_redirect_url":"https://www.example.com","envelope_queued":"2025-07-16T16:30:23+0000","envelope_all_at_once_enabled":true,"envelope_requires_otp":true,"envelope_parties":[{"party_id":"45855081","party_title":"Alex Mitchell","party_mobile_last4":"5678","party_password":null},{"party_id":"45855082","party_title":"Abby Signers","party_mobile_last4":"5678","party_password":null},{"party_id":"45855083","party_title":"Spectator","party_mobile_last4":null,"party_password":null}]},"summary":"Example send envelope (using single template) successful response"},"components/examples/EnvelopeSendTemplateMultipleResponseExample":{"id":"components/examples/EnvelopeSendTemplateMultipleResponseExample","value":{"http":202,"message":"Your envelope with title Barnsley Road 21/04/25 will be processed and sent out.","href":"https://api.signable.co.uk/v1/envelopes/584ea8b41b0d4c17a96b967433b211e6","envelope_title":"Barnsley Road 21/04/25","envelope_fingerprint":"584ea8b41b0d4c17a96b967433b211e6","envelope_signing_embed":"<iframe src=\"https://sign.signable.app/#kVXVoBHVOBwh8ijT56DXYhSIjTIcrNsyD6OyDAKdWMZ\" width=\"100%\" height=\"95%\" frameborder=\"0\" style=\"border: 0; overflow: hidden\"></iframe>\n","envelope_password_protect":false,"envelope_redirect_url":"https://www.example.com","envelope_queued":"2025-07-17T13:42:35+0000","envelope_all_at_once_enabled":true,"envelope_requires_otp":true,"envelope_parties":[{"party_id":"45880606","party_title":"Alex Mitchell","party_mobile_last4":"5678","party_password":null},{"party_id":"45880607","party_title":"Abby Signers","party_mobile_last4":"5678","party_password":null},{"party_id":"45880608","party_title":"Spectator","party_mobile_last4":null,"party_password":null}]},"summary":"Example send envelope (using multiple templates) successful response"},"components/examples/EnvelopeGetResponseExample":{"id":"components/examples/EnvelopeGetResponseExample","value":{"http":200,"envelope_fingerprint":"584ea8b41b0d4c17a96b967433b211e6","envelope_title":"17 John Street Tenancy Contract - 25th Jun 2025","envelope_status":"sent","envelope_redirect_url":null,"envelope_created":"2025-07-08T14:58:54+0000","envelope_sent":"2025-07-08T15:02:49+0000","envelope_processed":null,"envelope_all_at_once_enabled":true,"envelope_requires_otp":false,"envelope_parties":[{"party_id":"45631119","party_title":"Abby Signable","party_mobile_last4":null,"party_password":"Test123","contact_id":"17225983","contact_email":"abby@signable.co.uk","party_status":"in progress","party_signature_type":"remote","party_role":"signer"},{"party_id":"45631121","party_title":"Sabby","party_mobile_last4":null,"party_password":null,"contact_id":"17241370","contact_email":"abby+010725@signable.co.uk","party_status":"in progress","party_signature_type":"remote","party_role":"signer"},{"party_id":"45631122","party_title":"Bristol Solicitors","party_mobile_last4":null,"party_password":null,"contact_id":"17241371","contact_email":"test@example.com","party_status":"pending","party_signature_type":"remote","party_role":"copy"}],"envelope_documents":[{"document_fingerprint":"78c54190abc34179919e6c2197465926","document_title":"Sample Tenancy Contract","document_page_total":"2","document_pdf_url":"https://docs.signable.co.uk/original/78c54190abc34179919e6c2197465926.pdf","document_thumbnails":["https://docs.signable.co.uk/small/78c54190abc34179919e6c2197465926-0.jpg","https://docs.signable.co.uk/small/78c54190abc34179919e6c2197465926-1.jpg"],"document_pages":["https://docs.signable.co.uk/large/78c54190abc34179919e6c2197465926-0.jpg","https://docs.signable.co.uk/large/78c54190abc34179919e6c2197465926-1.jpg"],"document_fields":[{"field_id":"452902787","field_title":"First Name","field_type":"text","field_value":"Abby Sackson","party_id":"45631119","field_merge":"Sender Name"},{"field_id":"452902789","field_title":"Date please","field_type":"date","field_value":"","party_id":"45631119","field_merge":null},{"field_id":"452902790","field_title":"Passport Copy","field_type":"upload","field_value":"https://api.signable.co.uk/download/field/N2I5YmZhMGU0NDAzMGFmMGFhZTZiYmVmODRmYWMxOTA6NTGvATg5MjE1?expires=1779373241&signature=a569a4b52ef1e3c2d47bf9d0c0de2642fc86da851ad936cb2aa090e568b8b102","party_id":"45631119","field_merge":null}],"document_signed_pdf":"https://api.signableapi.com/shareable/document?t=03cbb315-4f68-400d-a5cc-c2884996d061"},{"document_fingerprint":"2cbd40997bc64c1c9b700d80471723b9","document_title":"Sample Contract","document_page_total":"1","document_pdf_url":"https://docs.signable.co.uk/original/2cbd40997bc64c1c9b700d80471723b9.pdf","document_thumbnails":["https://docs.signable.co.uk/small/2cbd40997bc64c1c9b700d80471723b9-0.jpg"],"document_pages":["https://docs.signable.co.uk/large/2cbd40997bc64c1c9b700d80471723b9-0.jpg"],"document_fields":[{"field_id":"452902797","field_title":"Print Name","field_type":"text","field_value":"","party_id":"45631119","field_merge":null},{"field_id":"452902798","field_title":"Full Address","field_type":"text","field_value":"","party_id":"45631119","field_merge":null}]}],"envelope_history":[{"history_detail":"Envelope generated by Abby Loves Signable","history_ip":"147.147.97.34","history_user_agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0 Safari/537.36","history_date":"2025-07-08T14:58:54+0000"},{"history_detail":"Document generated with fingerprint 78c54190abc34179919e6c2197465926","history_ip":"147.147.97.34","history_user_agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0 Safari/537.36","history_date":"2025-07-08T14:58:55+0000"},{"history_detail":"Document generated with fingerprint 2cbd40997bc64c1c9b700d80471723b9","history_ip":"147.147.97.34","history_user_agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0 Safari/537.36","history_date":"2025-07-08T14:58:55+0000"},{"history_detail":"Sent the envelope to Abby Signable (abby@signable.co.uk) for signing","history_ip":"147.147.97.34","history_user_agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0 Safari/537.36","history_date":"2025-07-08T15:02:48+0000"},{"history_detail":"Sent the envelope to Sabby (abby+010725@signable.co.uk) for signing","history_ip":"147.147.97.34","history_user_agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0 Safari/537.36","history_date":"2025-07-08T15:02:49+0000"},{"history_detail":"Document emailed to abby@signable.co.uk","history_ip":"","history_user_agent":"","history_date":"2025-07-08T15:02:49+0000"},{"history_detail":"Document emailed to abby+010725@signable.co.uk","history_ip":"","history_user_agent":"","history_date":"2025-07-08T15:02:49+0000"},{"history_detail":"Abby Signable opened the document email.","history_ip":"66.249.93.102","history_user_agent":"Mozilla/5.0 (Windows NT 5.1; rv:11.0) Gecko Firefox/11.0 (via ggpht.com GoogleImageProxy)","history_date":"2025-07-09T08:37:19+0000"},{"history_detail":"Sabby opened the document email.","history_ip":"66.249.93.98","history_user_agent":"Mozilla/5.0 (Windows NT 5.1; rv:11.0) Gecko Firefox/11.0 (via ggpht.com GoogleImageProxy)","history_date":"2025-07-09T08:37:19+0000"},{"history_detail":"Sent Abby Signable a reminder to sign the document.","history_ip":"","history_user_agent":"","history_date":"2025-07-13T15:03:15+0000"},{"history_detail":"Sent Sabby a reminder to sign the document.","history_ip":"","history_user_agent":"","history_date":"2025-07-13T15:03:15+0000"},{"history_detail":"Document emailed to abby@signable.co.uk","history_ip":"","history_user_agent":"","history_date":"2025-07-13T15:03:15+0000"},{"history_detail":"Document emailed to abby+010725@signable.co.uk","history_ip":"","history_user_agent":"","history_date":"2025-07-13T15:03:15+0000"}],"envelope_meta":{"internal_id":"ABC123","VIP":false}},"summary":"Example envelope details response"},"components/examples/EnvelopeDeleteResponseExample":{"id":"components/examples/EnvelopeDeleteResponseExample","value":{"http":200,"message":"The envelope has been deleted","envelope_fingerprint":"584ea8b41b0d4c17a96b967433b211e6","envelope_title":"Test Envelope","envelope_status":"deleted"},"summary":"Envelope deleted successfully"},"components/examples/EnvelopeRemindResponseExample":{"id":"components/examples/EnvelopeRemindResponseExample","value":{"http":200,"message":"The signing parties for this envelope have been reminded.","envelope_fingerprint":"584ea8b41b0d4c17a96b967433b211e6","envelope_title":"17 John Street Tenancy Contract - 25th Jun 2025","envelope_all_at_once_enabled":true},"summary":"Reminder email triggered"},"components/examples/EnvelopeCancelResponseExample":{"id":"components/examples/EnvelopeCancelResponseExample","value":{"http":200,"message":"The envelope has been cancelled","envelope_fingerprint":"584ea8b41b0d4c17a96b967433b211e6","envelope_title":"Contract Settlement","envelope_status":"cancelled","envelope_processed":"2025-07-14T13:34:34+0000"},"summary":"Envelope cancelled successfully"},"components/examples/EnvelopeExpireResponseExample":{"id":"components/examples/EnvelopeExpireResponseExample","value":{"http":200,"message":"The envelope has been expired","envelope_fingerprint":"584ea8b41b0d4c17a96b967433b211e6","envelope_title":"Industrial Contract","envelope_status":"expired","envelope_processed":"2025-07-14T14:37:34+0000"},"summary":"Envelope expired successfully"},"components/examples/EnvelopePartyUpdateRequestExample":{"id":"components/examples/EnvelopePartyUpdateRequestExample","value":{"party_email":"abby+updated@signable.co.uk","party_title":"Abby"},"summary":"Update party email and title"},"components/examples/EnvelopePartyUpdateResponseExample":{"id":"components/examples/EnvelopePartyUpdateResponseExample","value":{"http":200,"party_id":1234567,"party_title":"Abby","party_email":"abby+updated@signable.co.uk","party_role":"signer"},"summary":"Successful party update response"},"components/examples/TemplatesListResponseExample":{"id":"components/examples/TemplatesListResponseExample","value":{"http":200,"offset":0,"limit":10,"total_templates":"2","templates":[{"template_id":"53890528","template_fingerprint":"e0b3a9cbd4a6ff2cb57cfca161a38309","template_title":"Sample Tenancy Contract","template_page_total":"2","template_in_progress":"0","template_parties_total":"1","template_widget_url":"https://sign.signable.app/#/widget/YzVsBQ5Dyj","template_widget_embed":"<iframe src='https://sign.signable.app/#/widget/YzVsBQ5Dyj' frameborder='0' style='border:0;width:100%;height:100vh;' scrolling='yes'></iframe>","template_pdf_url":"https://docs.signable.co.uk/original/e0b3a9cbd4a6ff2cb57cfca161a38309.pdf","template_thumbnails":["https://docs.signable.co.uk/small/e0b3a9cbd4a6ff2cb57cfca161a38309-0.jpg","https://docs.signable.co.uk/small/e0b3a9cbd4a6ff2cb57cfca161a38309-1.jpg"],"template_pages":["https://docs.signable.co.uk/large/e0b3a9cbd4a6ff2cb57cfca161a38309-0.jpg","https://docs.signable.co.uk/large/e0b3a9cbd4a6ff2cb57cfca161a38309-1.jpg"],"template_uploaded":"2025-07-07T15:49:43+0000","template_parties":[{"party_id":"20576938","party_name":"Signer 1"}]},{"template_id":"53690003","template_fingerprint":"b786a173554cc06371248caf0b250704","template_title":"Sample Contract","template_page_total":"1","template_in_progress":"3","template_parties_total":"1","template_widget_url":"https://sign.signable.app/#/widget/","template_widget_embed":"<iframe src='https://sign.signable.app/#/widget/' frameborder='0' style='border:0;width:100%;height:100vh;' scrolling='yes'></iframe>","template_pdf_url":"https://docs.signable.co.uk/original/b786a173554cc06371248caf0b250704.pdf","template_thumbnails":["https://docs.signable.co.uk/small/b786a173554cc06371248caf0b250704-0.jpg"],"template_pages":["https://docs.signable.co.uk/large/b786a173554cc06371248caf0b250704-0.jpg"],"template_uploaded":"2025-07-01T08:40:38+0000","template_parties":[{"party_id":"20459705","party_name":"Party","party_merge_fields":[{"field_id":"450927743","field_merge":"Name of Sender","field_type":"text"}]}]}]},"summary":"Example template list response"},"components/examples/TemplateGetResponseExample":{"id":"components/examples/TemplateGetResponseExample","value":{"http":200,"template_id":"53690003","template_fingerprint":"b786a173554cc06371248caf0b250704","template_title":"Sample Contract","template_page_total":"1","template_in_progress":"3","template_parties_total":"1","template_widget_url":"https://sign.signable.app/#/widget/YzVsBQ5Dyj","template_widget_embed":"<iframe src='https://sign.signable.app/#/widget/YzVsBQ5Dyj' frameborder='0' style='border:0;width:100%;height:100vh;' scrolling='yes'></iframe>","template_pdf_url":"https://docs.signable.co.uk/original/b786a173554cc06371248caf0b250704.pdf","template_thumbnails":["https://docs.signable.co.uk/small/b786a173554cc06371248caf0b250704-0.jpg"],"template_pages":["https://docs.signable.co.uk/large/b786a173554cc06371248caf0b250704-0.jpg"],"template_uploaded":"2025-07-01T08:40:38+0000","template_parties":[{"party_id":"20459705","party_name":"Party","party_merge_fields":[{"field_id":"450927743","field_merge":"Name of Sender","field_type":"text"}]}]},"summary":"Example template details response"},"components/examples/TemplateDeleteResponseExample":{"id":"components/examples/TemplateDeleteResponseExample","value":{"http":200,"message":"Sample Tenancy Contract has been removed from your template list.","template_id":"53890528","tempate_fingerprint":"e0b3a9cbd4a6ff2cb57cfca161a38309","tempate_title":"Sample Tenancy Contract"},"summary":"Example template deletion confirmation"},"components/examples/ContactsListResponseExample":{"id":"components/examples/ContactsListResponseExample","value":{"http":200,"offset":0,"limit":50,"total_contacts":"100","next":"https://api.signable.co.uk/v1/contacts?offset=50&limit=50","contacts":[{"contact_id":"17224073","contact_name":"Buffy The Vampire Slayer","contact_email":"buffy@sunnydale.com","contact_outstanding_documents":"0","contact_created":"2025-07-07T09:54:08+0000"},{"contact_id":"17224050","contact_name":"Jane Doe","contact_email":"jane@example.com","contact_outstanding_documents":"0","contact_created":"2025-07-07T09:52:54+0000"},{"contact_id":"17224044","contact_name":"Jo Bloggs","contact_email":"jo@example.com","contact_outstanding_documents":"0","contact_created":"2025-07-07T09:52:32+0000"}]},"summary":"Paginated list of contacts"},"components/examples/ContactCreateRequestExample":{"id":"components/examples/ContactCreateRequestExample","value":{"contact_name":"Hanz Zimmer","contact_email":"hanz.zimmer@music.com"},"summary":"Example create contact request"},"components/examples/ContactCreateResponseExample":{"id":"components/examples/ContactCreateResponseExample","value":{"http":200,"message":"Hanz Zimmer has been added to your contact list.","href":"https://api.signable.co.uk/v1/contacts/17224150","contact_id":"17224150","contact_name":"Hanz Zimmer","contact_email":"hanz.zimmer@music.com","contact_created":"2025-07-07T09:57:39+0000"},"summary":"Example create contact response"},"components/examples/ContactGetResponseExample":{"id":"components/examples/ContactGetResponseExample","value":{"http":200,"contact_id":17224150,"contact_name":"Hanz Zimmer","contact_email":"hanz.zimmer@music.com","contact_outstanding_documents":"0","contact_created":"2025-07-07T09:57:39+0000"},"summary":"Example get contact response"},"components/examples/ContactUpdateRequestExample":{"id":"components/examples/ContactUpdateRequestExample","value":{"contact_name":"Nemo","contact_email":"nemo@coralreef.com"},"summary":"Example update contact request"},"components/examples/ContactUpdateResponseExample":{"id":"components/examples/ContactUpdateResponseExample","value":{"http":200,"message":"Nemo has been updated in your contact list.","href":"https://api.signable.co.uk/v1/contacts/17224150","contact_id":17224150,"contact_name":"Nemo","contact_email":"nemo@coralreef.com","contact_updated":"2025-07-07T09:59:25+0000"},"summary":"Example update contact response"},"components/examples/ContactDeleteResponseExample":{"id":"components/examples/ContactDeleteResponseExample","value":{"http":200,"message":"Nemo has been removed from your contact list.","contact_id":17224150,"contact_name":"Nemo","contact_email":"nemo@coralreef.com"},"summary":"Example delete contact response"},"components/examples/ContactEnvelopesListResponseExample":{"id":"components/examples/ContactEnvelopesListResponseExample","value":{"http":200,"offset":0,"limit":10,"total_envelopes":"3","envelopes":[{"envelope_fingerprint":"584ea8b41b0d4c17a96b967433b211e6","envelope_title":"Another Test","envelope_status":"draft","envelope_created":"2025-07-07T11:30:27+0000","envelope_sent":null,"envelope_processed":null},{"envelope_fingerprint":"584ea8b41b0d4c17a96b967433b211e6","envelope_title":"2nd Test","envelope_status":"signed","envelope_created":"2025-07-07T11:27:44+0000","envelope_sent":"2025-07-07T11:29:31+0000","envelope_processed":"2025-07-07T11:30:09+0000","envelope_signed_pdf":"https://api.signableapi.com/shareable/envelope?t=403cebcc-60ec-4cc2-b7d6-753fb7d5c632"},{"envelope_fingerprint":"584ea8b41b0d4c17a96b967433b211e6","envelope_title":"Test Envelope","envelope_status":"signed","envelope_created":"2025-07-07T10:30:02+0000","envelope_sent":"2025-07-07T11:26:20+0000","envelope_processed":"2025-07-07T11:27:20+0000","envelope_signed_pdf":"https://api.signableapi.com/shareable/envelope?t=3dd2069d-4a61-4c9e-99c8-9dfc737eb150"}]},"summary":"Envelopes associated with a contact"},"components/examples/UsersListResponseExample":{"id":"components/examples/UsersListResponseExample","value":{"http":200,"offset":0,"limit":50,"total_users":"2","users":[{"user_id":"836499","role_id":"3","user_name":"Abby Loves Signable","user_email":"abby+010725@signable.co.uk","user_added":"2025-07-01T08:40:38+0000","user_last_updated":"2025-07-07T07:57:54+0000"},{"user_id":"837142","role_id":"1","user_name":"Sabby","user_email":"abby+sabby@signable.co.uk","user_added":"2025-07-07T07:58:38+0000","user_last_updated":"2025-07-07T07:58:44+0000"}]},"summary":"Paginated user list"},"components/examples/UserCreateRequestExample":{"id":"components/examples/UserCreateRequestExample","value":{"user_name":"Abby Example","user_email":"abby+example@wearedom.com","role_id":"2"},"summary":"Example user creation request"},"components/examples/UserCreateResponseExample":{"id":"components/examples/UserCreateResponseExample","value":{"http":200,"message":"Abby Example has been added to your user list.","href":"https://api.signable.co.uk/v1/users/837146","user_id":"837146","role_id":"2","user_name":"Abby Example","user_email":"abby+example@wearedom.com","user_added":"2025-07-07T08:06:49+0000"},"summary":"Example successful user creation response"},"components/examples/UserGetResponseExample":{"id":"components/examples/UserGetResponseExample","value":{"http":200,"user_id":836499,"role_id":"3","user_name":"Abby Loves Signable","user_email":"abby+010725@signable.co.uk","user_added":"2025-07-01T08:40:38+0000","user_last_updated":"2025-07-07T07:57:54+0000"},"summary":"Single user response"},"components/examples/UserUpdateRequestUserNameOnlyExample":{"id":"components/examples/UserUpdateRequestUserNameOnlyExample","value":{"user_name":"Abby Smith"},"summary":"Update a user name only"},"components/examples/UserUpdateRequestUserEmailOnlyExample":{"id":"components/examples/UserUpdateRequestUserEmailOnlyExample","value":{"user_email":"abby+jackson@signable.co.uk"},"summary":"Update a user email only"},"components/examples/UserUpdateRequestNameAndEmailExample":{"id":"components/examples/UserUpdateRequestNameAndEmailExample","value":{"user_name":"Abby Smith","user_email":"abby+jackson@signable.co.uk"},"summary":"Update a user name and email"},"components/examples/UserUpdateRequestExample":{"id":"components/examples/UserUpdateRequestExample","value":{"user_name":"Abby Smith","user_email":"abby+jackson@signable.co.uk","role_id":"1"},"summary":"Update user details"},"components/examples/UserUpdateResponseExample":{"id":"components/examples/UserUpdateResponseExample","value":{"http":200,"message":"Abby Smith has been updated in your user list.","href":"https://api.signable.co.uk/v1/users/837154","user_id":837154,"role_id":"1","user_name":"Abby Smith","user_email":"abby+jackson@signable.co.uk","user_updated":"2025-07-07T08:38:54+0000"},"summary":"Successful user update"},"components/examples/UserUpdateRoleOnlyErrorExample":{"id":"components/examples/UserUpdateRoleOnlyErrorExample","value":{"http":400,"code":10104,"message":"The user name and email are missing. Please make sure at least one of them is provided."},"summary":"Role-only update request is rejected"},"components/examples/UserDeleteResponseExample":{"id":"components/examples/UserDeleteResponseExample","value":{"http":200,"message":"Abby Smith has been removed from your user list.","user_id":837154,"role_id":"1","user_email":"abby+jackson@signable.co.uk","user_name":"Abby Smith"},"summary":"User deletion confirmation"},"components/examples/WebhookListResponseExample":{"id":"components/examples/WebhookListResponseExample","value":{"http":200,"offset":10,"limit":10,"total_webhooks":"44","next":"https://api.signable.co.uk/v1/webhooks?offset=10&limit=10","webhooks":[{"webhook_id":"132223","webhook_url":"https://mylovelyendpointfortesting.free.beeceptor.com","webhook_type":"all","webhook_created":"2019-01-29T18:22:05+0000","webhook_suspended":"2024-07-11T12:21:12+0000","webhook_updated":"2024-07-11T12:21:12+0000"},{"webhook_id":"133097","webhook_url":"https://webhook.site/e9f2c61c-98ec-4277-bef8-cf6bca506583","webhook_type":"send-envelope","webhook_created":"2019-07-29T14:20:40+0000","webhook_suspended":"2024-07-11T12:10:22+0000","webhook_updated":"2024-07-11T12:10:22+0000"},{"webhook_id":"133203","webhook_url":"https://webhook.site/1b225ac0-703d-4d91-ab35-751034157ace","webhook_type":"cancelled-envelope","webhook_created":"2019-08-22T08:38:35+0000","webhook_suspended":"2024-07-17T08:48:02+0000","webhook_updated":"2024-07-17T08:48:02+0000"}]},"summary":"Paginated list of webhooks"},"components/examples/WebhookRequestExample":{"id":"components/examples/WebhookRequestExample","value":{"webhook_url":"https://example.com/webhook","webhook_type":"send-envelope"},"summary":"Example of a webhook request payload"},"components/examples/WebhookPostResponseExample":{"id":"components/examples/WebhookPostResponseExample","value":{"http":200,"message":"The webhook (https://example.com) has been created","href":"https://api.signable.co.uk/v1/webhooks/152691","webhook_id":"152691","webhook_url":"https://example.com","webhook_type":"all","webhook_created":"2025-06-23T17:15:01+0000"},"summary":"Example response after creating a webhook"},"components/examples/WebhookGetResponseExample":{"id":"components/examples/WebhookGetResponseExample","value":{"http":200,"webhook_id":152691,"webhook_url":"https://example.com","webhook_type":"all","webhook_created":"2025-06-23T17:15:01+0000","webhook_updated":null,"webhook_suspended":null},"summary":"Example of a single webhook fetched by ID"},"components/examples/WebhookUpdateRequestUrlOnlyExample":{"id":"components/examples/WebhookUpdateRequestUrlOnlyExample","value":{"webhook_url":"https://example.com/updated-webhook"},"summary":"Example of updating only the webhook URL"},"components/examples/WebhookUpdateRequestTypeOnlyExample":{"id":"components/examples/WebhookUpdateRequestTypeOnlyExample","value":{"webhook_type":"signed-envelope"},"summary":"Example of updating only the webhook type"},"components/examples/WebhookUpdateRequestBothExample":{"id":"components/examples/WebhookUpdateRequestBothExample","value":{"webhook_url":"https://example.com/updated-webhook","webhook_type":"signed-envelope"},"summary":"Example of updating both the webhook URL and webhook type"},"components/examples/WebhookPutResponseExample":{"id":"components/examples/WebhookPutResponseExample","value":{"http":200,"message":"The webhook with ID 152691 has been updated","href":"https://api.signable.co.uk/v1/webhooks/152691","webhook_id":152691,"webhook_secret":"whsec_example_redacted","webhook_url":"https://abby-example.com","webhook_type":"all","webhook_updated":"2025-06-24T09:32:55+0000"},"summary":"Example response from updating a webhook"},"components/examples/WebhookDeleteResponseExample":{"id":"components/examples/WebhookDeleteResponseExample","value":{"http":200,"message":"The webhook (https://abby-example.com) has been removed from your account.","webhook_id":152691,"webhook_url":"https://abby-example.com","webhook_type":"all"},"summary":"Example response after deleting a webhook"},"components/examples/BrandingResponseExample":{"id":"components/examples/BrandingResponseExample","value":{"http":200,"branding_logo":"https://www.signable.co.uk/signable.png","branding_colour":"#0095E6"},"summary":"Example branding configuration"},"components/examples/BrandingPutRequestExample":{"id":"components/examples/BrandingPutRequestExample","value":{"branding_logo_url":"https://upload.wikimedia.org/wikipedia/commons/7/70/Example.png","branding_colour":"#558caa"},"summary":"Example branding update request"},"components/examples/BrandingPutResponseExample":{"id":"components/examples/BrandingPutResponseExample","value":{"http":200,"message":"Branding options have been updated.","branding_logo":"https://assets.signable.co.uk/company-logo/213690-1751360856.png","branding_colour":"#558CAA"},"summary":"Branding successfully updated"},"components/examples/BrandingEmailsResponseExample":{"id":"components/examples/BrandingEmailsResponseExample","value":{"http":200,"branding_emails":[{"branding_email_type":"email-cancelled","branding_email_subject":"{company name} has cancelled a document","branding_email_content":"<body style=\"font-family:Arial,Helvetica,sans-serif;\">\n<table style=\"background:#FFF;font-family:Arial,Helvetica,sans-serif;border-collpase:collapse;width:600px;margin:0 auto;\">\n  <tr>\n    <td>\n      <table style=\"border-collpase:collapse\">\n        <tr>\n          <td style=\"padding:15px 10px 10px\">\n            <a href=\"https://www.signable.co.uk\">\n              <img src=\"{company logo}\" alt=\"{company name}\" />\n            </a>\n          </td>\n        </tr>\n        <tr>\n          <td style=\"padding-top:10px\">\n            <h1 style=\"font-size:15px;\">A document previously sent to you has been cancelled</h1>\n            <p><strong>{company name}</strong> has cancelled the <strong>{contract title}</strong> document.</p>\n            <p>Kind regards, <a href=\"https://www.signable.co.uk\">Signable</a></p>\n          </td>\n        </tr>\n      </table>\n    </td>\n  </tr>\n</table>\n</body>\n","branding_email_content_plain":"A document previously sent to you has been cancelled\n\n{company name} has cancelled the {contract title} document.\n\nKind regards,\nSignable\n\nhttps://www.signable.co.uk\n","branding_email_updated":"2025-07-01T08:40:38+0000"},{"branding_email_type":"email-rejected","branding_email_subject":"{contract title} document rejected","branding_email_content":"<html>...</html>","branding_email_content_plain":"A document you signed has been rejected...","branding_email_updated":"2025-07-01T08:40:38+0000"},{"branding_email_type":"email-reminder","branding_email_subject":"{company name} has sent you a document to sign","branding_email_content":"<body>...</body>","branding_email_content_plain":"{company name} has sent you the document {contract title} to sign online...","branding_email_updated":"2025-07-01T08:40:38+0000"},{"branding_email_type":"email-reminder-password","branding_email_subject":"{company name} has sent you a document to sign","branding_email_content":"<body>...</body>","branding_email_content_plain":"{company name} has also requested this document be password protected...","branding_email_updated":"2025-07-01T08:40:38+0000"},{"branding_email_type":"email-send","branding_email_subject":"{company name} has sent you a document to sign","branding_email_content":"<body>...</body>","branding_email_content_plain":"{client name}, you have been sent a document to sign...","branding_email_updated":"2025-07-01T08:40:38+0000"},{"branding_email_type":"email-send-password","branding_email_subject":"{company name} has sent you a document to sign","branding_email_content":"<body>...</body>","branding_email_content_plain":"{client name}, you've been sent a secure document...","branding_email_updated":"2025-07-01T08:40:38+0000"},{"branding_email_type":"email-signed","branding_email_subject":"Document signed confirmation","branding_email_content":"<body>...</body>","branding_email_content_plain":"You have successfully signed {contract title}...","branding_email_updated":"2025-07-01T08:40:38+0000"},{"branding_email_type":"email-widget-verify","branding_email_subject":"Verify your signed document with {company name}","branding_email_content":"<body>...</body>","branding_email_content_plain":"Please verify your email address to complete signing of {contract title}...","branding_email_updated":"2025-07-01T08:40:38+0000"}]},"summary":"Example branding emails response"},"components/examples/BrandingEmailSingleResponseExample":{"id":"components/examples/BrandingEmailSingleResponseExample","value":{"http":200,"branding_email_type":"email-cancelled","branding_email_subject":"{company name} has cancelled a document","branding_email_content":"<body style=\"font-family:Arial,Helvetica,sans-serif;\">\n<table style=\"background:#FFF;font-family:Arial,Helvetica,sans-serif;border-collpase:collapse;width:600px;margin:0 auto;\">\n  <tr>\n    <td>\n      <table style=\"border-collpase:collapse\">\n        <tr>\n          <td style=\"padding:15px 10px 10px\">\n            <a href=\"https://www.signable.co.uk\">\n              <img src=\"{company logo}\" alt=\"{company name}\" />\n            </a>\n          </td>\n        </tr>\n        <tr>\n          <td style=\"padding-top:10px\">\n            <h1 style=\"font-size:15px;\">A document previously sent to you has been cancelled</h1>\n            <p><strong>{company name}</strong> has cancelled the <strong>{contract title}</strong> document.</p>\n            <p>Kind regards, <a href=\"https://www.signable.co.uk\">Signable</a></p>\n          </td>\n        </tr>\n      </table>\n    </td>\n  </tr>\n</table>\n</body>\n","branding_email_content_plain":"A document previously sent to you has been cancelled\n\n{company name} has cancelled the {contract title} document.\n\nKind regards,\nSignable\n\nhttps://www.signable.co.uk\n","branding_email_updated":"2025-07-01T08:40:38+0000"},"summary":"Example single branding email response"},"components/examples/BrandingEmailPutRequestExample":{"id":"components/examples/BrandingEmailPutRequestExample","value":{"branding_email_subject":"{company name} has cancelled a test document","branding_email_content":"<body style=\"font-family:Arial,Helvetica,serif;\">\n<table style=\"background:#FFF;font-family:Arial,Helvetica,sans-serif;border-collpase:collapse;width:600px;margin:0 auto;\">\n    <tr>\n        <td>\n            <table style=\"border-collpase:collapse\">\n                <tr>\n                    <td style=\"padding:15px 10px 10px\">\n                        <a href=\"https://www.signable.co.uk\" style=\"font-size:25px;color:#FFF;letter-spacing:-1px;font-weight:normal\">\n                            <img src=\"{company logo}\" alt=\"{company name}\" style=\"border:0;\" />\n                        </a>\n                    </td>\n                </tr>\n                <tr>\n                    <td style=\"padding-top:10px\">\n                        <h1 style=\"font-size:15px;font-weight:normal;color:#444\">A document previously sent to you has been cancelled</h1>\n                        <p style=\"font-size:13px;color:#444;line-height:18px;padding-top:10px\">\n                          <span style=\"font-weight:bold;\">{company name}</span> has cancelled the <span style=\"font-weight:bold;\">{contract title}</span> document.\n                        </p>\n                        <p style=\"font-size:15px;color:#555;margin-top:30px\">\n                          Kind regards, <a href=\"https://www.signable.co.uk\" style=\"color:#555;\">Signable</a>\n                        </p>\n                        <hr style=\"background:#FFF;color:#FFF;border:none;height:0;border-bottom:1px dotted #CCC;\" />\n                    </td>\n                </tr>\n            </table>\n        </td>\n    </tr>\n</table>\n</body>\n","branding_email_content_plain":"A test document previously sent to you has been cancelled\r\n\r\n{company name} has cancelled the {contract title} document.\r\n\r\nKind regards,\r\nSignable\r\n\r\nhttps://www.signable.co.uk"},"summary":"Update branding email"},"components/examples/BrandingEmailPutResponseExample":{"id":"components/examples/BrandingEmailPutResponseExample","value":{"http":200,"message":"email-cancelled email has been updated.","branding_email_type":"email-cancelled","branding_email_subject":"{company name} has cancelled a test document","branding_email_content":"<body style=\"font-family:Arial,Helvetica,serif;\">\n<table style=\"background:#FFF;font-family:Arial,Helvetica,sans-serif;border-collpase:collapse;width:600px;margin:0 auto;\">\n    <tr>\n        <td>\n          <table style=\"border-collpase:collapse\">\n              <tr>\n                  <td style=\"padding:15px 10px 10px\">\n                      <a href=\"https://www.signable.co.uk\">\n                          <img src=\"{company logo}\" alt=\"{company name}\" />\n                      </a>\n                  </td>\n              </tr>\n              <tr>\n                  <td style=\"padding-top:10px\">\n                      <h1 style=\"font-size:15px;color:#444;\">A document previously sent to you has been cancelled</h1>\n                      <p style=\"font-size:13px;color:#444;line-height:18px;padding-top:10px\">\n                          <strong>{company name}</strong> has cancelled the <strong>{contract title}</strong> document.\n                      </p>\n                      <p style=\"font-size:15px;color:#555;margin-top:30px\">Kind regards, <a href=\"https://www.signable.co.uk\" style=\"color:#555;\">Signable</a></p>\n                      <hr style=\"background:#FFF;color:#FFF;border:none;height:0;border-bottom:1px dotted #CCC;\" />\n                  </td>\n              </tr>\n          </table>\n        </td>\n    </tr>\n</table>\n</body>\n","branding_email_content_plain":"A test document previously sent to you has been cancelled\r\n\r\n{company name} has cancelled the {contract title} document.\r\n\r\nKind regards,\r\nSignable\r\n\r\nhttps://www.signable.co.uk","branding_email_updated":"2025-07-02T11:44:32+0000"},"summary":"Updated branding email response"},"components/examples/SettingsResponseExample":{"id":"components/examples/SettingsResponseExample","value":{"http":200,"setting_signature_more_info":true,"setting_signature_format_accepted":"typed,drawn,upload","setting_signature_format_default":"typed","setting_email_pdf_attach":true,"setting_email_pdf_attach_sender":true,"setting_email_envelope_open":true,"setting_email_main_email":true,"setting_email_return_address_user":true,"setting_signing_consumer_regulations_act":false,"setting_signing_tooltips":false,"setting_signing_questions":true,"setting_pdf_audit_trail_hide":true,"setting_all_at_once_default":false},"summary":"Example company settings response"},"components/examples/SettingsPutRequestExample":{"id":"components/examples/SettingsPutRequestExample","value":{"setting_signature_more_info":true,"setting_signature_format_accepted":"typed,drawn,upload","setting_signature_format_default":"typed","setting_email_pdf_attach":true,"setting_email_pdf_attach_sender":true,"setting_email_envelope_open":true,"setting_email_main_email":true,"setting_email_return_address_user":true,"setting_signing_consumer_regulations_act":false,"setting_signing_tooltips":false,"setting_signing_questions":true,"setting_pdf_audit_trail_hide":true,"setting_all_at_once_default":false},"summary":"Example of an update company settings request payload"},"components/examples/SettingsPutResponseExample":{"id":"components/examples/SettingsPutResponseExample","value":{"http":200,"message":"Signable Ltd settings have been updated.","href":"https://api.signable.co.uk/v1/companies/32275","company_id":"32275","company_name":"Signable Ltd","setting_signature_more_info":true,"setting_signature_format_accepted":"typed,drawn,upload","setting_signature_format_default":"typed","setting_email_pdf_attach":true,"setting_email_pdf_attach_sender":true,"setting_email_envelope_open":true,"setting_email_main_email":true,"setting_email_return_address_user":true,"setting_signing_consumer_regulations_act":false,"setting_signing_tooltips":true,"setting_signing_questions":false,"setting_pdf_audit_trail_hide":true,"setting_all_at_once_default":false},"summary":"A successful update of company settings"},"paths/~1companies/get/responses/200/content/application~1json/examples/success":{"value":{"http":200,"offset":0,"limit":10,"total_companies":"2","companies":[{"company_id":"196735","company_name":"ExampleSubAccount_1","company_email":"abby+1@signable.co.uk","company_api_key":"9c66b129752046***********","company_created":"2024-09-03T09:03:12+0000"},{"company_id":"196737","company_name":"ExampleSubAccount_2","company_email":"abby+2@signable.co.uk","company_api_key":"1v64g56ds98577***********","company_created":"2024-09-03T09:08:49+0000"}]},"key":"success","summary":"An example paginated list of sub-accounts.","id":"paths/~1companies/get/responses/200/content/application~1json/examples/success"},"paths/~1companies/get/responses/401/content/application~1json/examples/invalidAuth":{"value":{"http":401,"code":10002,"message":"Authentication failed. Please enter the correct API Key and password."},"key":"invalidAuth","summary":"Invalid authentication","id":"paths/~1companies/get/responses/401/content/application~1json/examples/invalidAuth"},"paths/~1companies/post/requestBody/content/application~1json/examples/success":{"value":{"company_name":"Example Inc","user_name":"Abby Signs","user_email":"abby@example.com"},"key":"success","summary":"Example create sub-account request","id":"paths/~1companies/post/requestBody/content/application~1json/examples/success"},"paths/~1companies/post/responses/200/content/application~1json/examples/success":{"value":{"http":200,"message":"Example Inc has been added as a company","href":"https://api.signable.co.uk/v1/companies/214821","company_id":"214821","company_name":"Example Inc","company_email":"abby@example.com","api_key":"9c66b129752046***********","user_id":"838931","user_name":"Abby Signs","user_email":"abby@example.com","user_href":"https://api.signable.co.uk/v1/users/838931","company_added":"2025-07-21T08:16:51+0000"},"key":"success","summary":"Example response for successfully creating a sub-account","id":"paths/~1companies/post/responses/200/content/application~1json/examples/success"},"paths/~1companies/post/responses/400/content/application~1json/examples/missingCompanyName":{"value":{"http":400,"code":10350,"message":"The company name is missing. To be able to create a new company, you must provide a name."},"key":"missingCompanyName","summary":"Missing company_name","id":"paths/~1companies/post/responses/400/content/application~1json/examples/missingCompanyName"},"paths/~1companies/post/responses/400/content/application~1json/examples/missingUserEmail":{"value":{"http":400,"code":10351,"message":"The user email is missing. To be able to create a new company, you must provide a user email."},"key":"missingUserEmail","summary":"Missing user_email","id":"paths/~1companies/post/responses/400/content/application~1json/examples/missingUserEmail"},"paths/~1companies/post/responses/400/content/application~1json/examples/missingUserName":{"value":{"http":400,"code":10352,"message":"The user name is missing. To be able to create a new company, you must provide a user name."},"key":"missingUserName","summary":"Missing user_name","id":"paths/~1companies/post/responses/400/content/application~1json/examples/missingUserName"},"paths/~1companies/post/responses/400/content/application~1json/examples/duplicateUserEmail":{"value":{"http":400,"code":10353,"message":"The user email already exists, please use another."},"key":"duplicateUserEmail","summary":"Duplicate user_email","id":"paths/~1companies/post/responses/400/content/application~1json/examples/duplicateUserEmail"},"paths/~1companies/post/responses/401/content/application~1json/examples/invalidAuth":{"value":{"http":401,"code":10002,"message":"Authentication failed. Please enter the correct API Key and password."},"key":"invalidAuth","summary":"Invalid authentication","id":"paths/~1companies/post/responses/401/content/application~1json/examples/invalidAuth"},"paths/~1companies~1{company_id}/get/responses/200/content/application~1json/examples/success":{"value":{"http":200,"company_id":196735,"company_name":"ExampleSubAccount_1","company_email":"abby+1@signable.co.uk","company_api_key":"9c66b129752046***********","company_created":"2024-09-03T09:03:12+0000","company_usage":[{"month":"July","year":"2025","sent":"1"}]},"key":"success","summary":"An example paginated list of a single sub-account.","id":"paths/~1companies~1{company_id}/get/responses/200/content/application~1json/examples/success"},"paths/~1companies~1{company_id}/get/responses/401/content/application~1json/examples/invalidAuth":{"value":{"http":401,"code":10002,"message":"Authentication failed. Please enter the correct API Key and password."},"key":"invalidAuth","summary":"Invalid authentication","id":"paths/~1companies~1{company_id}/get/responses/401/content/application~1json/examples/invalidAuth"},"paths/~1companies~1{company_id}/put/requestBody/content/application~1json/examples/success":{"value":{"company_name":"Apple Tree Ltd","company_email":"abby@appletree.com"},"key":"success","summary":"Example update sub-account request","id":"paths/~1companies~1{company_id}/put/requestBody/content/application~1json/examples/success"},"paths/~1companies~1{company_id}/put/responses/200/content/application~1json/examples/success":{"value":{"http":200,"message":"Apple Tree Ltd has been updated.","href":"https://api.signable.co.uk/v1/company/214821","company_id":214821,"company_name":"Apple Tree Ltd","company_email":"abby@appletree.com","company_updated":"2025-07-21T08:30:27+0000"},"key":"success","summary":"Example response for updating a sub-account","id":"paths/~1companies~1{company_id}/put/responses/200/content/application~1json/examples/success"},"paths/~1companies~1{company_id}/put/responses/401/content/application~1json/examples/invalidAuth":{"value":{"http":401,"code":10002,"message":"Authentication failed. Please enter the correct API Key and password."},"key":"invalidAuth","summary":"Invalid authentication","id":"paths/~1companies~1{company_id}/put/responses/401/content/application~1json/examples/invalidAuth"},"paths/~1companies~1{company_id}/put/responses/404/content/application~1json/examples/companyNotFound":{"value":{"http":404,"code":10355,"message":"The company ID you have provided doesn't exist under your account."},"key":"companyNotFound","summary":"Company does not exist under Partner account","id":"paths/~1companies~1{company_id}/put/responses/404/content/application~1json/examples/companyNotFound"},"paths/~1companies~1{company_id}/delete/responses/200/content/application~1json/examples/success":{"value":{"http":200,"message":"Apple Tree Ltd has been removed.","company_id":214821,"company_name":"Apple Tree Ltd","company_email":"abby@appletree.com"},"key":"success","summary":"Example response for successful deletion","id":"paths/~1companies~1{company_id}/delete/responses/200/content/application~1json/examples/success"},"paths/~1companies~1{company_id}/delete/responses/401/content/application~1json/examples/invalidAuth":{"value":{"http":401,"code":10002,"message":"Authentication failed. Please enter the correct API Key and password."},"key":"invalidAuth","summary":"Invalid authentication","id":"paths/~1companies~1{company_id}/delete/responses/401/content/application~1json/examples/invalidAuth"},"paths/~1companies~1{company_id}/delete/responses/404/content/application~1json/examples/companyNotFound":{"value":{"http":404,"code":10355,"message":"The company ID you have provided doesn't exist under your account."},"key":"companyNotFound","summary":"Company does not exist under Partner account","id":"paths/~1companies~1{company_id}/delete/responses/404/content/application~1json/examples/companyNotFound"},"paths/~1usage/get/responses/200/content/application~1json/examples/success":{"value":{"http":200,"offset":0,"limit":10,"total_companies":"2","current_start_date":"2025-07-01T00:00:00+0000","current_end_date":"2025-08-01T00:00:00+0000","previous_start_date":"2025-06-01T00:00:00+0000","previous_end_date":"2025-07-01T00:00:00+0000","companies":[{"company_id":"196735","company_name":"ExampleSubAccount_1","current_usage":"1","previous_usage":"0","company_created":"2024-09-03T09:03:12+0000"},{"company_id":"196737","company_name":"ExampleSubAccount_2","current_usage":"6","previous_usage":"15","company_created":"2024-09-03T09:08:49+0000"}]},"key":"success","summary":"Example usage data across 2 sub-accounts","id":"paths/~1usage/get/responses/200/content/application~1json/examples/success"},"paths/~1usage/get/responses/401/content/application~1json/examples/invalidAuth":{"value":{"http":401,"code":10002,"message":"Authentication failed. Please enter the correct API Key and password."},"key":"invalidAuth","summary":"Invalid authentication","id":"paths/~1usage/get/responses/401/content/application~1json/examples/invalidAuth"},"paths/~1envelopes/get/responses/200/content/application~1json/examples/envelopeList":{"value":{"http":200,"offset":0,"limit":10,"total_envelopes":"3","envelopes":[{"envelope_fingerprint":"584ea8b41b0d4c17a96b967433b211e6","envelope_title":"Another Test","envelope_status":"draft","envelope_redirect_url":"","envelope_created":"2025-07-07T11:30:27+0000","envelope_sent":null,"envelope_processed":null,"envelope_all_at_once_enabled":true,"envelope_requires_otp":false,"envelope_parties":[{"party_id":"45583378","party_title":"Abby Test","party_mobile_last4":null,"party_password":null}]},{"envelope_fingerprint":"84b6334b5e5249a78e7ae3f4bba33068","envelope_title":"2nd Test","envelope_status":"signed","envelope_redirect_url":"","envelope_created":"2025-07-07T11:27:44+0000","envelope_sent":"2025-07-07T11:29:31+0000","envelope_processed":"2025-07-07T11:30:09+0000","envelope_all_at_once_enabled":true,"envelope_requires_otp":false,"envelope_parties":[{"party_id":"45583236","party_title":"Abby Test","party_mobile_last4":null,"party_password":null}],"envelope_signed_pdf":"https://api.signableapi.com/shareable/envelope?t=03cbb315-4f68-400d-a5cc-c2884996d061"},{"envelope_fingerprint":"2a965d809ca943fb98ca71d3c7c98af5","envelope_title":"Test Envelope","envelope_status":"signed","envelope_redirect_url":"","envelope_created":"2025-07-07T10:30:02+0000","envelope_sent":"2025-07-07T11:26:20+0000","envelope_processed":"2025-07-07T11:27:20+0000","envelope_all_at_once_enabled":true,"envelope_requires_otp":false,"envelope_parties":[{"party_id":"45583038","party_title":"Jane Doe","party_mobile_last4":null,"party_password":null}],"envelope_signed_pdf":"https://api.signableapi.com/shareable/envelope?t=1ea41464-40ae-4638-b004-5ca1c8143318"}]},"key":"envelopeList","summary":"An example paginated list of envelopes","id":"paths/~1envelopes/get/responses/200/content/application~1json/examples/envelopeList"},"paths/~1envelopes/get/responses/401/content/application~1json/examples/invalidAuth":{"value":{"http":401,"code":10002,"message":"Authentication failed. Please enter the correct API Key and password.","company":null,"url":"https://developer.signable.co.uk/errors/error-10002","detail":null},"key":"invalidAuth","summary":"Invalid authentication","id":"paths/~1envelopes/get/responses/401/content/application~1json/examples/invalidAuth"},"paths/~1envelopes/post/requestBody/content/application~1json/examples/with_document":{"value":{"envelope_title":"Singer Road 23/06/25","user_id":838180,"envelope_redirect_url":"https://www.example.com","envelope_all_at_once_enabled":false,"envelope_password_protect":false,"envelope_auto_expire_hours":144,"envelope_auto_remind_hours":72,"envelope_meta":{"internal_id":"ABC123","VIP":false},"envelope_parties":[{"party_name":"Alex Mitchell","party_email":"abby+alex@signable.co.uk","party_role":"signer2","party_message":"Hello Alex, Please review and sign","party_mobile":"+447712345678"},{"party_name":"Abby Signers","party_email":"abby@signable.co.uk","party_role":"signer1","party_message":"Hello, Please sign pronto!","party_mobile":"+447712345678"},{"party_name":"Spectator","party_email":"abby+spectator@signable.co.uk","party_role":"copy","party_message":"Hello Alex, Please have a read"},{"party_name":"Tim Matthews","party_email":"abby@signable.co.uk","party_role":"signer3","party_message":"Hello, Please sign pronto!","party_mobile":"+447712345678"}],"envelope_documents":[{"document_url":"https://yellow-della-30.tiiny.site/Tenancy-Contract-2025-v2.pdf","document_title":"Test Agreement"},{"document_title":"Validation Contract","document_file_name":"ValidationContract.pdf","document_file_content":"JVBERi0xLjQKJdPr6...Zgo2MDE3MwolJUVPRgo="}]},"key":"with_document","summary":"Example send envelope (using document) request","id":"paths/~1envelopes/post/requestBody/content/application~1json/examples/with_document"},"paths/~1envelopes/post/requestBody/content/application~1json/examples/with_template":{"value":{"envelope_title":"Melbourne Road 23/06/25","user_id":819622,"envelope_redirect_url":"https://www.example.com","envelope_all_at_once_enabled":true,"envelope_password_protect":false,"envelope_auto_expire_hours":144,"envelope_auto_remind_hours":72,"envelope_meta":{"internal_id":"ABC123","VIP":false},"envelope_parties":[{"party_name":"Alex Mitchell","party_email":"abby+alex@signable.co.uk","party_id":"20748256","party_role":"signer","party_message":"Hello Alex, Please review and sign","party_mobile":"+447712345678"},{"party_name":"Abby Signers","party_email":"abby@signable.co.uk","party_id":"20748255","party_role":"signer","party_message":"Hello, Please sign pronto!","party_mobile":"+447712345678"},{"party_name":"Spectator","party_email":"abby+spectator@signable.co.uk","party_id":"20750393","party_role":"copy","party_message":"Hello Maisy, Please have a read"}],"envelope_documents":[{"document_title":"TC 2025 v2","document_template_fingerprint":"28f9add86f25028df2eee9adee866aba","document_merge_fields":[{"field_id":"454958773","field_value":"Note that breakables are not included in rent cost"}]}]},"key":"with_template","summary":"Example send envelope (using single template) request","id":"paths/~1envelopes/post/requestBody/content/application~1json/examples/with_template"},"paths/~1envelopes/post/requestBody/content/application~1json/examples/with_template_multiple":{"value":{"envelope_title":"Barnsley Road 21/04/25","user_id":819622,"envelope_redirect_url":"https://www.example.com","envelope_all_at_once_enabled":true,"envelope_password_protect":false,"envelope_auto_expire_hours":144,"envelope_auto_remind_hours":72,"envelope_meta":{"internal_id":"ABC123","VIP":false},"envelope_parties":[{"party_name":"Alex Mitchell","party_email":"abby+alex@signable.co.uk","party_role":"signer","party_message":"Hello Alex, Please review and sign","party_mobile":"+447712345678","party_documents":[{"party_id":"20748256","document_template_fingerprint":"28f9add86f25028df2eee9adee866aba"}]},{"party_name":"Abby Signers","party_email":"abby@signable.co.uk","party_role":"signer","party_message":"Hello, Please sign pronto!","party_mobile":"+447712345678","party_documents":[{"party_id":"20748265","document_template_fingerprint":"88d2c9e8dc4a69ce1cd97ac1684f3e45"},{"party_id":"20748255","document_template_fingerprint":"28f9add86f25028df2eee9adee866aba"}]},{"party_name":"Spectator","party_email":"abby+spectator@signable.co.uk","party_role":"copy","party_message":"Hello Maisy, Please have a read","party_documents":[]}],"envelope_documents":[{"document_title":"TC 2025 v2","document_template_fingerprint":"28f9add86f25028df2eee9adee866aba","document_merge_fields":[{"field_id":"454958773","field_value":"Note that breakables are not included in rent cost"}]},{"document_title":"TC 2025 v3","document_template_fingerprint":"88d2c9e8dc4a69ce1cd97ac1684f3e45"}]},"key":"with_template_multiple","summary":"Example send envelope (using multiple templates) successful response","id":"paths/~1envelopes/post/requestBody/content/application~1json/examples/with_template_multiple"},"paths/~1envelopes/post/responses/202/content/application~1json/examples/with_document":{"value":{"http":202,"message":"Your envelope with title Singer Road 23/06/25 will be processed and sent out.","href":"https://api.signable.co.uk/v1/envelopes/584ea8b41b0d4c17a96b967433b211e6","envelope_title":"Singer Road 23/06/25","envelope_fingerprint":"584ea8b41b0d4c17a96b967433b211e6","envelope_password_protect":false,"envelope_requires_otp":true,"envelope_redirect_url":"https://www.example.com","envelope_queued":"2025-07-16T14:39:02+0000","envelope_all_at_once_enabled":false,"envelope_parties":[{"party_id":"45849370","party_title":"Alex Mitchell","party_mobile_last4":"5678","party_password":null},{"party_id":"45849371","party_title":"Abby Signers","party_mobile_last4":"5678","party_password":null},{"party_id":"45849372","party_title":"Spectator","party_mobile_last4":null,"party_password":null},{"party_id":"45849373","party_title":"Tim Matthews","party_mobile_last4":"5678","party_password":null}]},"key":"with_document","summary":"Example send envelope (using document) successful response","id":"paths/~1envelopes/post/responses/202/content/application~1json/examples/with_document"},"paths/~1envelopes/post/responses/202/content/application~1json/examples/with_template":{"value":{"http":202,"message":"Your envelope with title Melbourne Road 23/06/25 will be processed and sent out.","href":"https://api.signable.co.uk/v1/envelopes/584ea8b41b0d4c17a96b967433b211e6","envelope_title":"Melbourne Road 23/06/25","envelope_fingerprint":"584ea8b41b0d4c17a96b967433b211e6","envelope_signing_embed":"<iframe src=\"https://sign.signable.app/#yXqPrm7HVOaiQUNM4NZI34BocfDWB69lf68lHq90R0s\" width=\"100%\" height=\"95%\" frameborder=\"0\" style=\"border: 0; overflow: hidden\"></iframe>","envelope_password_protect":false,"envelope_redirect_url":"https://www.example.com","envelope_queued":"2025-07-16T16:30:23+0000","envelope_all_at_once_enabled":true,"envelope_requires_otp":true,"envelope_parties":[{"party_id":"45855081","party_title":"Alex Mitchell","party_mobile_last4":"5678","party_password":null},{"party_id":"45855082","party_title":"Abby Signers","party_mobile_last4":"5678","party_password":null},{"party_id":"45855083","party_title":"Spectator","party_mobile_last4":null,"party_password":null}]},"key":"with_template","summary":"Example send envelope (using single template) successful response","id":"paths/~1envelopes/post/responses/202/content/application~1json/examples/with_template"},"paths/~1envelopes/post/responses/202/content/application~1json/examples/with_template_multiple":{"value":{"http":202,"message":"Your envelope with title Barnsley Road 21/04/25 will be processed and sent out.","href":"https://api.signable.co.uk/v1/envelopes/584ea8b41b0d4c17a96b967433b211e6","envelope_title":"Barnsley Road 21/04/25","envelope_fingerprint":"584ea8b41b0d4c17a96b967433b211e6","envelope_signing_embed":"<iframe src=\"https://sign.signable.app/#kVXVoBHVOBwh8ijT56DXYhSIjTIcrNsyD6OyDAKdWMZ\" width=\"100%\" height=\"95%\" frameborder=\"0\" style=\"border: 0; overflow: hidden\"></iframe>\n","envelope_password_protect":false,"envelope_redirect_url":"https://www.example.com","envelope_queued":"2025-07-17T13:42:35+0000","envelope_all_at_once_enabled":true,"envelope_requires_otp":true,"envelope_parties":[{"party_id":"45880606","party_title":"Alex Mitchell","party_mobile_last4":"5678","party_password":null},{"party_id":"45880607","party_title":"Abby Signers","party_mobile_last4":"5678","party_password":null},{"party_id":"45880608","party_title":"Spectator","party_mobile_last4":null,"party_password":null}]},"key":"with_template_multiple","summary":"Example send envelope (using multiple templates) successful response","id":"paths/~1envelopes/post/responses/202/content/application~1json/examples/with_template_multiple"},"paths/~1envelopes/post/responses/400/content/application~1json/examples/invalidRequest":{"value":{"http":400,"code":10250,"message":"The envelope could not be sent. Please check your request and try again.","company":null,"url":"https://developers.signable.app/errors/envelope-errors","detail":null},"key":"invalidRequest","summary":"Invalid request","id":"paths/~1envelopes/post/responses/400/content/application~1json/examples/invalidRequest"},"paths/~1envelopes~1{envelope_fingerprint}/get/responses/200/content/application~1json/examples/envelopeDetails":{"value":{"http":200,"envelope_fingerprint":"584ea8b41b0d4c17a96b967433b211e6","envelope_title":"17 John Street Tenancy Contract - 25th Jun 2025","envelope_status":"sent","envelope_redirect_url":null,"envelope_created":"2025-07-08T14:58:54+0000","envelope_sent":"2025-07-08T15:02:49+0000","envelope_processed":null,"envelope_all_at_once_enabled":true,"envelope_requires_otp":false,"envelope_parties":[{"party_id":"45631119","party_title":"Abby Signable","party_mobile_last4":null,"party_password":"Test123","contact_id":"17225983","contact_email":"abby@signable.co.uk","party_status":"in progress","party_signature_type":"remote","party_role":"signer"},{"party_id":"45631121","party_title":"Sabby","party_mobile_last4":null,"party_password":null,"contact_id":"17241370","contact_email":"abby+010725@signable.co.uk","party_status":"in progress","party_signature_type":"remote","party_role":"signer"},{"party_id":"45631122","party_title":"Bristol Solicitors","party_mobile_last4":null,"party_password":null,"contact_id":"17241371","contact_email":"test@example.com","party_status":"pending","party_signature_type":"remote","party_role":"copy"}],"envelope_documents":[{"document_fingerprint":"78c54190abc34179919e6c2197465926","document_title":"Sample Tenancy Contract","document_page_total":"2","document_pdf_url":"https://docs.signable.co.uk/original/78c54190abc34179919e6c2197465926.pdf","document_thumbnails":["https://docs.signable.co.uk/small/78c54190abc34179919e6c2197465926-0.jpg","https://docs.signable.co.uk/small/78c54190abc34179919e6c2197465926-1.jpg"],"document_pages":["https://docs.signable.co.uk/large/78c54190abc34179919e6c2197465926-0.jpg","https://docs.signable.co.uk/large/78c54190abc34179919e6c2197465926-1.jpg"],"document_fields":[{"field_id":"452902787","field_title":"First Name","field_type":"text","field_value":"Abby Sackson","party_id":"45631119","field_merge":"Sender Name"},{"field_id":"452902789","field_title":"Date please","field_type":"date","field_value":"","party_id":"45631119","field_merge":null},{"field_id":"452902790","field_title":"Passport Copy","field_type":"upload","field_value":"https://api.signable.co.uk/download/field/N2I5YmZhMGU0NDAzMGFmMGFhZTZiYmVmODRmYWMxOTA6NTGvATg5MjE1?expires=1779373241&signature=a569a4b52ef1e3c2d47bf9d0c0de2642fc86da851ad936cb2aa090e568b8b102","party_id":"45631119","field_merge":null}],"document_signed_pdf":"https://api.signableapi.com/shareable/document?t=03cbb315-4f68-400d-a5cc-c2884996d061"},{"document_fingerprint":"2cbd40997bc64c1c9b700d80471723b9","document_title":"Sample Contract","document_page_total":"1","document_pdf_url":"https://docs.signable.co.uk/original/2cbd40997bc64c1c9b700d80471723b9.pdf","document_thumbnails":["https://docs.signable.co.uk/small/2cbd40997bc64c1c9b700d80471723b9-0.jpg"],"document_pages":["https://docs.signable.co.uk/large/2cbd40997bc64c1c9b700d80471723b9-0.jpg"],"document_fields":[{"field_id":"452902797","field_title":"Print Name","field_type":"text","field_value":"","party_id":"45631119","field_merge":null},{"field_id":"452902798","field_title":"Full Address","field_type":"text","field_value":"","party_id":"45631119","field_merge":null}]}],"envelope_history":[{"history_detail":"Envelope generated by Abby Loves Signable","history_ip":"147.147.97.34","history_user_agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0 Safari/537.36","history_date":"2025-07-08T14:58:54+0000"},{"history_detail":"Document generated with fingerprint 78c54190abc34179919e6c2197465926","history_ip":"147.147.97.34","history_user_agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0 Safari/537.36","history_date":"2025-07-08T14:58:55+0000"},{"history_detail":"Document generated with fingerprint 2cbd40997bc64c1c9b700d80471723b9","history_ip":"147.147.97.34","history_user_agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0 Safari/537.36","history_date":"2025-07-08T14:58:55+0000"},{"history_detail":"Sent the envelope to Abby Signable (abby@signable.co.uk) for signing","history_ip":"147.147.97.34","history_user_agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0 Safari/537.36","history_date":"2025-07-08T15:02:48+0000"},{"history_detail":"Sent the envelope to Sabby (abby+010725@signable.co.uk) for signing","history_ip":"147.147.97.34","history_user_agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0 Safari/537.36","history_date":"2025-07-08T15:02:49+0000"},{"history_detail":"Document emailed to abby@signable.co.uk","history_ip":"","history_user_agent":"","history_date":"2025-07-08T15:02:49+0000"},{"history_detail":"Document emailed to abby+010725@signable.co.uk","history_ip":"","history_user_agent":"","history_date":"2025-07-08T15:02:49+0000"},{"history_detail":"Abby Signable opened the document email.","history_ip":"66.249.93.102","history_user_agent":"Mozilla/5.0 (Windows NT 5.1; rv:11.0) Gecko Firefox/11.0 (via ggpht.com GoogleImageProxy)","history_date":"2025-07-09T08:37:19+0000"},{"history_detail":"Sabby opened the document email.","history_ip":"66.249.93.98","history_user_agent":"Mozilla/5.0 (Windows NT 5.1; rv:11.0) Gecko Firefox/11.0 (via ggpht.com GoogleImageProxy)","history_date":"2025-07-09T08:37:19+0000"},{"history_detail":"Sent Abby Signable a reminder to sign the document.","history_ip":"","history_user_agent":"","history_date":"2025-07-13T15:03:15+0000"},{"history_detail":"Sent Sabby a reminder to sign the document.","history_ip":"","history_user_agent":"","history_date":"2025-07-13T15:03:15+0000"},{"history_detail":"Document emailed to abby@signable.co.uk","history_ip":"","history_user_agent":"","history_date":"2025-07-13T15:03:15+0000"},{"history_detail":"Document emailed to abby+010725@signable.co.uk","history_ip":"","history_user_agent":"","history_date":"2025-07-13T15:03:15+0000"}],"envelope_meta":{"internal_id":"ABC123","VIP":false}},"key":"envelopeDetails","summary":"Example envelope details response","id":"paths/~1envelopes~1{envelope_fingerprint}/get/responses/200/content/application~1json/examples/envelopeDetails"},"paths/~1envelopes~1{envelope_fingerprint}/delete/responses/200/content/application~1json/examples/success":{"value":{"http":200,"message":"The envelope has been deleted","envelope_fingerprint":"584ea8b41b0d4c17a96b967433b211e6","envelope_title":"Test Envelope","envelope_status":"deleted"},"key":"success","summary":"Envelope deleted successfully","id":"paths/~1envelopes~1{envelope_fingerprint}/delete/responses/200/content/application~1json/examples/success"},"paths/~1envelopes~1{envelope_fingerprint}~1remind/put/responses/200/content/application~1json/examples/success":{"value":{"http":200,"message":"The signing parties for this envelope have been reminded.","envelope_fingerprint":"584ea8b41b0d4c17a96b967433b211e6","envelope_title":"17 John Street Tenancy Contract - 25th Jun 2025","envelope_all_at_once_enabled":true},"key":"success","summary":"Reminder email triggered","id":"paths/~1envelopes~1{envelope_fingerprint}~1remind/put/responses/200/content/application~1json/examples/success"},"paths/~1envelopes~1{envelope_fingerprint}~1remind/put/responses/400/content/application~1json/examples/wrongStatus":{"value":{"http":400,"code":10275,"message":"The envelope you are trying to remind doesn't have the correct status. The envelope can't be complete and must still be active."},"key":"wrongStatus","summary":"Envelope is not active","id":"paths/~1envelopes~1{envelope_fingerprint}~1remind/put/responses/400/content/application~1json/examples/wrongStatus"},"paths/~1envelopes~1{envelope_fingerprint}~1remind/put/responses/401/content/application~1json/examples/invalidAuth":{"value":{"http":401,"code":10002,"message":"Authentication failed. Please enter the correct API Key and password."},"key":"invalidAuth","summary":"Invalid authentication","id":"paths/~1envelopes~1{envelope_fingerprint}~1remind/put/responses/401/content/application~1json/examples/invalidAuth"},"paths/~1envelopes~1{envelope_fingerprint}~1remind/put/responses/404/content/application~1json/examples/unknownEnvelope":{"value":{"http":404,"code":10253,"message":"The envelope does not exist. Have you used the correct envelope fingerprint?"},"key":"unknownEnvelope","summary":"Unknown or inaccessible envelope","id":"paths/~1envelopes~1{envelope_fingerprint}~1remind/put/responses/404/content/application~1json/examples/unknownEnvelope"},"paths/~1envelopes~1{envelope_fingerprint}~1cancel/put/responses/200/content/application~1json/examples/success":{"value":{"http":200,"message":"The envelope has been cancelled","envelope_fingerprint":"584ea8b41b0d4c17a96b967433b211e6","envelope_title":"Contract Settlement","envelope_status":"cancelled","envelope_processed":"2025-07-14T13:34:34+0000"},"key":"success","summary":"Envelope cancelled successfully","id":"paths/~1envelopes~1{envelope_fingerprint}~1cancel/put/responses/200/content/application~1json/examples/success"},"paths/~1envelopes~1{envelope_fingerprint}~1cancel/put/responses/400/content/application~1json/examples/wrongStatus":{"value":{"http":400,"code":10274,"message":"The envelope you are trying to cancel doesn't have the correct status. The envelope can't be complete and must still be active.","company":null,"url":"http://developer.signable.co.uk/errors/error-10274","detail":null},"key":"wrongStatus","summary":"Envelope is not active","id":"paths/~1envelopes~1{envelope_fingerprint}~1cancel/put/responses/400/content/application~1json/examples/wrongStatus"},"paths/~1envelopes~1{envelope_fingerprint}~1cancel/put/responses/401/content/application~1json/examples/invalidAuth":{"value":{"http":401,"code":10002,"message":"Authentication failed. Please enter the correct API Key and password.","company":null,"url":"https://developer.signable.co.uk/errors/error-10002","detail":null},"key":"invalidAuth","summary":"Invalid authentication","id":"paths/~1envelopes~1{envelope_fingerprint}~1cancel/put/responses/401/content/application~1json/examples/invalidAuth"},"paths/~1envelopes~1{envelope_fingerprint}~1cancel/put/responses/404/content/application~1json/examples/unknownEnvelope":{"value":{"http":404,"code":10253,"message":"The envelope does not exist. Have you used the correct envelope fingerprint?","company":null,"url":"https://developers.signable.app/errors/envelope-errors","detail":null},"key":"unknownEnvelope","summary":"Unknown or inaccessible envelope","id":"paths/~1envelopes~1{envelope_fingerprint}~1cancel/put/responses/404/content/application~1json/examples/unknownEnvelope"},"paths/~1envelopes~1{envelope_fingerprint}~1expire/put/responses/200/content/application~1json/examples/success":{"value":{"http":200,"message":"The envelope has been expired","envelope_fingerprint":"584ea8b41b0d4c17a96b967433b211e6","envelope_title":"Industrial Contract","envelope_status":"expired","envelope_processed":"2025-07-14T14:37:34+0000"},"key":"success","summary":"Envelope expired successfully","id":"paths/~1envelopes~1{envelope_fingerprint}~1expire/put/responses/200/content/application~1json/examples/success"},"paths/~1envelopes~1{envelope_fingerprint}~1parties~1{party_id}/patch/requestBody/content/application~1json/examples/default":{"value":{"party_email":"abby+updated@signable.co.uk","party_title":"Abby"},"key":"default","summary":"Update party email and title","id":"paths/~1envelopes~1{envelope_fingerprint}~1parties~1{party_id}/patch/requestBody/content/application~1json/examples/default"},"paths/~1envelopes~1{envelope_fingerprint}~1parties~1{party_id}/patch/responses/200/content/application~1json/examples/default":{"value":{"http":200,"party_id":1234567,"party_title":"Abby","party_email":"abby+updated@signable.co.uk","party_role":"signer"},"key":"default","summary":"Successful party update response","id":"paths/~1envelopes~1{envelope_fingerprint}~1parties~1{party_id}/patch/responses/200/content/application~1json/examples/default"},"paths/~1templates/get/responses/200/content/application~1json/examples/default":{"value":{"http":200,"offset":0,"limit":10,"total_templates":"2","templates":[{"template_id":"53890528","template_fingerprint":"e0b3a9cbd4a6ff2cb57cfca161a38309","template_title":"Sample Tenancy Contract","template_page_total":"2","template_in_progress":"0","template_parties_total":"1","template_widget_url":"https://sign.signable.app/#/widget/YzVsBQ5Dyj","template_widget_embed":"<iframe src='https://sign.signable.app/#/widget/YzVsBQ5Dyj' frameborder='0' style='border:0;width:100%;height:100vh;' scrolling='yes'></iframe>","template_pdf_url":"https://docs.signable.co.uk/original/e0b3a9cbd4a6ff2cb57cfca161a38309.pdf","template_thumbnails":["https://docs.signable.co.uk/small/e0b3a9cbd4a6ff2cb57cfca161a38309-0.jpg","https://docs.signable.co.uk/small/e0b3a9cbd4a6ff2cb57cfca161a38309-1.jpg"],"template_pages":["https://docs.signable.co.uk/large/e0b3a9cbd4a6ff2cb57cfca161a38309-0.jpg","https://docs.signable.co.uk/large/e0b3a9cbd4a6ff2cb57cfca161a38309-1.jpg"],"template_uploaded":"2025-07-07T15:49:43+0000","template_parties":[{"party_id":"20576938","party_name":"Signer 1"}]},{"template_id":"53690003","template_fingerprint":"b786a173554cc06371248caf0b250704","template_title":"Sample Contract","template_page_total":"1","template_in_progress":"3","template_parties_total":"1","template_widget_url":"https://sign.signable.app/#/widget/","template_widget_embed":"<iframe src='https://sign.signable.app/#/widget/' frameborder='0' style='border:0;width:100%;height:100vh;' scrolling='yes'></iframe>","template_pdf_url":"https://docs.signable.co.uk/original/b786a173554cc06371248caf0b250704.pdf","template_thumbnails":["https://docs.signable.co.uk/small/b786a173554cc06371248caf0b250704-0.jpg"],"template_pages":["https://docs.signable.co.uk/large/b786a173554cc06371248caf0b250704-0.jpg"],"template_uploaded":"2025-07-01T08:40:38+0000","template_parties":[{"party_id":"20459705","party_name":"Party","party_merge_fields":[{"field_id":"450927743","field_merge":"Name of Sender","field_type":"text"}]}]}]},"key":"default","summary":"Example template list response","id":"paths/~1templates/get/responses/200/content/application~1json/examples/default"},"paths/~1templates~1{template_fingerprint}/get/responses/200/content/application~1json/examples/default":{"value":{"http":200,"template_id":"53690003","template_fingerprint":"b786a173554cc06371248caf0b250704","template_title":"Sample Contract","template_page_total":"1","template_in_progress":"3","template_parties_total":"1","template_widget_url":"https://sign.signable.app/#/widget/YzVsBQ5Dyj","template_widget_embed":"<iframe src='https://sign.signable.app/#/widget/YzVsBQ5Dyj' frameborder='0' style='border:0;width:100%;height:100vh;' scrolling='yes'></iframe>","template_pdf_url":"https://docs.signable.co.uk/original/b786a173554cc06371248caf0b250704.pdf","template_thumbnails":["https://docs.signable.co.uk/small/b786a173554cc06371248caf0b250704-0.jpg"],"template_pages":["https://docs.signable.co.uk/large/b786a173554cc06371248caf0b250704-0.jpg"],"template_uploaded":"2025-07-01T08:40:38+0000","template_parties":[{"party_id":"20459705","party_name":"Party","party_merge_fields":[{"field_id":"450927743","field_merge":"Name of Sender","field_type":"text"}]}]},"key":"default","summary":"Example template details response","id":"paths/~1templates~1{template_fingerprint}/get/responses/200/content/application~1json/examples/default"},"paths/~1templates~1{template_fingerprint}/delete/responses/200/content/application~1json/examples/default":{"value":{"http":200,"message":"Sample Tenancy Contract has been removed from your template list.","template_id":"53890528","tempate_fingerprint":"e0b3a9cbd4a6ff2cb57cfca161a38309","tempate_title":"Sample Tenancy Contract"},"key":"default","summary":"Example template deletion confirmation","id":"paths/~1templates~1{template_fingerprint}/delete/responses/200/content/application~1json/examples/default"},"paths/~1contacts/get/responses/200/content/application~1json/examples/default":{"value":{"http":200,"offset":0,"limit":50,"total_contacts":"100","next":"https://api.signable.co.uk/v1/contacts?offset=50&limit=50","contacts":[{"contact_id":"17224073","contact_name":"Buffy The Vampire Slayer","contact_email":"buffy@sunnydale.com","contact_outstanding_documents":"0","contact_created":"2025-07-07T09:54:08+0000"},{"contact_id":"17224050","contact_name":"Jane Doe","contact_email":"jane@example.com","contact_outstanding_documents":"0","contact_created":"2025-07-07T09:52:54+0000"},{"contact_id":"17224044","contact_name":"Jo Bloggs","contact_email":"jo@example.com","contact_outstanding_documents":"0","contact_created":"2025-07-07T09:52:32+0000"}]},"key":"default","summary":"Paginated list of contacts","id":"paths/~1contacts/get/responses/200/content/application~1json/examples/default"},"paths/~1contacts/get/responses/401/content/application~1json/examples/missingOrBlankAuth":{"value":{"http":401,"code":10004,"message":"Authentication failed. Either the API Key or password was blank."},"key":"missingOrBlankAuth","summary":"Missing or blank authentication","id":"paths/~1contacts/get/responses/401/content/application~1json/examples/missingOrBlankAuth"},"paths/~1contacts/get/responses/401/content/application~1json/examples/invalidAuth":{"value":{"http":401,"code":10002,"message":"Authentication failed. Please enter the correct API Key and password."},"key":"invalidAuth","summary":"Invalid authentication","id":"paths/~1contacts/get/responses/401/content/application~1json/examples/invalidAuth"},"paths/~1contacts/post/requestBody/content/application~1json/examples/default":{"value":{"contact_name":"Hanz Zimmer","contact_email":"hanz.zimmer@music.com"},"key":"default","summary":"Example create contact request","id":"paths/~1contacts/post/requestBody/content/application~1json/examples/default"},"paths/~1contacts/post/responses/200/content/application~1json/examples/default":{"value":{"http":200,"message":"Hanz Zimmer has been added to your contact list.","href":"https://api.signable.co.uk/v1/contacts/17224150","contact_id":"17224150","contact_name":"Hanz Zimmer","contact_email":"hanz.zimmer@music.com","contact_created":"2025-07-07T09:57:39+0000"},"key":"default","summary":"Example create contact response","id":"paths/~1contacts/post/responses/200/content/application~1json/examples/default"},"paths/~1contacts/post/responses/400/content/application~1json/examples/missingContactName":{"value":{"http":400,"code":10050,"message":"The contact name is missing. To be able to create a new contact, you must provide a name."},"key":"missingContactName","summary":"Missing contact_name","id":"paths/~1contacts/post/responses/400/content/application~1json/examples/missingContactName"},"paths/~1contacts/post/responses/400/content/application~1json/examples/missingBody":{"value":{"http":400,"code":10050,"message":"The contact name is missing. To be able to create a new contact, you must provide a name."},"key":"missingBody","summary":"Missing request body","id":"paths/~1contacts/post/responses/400/content/application~1json/examples/missingBody"},"paths/~1contacts/post/responses/400/content/application~1json/examples/malformedJson":{"value":{"http":400,"code":10050,"message":"The contact name is missing. To be able to create a new contact, you must provide a name."},"key":"malformedJson","summary":"Malformed JSON","id":"paths/~1contacts/post/responses/400/content/application~1json/examples/malformedJson"},"paths/~1contacts/post/responses/400/content/application~1json/examples/missingContactEmail":{"value":{"http":400,"code":10051,"message":"The contact email is missing. To be able to create a new contact, you must provide an email address."},"key":"missingContactEmail","summary":"Missing contact_email","id":"paths/~1contacts/post/responses/400/content/application~1json/examples/missingContactEmail"},"paths/~1contacts/post/responses/400/content/application~1json/examples/invalidContactEmail":{"value":{"http":400,"code":10051,"message":"The contact email is missing. To be able to create a new contact, you must provide an email address."},"key":"invalidContactEmail","summary":"Invalid contact_email","id":"paths/~1contacts/post/responses/400/content/application~1json/examples/invalidContactEmail"},"paths/~1contacts/post/responses/400/content/application~1json/examples/duplicateContactEmail":{"value":{"http":400,"code":10059,"message":"Unable to add a new contact as a contact already exists with this email address."},"key":"duplicateContactEmail","summary":"Duplicate contact_email","id":"paths/~1contacts/post/responses/400/content/application~1json/examples/duplicateContactEmail"},"paths/~1contacts/post/responses/401/content/application~1json/examples/missingOrBlankAuth":{"value":{"http":401,"code":10004,"message":"Authentication failed. Either the API Key or password was blank."},"key":"missingOrBlankAuth","summary":"Missing or blank authentication","id":"paths/~1contacts/post/responses/401/content/application~1json/examples/missingOrBlankAuth"},"paths/~1contacts/post/responses/401/content/application~1json/examples/invalidAuth":{"value":{"http":401,"code":10002,"message":"Authentication failed. Please enter the correct API Key and password."},"key":"invalidAuth","summary":"Invalid authentication","id":"paths/~1contacts/post/responses/401/content/application~1json/examples/invalidAuth"},"paths/~1contacts~1{contact_id}/get/responses/200/content/application~1json/examples/default":{"value":{"http":200,"contact_id":17224150,"contact_name":"Hanz Zimmer","contact_email":"hanz.zimmer@music.com","contact_outstanding_documents":"0","contact_created":"2025-07-07T09:57:39+0000"},"key":"default","summary":"Example get contact response","id":"paths/~1contacts~1{contact_id}/get/responses/200/content/application~1json/examples/default"},"paths/~1contacts~1{contact_id}/get/responses/401/content/application~1json/examples/missingOrBlankAuth":{"value":{"http":401,"code":10004,"message":"Authentication failed. Either the API Key or password was blank."},"key":"missingOrBlankAuth","summary":"Missing or blank authentication","id":"paths/~1contacts~1{contact_id}/get/responses/401/content/application~1json/examples/missingOrBlankAuth"},"paths/~1contacts~1{contact_id}/get/responses/401/content/application~1json/examples/invalidAuth":{"value":{"http":401,"code":10002,"message":"Authentication failed. Please enter the correct API Key and password."},"key":"invalidAuth","summary":"Invalid authentication","id":"paths/~1contacts~1{contact_id}/get/responses/401/content/application~1json/examples/invalidAuth"},"paths/~1contacts~1{contact_id}/get/responses/404/content/application~1json/examples/contactNotFound":{"value":{"http":404,"code":10053,"message":"The contact does not exist. Have you used the correct contact ID?"},"key":"contactNotFound","summary":"Unknown, deleted, or wrong-account contact","id":"paths/~1contacts~1{contact_id}/get/responses/404/content/application~1json/examples/contactNotFound"},"paths/~1contacts~1{contact_id}/get/responses/404/content/application~1json/examples/nonNumericContactId":{"value":{"message":"The route v1/contacts/abc could not be found."},"key":"nonNumericContactId","summary":"Non-numeric contact_id","id":"paths/~1contacts~1{contact_id}/get/responses/404/content/application~1json/examples/nonNumericContactId"},"paths/~1contacts~1{contact_id}/put/requestBody/content/application~1json/examples/default":{"value":{"contact_name":"Nemo","contact_email":"nemo@coralreef.com"},"key":"default","summary":"Example update contact request","id":"paths/~1contacts~1{contact_id}/put/requestBody/content/application~1json/examples/default"},"paths/~1contacts~1{contact_id}/put/responses/200/content/application~1json/examples/default":{"value":{"http":200,"message":"Nemo has been updated in your contact list.","href":"https://api.signable.co.uk/v1/contacts/17224150","contact_id":17224150,"contact_name":"Nemo","contact_email":"nemo@coralreef.com","contact_updated":"2025-07-07T09:59:25+0000"},"key":"default","summary":"Example update contact response","id":"paths/~1contacts~1{contact_id}/put/responses/200/content/application~1json/examples/default"},"paths/~1contacts~1{contact_id}/put/responses/400/content/application~1json/examples/missingBody":{"value":{"http":400,"code":10054,"message":"Both the contact name and contact email are missing. Please make sure at least one of them are provided."},"key":"missingBody","summary":"Missing request body","id":"paths/~1contacts~1{contact_id}/put/responses/400/content/application~1json/examples/missingBody"},"paths/~1contacts~1{contact_id}/put/responses/400/content/application~1json/examples/malformedJson":{"value":{"http":400,"code":10054,"message":"Both the contact name and contact email are missing. Please make sure at least one of them are provided."},"key":"malformedJson","summary":"Malformed JSON","id":"paths/~1contacts~1{contact_id}/put/responses/400/content/application~1json/examples/malformedJson"},"paths/~1contacts~1{contact_id}/put/responses/401/content/application~1json/examples/missingOrBlankAuth":{"value":{"http":401,"code":10004,"message":"Authentication failed. Either the API Key or password was blank."},"key":"missingOrBlankAuth","summary":"Missing or blank authentication","id":"paths/~1contacts~1{contact_id}/put/responses/401/content/application~1json/examples/missingOrBlankAuth"},"paths/~1contacts~1{contact_id}/put/responses/401/content/application~1json/examples/invalidAuth":{"value":{"http":401,"code":10002,"message":"Authentication failed. Please enter the correct API Key and password."},"key":"invalidAuth","summary":"Invalid authentication","id":"paths/~1contacts~1{contact_id}/put/responses/401/content/application~1json/examples/invalidAuth"},"paths/~1contacts~1{contact_id}/put/responses/404/content/application~1json/examples/contactNotFound":{"value":{"http":404,"code":10053,"message":"The contact does not exist. Have you used the correct contact ID?"},"key":"contactNotFound","summary":"Unknown or wrong-account contact","id":"paths/~1contacts~1{contact_id}/put/responses/404/content/application~1json/examples/contactNotFound"},"paths/~1contacts~1{contact_id}/put/responses/404/content/application~1json/examples/nonNumericContactId":{"value":{"message":"The route v1/contacts/abc could not be found."},"key":"nonNumericContactId","summary":"Non-numeric contact_id","id":"paths/~1contacts~1{contact_id}/put/responses/404/content/application~1json/examples/nonNumericContactId"},"paths/~1contacts~1{contact_id}/delete/responses/200/content/application~1json/examples/default":{"value":{"http":200,"message":"Nemo has been removed from your contact list.","contact_id":17224150,"contact_name":"Nemo","contact_email":"nemo@coralreef.com"},"key":"default","summary":"Example delete contact response","id":"paths/~1contacts~1{contact_id}/delete/responses/200/content/application~1json/examples/default"},"paths/~1contacts~1{contact_id}/delete/responses/401/content/application~1json/examples/missingOrBlankAuth":{"value":{"http":401,"code":10004,"message":"Authentication failed. Either the API Key or password was blank."},"key":"missingOrBlankAuth","summary":"Missing or blank authentication","id":"paths/~1contacts~1{contact_id}/delete/responses/401/content/application~1json/examples/missingOrBlankAuth"},"paths/~1contacts~1{contact_id}/delete/responses/401/content/application~1json/examples/invalidAuth":{"value":{"http":401,"code":10002,"message":"Authentication failed. Please enter the correct API Key and password."},"key":"invalidAuth","summary":"Invalid authentication","id":"paths/~1contacts~1{contact_id}/delete/responses/401/content/application~1json/examples/invalidAuth"},"paths/~1contacts~1{contact_id}/delete/responses/404/content/application~1json/examples/contactNotFound":{"value":{"http":404,"code":10053,"message":"The contact does not exist. Have you used the correct contact ID?"},"key":"contactNotFound","summary":"Unknown, already deleted, or wrong-account contact","id":"paths/~1contacts~1{contact_id}/delete/responses/404/content/application~1json/examples/contactNotFound"},"paths/~1contacts~1{contact_id}/delete/responses/404/content/application~1json/examples/nonNumericContactId":{"value":{"message":"The route v1/contacts/abc could not be found."},"key":"nonNumericContactId","summary":"Non-numeric contact_id","id":"paths/~1contacts~1{contact_id}/delete/responses/404/content/application~1json/examples/nonNumericContactId"},"paths/~1contacts~1{contact_id}~1envelopes/get/responses/200/content/application~1json/examples/default":{"value":{"http":200,"offset":0,"limit":10,"total_envelopes":"3","envelopes":[{"envelope_fingerprint":"584ea8b41b0d4c17a96b967433b211e6","envelope_title":"Another Test","envelope_status":"draft","envelope_created":"2025-07-07T11:30:27+0000","envelope_sent":null,"envelope_processed":null},{"envelope_fingerprint":"584ea8b41b0d4c17a96b967433b211e6","envelope_title":"2nd Test","envelope_status":"signed","envelope_created":"2025-07-07T11:27:44+0000","envelope_sent":"2025-07-07T11:29:31+0000","envelope_processed":"2025-07-07T11:30:09+0000","envelope_signed_pdf":"https://api.signableapi.com/shareable/envelope?t=403cebcc-60ec-4cc2-b7d6-753fb7d5c632"},{"envelope_fingerprint":"584ea8b41b0d4c17a96b967433b211e6","envelope_title":"Test Envelope","envelope_status":"signed","envelope_created":"2025-07-07T10:30:02+0000","envelope_sent":"2025-07-07T11:26:20+0000","envelope_processed":"2025-07-07T11:27:20+0000","envelope_signed_pdf":"https://api.signableapi.com/shareable/envelope?t=3dd2069d-4a61-4c9e-99c8-9dfc737eb150"}]},"key":"default","summary":"Envelopes associated with a contact","id":"paths/~1contacts~1{contact_id}~1envelopes/get/responses/200/content/application~1json/examples/default"},"paths/~1contacts~1{contact_id}~1envelopes/get/responses/401/content/application~1json/examples/missingOrBlankAuth":{"value":{"http":401,"code":10004,"message":"Authentication failed. Either the API Key or password was blank."},"key":"missingOrBlankAuth","summary":"Missing or blank authentication","id":"paths/~1contacts~1{contact_id}~1envelopes/get/responses/401/content/application~1json/examples/missingOrBlankAuth"},"paths/~1contacts~1{contact_id}~1envelopes/get/responses/401/content/application~1json/examples/invalidAuth":{"value":{"http":401,"code":10002,"message":"Authentication failed. Please enter the correct API Key and password."},"key":"invalidAuth","summary":"Invalid authentication","id":"paths/~1contacts~1{contact_id}~1envelopes/get/responses/401/content/application~1json/examples/invalidAuth"},"paths/~1contacts~1{contact_id}~1envelopes/get/responses/404/content/application~1json/examples/noContactEnvelopes":{"value":{"http":404,"code":10060,"message":"This contact hasn't been sent any envelopes."},"key":"noContactEnvelopes","summary":"Unknown or wrong-account contact","id":"paths/~1contacts~1{contact_id}~1envelopes/get/responses/404/content/application~1json/examples/noContactEnvelopes"},"paths/~1contacts~1{contact_id}~1envelopes/get/responses/404/content/application~1json/examples/nonNumericContactId":{"value":{"message":"The route v1/contacts/abc/envelopes could not be found."},"key":"nonNumericContactId","summary":"Non-numeric contact_id","id":"paths/~1contacts~1{contact_id}~1envelopes/get/responses/404/content/application~1json/examples/nonNumericContactId"},"paths/~1users/get/responses/200/content/application~1json/examples/default":{"value":{"http":200,"offset":0,"limit":50,"total_users":"2","users":[{"user_id":"836499","role_id":"3","user_name":"Abby Loves Signable","user_email":"abby+010725@signable.co.uk","user_added":"2025-07-01T08:40:38+0000","user_last_updated":"2025-07-07T07:57:54+0000"},{"user_id":"837142","role_id":"1","user_name":"Sabby","user_email":"abby+sabby@signable.co.uk","user_added":"2025-07-07T07:58:38+0000","user_last_updated":"2025-07-07T07:58:44+0000"}]},"key":"default","summary":"Paginated user list","id":"paths/~1users/get/responses/200/content/application~1json/examples/default"},"paths/~1users/post/requestBody/content/application~1json/examples/default":{"value":{"user_name":"Abby Example","user_email":"abby+example@wearedom.com","role_id":"2"},"key":"default","summary":"Example user creation request","id":"paths/~1users/post/requestBody/content/application~1json/examples/default"},"paths/~1users/post/responses/200/content/application~1json/examples/default":{"value":{"http":200,"message":"Abby Example has been added to your user list.","href":"https://api.signable.co.uk/v1/users/837146","user_id":"837146","role_id":"2","user_name":"Abby Example","user_email":"abby+example@wearedom.com","user_added":"2025-07-07T08:06:49+0000"},"key":"default","summary":"Example successful user creation response","id":"paths/~1users/post/responses/200/content/application~1json/examples/default"},"paths/~1users~1{user_id}/get/responses/200/content/application~1json/examples/default":{"value":{"http":200,"user_id":836499,"role_id":"3","user_name":"Abby Loves Signable","user_email":"abby+010725@signable.co.uk","user_added":"2025-07-01T08:40:38+0000","user_last_updated":"2025-07-07T07:57:54+0000"},"key":"default","summary":"Single user response","id":"paths/~1users~1{user_id}/get/responses/200/content/application~1json/examples/default"},"paths/~1users~1{user_id}/put/requestBody/content/application~1json/examples/userNameOnly":{"value":{"user_name":"Abby Smith"},"key":"userNameOnly","summary":"Update a user name only","id":"paths/~1users~1{user_id}/put/requestBody/content/application~1json/examples/userNameOnly"},"paths/~1users~1{user_id}/put/requestBody/content/application~1json/examples/userEmailOnly":{"value":{"user_email":"abby+jackson@signable.co.uk"},"key":"userEmailOnly","summary":"Update a user email only","id":"paths/~1users~1{user_id}/put/requestBody/content/application~1json/examples/userEmailOnly"},"paths/~1users~1{user_id}/put/requestBody/content/application~1json/examples/userNameAndUserEmail":{"value":{"user_name":"Abby Smith","user_email":"abby+jackson@signable.co.uk"},"key":"userNameAndUserEmail","summary":"Update a user name and email","id":"paths/~1users~1{user_id}/put/requestBody/content/application~1json/examples/userNameAndUserEmail"},"paths/~1users~1{user_id}/put/requestBody/content/application~1json/examples/fullPayload":{"value":{"user_name":"Abby Smith","user_email":"abby+jackson@signable.co.uk","role_id":"1"},"key":"fullPayload","summary":"Update user details","id":"paths/~1users~1{user_id}/put/requestBody/content/application~1json/examples/fullPayload"},"paths/~1users~1{user_id}/put/responses/200/content/application~1json/examples/default":{"value":{"http":200,"message":"Abby Smith has been updated in your user list.","href":"https://api.signable.co.uk/v1/users/837154","user_id":837154,"role_id":"1","user_name":"Abby Smith","user_email":"abby+jackson@signable.co.uk","user_updated":"2025-07-07T08:38:54+0000"},"key":"default","summary":"Successful user update","id":"paths/~1users~1{user_id}/put/responses/200/content/application~1json/examples/default"},"paths/~1users~1{user_id}/put/responses/400/content/application~1json/examples/roleIdOnly":{"value":{"http":400,"code":10104,"message":"The user name and email are missing. Please make sure at least one of them is provided."},"key":"roleIdOnly","summary":"Role-only update request is rejected","id":"paths/~1users~1{user_id}/put/responses/400/content/application~1json/examples/roleIdOnly"},"paths/~1users~1{user_id}/delete/responses/200/content/application~1json/examples/default":{"value":{"http":200,"message":"Abby Smith has been removed from your user list.","user_id":837154,"role_id":"1","user_email":"abby+jackson@signable.co.uk","user_name":"Abby Smith"},"key":"default","summary":"User deletion confirmation","id":"paths/~1users~1{user_id}/delete/responses/200/content/application~1json/examples/default"},"paths/~1branding/get/responses/200/content/application~1json/examples/default":{"value":{"http":200,"branding_logo":"https://www.signable.co.uk/signable.png","branding_colour":"#0095E6"},"key":"default","summary":"Example branding configuration","id":"paths/~1branding/get/responses/200/content/application~1json/examples/default"},"paths/~1branding/put/requestBody/content/application~1json/examples/default":{"value":{"branding_logo_url":"https://upload.wikimedia.org/wikipedia/commons/7/70/Example.png","branding_colour":"#558caa"},"key":"default","summary":"Example branding update request","id":"paths/~1branding/put/requestBody/content/application~1json/examples/default"},"paths/~1branding/put/responses/200/content/application~1json/examples/default":{"value":{"http":200,"message":"Branding options have been updated.","branding_logo":"https://assets.signable.co.uk/company-logo/213690-1751360856.png","branding_colour":"#558CAA"},"key":"default","summary":"Branding successfully updated","id":"paths/~1branding/put/responses/200/content/application~1json/examples/default"},"paths/~1branding~1emails/get/responses/200/content/application~1json/examples/success":{"value":{"http":200,"branding_emails":[{"branding_email_type":"email-cancelled","branding_email_subject":"{company name} has cancelled a document","branding_email_content":"<body style=\"font-family:Arial,Helvetica,sans-serif;\">\n<table style=\"background:#FFF;font-family:Arial,Helvetica,sans-serif;border-collpase:collapse;width:600px;margin:0 auto;\">\n  <tr>\n    <td>\n      <table style=\"border-collpase:collapse\">\n        <tr>\n          <td style=\"padding:15px 10px 10px\">\n            <a href=\"https://www.signable.co.uk\">\n              <img src=\"{company logo}\" alt=\"{company name}\" />\n            </a>\n          </td>\n        </tr>\n        <tr>\n          <td style=\"padding-top:10px\">\n            <h1 style=\"font-size:15px;\">A document previously sent to you has been cancelled</h1>\n            <p><strong>{company name}</strong> has cancelled the <strong>{contract title}</strong> document.</p>\n            <p>Kind regards, <a href=\"https://www.signable.co.uk\">Signable</a></p>\n          </td>\n        </tr>\n      </table>\n    </td>\n  </tr>\n</table>\n</body>\n","branding_email_content_plain":"A document previously sent to you has been cancelled\n\n{company name} has cancelled the {contract title} document.\n\nKind regards,\nSignable\n\nhttps://www.signable.co.uk\n","branding_email_updated":"2025-07-01T08:40:38+0000"},{"branding_email_type":"email-rejected","branding_email_subject":"{contract title} document rejected","branding_email_content":"<html>...</html>","branding_email_content_plain":"A document you signed has been rejected...","branding_email_updated":"2025-07-01T08:40:38+0000"},{"branding_email_type":"email-reminder","branding_email_subject":"{company name} has sent you a document to sign","branding_email_content":"<body>...</body>","branding_email_content_plain":"{company name} has sent you the document {contract title} to sign online...","branding_email_updated":"2025-07-01T08:40:38+0000"},{"branding_email_type":"email-reminder-password","branding_email_subject":"{company name} has sent you a document to sign","branding_email_content":"<body>...</body>","branding_email_content_plain":"{company name} has also requested this document be password protected...","branding_email_updated":"2025-07-01T08:40:38+0000"},{"branding_email_type":"email-send","branding_email_subject":"{company name} has sent you a document to sign","branding_email_content":"<body>...</body>","branding_email_content_plain":"{client name}, you have been sent a document to sign...","branding_email_updated":"2025-07-01T08:40:38+0000"},{"branding_email_type":"email-send-password","branding_email_subject":"{company name} has sent you a document to sign","branding_email_content":"<body>...</body>","branding_email_content_plain":"{client name}, you've been sent a secure document...","branding_email_updated":"2025-07-01T08:40:38+0000"},{"branding_email_type":"email-signed","branding_email_subject":"Document signed confirmation","branding_email_content":"<body>...</body>","branding_email_content_plain":"You have successfully signed {contract title}...","branding_email_updated":"2025-07-01T08:40:38+0000"},{"branding_email_type":"email-widget-verify","branding_email_subject":"Verify your signed document with {company name}","branding_email_content":"<body>...</body>","branding_email_content_plain":"Please verify your email address to complete signing of {contract title}...","branding_email_updated":"2025-07-01T08:40:38+0000"}]},"key":"success","summary":"Example branding emails response","id":"paths/~1branding~1emails/get/responses/200/content/application~1json/examples/success"},"paths/~1branding~1emails~1{branding_email_type}/get/responses/200/content/application~1json/examples/success":{"value":{"http":200,"branding_email_type":"email-cancelled","branding_email_subject":"{company name} has cancelled a document","branding_email_content":"<body style=\"font-family:Arial,Helvetica,sans-serif;\">\n<table style=\"background:#FFF;font-family:Arial,Helvetica,sans-serif;border-collpase:collapse;width:600px;margin:0 auto;\">\n  <tr>\n    <td>\n      <table style=\"border-collpase:collapse\">\n        <tr>\n          <td style=\"padding:15px 10px 10px\">\n            <a href=\"https://www.signable.co.uk\">\n              <img src=\"{company logo}\" alt=\"{company name}\" />\n            </a>\n          </td>\n        </tr>\n        <tr>\n          <td style=\"padding-top:10px\">\n            <h1 style=\"font-size:15px;\">A document previously sent to you has been cancelled</h1>\n            <p><strong>{company name}</strong> has cancelled the <strong>{contract title}</strong> document.</p>\n            <p>Kind regards, <a href=\"https://www.signable.co.uk\">Signable</a></p>\n          </td>\n        </tr>\n      </table>\n    </td>\n  </tr>\n</table>\n</body>\n","branding_email_content_plain":"A document previously sent to you has been cancelled\n\n{company name} has cancelled the {contract title} document.\n\nKind regards,\nSignable\n\nhttps://www.signable.co.uk\n","branding_email_updated":"2025-07-01T08:40:38+0000"},"key":"success","summary":"Example single branding email response","id":"paths/~1branding~1emails~1{branding_email_type}/get/responses/200/content/application~1json/examples/success"},"paths/~1branding~1emails~1{branding_email_type}/put/requestBody/content/application~1json/examples/default":{"value":{"branding_email_subject":"{company name} has cancelled a test document","branding_email_content":"<body style=\"font-family:Arial,Helvetica,serif;\">\n<table style=\"background:#FFF;font-family:Arial,Helvetica,sans-serif;border-collpase:collapse;width:600px;margin:0 auto;\">\n    <tr>\n        <td>\n            <table style=\"border-collpase:collapse\">\n                <tr>\n                    <td style=\"padding:15px 10px 10px\">\n                        <a href=\"https://www.signable.co.uk\" style=\"font-size:25px;color:#FFF;letter-spacing:-1px;font-weight:normal\">\n                            <img src=\"{company logo}\" alt=\"{company name}\" style=\"border:0;\" />\n                        </a>\n                    </td>\n                </tr>\n                <tr>\n                    <td style=\"padding-top:10px\">\n                        <h1 style=\"font-size:15px;font-weight:normal;color:#444\">A document previously sent to you has been cancelled</h1>\n                        <p style=\"font-size:13px;color:#444;line-height:18px;padding-top:10px\">\n                          <span style=\"font-weight:bold;\">{company name}</span> has cancelled the <span style=\"font-weight:bold;\">{contract title}</span> document.\n                        </p>\n                        <p style=\"font-size:15px;color:#555;margin-top:30px\">\n                          Kind regards, <a href=\"https://www.signable.co.uk\" style=\"color:#555;\">Signable</a>\n                        </p>\n                        <hr style=\"background:#FFF;color:#FFF;border:none;height:0;border-bottom:1px dotted #CCC;\" />\n                    </td>\n                </tr>\n            </table>\n        </td>\n    </tr>\n</table>\n</body>\n","branding_email_content_plain":"A test document previously sent to you has been cancelled\r\n\r\n{company name} has cancelled the {contract title} document.\r\n\r\nKind regards,\r\nSignable\r\n\r\nhttps://www.signable.co.uk"},"key":"default","summary":"Update branding email","id":"paths/~1branding~1emails~1{branding_email_type}/put/requestBody/content/application~1json/examples/default"},"paths/~1branding~1emails~1{branding_email_type}/put/responses/200/content/application~1json/examples/default":{"value":{"http":200,"message":"email-cancelled email has been updated.","branding_email_type":"email-cancelled","branding_email_subject":"{company name} has cancelled a test document","branding_email_content":"<body style=\"font-family:Arial,Helvetica,serif;\">\n<table style=\"background:#FFF;font-family:Arial,Helvetica,sans-serif;border-collpase:collapse;width:600px;margin:0 auto;\">\n    <tr>\n        <td>\n          <table style=\"border-collpase:collapse\">\n              <tr>\n                  <td style=\"padding:15px 10px 10px\">\n                      <a href=\"https://www.signable.co.uk\">\n                          <img src=\"{company logo}\" alt=\"{company name}\" />\n                      </a>\n                  </td>\n              </tr>\n              <tr>\n                  <td style=\"padding-top:10px\">\n                      <h1 style=\"font-size:15px;color:#444;\">A document previously sent to you has been cancelled</h1>\n                      <p style=\"font-size:13px;color:#444;line-height:18px;padding-top:10px\">\n                          <strong>{company name}</strong> has cancelled the <strong>{contract title}</strong> document.\n                      </p>\n                      <p style=\"font-size:15px;color:#555;margin-top:30px\">Kind regards, <a href=\"https://www.signable.co.uk\" style=\"color:#555;\">Signable</a></p>\n                      <hr style=\"background:#FFF;color:#FFF;border:none;height:0;border-bottom:1px dotted #CCC;\" />\n                  </td>\n              </tr>\n          </table>\n        </td>\n    </tr>\n</table>\n</body>\n","branding_email_content_plain":"A test document previously sent to you has been cancelled\r\n\r\n{company name} has cancelled the {contract title} document.\r\n\r\nKind regards,\r\nSignable\r\n\r\nhttps://www.signable.co.uk","branding_email_updated":"2025-07-02T11:44:32+0000"},"key":"default","summary":"Updated branding email response","id":"paths/~1branding~1emails~1{branding_email_type}/put/responses/200/content/application~1json/examples/default"},"paths/~1settings/get/responses/200/content/application~1json/examples/default":{"value":{"http":200,"setting_signature_more_info":true,"setting_signature_format_accepted":"typed,drawn,upload","setting_signature_format_default":"typed","setting_email_pdf_attach":true,"setting_email_pdf_attach_sender":true,"setting_email_envelope_open":true,"setting_email_main_email":true,"setting_email_return_address_user":true,"setting_signing_consumer_regulations_act":false,"setting_signing_tooltips":false,"setting_signing_questions":true,"setting_pdf_audit_trail_hide":true,"setting_all_at_once_default":false},"key":"default","summary":"Example company settings response","id":"paths/~1settings/get/responses/200/content/application~1json/examples/default"},"paths/~1settings/get/responses/401/content/application~1json/examples/missingAuth":{"value":{"http":401,"code":10002,"message":"Authentication failed. Please enter the correct API Key and password."},"key":"missingAuth","summary":"Missing authentication","id":"paths/~1settings/get/responses/401/content/application~1json/examples/missingAuth"},"paths/~1settings/get/responses/401/content/application~1json/examples/invalidAuth":{"value":{"http":401,"code":10002,"message":"Authentication failed. Please enter the correct API Key and password."},"key":"invalidAuth","summary":"Invalid authentication","id":"paths/~1settings/get/responses/401/content/application~1json/examples/invalidAuth"},"paths/~1settings/put/requestBody/content/application~1json/examples/default":{"value":{"setting_signature_more_info":true,"setting_signature_format_accepted":"typed,drawn,upload","setting_signature_format_default":"typed","setting_email_pdf_attach":true,"setting_email_pdf_attach_sender":true,"setting_email_envelope_open":true,"setting_email_main_email":true,"setting_email_return_address_user":true,"setting_signing_consumer_regulations_act":false,"setting_signing_tooltips":false,"setting_signing_questions":true,"setting_pdf_audit_trail_hide":true,"setting_all_at_once_default":false},"key":"default","summary":"Example of an update company settings request payload","id":"paths/~1settings/put/requestBody/content/application~1json/examples/default"},"paths/~1settings/put/responses/200/content/application~1json/examples/updated":{"value":{"http":200,"message":"Signable Ltd settings have been updated.","href":"https://api.signable.co.uk/v1/companies/32275","company_id":"32275","company_name":"Signable Ltd","setting_signature_more_info":true,"setting_signature_format_accepted":"typed,drawn,upload","setting_signature_format_default":"typed","setting_email_pdf_attach":true,"setting_email_pdf_attach_sender":true,"setting_email_envelope_open":true,"setting_email_main_email":true,"setting_email_return_address_user":true,"setting_signing_consumer_regulations_act":false,"setting_signing_tooltips":true,"setting_signing_questions":false,"setting_pdf_audit_trail_hide":true,"setting_all_at_once_default":false},"key":"updated","summary":"A successful update of company settings","id":"paths/~1settings/put/responses/200/content/application~1json/examples/updated"},"paths/~1settings/put/responses/400/content/application~1json/examples/invalidAcceptedSignatureFormat":{"value":{"http":400,"code":10651,"message":"The signature format you have passed in isn't valid. It must be either 'drawn', 'typed' or 'upload'"},"key":"invalidAcceptedSignatureFormat","summary":"Invalid setting_signature_format_accepted","id":"paths/~1settings/put/responses/400/content/application~1json/examples/invalidAcceptedSignatureFormat"},"paths/~1settings/put/responses/401/content/application~1json/examples/missingAuth":{"value":{"http":401,"code":10002,"message":"Authentication failed. Please enter the correct API Key and password."},"key":"missingAuth","summary":"Missing authentication","id":"paths/~1settings/put/responses/401/content/application~1json/examples/missingAuth"},"paths/~1settings/put/responses/401/content/application~1json/examples/invalidAuth":{"value":{"http":401,"code":10002,"message":"Authentication failed. Please enter the correct API Key and password."},"key":"invalidAuth","summary":"Invalid authentication","id":"paths/~1settings/put/responses/401/content/application~1json/examples/invalidAuth"},"paths/~1webhooks/get/responses/200/content/application~1json/examples/default":{"value":{"http":200,"offset":10,"limit":10,"total_webhooks":"44","next":"https://api.signable.co.uk/v1/webhooks?offset=10&limit=10","webhooks":[{"webhook_id":"132223","webhook_url":"https://mylovelyendpointfortesting.free.beeceptor.com","webhook_type":"all","webhook_created":"2019-01-29T18:22:05+0000","webhook_suspended":"2024-07-11T12:21:12+0000","webhook_updated":"2024-07-11T12:21:12+0000"},{"webhook_id":"133097","webhook_url":"https://webhook.site/e9f2c61c-98ec-4277-bef8-cf6bca506583","webhook_type":"send-envelope","webhook_created":"2019-07-29T14:20:40+0000","webhook_suspended":"2024-07-11T12:10:22+0000","webhook_updated":"2024-07-11T12:10:22+0000"},{"webhook_id":"133203","webhook_url":"https://webhook.site/1b225ac0-703d-4d91-ab35-751034157ace","webhook_type":"cancelled-envelope","webhook_created":"2019-08-22T08:38:35+0000","webhook_suspended":"2024-07-17T08:48:02+0000","webhook_updated":"2024-07-17T08:48:02+0000"}]},"key":"default","summary":"Paginated list of webhooks","id":"paths/~1webhooks/get/responses/200/content/application~1json/examples/default"},"paths/~1webhooks/post/requestBody/content/application~1json/examples/default":{"value":{"webhook_url":"https://example.com/webhook","webhook_type":"send-envelope"},"key":"default","summary":"Example of a webhook request payload","id":"paths/~1webhooks/post/requestBody/content/application~1json/examples/default"},"paths/~1webhooks/post/responses/200/content/application~1json/examples/createdWebhook":{"value":{"http":200,"message":"The webhook (https://example.com) has been created","href":"https://api.signable.co.uk/v1/webhooks/152691","webhook_id":"152691","webhook_url":"https://example.com","webhook_type":"all","webhook_created":"2025-06-23T17:15:01+0000"},"key":"createdWebhook","summary":"Example response after creating a webhook","id":"paths/~1webhooks/post/responses/200/content/application~1json/examples/createdWebhook"},"paths/~1webhooks~1{webhook_id}/get/responses/200/content/application~1json/examples/default":{"value":{"http":200,"webhook_id":152691,"webhook_url":"https://example.com","webhook_type":"all","webhook_created":"2025-06-23T17:15:01+0000","webhook_updated":null,"webhook_suspended":null},"key":"default","summary":"Example of a single webhook fetched by ID","id":"paths/~1webhooks~1{webhook_id}/get/responses/200/content/application~1json/examples/default"},"paths/~1webhooks~1{webhook_id}/put/requestBody/content/application~1json/examples/webhookUrlOnly":{"value":{"webhook_url":"https://example.com/updated-webhook"},"key":"webhookUrlOnly","summary":"Example of updating only the webhook URL","id":"paths/~1webhooks~1{webhook_id}/put/requestBody/content/application~1json/examples/webhookUrlOnly"},"paths/~1webhooks~1{webhook_id}/put/requestBody/content/application~1json/examples/webhookTypeOnly":{"value":{"webhook_type":"signed-envelope"},"key":"webhookTypeOnly","summary":"Example of updating only the webhook type","id":"paths/~1webhooks~1{webhook_id}/put/requestBody/content/application~1json/examples/webhookTypeOnly"},"paths/~1webhooks~1{webhook_id}/put/requestBody/content/application~1json/examples/bothFields":{"value":{"webhook_url":"https://example.com/updated-webhook","webhook_type":"signed-envelope"},"key":"bothFields","summary":"Example of updating both the webhook URL and webhook type","id":"paths/~1webhooks~1{webhook_id}/put/requestBody/content/application~1json/examples/bothFields"},"paths/~1webhooks~1{webhook_id}/put/responses/200/content/application~1json/examples/updated":{"value":{"http":200,"message":"The webhook with ID 152691 has been updated","href":"https://api.signable.co.uk/v1/webhooks/152691","webhook_id":152691,"webhook_secret":"whsec_example_redacted","webhook_url":"https://abby-example.com","webhook_type":"all","webhook_updated":"2025-06-24T09:32:55+0000"},"key":"updated","summary":"Example response from updating a webhook","id":"paths/~1webhooks~1{webhook_id}/put/responses/200/content/application~1json/examples/updated"},"paths/~1webhooks~1{webhook_id}/delete/responses/200/content/application~1json/examples/deleted":{"value":{"http":200,"message":"The webhook (https://abby-example.com) has been removed from your account.","webhook_id":152691,"webhook_url":"https://abby-example.com","webhook_type":"all"},"key":"deleted","summary":"Example response after deleting a webhook","id":"paths/~1webhooks~1{webhook_id}/delete/responses/200/content/application~1json/examples/deleted"},"paths/send-envelope/post/requestBody/content/application~1x-www-form-urlencoded/example":{"value":{"envelope_fingerprint":"584ea8b41b0d4c17a96b967433b211e6","envelope_documents":"[{\"document_title\":\"Untitled document\",\"document_fingerprint\":\"584ea8b41b0d4c17a96b967433b211e6\",\"document_pdf\":\"https://api.signableapi.com/shareable/document?t=03cbb315-4f68-400d-a5cc-c2884996d061\",\"document_download\":\"https://api.signableapi.com/shareable/document?t=03cbb315-4f68-400d-a5cc-c2884996d061\"}]","envelope_download":"https://api.signableapi.com/shareable/envelope?t=03cbb315-4f68-400d-a5cc-c2884996d061","envelope_signing_embed":"<iframe src=\"https://sign.signable.app/#2KnUUnVQTxtkpV8rmWqem9qXpvaTU2hYLHHyQD7WtdQ\" width=\"100%\" height=\"95%\" frameborder=\"0\" style=\"border: 0; overflow: hidden\"></iframe>","contact_id":14029945,"contact_name":"Abby Smith","contact_email":"abby@signable.co.uk","action":"send-envelope","action_date":"2025-06-20T15:50:10+00:00","envelope_meta":""},"id":"paths/send-envelope/post/requestBody/content/application~1x-www-form-urlencoded/example"},"paths/signed-envelope/post/requestBody/content/application~1x-www-form-urlencoded/example":{"value":{"envelope_fingerprint":"584ea8b41b0d4c17a96b967433b211e6","envelope_documents":"[{\"document_title\":\"Make Tests\",\"document_fingerprint\":\"584ea8b41b0d4c17a96b967433b211e6\",\"document_pdf\":\"https://api.signableapi.com/shareable/document?t=03cbb315-4f68-400d-a5cc-c2884996d061\",\"document_download\":\"https://api.signableapi.com/shareable/document?t=03cbb315-4f68-400d-a5cc-c2884996d061\"}]","envelope_fields":"[{\"field_id\":458946901,\"field_name\":\"Untitled\",\"field_type\":\"text\",\"field_value\":\"1st Aug\"}]","envelope_download":"https://api.signableapi.com/shareable/envelope?t=03cbb315-4f68-400d-a5cc-c2884996d061","contact_id":7418454,"contact_name":"Abby","contact_email":"abby@signable.co.uk","company_id":64034,"user_id":267199,"signature_fingerprint":"584ea8b41b0d4c17a96b967433b211e6","client_ip":"87.177.50.205","envelope_meta":"","action":"signed-envelope","action_date":"2025-08-01T14:37:47+00:00"},"id":"paths/signed-envelope/post/requestBody/content/application~1x-www-form-urlencoded/example"},"paths/cancelled-envelope/post/requestBody/content/application~1x-www-form-urlencoded/example":{"value":{"envelope_fingerprint":"584ea8b41b0d4c17a96b967433b211e6","envelope_title":"tagstest - Copy","action":"cancelled-envelope","action_date":"2025-08-06T12:59:03+00:00","envelope_meta":"","company_id":64034,"user_id":267199,"client_ip":"203.0.113.42"},"id":"paths/cancelled-envelope/post/requestBody/content/application~1x-www-form-urlencoded/example"},"paths/signed-envelope-complete/post/requestBody/content/application~1x-www-form-urlencoded/example":{"value":{"envelope_fingerprint":"584ea8b41b0d4c17a96b967433b211e6","envelope_documents":"[{\"document_title\":\"Word Doc\",\"document_fingerprint\":\"584ea8b41b0d4c17a96b967433b211e6\",\"document_pdf\":\"https://api.signableapi.com/shareable/document?t=03cbb315-4f68-400d-a5cc-c2884996d061\",\"document_download\":\"https://api.signableapi.com/shareable/document?t=03cbb315-4f68-400d-a5cc-c2884996d061\"}]","envelope_download":"https://api.signableapi.com/shareable/envelope?t=03cbb315-4f68-400d-a5cc-c2884996d061","envelope_fields":"[{\"field_id\":460133805,\"field_name\":\"Untitled\",\"field_type\":\"text\",\"field_value\":\"Test\"}]","envelope_meta":"","action":"signed-envelope-complete","action_date":"2025-08-07T10:14:33+00:00","company_id":64034,"user_id":267199,"client_ip":"203.0.113.17"},"id":"paths/signed-envelope-complete/post/requestBody/content/application~1x-www-form-urlencoded/example"}},"securitySchemeStore":{"basicAuth":{"id":"basicAuth","type":"http","scheme":"basic","description":"Authenticate using HTTP Basic Authentication. Use your API key as the username and the password can be anything. For ease of use we recommend \"x\".\n"}},"servers":[{"url":"https://api.signable.co.uk/v1","description":"Production server"}]},"options":{"hideSidebar":true,"mockServer":{"off":true},"disableRouter":true,"downloadUrls":[{"url":"/_bundle/openapi.json?download"},{"url":"/_bundle/openapi.yaml?download"}],"excludeFromSearch":false,"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"Signable API","description":"The Signable API provides secure and efficient access to Signable's electronic signature platform. With this RESTful API, you can send documents for signature, manage templates, track envelope status, and automate your document workflows from within your own applications.\n","showLastModified":true}},"baseSlug":"/openapi","routesMapping":{}}