Sign in

v18

latestOpenAPI 3.0.32026-08-07378889.6 MB
checks

Update a check

Update an existing check. This endpoint must be called with an OAuth2 or it will produce a 400 error.

patch/v1/deployments/{deploymentId}/checks/{checkId}

Path parameters

deploymentIdstring required

The deployment to update the check for.

Example:dpl_2qn7PZrx89yxY34vEZPD31Y9XVj6

The deployment to update the check for.

checkIdstring required

The check being updated

Example:check_2qn7PZrx89yxY34vEZPD31Y9XVj6

The check being updated

Query parameters

teamIdstring
Example:team_1a2b3c4d5e6f7g8h9i0j1k2l

The Team identifier to perform the request on behalf of.

slugstring
Example:my-team-url-slug

The Team slug to perform the request on behalf of.

Request body

namestring

The name of the check being created

pathstring

Path of the page that is being checked

status'running' | 'completed'

The current status of the check

conclusion'canceled' | 'failed' | 'neutral' | 'succeeded' | 'skipped'

The result of the check being run

detailsUrlstring

A URL a user may visit to see more information about the check

externalIdstring

An identifier that can be used as an external reference

Example request

{
  "name": "Performance Check",
  "path": "/",
  "detailsUrl": "https://example.com/check/run/1234abc",
  "output": {
    "metrics": {
      "FCP": {
        "value": 1200,
        "previousValue": 900
      },
      "LCP": {
        "value": 1200,
        "previousValue": 1000
      },
      "CLS": {
        "value": 4,
        "previousValue": 2
      },
      "TBT": {
        "value": 3000,
        "previousValue": 3500
      },
      "virtualExperienceScore": {
        "value": 30,
        "previousValue": 35
      }
    }
  },
  "externalId": "1234abc"
}

Response

idstring required
namestring required
createdAtnumber required
updatedAtnumber required
deploymentIdstring required
status'completed' | 'registered' | 'running' required
conclusion'canceled' | 'failed' | 'neutral' | 'skipped' | 'stale' | 'succeeded'
externalIdstring
completedAtnumber
pathstring
blockingfalse | true required
detailsUrlstring
integrationIdstring required
startedAtnumber
rerequestablefalse | true