esign_requirements_not_met (403)

← Error reference

esign_requirements_not_met

HTTP status: 403

Retryable: No. Retrying without changes will fail the same way.

The workflow cannot run the document signing step it was given.

When it fires

A create or update of a workflow template, or a session create, resolved a workflow whose `esign` step outruns the workflow that would execute it. `details.reason` names the exact rule: the named document version is not published, the workflow has two signing steps, signing is ordered before identity verification, the document places a variable only identity verification supplies, or it places a collected input the workflow never gathers. The refusal is authoring-time on purpose - a document a signer could never complete must not reach one.

How to handle it

Read `details.reason`, then fix the workflow or the document and retry. Publish the document version, remove the second signing step, move the signing step after identity verification, or add the step that supplies the missing value. Retrying the same request unchanged will produce the same response.

Example response

{
  "error": {
    "type": "https://docs.checktiv.com/api/errors/esign_requirements_not_met",
    "code": "esign_requirements_not_met",
    "message": "The document signing step cannot run in this workflow.",
    "request_id": "req_01HEXAMPLE0000000000000000",
    "doc_url": "https://docs.checktiv.com/api/errors/esign_requirements_not_met"
  }
}