Favorite Template

{
  "data": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "name": "Social Media Content Scheduler",
    "definition": {
      "graph": {
        "nodes": [
          {
            "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
            "type": "source_script",
            "position": {
              "x": 100.5,
              "y": 200.75
            },
            "name": "Fetch Content",
            "config": {
              "script_url": "https://example.com/scripts/fetch_content.js",
              "retry_attempts": 3
            },
            "config_version": 1
          }
        ],
        "edges": [
          {
            "id": "e7b8f1a2-3c4d-4f5a-9b6c-123456789abc",
            "source": "d290f1ee-6c54-4b01-90e6-d701748f0851",
            "sourcePort": "output",
            "target": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
            "targetPort": "input"
          }
        ]
      },
      "execution": {
        "steps": [
          "d290f1ee-6c54-4b01-90e6-d701748f0851"
        ],
        "params": {
          "schedule_time": "09:00",
          "platforms": [
            "twitter",
            "facebook",
            "instagram"
          ]
        }
      }
    },
    "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 to automate scheduling posts across multiple social media platforms.",
    "category": "media",
    "is_favorite": false,
    "created_by": "7c9e6679-7425-40de-944b-e07fc1f90ae7"
  },
  "meta": {
    "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "timestamp": "2024-04-27T12:00:00Z"
  }
}

Mark a visible template as a favorite for the current user.

Authenticated but not workspace-scoped — favorites are cross-workspace by design for public/starter templates and for the caller’s own private templates when they still belong to that template’s workspace.

Returns 404 when the template does not exist or is not visible to the caller. This POST intentionally enumerates success/failure for the toggle UX, while DELETE stays non-enumerating.

Mark a visible template as a favorite for the current user. Authenticated but not workspace-scoped — favorites are cross-workspace by design for public/starter templates and for the caller's own private templates when they still belong to that template's workspace. Returns 404 when the template does not exist or is not visible to the caller. This POST intentionally enumerates success/failure for the toggle UX, while DELETE stays non-enumerating.

Authentication

AuthorizationBearer

Clerk JWT token

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