Skip to main content
POST
End Session
Ends a session you started with Load, using the same API key. Ending disconnects any browser view paired to the session. MCP: workspace_session_end. CLI: rip workspace session end <workspace-id> <session-id> [--summary | --handoff-artifact-id]. Auth: Authorization: Bearer tr_... (an account API key). {id} and {sessionId} are UUIDs.

Request body

Send at most one of the two. Either one requires writeHandoff; any member, viewers included, can end a session with neither.

Response (201)

handoffArtifactId is the handoff’s public artifact id, or null. Repeating the request with the same body returns the original result. The next Load lists the handoff under handoffs; handoffs are ordinary artifacts, follow audience rules, and outlive the session.

Errors