List Templates Api V1 Workstreams Templates Get

get/api/v1/workstreams/templates

List workflow templates

List all available workflow templates. Templates are reusable workflow definitions that can be customized into blueprints for specific clients. **Query Parameters:** - `category`: Filter by template category - `status`: Filter by template status (default: active) - `limit`: Results per page (1-100, default: 20) - `offset`: Pagination offset (default: 0) **Authentication Required:** JWT Bearer token

Query parameters

`category` query	Filter by category
`search` query	Search by name or description
`runnable_only` query	Only include templates with at least one active linked blueprint
`launchable_only` query	Only include LAUNCHABLE recipes — workstreams with a step DAG (non-empty `steps`) or an agentic `goal_spec`. Excludes agentic CONTAINERS (the per-job and ad-hoc workstreams, which have neither and are run via /jobs/{id}/run, not @-mention). Note: `is_template` is NOT the launchability signal — the FIC catalogue and firm recipes ship `is_template=false` but are launchable.
`is_template` query	Optional filter on the `is_template` column. Default: include BOTH template and non-template workstreams. Pass `true` to restrict to flagged templates (legacy behaviour); pass `false` to restrict to non-template workstreams.
`status` query	Filter by status `draftactivepausedarchived`
`include_all_workspaces` query	god-mode ONLY: include workstreams from ALL workspaces (the WSS Trace/Studio cross-workspace view). Default False so the @-mention launcher picker stays scoped to the caller's workspace — it must never surface templates the caller can't launch here.
`include_internal` query	Include engineering/test 'plumbing' rows in the result. Default False — the recipe LIBRARY hides the internal bucket (FIC:/Demo:/Read PDF rows + the 'internal' catch-all category) so the customer-facing grid shows only curated catalog + real recipes. Pass True for the @-mention picker / eng tooling that needs them.
`scope` query	Filter by distribution scope — the customer 'My WorkStreams' view is grouped firm -> team -> user (#170). When set, the firm-scoped FIC workstreams become visible (the default grid's FIC name-hide is skipped for an explicit scope view); eng plumbing stays hidden. Omit for the default catalog grid. `gallery`/`plan` scopes are not filter options (gallery is parked).
`limit` query	Results per page
`offset` query	Pagination offset

Responses

200Templates retrieved successfully

Field	Type	Description
`items`	`TemplateResponse[]`	— item shape TemplateResponse
`pagination`required	`Pagination`	Pagination information show nested Pagination

401Unauthorized - invalid or missing JWT token

422Validation Error

Field	Type	Description
`detail`	`ValidationError[]`	— item shape ValidationError

curl https://api.dev.arch.ie/api/v1/workstreams/templates \
  -H "Authorization: Bearer sk_..."