POSTRequires Bearer token

Create role

/api/v1/roles

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

Path parameters

This endpoint has no path parameters.

Query parameters

This endpoint has no query parameters.

Request body

Field	Type	Description
name Required	string	Role name. e.g. "Manager"
description	string	Role description.

Responses

Status	Meaning
500	See the example response.

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"}'

Response 200

json

{
  "status": "success",
  "message": "Upstream response is forwarded unchanged."
}