Tearleads

DELETE/auth/sessions/{sessionId}

Destroy a user session

Operation auth.sessions.destroy

Description

Signs out one of the caller's own sessions, for example a lost device. A session id that is unknown or belongs to another user returns 404.

Authentication

Requires a signed-in session: the client sends its session token as a bearer token in the Authorization header.

Parameters

NameInTypeDetails
sessionIdpathstringrequired
  • exactly 64 characters
  • lowercase hexadecimal

Responses

200 OK

application/jsonDestroySessionResponse

Confirms that a session was signed out.

1 field
  • messagestringrequired
    • always ok

Other fields are allowed.

Other responses

StatusMeaningBody
400Bad Request

application/jsonErrorResponse

401Unauthorized

application/jsonSessionFailureResponse

404Not Found

application/jsonErrorResponse

500Internal Server Error

application/jsonErrorResponse

503Service Unavailable

application/jsonErrorResponse