Create Template

{
  "data": {
    "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
    "name": "Social Media Content Workflow",
    "definition": {
      "graph": {
        "nodes": [
          {
            "id": "a3f1c9e2-4b7a-4d3e-9f1a-2b5e6c7d8f90",
            "type": "source_script",
            "position": {
              "x": 100.5,
              "y": 200.75
            },
            "name": "Content Fetcher",
            "config": {},
            "config_version": 1
          }
        ],
        "edges": [
          {
            "id": "b4e2d3f4-5c6a-7b8d-9e0f-1a2b3c4d5e6f",
            "source": "a3f1c9e2-4b7a-4d3e-9f1a-2b5e6c7d8f90",
            "sourcePort": "output",
            "target": "c5d6e7f8-9a0b-1c2d-3e4f-5a6b7c8d9e0f",
            "targetPort": "input"
          }
        ]
      },
      "execution": {
        "steps": [
          "a3f1c9e2-4b7a-4d3e-9f1a-2b5e6c7d8f90"
        ],
        "params": {}
      }
    },
    "is_starter": true,
    "is_public": true,
    "uses_count": 42,
    "created_at": "2024-01-15T09:30:00Z",
    "updated_at": "2024-01-15T09:30:00Z",
    "description": "A workflow template designed to automate content creation and publishing for social media platforms.",
    "category": "media",
    "is_favorite": false,
    "created_by": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
  },
  "meta": {
    "request_id": "7f9c2ba4-3d5e-4f6a-8b9c-1d2e3f4a5b6c",
    "timestamp": "2024-01-15T09:30:00Z"
  }
}

Create a new workflow template in the current workspace.

The caller supplies a full WorkflowDefinition (graph + execution). Save-time validation (validate_definition_save) mirrors the /api/v1/workflows contract — duplicate node/edge IDs, port mismatches, and other structural errors fail at write time rather than surfacing when a caller later clones the template into a workflow.

Create a new workflow template in the current workspace. The caller supplies a full `WorkflowDefinition` (graph + execution). Save-time validation (`validate_definition_save`) mirrors the `/api/v1/workflows` contract — duplicate node/edge IDs, port mismatches, and other structural errors fail at write time rather than surfacing when a caller later clones the template into a workflow.

Authentication

AuthorizationBearer

Clerk JWT token

Headers

X-Workspace-Idstring or nullOptional

Request

This endpoint expects an object.

namestringRequired1-200 characters

descriptionstring or nullOptional<=2000 characters

categoryenum or nullOptional

definitionobjectOptional

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 -X POST https://api.onepin.ai/api/v1/templates \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "Social Media Content Workflow"
>	}'