Content / REST API

Run content work

Generate reviewable outputs for prepared hosted content work. Never publishes or sends.

POST /api/v1/content/work/{workId}/runBackend AI, consent required

Parameters

workspaceIdOptional · string
See the input schema for this field.
outputIdOptional · string
Regenerate only this saved idea slot, preserving other accepted edits.
workIdRequired · string
See the input schema for this field.
expectedRevisionRequired · integer
See the input schema for this field.
operationKeyRequired · string
Caller-stable retry key.
allowHostedAiOptional · boolean
Must be true when this operation uses Pipeline hosted inference.
Request example
curl -X POST "https://app.pipeline.help/api/v1/content/work/00000000-0000-4000-8000-000000000000/run" \
  -H "Authorization: Bearer $PIPELINE_API_KEY" \
  -H "X-Pipeline-Execution-Policy: hosted-enabled" \
  -H "Content-Type: application/json" \
  -d '{"expectedRevision":1,"operationKey":"example","allowHostedAi":true}'
Full input schema
Input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "workspaceId": {
      "type": "string"
    },
    "outputId": {
      "type": "string",
      "format": "uuid",
      "description": "Regenerate only this saved idea slot, preserving other accepted edits."
    },
    "workId": {
      "type": "string"
    },
    "expectedRevision": {
      "type": "integer",
      "minimum": 1
    },
    "operationKey": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Caller-stable retry key."
    },
    "allowHostedAi": {
      "type": "boolean",
      "description": "Must be true when this operation uses Pipeline hosted inference."
    }
  },
  "required": [
    "workId",
    "expectedRevision",
    "operationKey"
  ]
}
See this operation inCLI MCP TypeScript SDK
API reference | Pipeline v2 preview