Skip to main content

​
List Conversations

GET /api/v1/workspaces/{workspaceId}/insights/conversations
​
limit
number
default:"20"
Page size, clamped to 1–100.
​
offset
number
default:"0"
​
from
string
ISO 8601. Filters by updated_at (or created_at if updated_at is null) >= from.
​
to
string
ISO 8601. Filters by updated_at (or created_at) <= to.
​
app_id
string
Filter by app ID. Repeat the param for multiple apps, or use app_ids as a comma-separated list.
​
user_key
string
Filter by end user — matches metadata.external_user_id, metadata.anonymous_visitor_id, or session_id.
​
status
string
​
data
object[]
​
meta
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}
​
data
object
curl https://suite.sundaypyjamas.com/api/v1/workspaces/ws_123/insights/conversations/thr_a1b2... \
  -H "Authorization: Bearer spj_ai_your_api_key_here"

​
Errors

StatusErrorCause
401UnauthorizedInvalid key, or workspaceId doesn’t match your API key’s workspace
404Conversation not foundThread doesn’t exist or belongs to a different workspace