Project roles

GET

/project/{id}/roles

const url = 'https://testomato.com/api/project/5e9602e7a39e5a46428b457f/roles';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://testomato.com/api/project/5e9602e7a39e5a46428b457f/roles \
  --header 'Authorization: Bearer <token>'

Get an array of project roles

Authorizations

ApiToken

Parameters

Path Parameters

required

string

A unique project ID

Example

5e9602e7a39e5a46428b457f

Responses

200

List of Project Areas/Groups

application/json

Array<object>

object

string

users_id

string format: nullable

name

string

permissions

Array<string>

systemRole

boolean

permissionsSwitches

Project permissions for current user

object

read

Can the current user view results?

boolean

run

Can the current user run checks?

boolean

editTest

Can the current user edit tests?

boolean

edit

Can the current user edit project settings?

boolean

manageUsers

Can the current user manage other users?

boolean

default: true

apiKey

Can the current user view the API key?

boolean

default: true

leave

Can the current user leave the project?

boolean

default: true

Example

[
  {
    "id": 4,
    "name": "project admin",
    "permissions": [
      [
        "read",
        "run",
        "editTests",
        "edit",
        "manageUsers",
        "apiKey"
      ]
    ],
    "systemRole": true,
    "permissionsSwitches": {
      "manageUsers": true,
      "apiKey": true,
      "leave": true
    }
  }
]

401

The API token is missing, malformed or expired. Request a new one from POST /api/authenticate.

application/json

object

message

Error message text

string

default: Access denied! Please log in to access this resource.

code

Error code number

integer

default: 401

boolean

error

boolean

default: true

Example

{
  "message": "Access denied! Please log in to access this resource.",
  "code": 401,
  "ok": false,
  "error": true
}

403

The token is valid but the operation is not allowed. Two distinct causes:

the subscription plan does not include API access — every endpoint returns this, regardless of the resource
the account lacks the required role on the project — reading needs read, changing checks needs editTests, and so on. See Project permissions.

application/json

object

message

Error message text

string

default: Sorry! Your current plan does not support access to Testomato API.

code

Error code number

integer

default: 403

boolean

error

boolean

default: true

Example

{
  "message": "Sorry! Your current plan does not support access to Testomato API.",
  "code": 403,
  "ok": false,
  "error": true
}