Request a magic-link login email
POST
/login/requests
const url = 'https://quikstik-core.fly.dev/login/requests';const options = { method: 'POST', headers: { 'x-tenant-id': '2489E9AD-2EE2-8E00-8EC9-32D5F69181C0', 'Content-Type': 'application/json' }, body: '{"email":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://quikstik-core.fly.dev/login/requests \ --header 'Content-Type: application/json' \ --header 'x-tenant-id: 2489E9AD-2EE2-8E00-8EC9-32D5F69181C0' \ --data '{ "email": "example" }'Always 202. If the email maps to an account in the tenant, a single-use short-TTL link is
issued and emailed; otherwise nothing happens — the response is identical either way.
Parameters
Section titled “Parameters”Header Parameters
Section titled “Header Parameters”x-tenant-id
required
string format: uuid
Tenant identifier (UUID).
Authn/authz semantics are intentionally TBD for this contract slice; this header exists to keep the contract explicitly multi-tenant from day 0.
Request Bodyrequired
Section titled “Request Bodyrequired”Media typeapplication/json
object
email
required
string
Example generated
{ "email": "example"}Responses
Section titled “Responses”Accepted (identical for known and unknown emails)
Malformed body
Media typeapplication/json
object
reason
required
string
Example generated
{ "reason": "example"}No durable backend is wired for this operation (fail-closed)
Media typeapplication/json
object
reason
required
Stable, machine-readable reason code (e.g. “sold_out”, “processor_not_configured”, “rail_refused”).
string
Example
{ "reason": "sold_out"}