Get messages from a playground session
Retrieve messages from a playground session with optional filtering. Supports polling via the `since` parameter to fetch only new messages.
JWT token for authentication
In: header
Path Parameters
Playground session UUID
uuidQuery Parameters
Sequence number cursor — returns only messages with sequenceNumber
greater than this value (forward pagination). Used for efficient
polling of the live conversation tail. Mutually exclusive with before.
0 <= valueSequence number cursor for backward pagination — returns the page of
messages with sequenceNumber LESS than this value, selecting the
limit messages with the highest sequence numbers below the cursor
(i.e. the page immediately older than the cursor). Used for
"load older" on scroll-up. Mutually exclusive with since.
0 <= valueWhen true, return the most recent limit messages (the conversation
tail), ignoring since and before. Use for the initial load of a
chat surface. Defaults to false, which preserves the legacy
oldest-first behavior when no cursor is supplied.
falseMaximum number of messages to return
1 <= value <= 500100Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/playground/sessions/497f6eca-6276-4993-bfeb-53cbbbba6f08/messages"{ "success": true, "message": "string", "error": "string", "data": [ { "id": "be4d854d-d6b3-4242-b2ea-0008b2e059bd", "sessionId": "fe5304ea-f069-433f-b0bf-945975c0b806", "role": "user", "content": "Hello. How are you?", "timestamp": "2026-01-19T10:03:32+01:00", "status": "completed", "sequenceNumber": 1, "parentMessageId": null, "nodeId": null, "metadata": {} } ], "hasMore": true, "hasOlder": true, "sessionStatus": "idle"}Get playground session details GET
Retrieve detailed information about a specific playground session, including its current status and configuration.
List playground sessions for a workflow GET
Retrieve all playground sessions associated with a workflow. Sessions are used to test and interact with workflows in an isolated environment.