apiDeterministic
Delegate agent chat turn
POST /api/agents/conversations
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.
Parameters
workspaceId
string
No description.
actionrequired
string
No description.
turnIdrequired
string
No description.
claimTokenrequired
string
No description.
recipientrequired
string
No description.
strategist | gtm_engineer | reply_agent | sdr_agent | gtm_lead | content_agent | engagement
taskrequired
string
No description.
intentrequired
string
No description.
ask | delegate | handoff
Example
REST requestbash
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"}'
Response
Success response schemajson schema
{"type": "object","properties": {"childTurnId": {"type": "string"},"conversationId": {"type": "string"},"executionMode": {"type": "string","enum": ["external_agent"]},"intent": {"type": "string"}},"required": ["childTurnId","conversationId","executionMode","intent"]}
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.