POST /api/auth/signin
Authentication flow · HTTP API reference
All endpoints · Authentication and retries · Download OpenAPI
- Part of a browser authentication or connection flow. Keep the flow's state and cookies; provider values in examples must come from that flow.
Request
No path, query or custom header parameters.
Body · application/json
email required · stringpassword required · stringExample
Examples use fictional data. Replace identifiers with resources you can access. For account requests, cookies.txt must contain your own session; set CSRF_TOKEN to the matching CSRF cookie value where required.
Save as request.json
{
"email": "developer@example.com",
"password": "EXAMPLE-only-Passphrase-42!"
}cURL (POSIX shell)
curl --include \
--request POST \
'https://api.weavers.app/api/auth/signin' \
--cookie cookies.txt --cookie-jar cookies.txt \
--header 'Content-Type: application/json' \
--data-binary @request.jsonResponses
200 · Successful response.
application/json
200 example · synthetic data
{
"message": "Explain the data used in this research.",
"user": {
"id": 1,
"name": "Example research",
"email": "developer@example.com"
}
}View response model
message required · stringuser required · objectView user model
id required · numbername required · stringemail required · stringAdditional fields: JSON values.
Additional fields: JSON values.
400 · Invalid request.
application/json
400 example · synthetic data
{
"error": "example"
}View response model
error required · stringAdditional fields: JSON values.
401 · Authentication is missing or invalid.
application/json
401 example · synthetic data
{
"error": "example",
"message": "Explain the data used in this research."
}View response model
error required · stringmessage required · stringAdditional fields: JSON values.
403 · Permission, origin or CSRF check failed.
application/json
403 example · synthetic data
{}View response model
Error envelopes can include resource-specific details. Check the status before reading these fields.
error optional · stringcode optional · stringmessage optional · stringAdditional fields: JSON values.
429 · Rate limit reached; honor Retry-After when supplied.
application/json
429 example · synthetic data
{
"error": "example",
"code": "example"
}View response model
Variant 1: object
error required · stringcode required · stringAdditional fields: JSON values.
500 · Server failure.
application/json
500 example · synthetic data
{
"error": "example"
}View response model
error required · stringAdditional fields: JSON values.