Agents / REST API

Delegate agent chat turn

Delegate a claimed external chat task to another public Pipeline agent with originating conversation context and scope. Returns a childTurnId to claim and execute with your current coding-agent model. No hosted inference. Complete the child, then claim and execute its returned parent continuation. Intent ask/delegate returns to the parent; handoff transfers remaining ownership.

POST /api/agents/conversationsDeterministic operation

Parameters

workspaceIdOptional · string: See the input schema for this field.
actionRequired · string: See the input schema for this field.
turnIdRequired · string: See the input schema for this field.
claimTokenRequired · string: See the input schema for this field.
recipientRequired · string: See the input schema for this field.strategist · gtm_engineer · reply_agent · sdr_agent · gtm_lead · content_agent · engagement
taskRequired · string: See the input schema for this field.
intentRequired · string: See the input schema for this field.ask · delegate · handoff

Request example

curl -X POST "https://app.pipeline.help/api/agents/conversations" \
  -H "Authorization: Bearer $PIPELINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"action":"external_delegate","turnId":"00000000-0000-4000-8000-000000000000","claimToken":"00000000-0000-4000-8000-000000000000","recipient":"strategist","task":"example","intent":"delegate"}'

Full input schema

Input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "workspaceId": {
      "type": "string",
      "format": "uuid"
    },
    "action": {
      "default": "external_delegate",
      "type": "string",
      "const": "external_delegate"
    },
    "turnId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "claimToken": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "recipient": {
      "type": "string",
      "enum": [
        "strategist",
        "gtm_engineer",
        "reply_agent",
        "sdr_agent",
        "gtm_lead",
        "content_agent",
        "engagement"
      ]
    },
    "task": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20000
    },
    "intent": {
      "default": "delegate",
      "type": "string",
      "enum": [
        "ask",
        "delegate",
        "handoff"
      ]
    }
  },
  "required": [
    "action",
    "turnId",
    "claimToken",
    "recipient",
    "task",
    "intent"
  ],
  "additionalProperties": false
}

See this operation inCLI MCP TypeScript SDK