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

apiDeterministic

Save comment draft

POST /api/v1/engagement/comment-drafts

Save a caller-authored comment as a reviewable draft for a tracked post. It never posts to LinkedIn.

Parameters

workspaceId

string

Optional with API key auth, inferred from the key.

trackedPostIdrequired

string

No description.

linkedinAccountIdrequired

string

No description.

commentrequired

string

No description.

alternatives

string[]

No description.

confidenceScore

number

No description.

reasoning

string

No description.

Example

REST requestbash

curl -X POST "https://app.pipeline.help/api/v1/engagement/comment-drafts" \
  -H "Authorization: Bearer $PIPELINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"trackedPostId":"00000000-0000-4000-8000-000000000000","linkedinAccountId":"00000000-0000-4000-8000-000000000000","comment":"example"}'

Response

Success response schemajson schema

{
  "type": "object",
  "properties": {
    "draft": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "workspace_id": {
          "type": "string"
        },
        "tracked_post_id": {
          "type": "string"
        },
        "approval_status": {
          "type": "string",
          "enum": [
            "pending",
            "approved",
            "rejected",
            "edited",
            "sent",
            "expired"
          ]
        }
      },
      "required": [
        "id",
        "workspace_id",
        "tracked_post_id",
        "approval_status"
      ]
    }
  },
  "required": [
    "draft"
  ]
}

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.