max
conversations

Unified endpoint that handles both conversation creation and streaming.

  • If message is provided: Start new conversation processing
  • If no message: Stream from existing conversation
post/api/projects/{project_id}/conversations/

Request

  • Base URL: https://us.posthog.com
  • URL: https://us.posthog.com/api/projects/{project_id}/conversations/
  • Auth: HTTP bearer

Path parameters

project_idstring required

Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.

Request body

contentstring nullable required
conversationstring uuid required
contextual_toolsobject
ui_contextunknown
billing_contextunknown
trace_idstring uuid required
session_idstring
agent_mode'product_analytics' | 'sql' | 'session_replay' | 'error_tracking' | 'plan' | 'execution' | 'survey' | 'research' | 'flags' | 'llm_analytics' | 'sandbox' | 'user_interview' | 'customer_analytics'
  • product_analytics - product_analytics
  • sql - sql
  • session_replay - session_replay
  • error_tracking - error_tracking
  • plan - plan
  • execution - execution
  • survey - survey
  • research - research
  • flags - flags
  • llm_analytics - llm_analytics
  • sandbox - sandbox
  • user_interview - user_interview
  • customer_analytics - customer_analytics
is_sandboxboolean
resume_payloadunknown

Response

contentstring nullable required
conversationstring uuid required
contextual_toolsobject
ui_contextunknown
billing_contextunknown
trace_idstring uuid required
session_idstring
agent_mode'product_analytics' | 'sql' | 'session_replay' | 'error_tracking' | 'plan' | 'execution' | 'survey' | 'research' | 'flags' | 'llm_analytics' | 'sandbox' | 'user_interview' | 'customer_analytics'
  • product_analytics - product_analytics
  • sql - sql
  • session_replay - session_replay
  • error_tracking - error_tracking
  • plan - plan
  • execution - execution
  • survey - survey
  • research - research
  • flags - flags
  • llm_analytics - llm_analytics
  • sandbox - sandbox
  • user_interview - user_interview
  • customer_analytics - customer_analytics
is_sandboxboolean
resume_payloadunknown

Changes

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