---
title: "Execute a test"
method: POST
path: "/api/tests/{id}/execute"
tags: ["Tests"]
---

# Execute a test

`POST /api/tests/{id}/execute`

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.

## Request body

- object
  - `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 `200`

Test execution started

- object
  - `success` boolean
  - `runId` string, uuid
  - `message` string

## Other responses

- `401` — Authentication required or token invalid
- `404` — Resource not found

---

[API](https://skmtc.dev/supercheck-io/apis/supercheck-api.md) · [All operations](https://skmtc.dev/supercheck-io/apis/supercheck-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/supercheck-io/supercheck-api/revisions/81782deccf0e/schema)