diff options
Diffstat (limited to 'docs/openapi.yaml')
| -rw-r--r-- | docs/openapi.yaml | 9 |
1 files changed, 7 insertions, 2 deletions
diff --git a/docs/openapi.yaml b/docs/openapi.yaml index 03afa2f..adee4a6 100644 --- a/docs/openapi.yaml +++ b/docs/openapi.yaml @@ -923,8 +923,13 @@ paths: '503': { description: Not ready yet. } delete: tags: [Auth] - summary: Forget the browser's session - description: The session cookie cleared. The token stays valid until it expires (`POST /auth/logout` ends them all). + summary: End the session + description: | + The session of the token it comes with (the cookie, or `Authorization: Bearer`) + ended: recorded as `_continuum/sessions/<user>/<session>` where the swarm has a + registry, so no node takes its tokens any more once the change reaches it; else on + this node only, others taking them until they expire. And the session cookie + cleared. (`POST /auth/logout` ends all of a user's sessions.) responses: '204': { description: Forgotten. } '401': |