close_session

Category: sessions
Access: write
Audience: ordinary (an ordinary user normally calls this directly)

Purpose

Closes one of your own sessions. Call it for renewal hygiene when a session is no longer needed.

Arguments

Required: session_id.

session_id.

Result

Object with closed (echoed session_id) and matched (1 closed, 0 untouched).

Boundaries

Only entries owned by the caller's own principal flip; foreign or unknown ids report matched 0 with no existence oracle. Operates inside the selected profile boundary.

Lifecycle / side effects

Moves one owned live session entry to ended. No history is removed; the entry stays as renewal hygiene evidence.

Errors

Missing session_id rejected by validation. Foreign or already-closed sessions are not errors: matched 0.

Example

{
  "session_id": "<uuid>"
}

Result shape:

{
  "closed": "<uuid>",
  "matched": 1
}