Update Template

{
  "data": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "name": "Social Media Content Generator",
    "definition": {
      "graph": {
        "nodes": [
          {
            "id": "1e7f3a2b-4c5d-4f6a-9b7e-123456789abc",
            "type": "source_script",
            "position": {
              "x": 100.5,
              "y": 200.75
            },
            "name": "Input Script Node",
            "config": {},
            "config_version": 1
          }
        ],
        "edges": [
          {
            "id": "2b7e3f1a-9c4d-4a6b-8e7f-abcdef123456",
            "source": "1e7f3a2b-4c5d-4f6a-9b7e-123456789abc",
            "sourcePort": "output",
            "target": "3c8d4e5f-6a7b-8c9d-0e1f-23456789abcd",
            "targetPort": "input"
          }
        ]
      },
      "execution": {
        "steps": [
          "1e7f3a2b-4c5d-4f6a-9b7e-123456789abc"
        ],
        "params": {}
      }
    },
    "is_starter": true,
    "is_public": true,
    "uses_count": 42,
    "created_at": "2024-01-15T09:30:00Z",
    "updated_at": "2024-04-20T14:45:00Z",
    "description": "A template to automate the creation of engaging social media posts using AI.",
    "category": "media",
    "is_favorite": false,
    "created_by": "7d9f3e2a-1b4c-4d5e-8f7a-9876543210ab"
  },
  "meta": {
    "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "timestamp": "2024-04-20T14:45:00Z"
  }
}

Update a template. Owner only; starter templates are read-only.

definition is full-replace (matches WorkflowUpdate — the FE sends the entire graph back on save). Other fields are partial via exclude_unset.

Authentication

AuthorizationBearer

Clerk JWT token

Path parameters

template_idstringRequiredformat: "uuid"

Request

This endpoint expects an object.

namestring or nullOptional1-200 characters

descriptionstring or nullOptional<=2000 characters

categoryenum or nullOptional

definitionobject or nullOptional

Full-replace on PATCH. Omit to keep the stored value. Explicit null is rejected — there is no ‘empty graph’ use-case worth the ambiguity. The union with null here only makes omission easy for FE clients; see reject_null_definition for the runtime guard.

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 PATCH https://api.onepin.ai/api/v1/templates/template_id \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

Authentication

Path parameters

Headers

Request

Response

Errors