Conversations

List Conversations

GET /api/v1/workspaces/{workspaceId}/insights/conversations

number

default:"20"

Page size, clamped to 1–100.

number

default:"0"

string

ISO 8601. Filters by updated_at (or created_at if updated_at is null) >= from.

string

ISO 8601. Filters by updated_at (or created_at) <= to.

string

Filter by app ID. Repeat the param for multiple apps, or use app_ids as a comma-separated list.

string

Filter by end user — matches metadata.external_user_id, metadata.anonymous_visitor_id, or session_id.

string

object[]

Show Conversation summary

string

string | null

number | null

string | null

object | null

string

Derived end-user identifier

object

Show usage_summary

number

object

{ limit, offset, total }

curl "https://suite.sundaypyjamas.com/api/v1/workspaces/ws_123/insights/conversations?limit=10&from=2026-06-01" \
  -H "Authorization: Bearer spj_ai_your_api_key_here"

Get Conversation

GET /api/v1/workspaces/{workspaceId}/insights/conversations/{threadId}

object

Show Conversation detail

string

string | null

number | null

string | null

object | null

object[]

Show message

string

Truncated to 4000 characters (with …) if longer

number

string | null

object[]

Show usage_record

string

string | null

number | null

string | null

object[]

Per-component cost breakdown

object[]

Up to 200 most recent raw usage events

curl https://suite.sundaypyjamas.com/api/v1/workspaces/ws_123/insights/conversations/thr_a1b2... \
  -H "Authorization: Bearer spj_ai_your_api_key_here"

Errors

Status	Error	Cause
401	`Unauthorized`	Invalid key, or `workspaceId` doesn’t match your API key’s workspace
404	`Conversation not found`	Thread doesn’t exist or belongs to a different workspace

Chat

Agents

RAG

Artifacts

Image

Vector Store

Apps

Storage

Integrations

Insights

Platform Tools

List Conversations

Get Conversation

Errors

​List Conversations

​Get Conversation

​Errors

List Conversations

Get Conversation

Errors