Skip to content
SupaCloud Docs
Select themeSelect language

`GET /api/scripts/{id}/runs` — the recent standalone runs of a script, newest first (#626 §13). The run panel renders this history alongside the live run it polls after a `POST .../run`. Tenancy-checks the script first (404 for an unknown id / wrong workspace).

GET
/api/scripts/{id}/runs
curl --request GET \
  --url https://example.com/api/scripts/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/runs

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
id
required
string format: uuid

Query Parameters

Section titled “Query Parameters”
limit
integer format: int64

Max rows (default 20, capped server-side at 100).

Responses

Section titled “Responses”

200

Section titled “200”
Media typeapplication/json
Array<object>

#626 §13 — one recent standalone-script run for the run panel. A compact summary of a kind='script' run row: the run id + status + timestamps, the failure message (if any) and the script’s structured result JSON (null while still running). The run panel polls the run row for the live result; this list shows the recent history.

object
created_at
required
string format: date-time
error_message
string | null
finished_at
string | null format: date-time
result
required
run_id
required
string format: uuid
status
required
string
Examplegenerated
[
  {
    "created_at": "2026-04-15T12:00:00Z",
    "error_message": "example",
    "finished_at": "2026-04-15T12:00:00Z",
    "result": "example",
    "run_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "status": "example"
  }
]

404

Section titled “404”

Unknown script id / wrong workspace

Media typeapplication/json

The canonical JSON body of every error response — the single source of truth the frontend binds to. Every AppError serializes as this exact shape, and the generated OpenAPI component ApiErrorBody (with its ErrorCode enum) is what the frontend error schema is generated from, so there is no hand-written error schema on either end.

object
code
required

Machine-readable, stable error code.

string
Allowed values: not_found unauthorized forbidden bad_request unprocessable precondition_failed conflict method_not_allowed rate_limited quota_exceeded database_error docker_error vault_error internal_error
details
One of:
null
error
required

Human-readable message (the server’s English text; the client may localize by code).

string
Example
{
  "code": "not_found"
}