API REFERENCE
Resend verification email
/api/v1/auth/verification/resendFor a valid email, returns a generic accepted message whether or not an unverified identity exists. For a pending identity, invalidates older verification links and queues a fresh 24-hour email verification challenge. Limit 5 per connection IP per minute. Sign into an already verified account rather than expecting another activation email.
Authentication
No bearer token required. This does not remove validation or rate limits.
Parameters
No path or query parameters.
Request
| Field | Type | Description & constraints |
|---|---|---|
emailRequired | string | Account email address.Format: email |
Example JSON body
{
"email": "dispatcher@example.com"
}Request schema
{
"$ref": "#/components/schemas/ResetRequest"
}Example request
Replace synthetic identifiers and credentials. Example dates, coordinates, revisions, and IDs are not production defaults. Read the workflow guide before making a write.
curl --request POST 'https://route-api.okok.space/api/v1/auth/verification/resend' \
--header 'Content-Type: application/json' \
--data '{"email":"dispatcher@example.com"}' \
--output response.binResponses
Examples illustrate the documented shape; optional fields and current state can differ. JSON extraction/body-limit errors may be plain text.
202 · If an unverified account exists, a fresh verification link will be emailed.
application/json
| Field | Type | Description & constraints |
|---|---|---|
messageRequired | string | Resource-specific value; see the related workflow and schema. |
Illustrative response
{
"message": "example"
}Response schema
{
"$ref": "#/components/schemas/Message"
}400 · Axum extraction rejects invalid JSON/type, oversized body, or malformed UUID before the domain handler. These responses may be text/plain rather than the domain Error object.
text/plain
Binary response. Save the returned bytes to a file; do not parse as JSON.
413 · Axum extraction rejects invalid JSON/type, oversized body, or malformed UUID before the domain handler. These responses may be text/plain rather than the domain Error object.
text/plain
Binary response. Save the returned bytes to a file; do not parse as JSON.
415 · Axum extraction rejects invalid JSON/type, oversized body, or malformed UUID before the domain handler. These responses may be text/plain rather than the domain Error object.
text/plain
Binary response. Save the returned bytes to a file; do not parse as JSON.
422 · Domain validation failure; names are trimmed and emails normalized.
application/json
| Field | Type | Description & constraints |
|---|---|---|
errorRequired | object | Resource-specific value; see the related workflow and schema. |
error fields
| Field | Type | Description & constraints |
|---|---|---|
error.codeRequired | validation | unauthorized | not_found | conflict | unavailable | rate_limited | Private activation or recovery code supplied to the driver. |
error.messageRequired | string | Resource-specific value; see the related workflow and schema. |
Illustrative response
{
"error": {
"code": "validation",
"message": "Domain validation failure; names are trimmed and emails normalized."
}
}Response schema
{
"$ref": "#/components/schemas/Error"
}429 · Connection-address request limit reached. Retry after the stated interval.
application/json
| Field | Type | Description & constraints |
|---|---|---|
errorRequired | object | Resource-specific value; see the related workflow and schema. |
error fields
| Field | Type | Description & constraints |
|---|---|---|
error.codeRequired | validation | unauthorized | not_found | conflict | unavailable | rate_limited | Private activation or recovery code supplied to the driver. |
error.messageRequired | string | Resource-specific value; see the related workflow and schema. |
Illustrative response
{
"error": {
"code": "rate_limited",
"message": "Connection-address request limit reached. Retry after the stated interval."
}
}Response schema
{
"$ref": "#/components/schemas/Error"
}503 · Required persistence or credential operation unavailable.
application/json
| Field | Type | Description & constraints |
|---|---|---|
errorRequired | object | Resource-specific value; see the related workflow and schema. |
error fields
| Field | Type | Description & constraints |
|---|---|---|
error.codeRequired | validation | unauthorized | not_found | conflict | unavailable | rate_limited | Private activation or recovery code supplied to the driver. |
error.messageRequired | string | Resource-specific value; see the related workflow and schema. |
Illustrative response
{
"error": {
"code": "unavailable",
"message": "Required persistence or credential operation unavailable."
}
}Response schema
{
"$ref": "#/components/schemas/Error"
}