DKBSignDocs

API reference

POSTRequires Bearer token

Create role

/api/v1/roles

Company-admin. modules is an array of enabled module ids; empty means full access.

Path parameters

This endpoint has no path parameters.

Query parameters

This endpoint has no query parameters.

Request body

FieldTypeDescription
name
Required
stringRole name (unique per company).
e.g. "Manager"
description
stringRole description.
e.g. "Approves envelopes"
modules
arrayEnabled module ids. Empty = full access.

Responses

StatusMeaning
201Role created
401Missing or invalid Bearer token.

Request

curl
curl -X POST 'https://api.dkbsigns.com/api/v1/roles' \
  -H 'Authorization: Bearer $DKBSIGN_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Manager","description":"Approves envelopes"}'

Response 201

json
{
  "status": "success",
  "message": "Role created",
  "data": {
    "id": 3,
    "name": "Manager"
  }
}