GET/api/v1/projects/{project_id}/templates
Needs scope: readMCP tool: list_templates
operationId list_templates
List templates
The project’s templates in id order, each by its latest version,
without sources, a page at a time. Needs scope read.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
project_idrequired |
path | string · uuid | The project’s id |
kind |
query | TemplateKind | Only templates of this kind |
limit |
query | integer · int64
1–500 |
Page size, 1 to 500; default 50 |
cursor |
query | string | next_cursor of the previous page |
Request body
None.
Responses
200
One page
- TemplateList object · all fields required
-
itemsarray of TemplateSummaryIn id order, each by its latest version.
6 fields
- TemplateSummary object · all fields required
-
created_atstring · date-timeWhen the latest version was saved.
-
idstring · uuid -
kindTemplateKindWhat a template is.
- message
- partial
-
namestring -
project_idstring · uuid -
versioninteger · int32The latest version.
≥ 1
-
next_cursorstring | nullPass as
cursorfor the next page;nullon the last page.
429
The key is over its rate limit, api.rate_limit_per_minute requests a minute on this node (rate_limited)
| Header | Type | Description |
|---|---|---|
Retry-After | integer | Seconds until the key’s next request passes; rounded up. |
504
Postwind’s storage did not answer within its time limit (storage_timeout). A change the request makes may still take effect: check before repeating it. A repeat with the same Idempotency-Key never runs it twice: it is 409 idempotency_key_in_progress until the key’s 24 h end