Sign in to run requests with your own sandbox key. Sign in

List published templates

GET /api/v1/workflow_templates
workflow_templates:read

Read-only catalog, ordered by name. Drafts and inactive templates are never exposed via the API. Requires workflow_templates:read.

Query parameters

NameTypeDescription
page integer

1-based page number.

Example: 1
per_page integer

Items per page. Values above 100 are clamped to 100.

Example: 25
filter[featured] boolean
filter[category] string

Responses

  • 200 Template list application/json
    • data array of WorkflowTemplate
      • id integer
      • object string
      • name string
      • description string, nullable
      • icon string, nullable
      • color string, nullable
      • category string, nullable
      • active boolean
      • featured boolean
      • published_at string (date-time), nullable
    • meta Meta

      Schema: PaginatedMeta

      • request_id string required Correlation id for this request. Also sent as the `X-Request-Id` response header; quote it when contacting support.
      • page integer required
      • per_page integer required
      • total_count integer required
      • total_pages integer required
      • object string required The object type of every item in `data`.
    200 example
    {
      "data": [
        {
          "id": 1,
          "object": "workflow_template",
          "name": "string",
          "description": "string",
          "icon": "string",
          "color": "string",
          "category": "string",
          "active": true,
          "featured": true,
          "published_at": "2026-05-08T18:41:05Z"
        }
      ],
      "meta": {
        "request_id": "7d4c2f48-9a1b-4c3d-8e2f-1a2b3c4d5e6f",
        "page": 1,
        "per_page": 25,
        "total_count": 142,
        "total_pages": 6,
        "object": "execution"
      }
    }
  • 401 Missing, malformed, expired or revoked bearer token. The WWW-Authenticate header carries the RFC 6750 challenge. application/json

    Schema: ErrorEnvelope

    401 example
    {
      "error": {
        "code": "unauthorized",
        "message": "A valid bearer token is required.",
        "details": [],
        "request_id": "7d4c2f48-9a1b-4c3d-8e2f-1a2b3c4d5e6f",
        "doc_url": "https://cascades.crscreditapi.com/docs/api/errors/unauthorized"
      }
    }
  • 403 Token does not hold the required scope. details lists the scope(s) that were checked. application/json

    Schema: ErrorEnvelope

    403 example
    {
      "error": {
        "code": "insufficient_scope",
        "message": "This token does not have the required scope.",
        "details": [
          {
            "field": "scope",
            "message": "executions:write"
          }
        ],
        "request_id": "7d4c2f48-9a1b-4c3d-8e2f-1a2b3c4d5e6f",
        "doc_url": "https://cascades.crscreditapi.com/docs/api/errors/insufficient_scope"
      }
    }
  • 429 Rate limit exceeded (60 req/min per IP on /api/v1, 600 req/hour per token prefix, or 300 req/5 min per IP globally). The body is the standard error envelope and Retry-After gives the seconds until the window resets. application/json

    Schema: ErrorEnvelope

    429 example
    {
      "error": {
        "code": "rate_limited",
        "message": "Rate limit exceeded. Retry later.",
        "details": [],
        "request_id": "7d4c2f48-9a1b-4c3d-8e2f-1a2b3c4d5e6f",
        "doc_url": "https://cascades.crscreditapi.com/docs/api/errors/rate_limited"
      }
    }
Was this page helpful?