com.atproto.server.getSession

Get information about the current auth session. Requires auth.

Details · query
Kindquery
Authorityserver.atproto.com
Indexed

Query

query · GET

Output

application/json

active

boolean

did

requiredstring · did

didDoc

unknown

email

string

handle

requiredstring · handle

status

string

If active=false, this optional field indicates a possible reason for why the account is not active. If active=false and no status is supplied, then the host makes no claim for why the repository is no longer being hosted.

  • knownValues: takendown | suspended | deactivated

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • Refresh an authentication session. Requires auth using the 'refreshJwt' (not the 'accessJwt').

  • Create an authentication session.

  • Get the hosting status for a repository, on this server. Expected to be implemented by PDS and Relay.

  • Describe the signed-in ILLI session: the account behind the illi_session cookie, which app it belongs to, and when the account joined the ILLI service. Served by the ILLI Service Agent Node.

  • Who the caller is signed in as. The session cookie carries an opaque id and nothing else (ADR 0034 §2), so this is how a client learns its own DID — it cannot read one out of the cookie, by design. Answers 200 with `signedIn: false` rather than 401 for an anonymous caller: not being signed in is an ordinary state of the application, not an error in the request.