`GET /api/scripts/board` — one server-paginated, language-filtered page of the scripts board plus the total + the per-language facets.

GET

/api/scripts/board

curl --request GET \
  --url https://example.com/api/scripts/board

Parameters

Query Parameters

language

string

Language tab: typescript / javascript / python (else all).

status

string

Last-run-status facet chip: keep only scripts whose latest standalone run has this status.

q

string

Free-text search over the script name + description.

sort

string

Whitelisted sort column: name | language | created_at | updated_at | ref_count | last_run_at. Default name.

dir

string

asc | desc (default asc — the board is name-sorted A-Z).

limit

integer format: int64

offset

integer format: int64

include_facets

boolean

Recompute the per-language facets (default true). The board sends false for a tab/page change (the counts depend only on the workspace).

Responses

200

Media typeapplication/json

GET /api/scripts/board body — one page of scripts + total + facets.

object

facets

One of:

null

null

object

Per-language NavTab/chip counts over the whole workspace (the all-tab total

• the TS/JS/PY counts), independent of the active tab.

object

by_status

required

Script counts by their latest standalone run’s status (the last-run-status facet).

Array<object>

One filter-chip value and its count. Counts are workspace-wide (independent of the active filter — the chip totals do not shift as the user filters).

object

count

required

How many rows fall in this bucket.

integer format: int64

value

required

The bucket value (e.g. a scope, a role, a framework).

string

javascript

required

integer format: int64

python

required

integer format: int64

total

required

integer format: int64

typescript

required

integer format: int64

items

required

Array<object>

Lightweight list-row view — drops source so a workspace with hundreds of scripts does not balloon the list-API payload. The detail GET still returns the full ScriptView with the source.

object

created_at

required

string format: date-time

description

string | null

id

required

string format: uuid

language

required

string

last_exit_code

integer | null format: int64

last_run_at

string | null format: date-time

last_run_status

string | null

latest_version

#358: latest committed script_revisions.version_number; None when the script has no revisions beyond its inline source (row renders no version).

integer | null format: int32

name

required

string

ref_count

#358 board rollups. ref_count = distinct workflows referencing this script via a code node script_ref; the last_run_* trio is the most recent standalone (kind='script') run. Default/empty for a fresh row.

integer format: int64

slug

required

string

updated_at

required

string format: date-time

workspace_id

required

string format: uuid

total

required

integer format: int64

Example^generated

{
  "facets": {
    "by_status": [
      {
        "count": 1,
        "value": "example"
      }
    ],
    "javascript": 1,
    "python": 1,
    "total": 1,
    "typescript": 1
  },
  "items": [
    {
      "created_at": "2026-04-15T12:00:00Z",
      "description": "example",
      "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "language": "example",
      "last_exit_code": 1,
      "last_run_at": "2026-04-15T12:00:00Z",
      "last_run_status": "example",
      "latest_version": 1,
      "name": "example",
      "ref_count": 1,
      "slug": "example",
      "updated_at": "2026-04-15T12:00:00Z",
      "workspace_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
    }
  ],
  "total": 1
}