conversations
conversations

Admit Turn

post/api/conversations/{conversation_id}/turns

Request

  • Base URL: https://api.usepomo.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.usepomo.ai/api/conversations/{conversation_id}/turns
  • Auth: HTTP bearer

Path parameters

conversation_idstring uuid required

Request body

messagestring required

User message

conversation_idstring uuid nullable

Existing conversation ID (creates new if omitted)

company_profile_idstring uuid required

Company profile context for MCP tools

organization_idstring uuid required

Organization context for multi-tenant scoping

workflow_stagestring nullable

Current workflow stage for context

target_team_idstring uuid nullable

Target team ID for @team or @agent routing (required when target_agent_key is set)

target_agent_keystring nullable

Target agent key for @agent routing (requires target_team_id)

idempotency_keystring nullable

Opaque retry key for an existing-conversation asynchronous v2 turn

Example request

{
  "company_profile_id": "123e4567-e89b-12d3-a456-426614174001",
  "conversation_id": "123e4567-e89b-12d3-a456-426614174002",
  "message": "What are my top performing campaigns?",
  "organization_id": "123e4567-e89b-12d3-a456-426614174000",
  "page_context": {
    "entity_id": "po_123",
    "entity_name": "Pro Suite",
    "source": "product-detail",
    "tab": "marketing"
  },
  "workflow_stage": "campaign_analysis"
}

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.