List Templates

{
  "data": [
    {
      "id": "d3f9a1b2-4c7e-4f8a-9b2d-3e5f7a8c9d01",
      "name": "Social Media Campaign Starter",
      "definition": {
        "graph": {
          "nodes": [
            {
              "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
              "type": "source_script",
              "position": {
                "x": 100.5,
                "y": 200.75
              },
              "name": "Content Input",
              "config": {
                "script": "def generate_content(topic): return f'Content about {topic}'",
                "script_language": "python"
              },
              "config_version": 1
            }
          ],
          "edges": [
            {
              "id": "e1f2a3b4-c5d6-7890-abcd-ef0987654321",
              "source": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
              "sourcePort": "output",
              "target": "b2c3d4e5-f6a7-8901-bcde-f0123456789a",
              "targetPort": "input"
            }
          ]
        },
        "execution": {
          "steps": [
            "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
          ],
          "params": {
            "topic": "New Product Launch"
          }
        }
      },
      "is_starter": true,
      "is_public": true,
      "uses_count": 152,
      "created_at": "2023-11-20T14:45:00Z",
      "updated_at": "2024-01-10T08:15:00Z",
      "description": "A ready-to-use template for launching social media marketing campaigns with automated content generation and scheduling.",
      "category": "media",
      "is_favorite": false,
      "created_by": "7f8e9d0c-1b2a-4c3d-9e0f-123456789abc"
    }
  ],
  "meta": {
    "request_id": "9f8e7d6c-5b4a-3c2d-1e0f-abcdef123456",
    "timestamp": "2024-04-25T12:00:00Z"
  },
  "pagination": {
    "limit": 1,
    "next": "https://api.onepin.ai/api/v1/templates?offset=1&limit=1",
    "prev": null
  }
}

Browse the public template gallery across all workspaces.

Returns only templates that have an active published snapshot (is_public=true, published_definition set, not unpublished). Results come from any workspace — the gallery is intentionally cross-workspace so callers can discover shared starting points regardless of their own workspace membership.

Does not require X-Workspace-Id, so callers without a workspace (e.g. during onboarding) can still browse. The response reflects the published snapshot for each row, not any unpublished draft edits.

Dual-auth: Bearer JWT or API key (scope templates:read).

Browse the public template gallery across all workspaces. Returns only templates that have an active published snapshot (`is_public=true`, `published_definition` set, not unpublished). Results come from any workspace — the gallery is intentionally cross-workspace so callers can discover shared starting points regardless of their own workspace membership. Does not require `X-Workspace-Id`, so callers without a workspace (e.g. during onboarding) can still browse. The response reflects the published snapshot for each row, not any unpublished draft edits. Dual-auth: Bearer JWT or API key (scope `templates:read`).

Authentication

AuthorizationBearer

Clerk JWT token

AuthorizationBearer

Onepin live API key (op_live_...). Test and public keys are reserved in Phase 1.

Query parameters

categorylist of enums or nullOptional

Filter by category. Repeat the parameter for OR logic, e.g. ?category=media&category=creative.

Allowed values:

searchstring or nullOptional<=100 characters

Full-text search over template name and description.

sortenumOptionalDefaults to recent

Sort order: recent (last published), popular (most cloned), or name (alphabetical).

Allowed values:

offsetintegerOptional>=0Defaults to 0

Zero-based offset for page navigation.

limitintegerOptional1-100Defaults to 20

Maximum number of templates to return (1–100).

favorites_onlybooleanOptionalDefaults to false

Response

Successful Response

datalist of objects

metaobject

paginationobject

Errors

422

Unprocessable Entity Error

$	curl https://api.onepin.ai/api/v1/templates \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json"