Generated from Postwind commit a19b2e4 OpenAPI 0.1.0 synced

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

NameInTypeDescription
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 TemplateSummary

    In id order, each by its latest version.

    6 fields
    • TemplateSummary object · all fields required
    • created_atstring · date-time

      When the latest version was saved.

    • idstring · uuid
    • What a template is.

      • message
      • partial
    • namestring
    • project_idstring · uuid
    • versioninteger · int32

      The latest version.

      ≥ 1

  • next_cursorstring | null

    Pass as cursor for the next page; null on the last page.

403

A project key without scope read (forbidden)

Problem (application/problem+json)

404

No such project, or another project’s (not_found)

Problem (application/problem+json)

429

The key is over its rate limit, api.rate_limit_per_minute requests a minute on this node (rate_limited)

HeaderTypeDescription
Retry-AfterintegerSeconds until the key’s next request passes; rounded up.

Problem (application/problem+json)

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

Problem (application/problem+json)