Skip to main content
POST
/
v1
/
v2
/
conversations
/
test-chat
Mint a fresh test-type v2 conversation bound to an agent or team
curl --request POST \
  --url https://api-sandbox.featherhq.com/v1/v2/conversations/test-chat \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "team_revision_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "tool_input_overrides": {},
  "context_variables": {}
}
'
{
  "session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "end_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Authorizations

x-api-key
string
header
required

Body

application/json

Mint a fresh session_type="test" chat session for the dashboard.

The agent-detail Test chat panel uses this to avoid leaning on the identity graph: every "Reset" or "End session" mints a new throwaway end_user_id + ConversationSession row so dev-side Neo4j churn (wipes, merges, deletes) can never strand the panel with a stale uid. Mirrors POST /v1/voice/web-call for text/API.

Bind to exactly one of a single Assistant (agent_id) or a Team (team_id + optional team_revision_id) — the same single-XOR-team invariant the runtime conversations table enforces. When team_id is given without team_revision_id, the handler resolves the team's active revision.

agent_id
string<uuid> | null
team_id
string<uuid> | null
team_revision_id
string<uuid> | null
tool_input_overrides
Tool Input Overrides · object
context_variables
Context Variables · object

Response

Successful Response

session_id
string<uuid>
required
end_user_id
string<uuid>
required