Remove users from project

DELETE

/project/{id}/users

const url = 'https://testomato.com/api/project/5e9602e7a39e5a46428b457f/users';
const options = {
  method: 'DELETE',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"users":[4211,4212]}'
};

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

curl --request DELETE \
  --url https://testomato.com/api/project/5e9602e7a39e5a46428b457f/users \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "users": [ 4211, 4212 ] }'

Revoke access for one or more accounts. The project owner cannot be removed this way — delete the project instead.

Authorizations

ApiToken

Parameters

Path Parameters

required

string

A unique project ID

Example

5e9602e7a39e5a46428b457f

Request Body

application/json

object

users

required

IDs of the users to remove

Array<integer>

Example

{
  "users": [
    4211,
    4212
  ]
}

Responses

200

Common success message

application/json

object

message

string

code

integer

default: 200

boolean

default: true

error

boolean

Example

{
  "code": 200,
  "ok": true,
  "error": false
}

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
}

404

Object not found error

application/json

object

message

Error message text

string

default: Object not found

code

Error code number

integer

default: 404

boolean

error

boolean

default: true

Example

{
  "message": "Object not found",
  "code": 404,
  "ok": false,
  "error": true
}