Skip to main content
POST
/
api
/
v1
/
external
/
{kitSlug}
Start a run
curl --request POST \
  --url https://rts-builder.slayers.tech/api/v1/external/{kitSlug} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "inputs": {
    "target": "example.com"
  }
}
'
{
  "message": "run started",
  "run": {
    "id": "86fb79ef-f82c-4e8b-b8ab-23d0ccbff71b",
    "kit_id": "8d4be855-4208-40c7-9435-df8e2b35f8ad",
    "kit_version": 1,
    "status": "pending",
    "inputs": {
      "target": "techslayers.ca"
    },
    "use_proxy": false,
    "created_at": "2026-03-29T02:31:49.292757Z"
  }
}

​
Start run

​
Request body

The public contract expects an inputs object. The exact input names depend on the exposed kit’s runtime variables.

​
Success shape

The external success payload could not be verified directly because the live environment rejected POST /api/v1/external/{kit_slug} for both:
  • the original user-provided key
  • a newly created team API key in the same tenant as an exposed kit
The schema rendered above is therefore based on the internally verified builder run-start payload and is labeled as inferred in the OpenAPI document.

Authorizations

​
X-API-Key
string
header
required

Team-scoped RTS Builder API key.

Path Parameters

​
kitSlug
string
required

Kit slug shown in RTS Builder.

Example:

"external-api-docs-probe"

Body

application/json
​
inputs
object
required

Runtime variable values keyed by kit variable name.

Example:
{ "target": "example.com" }

Response

Run started. Response body shape is inferred, not externally verified.

Observed on the internal /api/kits/{id}/run endpoint. Expected to be close to the external response, but not externally verified as of March 29, 2026 UTC.

​
message
string
required
Example:

"run started"

​
run
object
required