Sessions

List messages

GET https://api.129.212.147.181.sslip.io/v1/sessions/{session}/messages

The conversation, oldest first.

Path parameters

session string required

Query parameters

limit integer optional default 20
Page size, 1–100.
starting_after string optional
A message ID from the previous page; returns the messages after it.

Headers

Authorization string required
Bearer dg_test_… or Bearer dg_live_…
Docgen-Subject string optional
Your reference for the end user (a user ID, a hash; never an email). A session is bound to the subject it was created with, and every call on it must send the same value or it is 404. Set it from your own login, never from what the browser sent. Required to create and list sessions unless your organisation has subjects turned off.

Returns

200 OK: a MessageList object. One page of messages.

Errors

StatusCodeWhat to do
404session_not_foundCheck the ID, and that Docgen-Subject is the subject the session was created for.
410session_deletedThe session was deleted with its conversation and answers. Start a new one.

Any endpoint can also return the common errors (bad key, rate limit, idempotency).