Building a webhook integration? Read the webhook guide for signatures, retries, event schemas, and troubleshooting.
apiDeterministic

Prepare content authoring

POST /api/v1/content/authoring/prepare

Prepare an immutable, provider-neutral evidence bundle from the user's connected meeting sources and approved supporting sources. Use for generic content creation. Returns needs_input, blocked, or ready and never invokes Pipeline hosted inference or a saved workflow.

Parameters

workspaceId
string
No description.
meetingConnectionIds
string[]
Optional selected meeting-recording connections. Omit to discover eligible connected sources.
linkedinAccountId
string
No description.
voiceId
string
No description.
slackDestinationId
string
No description.
supportingSourceIds
string[]
No description.
callCount
integer
No description.
3
lookbackDays
integer
No description.
notifySlack
boolean
No description.
userGoal
string
No description.
clientRunIdrequired
string
No description.

Example

REST requestbash
curl -X POST "https://app.pipeline.help/api/v1/content/authoring/prepare" \
-H "Authorization: Bearer $PIPELINE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"clientRunId":"00000000-0000-4000-8000-000000000000"}'

Response

Success response schemajson schema
{
"type": "object",
"properties": {
"state": {
"type": "string",
"enum": [
"needs_input",
"blocked",
"ready"
]
}
},
"oneOf": [
{
"type": "object",
"properties": {
"state": {
"type": "string",
"enum": [
"needs_input"
]
},
"field": {
"type": "string"
},
"choices": {
"type": "array",
"minItems": 1,
"items": {
"type": "object"
}
}
},
"required": [
"state",
"field",
"choices"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"state": {
"type": "string",
"enum": [
"blocked"
]
},
"issues": {
"type": "array",
"minItems": 1,
"items": {
"type": "object"
}
}
},
"required": [
"state",
"issues"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"state": {
"type": "string",
"enum": [
"ready"
]
},
"authoringRunId": {
"type": "string"
},
"bundleId": {
"type": "string"
},
"bundleVersion": {
"type": "number"
},
"expiresAt": {
"type": "string"
},
"bundleHash": {
"type": "string"
},
"sources": {
"type": "array",
"minItems": 3,
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"sourceType": {
"type": "string"
},
"provider": {
"type": "string"
},
"connectionId": {
"type": "string"
},
"collectedAt": {
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"id",
"sourceType",
"provider",
"collectedAt"
],
"additionalProperties": false
}
},
"meetingSources": {
"type": "array",
"minItems": 3,
"maxItems": 3,
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"sourceType": {
"type": "string"
},
"provider": {
"type": "string"
},
"connectionId": {
"type": "string"
},
"collectedAt": {
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"id",
"sourceType",
"provider",
"collectedAt"
],
"additionalProperties": false
}
},
"supportingSources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"sourceType": {
"type": "string"
},
"provider": {
"type": "string"
},
"connectionId": {
"type": "string"
},
"collectedAt": {
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"id",
"sourceType",
"provider",
"collectedAt"
],
"additionalProperties": false
}
},
"optionalSourceChoices": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"sourceType": {
"type": "string"
},
"provider": {
"type": "string"
},
"connectionId": {
"type": "string"
},
"collectedAt": {
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"id",
"sourceType",
"provider",
"collectedAt"
],
"additionalProperties": false
}
},
"evidence": {
"type": "array",
"items": {
"type": "object"
},
"maxItems": 20
},
"context": {
"type": "object"
},
"skillResources": {
"type": "array",
"items": {
"type": "string"
}
},
"outputSchema": {
"type": "object"
},
"allowedNativeTools": {
"type": "array",
"items": {
"type": "string",
"enum": [
"web_search",
"web_fetch"
]
}
}
},
"required": [
"state",
"authoringRunId",
"bundleId",
"bundleVersion",
"expiresAt",
"bundleHash",
"sources",
"meetingSources",
"supportingSources",
"optionalSourceChoices",
"evidence",
"context",
"skillResources",
"outputSchema",
"allowedNativeTools"
],
"additionalProperties": false
}
]
}

HTTP errors

401
Missing or invalid API key.
403
Authenticated but not permitted for the workspace or resource.
404
The requested resource was not found.
Pipeline REST API reference | Pipeline