Create Template

{
  "data": {
    "id": "a3f1c9e2-4b7d-4f8a-9c2e-1d2f3b4a5c6d",
    "name": "Social Media Content Scheduler",
    "definition": {
      "graph": {
        "nodes": [
          {
            "id": "b1e2d3f4-5678-90ab-cdef-1234567890ab",
            "type": "source_script",
            "position": {
              "x": 100.5,
              "y": 200.75
            },
            "name": "Content Fetcher",
            "config": {},
            "config_version": 1
          }
        ],
        "edges": [
          {
            "id": "c2d3e4f5-6789-0abc-def1-234567890abc",
            "source": "b1e2d3f4-5678-90ab-cdef-1234567890ab",
            "sourcePort": "output",
            "target": "d3e4f5a6-7890-1bcd-ef12-34567890abcd",
            "targetPort": "input"
          }
        ]
      },
      "execution": {
        "steps": [
          "b1e2d3f4-5678-90ab-cdef-1234567890ab"
        ],
        "params": {}
      }
    },
    "is_starter": false,
    "is_public": false,
    "uses_count": 0,
    "created_at": "2024-01-15T09:30:00Z",
    "updated_at": "2024-01-15T09:30:00Z",
    "description": "Automates scheduling and posting of social media content across multiple platforms.",
    "category": "media",
    "is_favorite": false,
    "created_by": "d4e5f6a7-8901-2bcd-ef23-4567890abcde"
  },
  "meta": {
    "request_id": "f7a8b9c0-d1e2-3f45-6789-0abcde123456",
    "timestamp": "2024-01-15T09:30:00Z"
  }
}

Create a reusable workflow template in the current workspace.

Templates are workspace-private on creation (is_public=false, is_starter=false). The full WorkflowDefinition (graph + execution config) is validated at write time — structural errors (duplicate node/edge IDs, port mismatches, etc.) surface here rather than when a caller later clones the template into a workflow.

Use this to capture a workflow configuration you intend to reuse or share. To make a template available in the public gallery, an admin must mark it public via the admin API. To create a runnable workflow from an existing template, use POST /templates/{id}/clone instead.

Requires workspace editor role or higher.

Create a reusable workflow template in the current workspace. Templates are workspace-private on creation (`is_public=false`, `is_starter=false`). The full `WorkflowDefinition` (graph + execution config) is validated at write time — structural errors (duplicate node/edge IDs, port mismatches, etc.) surface here rather than when a caller later clones the template into a workflow. Use this to capture a workflow configuration you intend to reuse or share. To make a template available in the public gallery, an admin must mark it public via the admin API. To create a runnable workflow from an existing template, use `POST /templates/{id}/clone` instead. Requires workspace `editor` role or higher.

Authentication

AuthorizationBearer

Clerk JWT token

Headers

X-Workspace-Idstring or nullOptional

Request

This endpoint expects an object.

namestringRequired1-200 characters

Display name for the template (1–200 characters, not blank).

descriptionstring or nullOptional<=2000 characters

Optional human-readable description shown in the gallery (max 2,000 characters).

categoryenum or nullOptional

Optional category tag used for gallery filtering.

definitionobjectOptional

Full workflow definition (graph + execution config). Validated at write time — structural errors are rejected with 422.

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

Create a reusable workflow template in the current workspace.

Requires workspace editor role or higher.

$	curl -X POST https://api.onepin.ai/api/v1/templates \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "Social Media Content Scheduler"
>	}'