Skip to content

docs(sdk): cover the session logout endpoint across docs and all five SDKs - #995

Merged
rmyndharis merged 1 commit into
mainfrom
docs/logout-endpoint-coverage
Jul 29, 2026
Merged

docs(sdk): cover the session logout endpoint across docs and all five SDKs#995
rmyndharis merged 1 commit into
mainfrom
docs/logout-endpoint-coverage

Conversation

@rmyndharis

Copy link
Copy Markdown
Owner

Description

Follow-up to #984 (now merged). POST /sessions/:id/logout is reachable over REST but was absent from the hand-written reference docs and from every client, leaving each one a session route behind the API. This brings docs, all five SDKs, and the dashboard's API client back in sync.

  • Docs — new route section in docs/06 (including the 400 raised for a session that is not running), curl collection entry in docs/07, session_logged_out added to the AuditAction enumeration in docs/05, the deliberate-omission list in docs/24, and the per-language method tables in docs/18 and sdk/README.md.
  • SDKs — a logout method in the Go, Java, JavaScript, PHP, and Python SDKs, each mirroring the neighbouring forceKill, plus a routing test per language asserting the exact path.
  • DashboardsessionApi.logout(id) in dashboard/src/services/api.ts.
  • CHANGELOG — entry under [Unreleased] → Added.

No runtime behaviour changes; docs/client surface only. docs/18 documents only the TypeScript, Python, and PHP SDKs — Go and Java have never been covered there, which is left as-is.

Type of Change

  • Bug fix
  • New feature
  • Breaking change
  • Documentation update

Checklist

  • Tests added/updated
  • Documentation updated
  • Lint passes
  • Self-reviewed

Related Issues

Relates to #984

… SDKs

POST /sessions/:id/logout is reachable over REST but was absent from the
hand-written reference docs and from every SDK, leaving each client one
session route behind the API.

Adds the route to docs/06 (with the 400 raised for a session that is not
running), the curl collection in docs/07, the AuditAction enumeration in
docs/05, the deliberate-omission list in docs/24, and the per-language
method tables in docs/18 and sdk/README.md.

Adds a logout method to the Go, Java, JavaScript, PHP and Python SDKs,
mirroring the neighbouring forceKill in each, plus a routing test per
language asserting the exact path. The dashboard's sessionApi gains a
matching logout(id), and the CHANGELOG records the client-side additions.

docs/18 documents only the TypeScript, Python and PHP SDKs; Go and Java
have never been covered there, which is left as-is.
@rmyndharis
rmyndharis merged commit abf8bcb into main Jul 29, 2026
15 checks passed
@rmyndharis
rmyndharis deleted the docs/logout-endpoint-coverage branch July 29, 2026 09:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant