DKBSignDocs

API reference

PUTRequires Bearer token

Replace role

/api/v1/roles/{role}

Update /api/v1/roles/{role}. Authenticated routes need Authorization: Bearer {token} from POST /api/v1/login.

Path parameters

FieldTypeDescription
role
Required
stringPath parameter role.

Query parameters

This endpoint has no query parameters.

Request body

FieldTypeDescription
name
stringRole name (unique per company).
e.g. "Manager"
description
stringRole description.
modules
arrayEnabled module ids.

Responses

StatusMeaning
200Role updated
401Missing or invalid Bearer token.

Request

curl
curl -X PUT 'https://api.dkbsigns.com/api/v1/roles/role' \
  -H 'Authorization: Bearer $DKBSIGN_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Manager","description":"example","modules":[1]}'

Response 200

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