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
headerAuthorizationBearer <token>

Project-scoped CLI token (sck_live_* or sck_test_*) for documented API operations that accept bearer authentication. Interactive browser operations may require a session cookie. Trigger keys (sck_trigger_* / legacy job_*) are accepted only by job trigger endpoints.

Path Parameters

id*string

Test ID

Formatuuid

Request Body

application/json
  1. body
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

Test execution started

application/json
  1. response
runId?string
Formatuuid
status?string
Value in"running""queued"
position?integer

Queue position when the test is queued; omitted when it starts immediately.

Range0 <= value
testType?string
Value in"browser""api""performance""database""custom"
location?string

Resolved execution location for performance tests; omitted for other test types.

Example Request
curl -X POST 'https://demo.supercheck.dev/api/tests/497f6eca-6276-4993-bfeb-53cbbbba6f08/execute' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "runId": "78c33d18-170c-44d3-a227-b3194f134f73",  "status": "running",  "position": 0,  "testType": "browser",  "location": "string"}