Revoke a session
POST
/v1/backend/sessions/{sessionId}/revoke
const url = 'https://api.zautha.com/v1/backend/sessions/example/revoke';const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.zautha.com/v1/backend/sessions/example/revoke \ --header 'Authorization: Bearer <token>'Ends a pending or active session; an ended session is returned as it is. Its last session token stays valid until it expires, at most 60 seconds later.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”sessionId
required
string
Responses
Section titled “Responses”OK
Media typeapplication/json
object
id
required
string
user_id
required
string
status
required
created_at
required
string format: date-time
last_active_at
required
string format: date-time
expires_at
required
string format: date-time
abandon_at
required
null | string format: date-time
ended_at
required
null | string format: date-time
end_reason
required
null | string
browser
required
os
required
device_type
required
ip
required
null | string
Example
{ "status": "pending", "browser": "unknown", "os": "unknown", "device_type": "unknown"}The request is malformed, or a field is not valid (validation_failed names each one in errors).
Media typeapplication/problem+json
object
type
required
string
title
required
string
status
required
integer format: int32
detail
string
code
required
string
trace_id
required
string
reverification
object
level
required
string
after_minutes
required
integer format: int32
tasks
Array<string>
errors
Array<object>
object
field
required
string
code
required
string
message
required
string
Example
{ "code": "bad_request", "reverification": { "level": "first_factor" }, "tasks": [ "setup_mfa" ], "errors": [ { "code": "bad_request" } ]}The secret key is missing or not valid.
Media typeapplication/problem+json
object
type
required
string
title
required
string
status
required
integer format: int32
detail
string
code
required
string
trace_id
required
string
reverification
object
level
required
string
after_minutes
required
integer format: int32
tasks
Array<string>
errors
Array<object>
object
field
required
string
code
required
string
message
required
string
Example
{ "code": "bad_request", "reverification": { "level": "first_factor" }, "tasks": [ "setup_mfa" ], "errors": [ { "code": "bad_request" } ]}Not Found.
Media typeapplication/problem+json
object
type
required
string
title
required
string
status
required
integer format: int32
detail
string
code
required
string
trace_id
required
string
reverification
object
level
required
string
after_minutes
required
integer format: int32
tasks
Array<string>
errors
Array<object>
object
field
required
string
code
required
string
message
required
string
Example
{ "code": "bad_request", "reverification": { "level": "first_factor" }, "tasks": [ "setup_mfa" ], "errors": [ { "code": "bad_request" } ]}Too many requests with this secret key. Retry after the seconds in Retry-After.
Media typeapplication/problem+json
object
type
required
string
title
required
string
status
required
integer format: int32
detail
string
code
required
string
trace_id
required
string
reverification
object
level
required
string
after_minutes
required
integer format: int32
tasks
Array<string>
errors
Array<object>
object
field
required
string
code
required
string
message
required
string
Example
{ "code": "bad_request", "reverification": { "level": "first_factor" }, "tasks": [ "setup_mfa" ], "errors": [ { "code": "bad_request" } ]}Headers
Section titled “Headers”Retry-After
integer format: int32
Seconds to wait before retrying.
The service is temporarily unavailable. Try again shortly.
Media typeapplication/problem+json
object
type
required
string
title
required
string
status
required
integer format: int32
detail
string
code
required
string
trace_id
required
string
reverification
object
level
required
string
after_minutes
required
integer format: int32
tasks
Array<string>
errors
Array<object>
object
field
required
string
code
required
string
message
required
string
Example
{ "code": "bad_request", "reverification": { "level": "first_factor" }, "tasks": [ "setup_mfa" ], "errors": [ { "code": "bad_request" } ]}