End a session
Ends the session in any state, including ACTIVE, and releases its instance. An ended
session cannot be restarted.
Only the user who started the session may end it. An API key acts as the user who owns it, so a server holding the key can end sessions started with any session token minted from that user’s keys. A session token can end only the sessions bound to it.
The optional reason (at most 256 bytes) is kept and returned as ended.message, with
ended.reason USER_REQUEST, to anyone who can read the session, including the holder of
a session token. Send only text that reader may see.
Authorizations
A Reactor API key (rk_...), sent as Authorization: Bearer rk_.... Keep it on a server.
Headers
The API protocol version the client speaks. Currently 1. Older versions than the server's minimum get 426.
"1"
Path Parameters
The session's ID, as returned by POST /sessions.
Body
Why the session is ending, at most 256 bytes. Returned as ended.message.
256Response
The session was ended. The body is empty.