Content / REST API
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.
POST /api/v1/content/workDeterministic operationParameters
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.
curl -X POST "https://app.pipeline.help/api/v1/content/work" \
-H "Authorization: Bearer $PIPELINE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"kind":"voice_calibration","title":"example","operationKey":"example","brief":{}}'Full 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"
]
}