Lists every role, by name.

GET

/api/v1/admin/roles

Errors

401 when nothing was signed in, 403 when the caller may not read roles or used a bearer token, 404 when this instance has no administration.

Authorization

session

cookietessera_session<token>

Set by POST /auth/login. A browser sends it automatically; it is HttpOnly, so page scripts cannot read or set it.

Response Body

Every role on this instance

application/json

response

[index: integer]?

One role, as the API describes it.

curl -X GET 'https://example.com/api/v1/admin/roles'

[  {    "created_at": "string",    "description": "string",    "id": "string",    "is_system": true,    "max_file_bytes": 0,    "members": 0,    "name": "string",    "permissions": [      "string"    ],    "quota_bytes": 0,    "updated_at": "string"  }]