Skip to main content

SessionService

Source and message fields. Error family: session.

ListSessions​

Every live session, newest first.

  • Path: /backplane.console.v1.SessionService/ListSessions.
  • Input: ListSessionsRequest; output: ListSessionsResponse; mode: unary.
  • Errors: session + common.
  • Read/validation: safe to retry after a transient failure.
// client: SessionServiceClient; request: ListSessionsRequest; signal: AbortSignal
const response = await client.listSessions(request, { signal });

RevokeSession​

Ends a session: its connections close, its cookie stops working.

  • Path: /backplane.console.v1.SessionService/RevokeSession.
  • Input: RevokeSessionRequest; output: RevokeSessionResponse; mode: unary.
  • Errors: session + common.
  • Database mutation: never automatically replay after an ambiguous failure.
// client: SessionServiceClient; request: RevokeSessionRequest; signal: AbortSignal
const response = await client.revokeSession(request, { signal });

RevokeOtherSessions​

Ends every session but the caller's: after the admin token is rotated in the deployment, the sessions opened with the old one.

  • Path: /backplane.console.v1.SessionService/RevokeOtherSessions.
  • Input: RevokeOtherSessionsRequest; output: RevokeOtherSessionsResponse; mode: unary.
  • Errors: session + common.
  • Database mutation: never automatically replay after an ambiguous failure.
// client: SessionServiceClient; request: RevokeOtherSessionsRequest; signal: AbortSignal
const response = await client.revokeOtherSessions(request, { signal });