Address

Reference

Sign-in

address.seleya.ai's own sign-in, from its own page: emailed links and passkeys.

Markdown

Calls go to https://address.seleya.ai/api. A refusal is {"error": {"code", "message"}} with its status; every code is in Errors.

Email me a sign-in link

POST /v1/auth/email

Called by address.seleya.ai, signed in.

address.seleya.ai's own sign-in, from its own origin.

Body

email string required
request string
Optional pending OAuth request. The emailed link resumes its consent screen, including in another browser.

Answers

202
The link is on its way to that address; it works once, for 15 minutes.
400
The request is malformed
401
No valid key, session or token
403
Not allowed for this caller
422
A value is refused; the message says which
429
A limit is reached
502
The sign-in email could not be sent to that address
Answer 202
{
  "sent": true
}

Use a sign-in link

POST /v1/auth/email/verify

Called by address.seleya.ai, signed in.

address.seleya.ai's own sign-in, from its own origin.

Answers

200
Done
400
The request is malformed
401
No valid key, session or token
403
Not allowed for this caller
422
A value is refused; the message says which
429
A limit is reached
Answer 200
{
  "can_claim": [],
  "companies": [],
  "held": [],
  "passkeys": [],
  "person": {
    "email": "admin@acme.com",
    "id": "7f3c9a2e-0000-4000-8000-00000000002b"
  },
  "personal": null
}

Passkey: register

POST /v1/auth/passkeys/register

Called by address.seleya.ai, signed in.

address.seleya.ai's own sign-in, from its own origin.

Answers

200
Done
400
The request is malformed
401
No valid key, session or token
403
Not allowed for this caller
422
A value is refused; the message says which
429
A limit is reached

Passkey: registration options

POST /v1/auth/passkeys/register/options

Called by address.seleya.ai, signed in.

address.seleya.ai's own sign-in, from its own origin.

Answers

200
Done
400
The request is malformed
401
No valid key, session or token
403
Not allowed for this caller
422
A value is refused; the message says which
429
A limit is reached

Passkey: sign in

POST /v1/auth/passkeys/sign-in

Called by address.seleya.ai, signed in.

address.seleya.ai's own sign-in, from its own origin.

Answers

200
Done
400
The request is malformed
401
No valid key, session or token
403
Not allowed for this caller
422
A value is refused; the message says which
429
A limit is reached

Passkey: sign-in options

POST /v1/auth/passkeys/sign-in/options

Called by address.seleya.ai, signed in.

address.seleya.ai's own sign-in, from its own origin.

Answers

200
Done
400
The request is malformed
401
No valid key, session or token
403
Not allowed for this caller
422
A value is refused; the message says which
429
A limit is reached

Sign out

POST /v1/auth/sign-out

Called by address.seleya.ai, signed in.

address.seleya.ai's own sign-in, from its own origin.

Answers

200
Done
400
The request is malformed
401
No valid key, session or token
403
Not allowed for this caller
422
A value is refused; the message says which
429
A limit is reached

You

GET /v1/me

Called by address.seleya.ai, signed in.

The person signed in: companies, held addresses, own address, passkeys.

Answers

200
Done
401
No valid key, session or token
Fields of the 200 answer
person object
companies array of objects
held array of Address
can_claim array of objects
personal object
passkeys array of objects
next string
Optional relative consent path returned by email verification.

Remove a passkey

DELETE /v1/me/passkeys/{id}

Called by address.seleya.ai, signed in.

Removes one of your passkeys.

Parameters

id string, in path required
Its id.

Answers

204
Done, with no body
401
No valid key, session or token
404
Not found, or not yours to see

Docs