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

apiDeterministic

List pending approvals

GET /api/agents/approvals/list

List human-input items awaiting approval across the workspace: draft sends, drafted replies, push events, and Agent Teams human-input cards. Returns four arrays: drafts, replies, pushEvents, humanInputs.

Parameters

workspaceId

string

Optional workspace ID or slug. Required when this credential can access multiple workspaces and no workspace was configured on the client.

Example

REST requestbash

curl -X GET "https://app.pipeline.help/api/agents/approvals/list" \
  -H "Authorization: Bearer $PIPELINE_API_KEY"

Response

Success response schemajson schema

{
  "type": "object",
  "properties": {
    "drafts": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "replies": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "pushEvents": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "humanInputs": {
      "type": "array",
      "items": {
        "type": "object"
      }
    }
  },
  "required": [
    "drafts",
    "replies",
    "pushEvents",
    "humanInputs"
  ]
}

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.