Skip to main content
GET
List the prompts

Authorizations

Authorization
string
header
required

Headers

X-Workspace-Id
string<uuid>
required

UUID of the workspace to act in. Take it from GET /me (workspaces[].id). A key scoped to specific workspaces is rejected with 403 WORKSPACE_NOT_ALLOWED for any other id; a missing header is 400 WORKSPACE_REQUIRED.

Query Parameters

active
enum<string>

true: only active prompts (the ones runs measure). false: only inactive.

Available options:
true,
false
include
enum<string>

stats attaches per-prompt measurements.

Available options:
stats
from
string

Start of the window: an ISO date (2026-10-01, from 00:00 UTC) or timestamp. Defaults to 30 days before to. The plan's history window still applies: older data is not returned.

to
string

End of the window, inclusive: an ISO date (2026-10-31, to 23:59:59.999 UTC) or timestamp. Defaults to now. from after to, or a window over two years, is 422.

promptBrand
enum<string>

Scope of the stats, as on GET /analytics/summary. Only used with include=stats.

Available options:
all,
branded,
unbranded
cursor
string

Opaque cursor from the previous page's meta.cursor.

limit
integer

Page size, default 25, max 100.

Required range: 1 <= x <= 100

Response

A page of prompts

data
object[]
required
meta
object
required