Get session detail
Fetch one session plus a backward-paged window of its most recent events.
Restrictions
Usage
- Personal sessions are readable only by their creator; team sessions can be read by same-account callers with the
session_id. - Page older history with
search_after_ctxfrom the previous response. limit(or legacynum_recent_events) caps the event page; default 100, max 1000.- A malformed
search_after_ctxreturns 400 immediately, before any DB work. current_turn_*fields are populated only while the sessionis_running;suggest_initis the same account-wide onboarding flag assession/list.
Authorizations
App key issued from the Flashduty console. Required on every public API call. Keep it secret — it grants the same access as the owning account.
Body
Fetch one session plus a backward-paged window of its most recent events.
Target session ID.
1Share token for accessing a session through its share link. Omit it for normal account-authorized access.
512Legacy page size: number of most-recent events to return. Superseded by limit when both are set; 0 uses the server default (100).
0 <= x <= 1000Page size for events; takes precedence over num_recent_events. 0 uses the server default (100).
0 <= x <= 1000Opaque keyset cursor from a previous response; pass it back to fetch the next older page.
4096Response
Success
Standard response envelope used by every Flashduty public API. On success data contains the endpoint-specific payload and error is absent. On failure error is present and data is absent. request_id is always present and is also mirrored in the Flashcat-Request-Id response header.
Unique ID for this request. Mirrored in the Flashcat-Request-Id header. Include it when reporting issues.
"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"
Error payload inside the response envelope. Present only on non-2xx responses.
A session plus a backward-paged window of its events.