Update notifications

POST

/project/{id}/notifications

const url = 'https://testomato.com/api/project/5e9602e7a39e5a46428b457f/notifications';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"email":true,"slack":false,"webPush":true}'
};

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

curl --request POST \
  --url https://testomato.com/api/project/5e9602e7a39e5a46428b457f/notifications \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "email": true, "slack": false, "webPush": true }'

Update project notification settings for the current user

Authorizations

ApiToken

Parameters

Path Parameters

required

string

A unique project ID

Example

5e9602e7a39e5a46428b457f

Request Body

application/json

object

severity

1 - only errors (default)
3 - error and timeouts

integer format: int32

default: 1

email

Whether to send email notifications

boolean

pagerduty

Send PagerDuty notifications

boolean

pushover

Send Pushover notifications

boolean

pushbullet

Send PushBullet notifications

boolean

slack

Send Slack notifications

boolean

Example

{
  "email": true,
  "slack": false,
  "webPush": true
}

Responses

200

Notification settings response

application/json

object

severity

1 - only errors (default)
3 - error and timeouts

integer format: int32

default: 1

email

Whether to send email notifications

boolean

pagerduty

Send PagerDuty notifications

boolean

pushover

Send Pushover notifications

boolean

pushbullet

Send PushBullet notifications

boolean

slack

Send Slack notifications

boolean

Example

{
  "severity": 1,
  "email": true,
  "pagerduty": true,
  "pushover": true,
  "pushbullet": true,
  "slack": 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
}