Docs

Start here

Send the link to a request again

POST/v1/support/linkon https://api.auray.ai/v1

For somebody who has written in and lost the email.

For somebody who has written in and lost the email. Nothing is returned but a constant: the link is mailed to the address, so control of the mailbox is what opens the ticket. An address with a ticket, an address we have never seen and an address whose only tickets are held are answered identically — anybody may type any address here and learn nothing from doing it. Every send mints a new token and leaves the earlier ones working.

#Authentication

No key needed — this document is public.

#Request

#Body

application/json, required.

FieldTypeRequiredDefaultDescription
emailstringyes—Where the link is sent. Checked for shape only. 0 to 320 characters.
challengestringyes—From POST /v1/support/challenge, unchanged. Demanded here even though nothing is created, because this endpoint causes mail to an address the caller chose.
noncestringyes—0 to 64 characters.

#Example request

curl -X POST https://api.auray.ai/v1/support/link \
  -H "content-type: application/json" \
  -d '{
  "email": "…",
  "challenge": "…",
  "nonce": "…"
}'

#Responses

#202 Accepted

Accepted. The same answer for every address.

FieldTypeRequiredDefaultDescription
statusstringno—One of "sent_if_known".

Headers:

HeaderDescription
X-Request-Id

#400 Bad Request

support_email_invalid, challenge_required, challenge_invalid, challenge_expired, challenge_unsolved, invalid_body or invalid_json.

The error body: error, message, docs (the entry that explains it) and request_id.

#409 Conflict

challenge_spent — that challenge has already been used.

The error body: error, message, docs (the entry that explains it) and request_id.

#413 Payload Too Large

body_too_large — the body must be at most 65536 bytes.

The error body: error, message, docs (the entry that explains it) and request_id.

#429 Too Many Requests

support_rate_limited — one of three buckets refused: the recipient address, your address, or its network. The recipient's is drawn first, because they are the party who did not ask for any of this.

The error body: error, message, docs (the entry that explains it) and request_id.

#503 Service Unavailable

support_disabled, support_not_configured or support_unavailable.

The error body: error, message, docs (the entry that explains it) and request_id.

#Status codes

StatusMeaning
202Accepted. The same answer for every address.
400support_email_invalid, challenge_required, challenge_invalid, challenge_expired, challenge_unsolved, invalid_body or invalid_json.
409challenge_spent — that challenge has already been used.
413body_too_large — the body must be at most 65536 bytes.
429support_rate_limited — one of three buckets refused: the recipient address, your address, or its network.
503support_disabled, support_not_configured or support_unavailable.

Every refusal names its code, and every code is explained at Errors.

Start typing to search every page of the documentation.

Up arrow Down arrow to moveEnter to openEscape to close