Content / CLI

Prepare content work

Create durable content work for voice calibration, interviews, source adaptation, series, distribution packs, buyer research, resources, case studies, editorial actions, diagnostics, table insights, and offer launches. Preparation is deterministic and never publishes.

pipeline prepare-content-workDeterministic operation

Parameters

workspaceIdOptional · string
See the input schema for this field.
kindRequired · string
See the input schema for this field.voice_calibration · expertise_interview · source_adaptation · content_series · buyer_questions · lead_magnet · engagement_review · distribution_pack · opportunity_brief · deal_support · case_study · editorial_action · diagnostic_resource · table_insight · offer_launch
titleRequired · string
See the input schema for this field.
executionModeOptional · string
See the input schema for this field.pipeline_hosted · external_agent
operationKeyRequired · string
See the input schema for this field.
briefRequired · object
See the input schema for this field.
sourcesOptional · array
See the input schema for this field.
evidenceOptional · array
See the input schema for this field.
lineageOptional · object | null
See the input schema for this field.
Request example
pipeline prepare-content-work \
  --kind "voice_calibration" \
  --title "example" \
  --operation-key "example" \
  --brief-json '{}'
Full input schema
Input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "workspaceId": {
      "type": "string"
    },
    "kind": {
      "type": "string",
      "enum": [
        "voice_calibration",
        "expertise_interview",
        "source_adaptation",
        "content_series",
        "buyer_questions",
        "lead_magnet",
        "engagement_review",
        "distribution_pack",
        "opportunity_brief",
        "deal_support",
        "case_study",
        "editorial_action",
        "diagnostic_resource",
        "table_insight",
        "offer_launch"
      ]
    },
    "title": {
      "type": "string"
    },
    "executionMode": {
      "type": "string",
      "enum": [
        "pipeline_hosted",
        "external_agent"
      ]
    },
    "operationKey": {
      "type": "string"
    },
    "brief": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "planFirst": {
          "type": "boolean"
        },
        "seriesCount": {
          "type": "integer",
          "minimum": 2,
          "maximum": 10
        },
        "exportFormats": {
          "type": "array",
          "minItems": 1,
          "maxItems": 4,
          "items": {
            "type": "string",
            "enum": [
              "x_post",
              "newsletter",
              "youtube_package",
              "carousel"
            ]
          }
        },
        "voiceId": {
          "type": [
            "string",
            "null"
          ]
        },
        "linkedinAccountId": {
          "type": [
            "string",
            "null"
          ]
        },
        "strategyId": {
          "type": [
            "string",
            "null"
          ]
        },
        "referenceId": {
          "type": [
            "string",
            "null"
          ],
          "format": "uuid"
        },
        "pillarIds": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "offerReference": {
          "type": [
            "string",
            "null"
          ]
        },
        "audience": {
          "type": [
            "string",
            "null"
          ]
        },
        "goal": {
          "type": [
            "string",
            "null"
          ]
        },
        "editorialType": {
          "type": [
            "string",
            "null"
          ],
          "enum": [
            "case_study",
            "founder_story",
            "personal_story",
            "lead_magnet",
            "workflow_walkthrough",
            "expertise",
            null
          ]
        },
        "purpose": {
          "type": [
            "string",
            "null"
          ],
          "enum": [
            "reach_new_buyers",
            "build_trust",
            "help_buyers_decide",
            null
          ]
        },
        "author": {
          "type": [
            "string",
            "null"
          ]
        },
        "reader": {
          "type": [
            "string",
            "null"
          ]
        },
        "thesis": {
          "type": [
            "string",
            "null"
          ]
        },
        "desiredAction": {
          "type": [
            "string",
            "null"
          ]
        },
        "promotionMode": {
          "type": "string",
          "enum": [
            "none",
            "natural_mention",
            "direct_offer",
            "resource_delivery"
          ]
        },
        "linkedinLength": {
          "type": "string",
          "enum": [
            "short",
            "medium",
            "long"
          ]
        },
        "xLength": {
          "type": "string",
          "enum": [
            "short",
            "medium",
            "long"
          ]
        }
      }
    },
    "sources": {
      "type": "array",
      "maxItems": 20,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "pasted_text",
              "content_post",
              "inspiration_post",
              "meeting",
              "reply",
              "table_aggregate",
              "web_research"
            ]
          },
          "referenceId": {
            "type": [
              "string",
              "null"
            ]
          },
          "title": {
            "type": "string"
          },
          "excerpt": {
            "type": "string"
          },
          "observedAt": {
            "type": [
              "string",
              "null"
            ]
          },
          "publicUse": {
            "type": "boolean"
          },
          "revision": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 1
          },
          "digest": {
            "type": [
              "string",
              "null"
            ],
            "pattern": "^[a-f0-9]{64}$"
          },
          "available": {
            "type": "boolean"
          },
          "stale": {
            "type": "boolean"
          }
        },
        "required": [
          "kind",
          "title",
          "excerpt"
        ]
      }
    },
    "evidence": {
      "type": "array",
      "maxItems": 100,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "sourceIndex": {
            "type": "integer",
            "minimum": 0
          },
          "excerpt": {
            "type": "string"
          },
          "observedAt": {
            "type": [
              "string",
              "null"
            ]
          },
          "usage": {
            "type": "string",
            "enum": [
              "private_context",
              "public_claim",
              "structural_reference"
            ]
          },
          "provenance": {
            "type": "string"
          }
        },
        "required": [
          "sourceIndex",
          "excerpt",
          "provenance"
        ]
      }
    },
    "lineage": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": false,
      "properties": {
        "sourceWorkId": {
          "type": [
            "string",
            "null"
          ]
        },
        "sourceOutputId": {
          "type": [
            "string",
            "null"
          ]
        },
        "sourcePostId": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    }
  },
  "required": [
    "kind",
    "title",
    "operationKey",
    "brief"
  ]
}
See this operation inMCP REST API TypeScript SDK
CLI guide | Pipeline v2 preview