Read the conversation a share link opens, as any signed-in caller holding the link

Changed on

Answers the session as its reader sees it and one page of people's turns and the agent's replies, text only (no attachments, tool calls, system messages or marks), oldest first, with the same opaque cursor as /sessions/{id}/events. Works for view-only and guest links. Unknown, rotated, disabled and deleted links all answer 404 not_found; reads are rate-limited per token (429 rate_limited with Retry-After). Needs a token with read scope from any workspace; the link is the grant, so the caller need not belong to the session's workspace.

get/links/{token}/events

Request

  • Base URL
    https://api.agentsky.dev/v1
  • URL
    https://api.agentsky.dev/v1/links/{token}/events
  • Auth
    none declared

Path parameters

tokenstring required

Query parameters

cursorstring

cursor from the previous page

limitinteger
order'asc' | 'desc'

desc reads newest-first; the cursor then continues older

Response

OK

eventsobject[] required

user.message and agent.message events, text parts only

cursorstring nullable required
hasMoreboolean required

Changes