Skip to main content
PATCH
/
api
/
snoozes
/
{id}
Update Snooze
curl --request PATCH \
  --url https://dash.empirical.run/api/snoozes/{id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "snooze_until": "<string>",
  "description": "<string>",
  "expire_now": true,
  "scoped_to_environment_id": 123,
  "test_ids": [
    "<string>"
  ]
}
'
{
  "data": {
    "snooze": {
      "id": 12,
      "test_ids": [
        "a30a6eba6312f6b87ea5-55e241fbe3f4b8ae61ee"
      ],
      "snooze_until": "2026-05-01T00:00:00.000Z",
      "description": "Extended — fix delayed to next sprint",
      "created_from_test_run_id": 456,
      "created_by": null,
      "created_at": "2026-03-15T10:30:00.000Z",
      "updated_at": "2026-03-20T14:00:00.000Z",
      "scoped_to_environment_id": null
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.empirical.run/llms.txt

Use this file to discover all available pages before exploring further.

Updates an existing snooze. Use this to extend, expire, or modify a snooze.

​
Examples

{
  "data": {
    "snooze": {
      "id": 12,
      "test_ids": [
        "a30a6eba6312f6b87ea5-55e241fbe3f4b8ae61ee"
      ],
      "snooze_until": "2026-05-01T00:00:00.000Z",
      "description": "Extended — fix delayed to next sprint",
      "created_from_test_run_id": 456,
      "created_by": null,
      "created_at": "2026-03-15T10:30:00.000Z",
      "updated_at": "2026-03-20T14:00:00.000Z",
      "scoped_to_environment_id": null
    }
  }
}

​
Extend snooze duration

curl -X PATCH \
  https://dash.empirical.run/api/snoozes/12 \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $EMPIRICALRUN_KEY" \
  -d '{
    "snooze_until": "2026-05-01T00:00:00.000Z"
  }'

​
Expire a snooze

curl -X PATCH \
  https://dash.empirical.run/api/snoozes/12 \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $EMPIRICALRUN_KEY" \
  -d '{
    "expire_now": true
  }'

​
Update description

curl -X PATCH \
  https://dash.empirical.run/api/snoozes/12 \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $EMPIRICALRUN_KEY" \
  -d '{
    "description": "Extended — fix delayed to next sprint"
  }'

Path Parameters

​
id
integer
required

Snooze ID.

Required range: -9007199254740991 <= x <= 9007199254740991

Body

application/json

Request body.

​
snooze_until
string

ISO 8601 timestamp for when the snooze should expire.

​
description
string

Description explaining why the tests are snoozed.

​
expire_now
boolean

Set to true to immediately expire the snooze.

​
scoped_to_environment_id
number | null

Environment ID to scope the snooze to. Set to null to apply to all environments.

​
test_ids
string[]

Updated array of Playwright test IDs to snooze.

Response

Updated snooze.

​
data
object
required

Updated snooze.