com.atproto.server.createSession
POST/xrpc/com.atproto.server.createSession
This endpoint is part of the atproto PDS server and account management APIs. Requests often require authentication and are made directly to the user's own PDS instance.
To learn more about calling atproto API endpoints like this one, see the API Hosts and Auth guide.
Create an authentication session.
Request
- application/json
Body
required
Handle or other identifier supported by the server for the authenticating user.
Responses
- 200
- 400
- 401
OK
- application/json
- Schema
- Example (from schema)
Schema
Possible values: [takendown
, suspended
, deactivated
]
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.
{
"accessJwt": "string",
"refreshJwt": "string",
"handle": "string",
"did": "string",
"didDoc": {},
"email": "string",
"emailConfirmed": true,
"emailAuthFactor": true,
"active": true,
"status": "takendown"
}
Bad Request
- application/json
- Schema
- Example (from schema)
Schema
Possible values: [InvalidRequest
, ExpiredToken
, InvalidToken
, AccountTakedown
, AuthFactorTokenRequired
]
{
"error": "InvalidRequest",
"message": "string"
}
Unauthorized
- application/json
- Schema
- Example (from schema)
Schema
{
"message": "string"
}