System
Native health and first-party session resources.
Read current session
GET
/api/sessionReads safe metadata for the authoritative current Better Auth session.
Responses
cache-controlRequired
stringValues
no-storevaryRequired
stringValues
Origincache-controlRequired
stringValues
no-storevaryRequired
stringValues
Originwww-authenticateRequired
stringcache-controlRequired
stringValues
no-storevaryRequired
stringValues
Origincache-controlRequired
stringValues
no-storeretry-afterRequired
stringValues
5varyRequired
stringValues
OriginHeader Parameters
Responses
cache-controlRequired
stringValues
no-storevaryRequired
stringValues
Origincache-controlRequired
stringValues
no-storevaryRequired
stringValues
Origincache-controlRequired
stringValues
no-storevaryRequired
stringValues
Originwww-authenticateRequired
stringcache-controlRequired
stringValues
no-storevaryRequired
stringValues
Origincache-controlRequired
stringValues
no-storeretry-after
string | nullvaryRequired
stringValues
Origincache-controlRequired
stringValues
no-storevaryRequired
stringValues
Origincache-controlRequired
stringValues
no-storeretry-afterRequired
stringValues
5varyRequired
stringValues
OriginList current person's sessions
GET
/api/sessionsLists only safe metadata for sessions owned by the authenticated person.
Responses
cache-controlRequired
stringValues
no-storevaryRequired
stringValues
Origincache-controlRequired
stringValues
no-storevaryRequired
stringValues
Originwww-authenticateRequired
stringcache-controlRequired
stringValues
no-storevaryRequired
stringValues
Origincache-controlRequired
stringValues
no-storeretry-afterRequired
stringValues
5varyRequired
stringValues
OriginRevoke all sessions
POST
/api/sessions:revoke-allRevokes every owned session, including the authoritative current session.
Header Parameters
Responses
cache-controlRequired
stringValues
no-storevaryRequired
stringValues
Origincache-controlRequired
stringValues
no-storevaryRequired
stringValues
Origincache-controlRequired
stringValues
no-storevaryRequired
stringValues
Originwww-authenticateRequired
stringcache-controlRequired
stringValues
no-storevaryRequired
stringValues
Origincache-controlRequired
stringValues
no-storeretry-after
string | nullvaryRequired
stringValues
Origincache-controlRequired
stringValues
no-storevaryRequired
stringValues
Origincache-controlRequired
stringValues
no-storeretry-afterRequired
stringValues
5varyRequired
stringValues
OriginRevoke other sessions
POST
/api/sessions:revoke-othersRevokes every owned session except the authoritative current session.
Header Parameters
Responses
cache-controlRequired
stringValues
no-storevaryRequired
stringValues
Origincache-controlRequired
stringValues
no-storevaryRequired
stringValues
Origincache-controlRequired
stringValues
no-storevaryRequired
stringValues
Originwww-authenticateRequired
stringcache-controlRequired
stringValues
no-storevaryRequired
stringValues
Origincache-controlRequired
stringValues
no-storeretry-after
string | nullvaryRequired
stringValues
Origincache-controlRequired
stringValues
no-storevaryRequired
stringValues
Origincache-controlRequired
stringValues
no-storeretry-afterRequired
stringValues
5varyRequired
stringValues
OriginRevoke one session
DELETE
/api/sessions/{sessionId}Revokes one owned session; missing and non-owned identifiers are concealed.
Path Parameters
Header Parameters
Responses
cache-controlRequired
stringValues
no-storevaryRequired
stringValues
Origincache-controlRequired
stringValues
no-storevaryRequired
stringValues
Origincache-controlRequired
stringValues
no-storevaryRequired
stringValues
Originwww-authenticateRequired
stringcache-controlRequired
stringValues
no-storevaryRequired
stringValues
Origincache-controlRequired
stringValues
no-storevaryRequired
stringValues
Origincache-controlRequired
stringValues
no-storeretry-after
string | nullvaryRequired
stringValues
Origincache-controlRequired
stringValues
no-storevaryRequired
stringValues
Origincache-controlRequired
stringValues
no-storeretry-afterRequired
stringValues
5varyRequired
stringValues
OriginResponses
cache-controlRequired
stringValues
no-storevaryRequired
stringValues
Origincache-controlRequired
stringValues
no-storevaryRequired
stringValues
Origincache-controlRequired
stringValues
no-storeretry-afterRequired
stringValues
5varyRequired
stringValues
Origin