List Templates

{
  "data": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "Social Media Campaign",
      "definition": {
        "graph": {
          "nodes": [
            {
              "id": "1e7f9a2b-4c3d-4f2a-9a1b-2d3e4f5a6b7c",
              "type": "source_script",
              "position": {
                "x": 100.5,
                "y": 200.75
              },
              "name": "Content Input",
              "config": {
                "scriptLanguage": "JavaScript",
                "entryPoint": "main.js"
              },
              "config_version": 1
            }
          ],
          "edges": [
            {
              "id": "2b7c6d5e-8f9a-4b3c-9d1e-7f6a5b4c3d2e",
              "source": "1e7f9a2b-4c3d-4f2a-9a1b-2d3e4f5a6b7c",
              "sourcePort": "output",
              "target": "3c4d5e6f-7a8b-9c0d-1e2f-3a4b5c6d7e8f",
              "targetPort": "input"
            }
          ]
        },
        "execution": {
          "steps": [
            "1e7f9a2b-4c3d-4f2a-9a1b-2d3e4f5a6b7c"
          ],
          "params": {
            "maxPosts": 10,
            "schedule": "weekly"
          }
        }
      },
      "is_starter": true,
      "is_public": true,
      "uses_count": 152,
      "created_at": "2024-01-15T09:30:00Z",
      "updated_at": "2024-04-10T14:45:00Z",
      "description": "A template for creating engaging social media marketing campaigns.",
      "category": "media",
      "is_favorite": false,
      "created_by": "7d9f1e2a-3b4c-5d6e-7f8a-9b0c1d2e3f4a"
    }
  ],
  "meta": {
    "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "timestamp": "2024-06-01T12:00:00Z"
  },
  "pagination": {
    "limit": 20,
    "next": "https://api.onepin.ai/api/v1/templates?offset=20&limit=20",
    "prev": null
  }
}

List live published templates across workspaces (gallery).

Authenticated but not workspace-scoped — the gallery is cross-workspace by design (published rows from any workspace). Does not require X-Workspace-Id, so a freshly signed-up user without a workspace can still browse templates.

Dual-auth: Clerk JWT or op_live_* API key (scope templates:read).

List live published templates across workspaces (gallery). Authenticated but not workspace-scoped — the gallery is cross-workspace by design (published rows from any workspace). Does not require `X-Workspace-Id`, so a freshly signed-up user without a workspace can still browse templates. Dual-auth: Clerk JWT or `op_live_*` 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

Repeat for OR, e.g. ?category=media&category=creative

Allowed values:

searchstring or nullOptional<=100 characters

sortenumOptionalDefaults to recent

Allowed values:

offsetintegerOptional>=0Defaults to 0

limitintegerOptional1-100Defaults to 20

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"