Session Authentication
Logging in
In order to log a User in to a new Session, you must provide their credentials, in JSON format.
For security reasons, the only possible results are success or failure. No detail is provided upon failure.
Successful responses will come with an HTTP-Only, Secure-Only cookie. This cookie is primarily meant for use by the Central frontend, and we do not recommend relying upon it. It will only work on GET requests, and it will only work over HTTPS.
post/v1/sessions
Request body
Example request
{
"email": "my.email.address@getodk.org",
"password": "my.super.secure.password"
}Response
OK