Roles

get

Return a list of all available permissions.

Authorizations

Responses

200

Success

403

Access denied.

application/json

404

Record not found.

application/json

500

A generic exception has occurred.

application/json

get

HTTPcURLJavaScriptPython

GET /api/admin/permissions HTTP/1.1
Host: listen.dovafm.xyz
X-API-Key: YOUR_API_KEY
Accept: */*

No content

get

List all current roles in the system.

Authorizations

Responses

200

Success

application/json

Responseall of[]

404

Record not found.

application/json

500

A generic exception has occurred.

application/json

get

HTTPcURLJavaScriptPython

GET /api/admin/roles HTTP/1.1
Host: listen.dovafm.xyz
X-API-Key: YOUR_API_KEY
Accept: */*

[
  {
    "id": 1,
    "name": "Super Administrator",
    "permissions": []
  }
]

post

Create a new role.

Authorizations

Body

all ofOptional

Responses

200

Success

application/json

Responseall of

404

Record not found.

application/json

500

A generic exception has occurred.

application/json

post

HTTPcURLJavaScriptPython

POST /api/admin/roles HTTP/1.1
Host: listen.dovafm.xyz
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 54

{
  "id": 1,
  "name": "Super Administrator",
  "permissions": []
}

{
  "id": 1,
  "name": "Super Administrator",
  "permissions": []
}

get

Retrieve details for a single current role.

Authorizations

Path parameters

idinteger · int64Required

Role ID

Responses

200

Success

application/json

Responseall of

403

Access denied.

application/json

404

Record not found.

application/json

500

A generic exception has occurred.

application/json

get

HTTPcURLJavaScriptPython

GET /api/admin/role/{id} HTTP/1.1
Host: listen.dovafm.xyz
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "id": 1,
  "name": "Super Administrator",
  "permissions": []
}

put

Update details of a single role.

Authorizations

Path parameters

idinteger · int64Required

Role ID

Body

all ofOptional

Responses

200

Success

application/json

403

Access denied.

application/json

404

Record not found.

application/json

500

A generic exception has occurred.

application/json

put

HTTPcURLJavaScriptPython

PUT /api/admin/role/{id} HTTP/1.1
Host: listen.dovafm.xyz
X-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 54

{
  "id": 1,
  "name": "Super Administrator",
  "permissions": []
}

{
  "success": true,
  "message": "Changes saved successfully.",
  "formatted_message": "<b>Changes saved successfully.</b>"
}

delete

Delete a single role.

Authorizations

Path parameters

idinteger · int64Required

Role ID

Responses

200

Success

application/json

403

Access denied.

application/json

404

Record not found.

application/json

500

A generic exception has occurred.

application/json

delete

HTTPcURLJavaScriptPython

DELETE /api/admin/role/{id} HTTP/1.1
Host: listen.dovafm.xyz
X-API-Key: YOUR_API_KEY
Accept: */*

{
  "success": true,
  "message": "Changes saved successfully.",
  "formatted_message": "<b>Changes saved successfully.</b>"
}