POSTRequires Bearer token

Create a signature image

/api/v1/signatures

Upload a personal signature. Multipart. Max 50 MB. Setting default to true makes this the default appearance.

Path parameters

This endpoint has no path parameters.

Query parameters

This endpoint has no query parameters.

Request body

Send as multipart/form-data.

Field	Type	Description
type Required	string	`image`, `draw`, or `text`. e.g. "image"
filename Required	string	Signature image. e.g. "example"
default	boolean	Use as the default signature. e.g. true

Responses

Status	Meaning
201	Signature created
401	Missing or invalid Bearer token.

Request

curl

curl -X POST 'https://api.dkbsigns.com/api/v1/signatures' \
  -H 'Authorization: Bearer $DKBSIGN_TOKEN' \
  -H 'Accept: application/json' \
  -F 'type=image' \
  -F 'filename=example' \
  -F 'default=true'

Response 201

json

{
  "status": "success",
  "message": "Signature created",
  "data": {
    "id": 9,
    "type": "image",
    "default": true,
    "filename": "https://files.example/sig.png",
    "user_id": 4
  }
}