Signatures

Signature Create

POST
/signatures/signature/create

Creates and stores a user's signature in the Storage system.

  • The signature is represented as a Base64-encoded image (e.g., PNG or JPG).
  • Each signature is assigned a unique ID, which can be used in other operations to reference the signature.
  • Users can save multiple signatures and optionally designate one as the default for the signing process.

Authorization

AuthorizationBearer <token>

JWT token to authenticate the request.

In: header

X-Api-Key<token>

API key, sent as a request header.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/signatures/signature/create" \  -H "Content-Type: application/json" \  -d '{    "signature": {      "value": "data:image/png;base64,iVBORw0KGgo...",      "isDefault": true    }  }'
{  "signature": {    "id": "123e4567-e89b-12d3-a456-426614174000",    "message": "Signature saved."  }}
{  "error": {    "message": "Envelope not found.",    "statusCode": 400,    "innerErrors": [      {        "code": "ENVELOPE_ID_INVALID",        "message": "Envelope not found.",        "userMessage": "Envelope not found."      }    ]  },  "origin": "POST https://api.doctavian.com/v1/signatures/signature/create",  "dateTime": "2026-07-20T12:00:00.000Z",  "userId": "f15d5af1-17c2-42ba-aa76-eb312e52a139",  "operationId": "56933c86d01bff6828a22ebbbac7ab35"}
{  "error": {    "message": "Envelope not found.",    "statusCode": 500,    "innerErrors": [      {        "code": "ENVELOPE_ID_INVALID",        "message": "Envelope not found.",        "userMessage": "Envelope not found."      }    ]  },  "origin": "POST https://api.doctavian.com/v1/signatures/signature/create",  "dateTime": "2026-07-20T12:00:00.000Z",  "userId": "dd9bc11a-942a-46a2-bbde-a3e545c50863",  "operationId": "df416b40f7e32c28db56d167b286d7a4"}