v52

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-028581251.8 KB

com.atproto.server

Create an authentication session.

post/xrpc/com.atproto.server.createSession

Request body

passwordstring required

identifierstring required

Handle or other identifier supported by the server for the authenticating user.

allowTakendownboolean

When true, instead of throwing error for takendown accounts, a valid response with a narrow scoped token will be returned

authFactorTokenstring

Response

Success

didstring did required

emailstring

activeboolean

{"stackTrail":"paths:/xrpc/com.atproto.server.createSession:post:responses:200:content:application/json:schema:properties:didDoc","oasType":"schema","type":"unknown"}

handlestring handle required

statusstring

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.

accessJwtstring required

refreshJwtstring required

emailConfirmedboolean

emailAuthFactorboolean