Authorize signature

post

https://api.ext-sandbox.fourthline.com/v2/workflows/{workflowId}/signatures/authorize

Use this endpoint to authorize documents for signing by validating document hashes. This starts the authorization process.

Path Params

workflowId

uuid

required

The unique identifier of the workflow (signature) to authorize.

Format: uuid

Example: 790f325a-48c9-4b82-bb53-c0ea128236f0

Query Params

lang

string

enum

The language used for the SMS one-time passcode (OTP).

Format: ISO 639-1 alpha-2
Enum:
• cs: Czech
• de: German
• en: English (default)
• es: Spanish
• fi: Finnish
• fr: French
• it: Italian
• nl: Dutch
• pl: Polish
• sk: Slovak.

Body Params

authorizedDocuments

array of objects

required

The documents to authorize with content hashes.

authorizedDocuments*

legalDocumentsAccepted

array of objects

The legal documents the signer accepted (optional; each item requires id and version; url and text are optional).

legalDocumentsAccepted

Headers

Authorization

string

required

Defaults to Bearer <access_token>

The access_token returned in your most recent Create access token response.

Cache-Control

string

Defaults to no-cache

To have the response validated by the origin server instead of reusing stored content, we strongly recommend including this parameter and setting it to no-cache.

Responses

202The authorization request was accepted and processing started

400Invalid request parameters

404The specified workflow/signature was not found

409The authorized documents do not match the documents to sign

429The number of retry attempts has been exceeded