Content / REST API
Update content work
Save interview answers or edited outputs with optimistic revision protection. Never generates, publishes, or sends.
PATCH /api/v1/content/work/{workId}Deterministic operationParameters
workspaceIdOptional · string- See the input schema for this field.
workIdRequired · string- See the input schema for this field.
expectedRevisionRequired · integer- See the input schema for this field.
operationKeyRequired · string- See the input schema for this field.
answersOptional · array- See the input schema for this field.
briefOptional · object- See the input schema for this field.
confirmedPillarsOptional · array- See the input schema for this field.
outputsOptional · array- See the input schema for this field.
interviewActionOptional · string- See the input schema for this field.continue · stop
profileProposalOptional · object- See the input schema for this field.
confirmProfileOptional · boolean- See the input schema for this field.
confirmKnowledgeOptional · boolean- Confirm reviewed expertise interview knowledge for the selected author.
repairAuthorVoiceOptional · boolean- Repair an unlinked legacy interview voice to the existing account author. Submit separately from other edits.
curl -X PATCH "https://app.pipeline.help/api/v1/content/work/00000000-0000-4000-8000-000000000000" \
-H "Authorization: Bearer $PIPELINE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"expectedRevision":1,"operationKey":"example"}'Full input schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"workspaceId": {
"type": "string"
},
"workId": {
"type": "string"
},
"expectedRevision": {
"type": "integer",
"minimum": 1
},
"operationKey": {
"type": "string"
},
"answers": {
"type": "array",
"maxItems": 20,
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"questionId": {
"type": "string"
},
"answer": {
"type": "string"
}
},
"required": [
"questionId",
"answer"
]
}
},
"brief": {
"type": "object",
"additionalProperties": false,
"properties": {
"goal": {
"type": [
"string",
"null"
],
"maxLength": 4000
},
"referenceId": {
"type": [
"string",
"null"
],
"format": "uuid"
}
}
},
"confirmedPillars": {
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"purpose": {
"type": "string",
"maxLength": 2000
}
},
"required": [
"id",
"name",
"purpose"
]
}
},
"outputs": {
"type": "array",
"maxItems": 20,
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"linkedin_post",
"x_post",
"newsletter",
"youtube_package",
"carousel",
"markdown_resource",
"csv_resource",
"diagnostic",
"brief",
"critique",
"response"
]
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"body": {
"type": "string",
"maxLength": 100000
},
"status": {
"type": "string",
"enum": [
"draft",
"needs_review",
"approved",
"superseded"
]
},
"sourceIds": {
"type": "array",
"maxItems": 20,
"items": {
"type": "string"
}
},
"sourceRevision": {
"type": "integer",
"minimum": 1
},
"postId": {
"type": [
"string",
"null"
]
},
"stale": {
"type": "boolean"
},
"idea": {
"type": "object",
"additionalProperties": false,
"properties": {
"topic": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"angle": {
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"reader": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"buyerPurpose": {
"type": "string",
"enum": [
"reach_new_buyers",
"build_trust",
"help_buyers_decide"
]
},
"takeaway": {
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"authorEvidenceIds": {
"type": "array",
"maxItems": 20,
"items": {
"type": "string",
"format": "uuid"
}
},
"missingEvidence": {
"type": "array",
"maxItems": 10,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"readiness": {
"type": "string",
"enum": [
"ready",
"needs_author_input"
]
}
},
"required": [
"topic",
"angle",
"reader",
"buyerPurpose",
"takeaway",
"authorEvidenceIds",
"missingEvidence",
"readiness"
]
},
"plannedDate": {
"type": [
"string",
"null"
],
"format": "date"
},
"hookCandidates": {
"type": "array",
"maxItems": 3,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 1000
}
},
"selectedHook": {
"type": [
"string",
"null"
],
"maxLength": 1000
},
"patternId": {
"type": [
"string",
"null"
],
"maxLength": 200
},
"quality": {
"type": [
"object",
"null"
],
"additionalProperties": false,
"properties": {
"passed": {
"type": "boolean"
},
"normalizedPunctuation": {
"type": "array",
"maxItems": 50,
"items": {
"type": "string",
"maxLength": 200
}
},
"hardViolations": {
"type": "array",
"maxItems": 100,
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"code": {
"type": "string",
"maxLength": 100
},
"match": {
"type": "string",
"maxLength": 500
}
},
"required": [
"code",
"match"
]
}
},
"structuralWarnings": {
"type": "array",
"maxItems": 100,
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"code": {
"type": "string",
"maxLength": 100
},
"detail": {
"type": "string",
"maxLength": 1000
}
},
"required": [
"code",
"detail"
]
}
},
"rewriteAttempted": {
"type": "boolean"
}
},
"required": [
"passed"
]
},
"lineage": {
"type": [
"object",
"null"
],
"additionalProperties": false,
"properties": {
"sourceWorkId": {
"type": [
"string",
"null"
]
},
"sourceOutputId": {
"type": [
"string",
"null"
]
},
"sourcePostId": {
"type": [
"string",
"null"
]
},
"sourceRevision": {
"type": "integer",
"minimum": 1
},
"sourceDigest": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"stale": {
"type": "boolean"
}
},
"required": [
"sourceRevision",
"sourceDigest"
]
}
},
"required": [
"id",
"kind",
"title",
"body",
"sourceRevision"
]
}
},
"interviewAction": {
"type": "string",
"enum": [
"continue",
"stop"
]
},
"profileProposal": {
"type": "object",
"additionalProperties": false,
"properties": {
"version": {
"type": "integer",
"enum": [
1
]
},
"desiredAssociation": {
"type": "string",
"maxLength": 2000
},
"audience": {
"type": "string",
"maxLength": 2000
},
"positions": {
"type": "array",
"maxItems": 10,
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"position": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"reason": {
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"evidenceIds": {
"type": "array",
"maxItems": 20,
"items": {
"type": "string"
}
}
},
"required": [
"position",
"reason"
]
}
},
"approvedExperiences": {
"type": "array",
"maxItems": 10,
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"summary": {
"type": "string",
"minLength": 1,
"maxLength": 2000
},
"evidenceIds": {
"type": "array",
"maxItems": 20,
"items": {
"type": "string"
}
}
},
"required": [
"summary"
]
}
},
"personalDetails": {
"type": "array",
"maxItems": 20,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 4000
}
},
"boundaries": {
"type": "array",
"maxItems": 20,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"styleRules": {
"type": "array",
"maxItems": 20,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"ownSampleIds": {
"type": "array",
"maxItems": 20,
"items": {
"type": "string"
}
},
"referenceIds": {
"type": "array",
"maxItems": 20,
"items": {
"type": "string"
}
}
}
},
"confirmProfile": {
"type": "boolean"
},
"confirmKnowledge": {
"type": "boolean",
"description": "Confirm reviewed expertise interview knowledge for the selected author."
},
"repairAuthorVoice": {
"type": "boolean",
"description": "Repair an unlinked legacy interview voice to the existing account author. Submit separately from other edits."
}
},
"required": [
"workId",
"expectedRevision",
"operationKey"
]
}