Get Template | OnePin

{
  "data": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "name": "Social Media Content Planner",
    "definition": {
      "graph": {
        "nodes": [
          {
            "id": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
            "type": "source_script",
            "position": {
              "x": 100.5,
              "y": 200.75
            },
            "name": "Content Input",
            "config": {
              "scriptLanguage": "JavaScript",
              "script": "function fetchContent() { return ['Post1', 'Post2']; }"
            },
            "config_version": 1
          }
        ],
        "edges": [
          {
            "id": "7f8e9d0c-1b2a-3c4d-5e6f-7a8b9c0d1e2f",
            "source": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
            "sourcePort": "output",
            "target": "9f8e7d6c-5b4a-3c2d-1e0f-9a8b7c6d5e4f",
            "targetPort": "input"
          }
        ]
      },
      "execution": {
        "steps": [
          "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d"
        ],
        "params": {
          "scheduleTime": "09:00",
          "timezone": "UTC"
        }
      }
    },
    "is_starter": true,
    "is_public": true,
    "uses_count": 124,
    "created_at": "2024-01-15T09:30:00Z",
    "updated_at": "2024-04-10T14:45:00Z",
    "description": "A template to plan and schedule social media posts efficiently.",
    "category": "media",
    "is_favorite": false,
    "created_by": "d290f1ee-6c54-4b01-90e6-d701748f0851"
  },
  "meta": {
    "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "timestamp": "2024-04-27T12:00:00Z"
  }
}

Fetch a template by id if visible (own, public, or starter).

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.

Path parameters

template_idstringRequiredformat: "uuid"

Response

Successful Response

dataobject

Response shape. workspace_id is intentionally omitted so the gallery endpoint (which returns rows from any workspace) does not leak tenant ownership IDs across tenants. created_by is retained as author provenance for public/starter rows.

definition is the serialized WorkflowDefinition JSONB (same shape as Workflow.definition) — a template is a reusable workflow snapshot.

metaobject

Errors

422

Unprocessable Entity Error

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

Authentication

Path parameters

Headers

Response

Errors