Supercheck LogoSupercheck
Tests API

Execute a test

Execute a single test immediately. Creates a run and enqueues the test for execution. For k6 performance tests, an optional location can target an enabled location code or global for unrestricted any-worker routing.

POST
/api/tests/{id}/execute

Authorization

bearerAuth
AuthorizationBearer <token>

CLI token (sck_live_*) for full API access, or trigger key (sck_trigger_* / legacy job_*) for job trigger endpoint only.

In: header

Path Parameters

id*string

Test ID

Formatuuid

Request Body

application/json

location?string

Execution location for k6 performance tests. Use an enabled location code (for example us-east) or global for unrestricted any-worker routing. global is rejected when project location restrictions are enabled.

Response Body

application/json

application/json

application/json

curl -X POST "https://demo.supercheck.dev/api/tests/497f6eca-6276-4993-bfeb-53cbbbba6f08/execute" \  -H "Content-Type: application/json" \  -d '{}'
{
  "success": true,
  "runId": "78c33d18-170c-44d3-a227-b3194f134f73",
  "message": "string"
}
{
  "error": "Unauthorized"
}
{
  "error": "Not found"
}