Self-serve register (email + password)

Public. Responses are byte-identical regardless of whether the email already exists (enumeration-safe): a valid request always returns 202 pendingVerification. The only non-202 branches are 400 (bad format), 429 (rate limit), and 503 (system email globally undeliverable — fail-closed, no account created). Password min length 8.

Request Body^required

application/json

object

email

required

string format: email

password

required

string

>= 8 characters

Example^generated

1
{
2
  "email": "hello@example.com",
3
  "password": "example"
4
}

Responses

202

Verification pending (uniform response)

application/json

object

boolean

pendingVerification

boolean

400

Invalid email or password format

application/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

1
{
2
  "error": "example",
3
  "message": "example"
4
}

429

Rate limited

application/json

object

error

required

string

retryAfterSeconds

integer

Example^generated

1
{
2
  "error": "example",
3
  "retryAfterSeconds": 1
4
}

503

Self-serve signup unavailable (system email undeliverable)

application/json

object

boolean

error

string

Allowed value: self_serve_signup_unavailable

Example

1
{
2
  "ok": false,
3
  "error": "self_serve_signup_unavailable"
4
}

POST

/api/auth/register

1
curl --request POST \
2
  --url https://retidal.com/api/auth/register \
3
  --header 'Content-Type: application/json' \
4
  --data '{
5
  "email": "<string>",
6
  "password": "<string>"
7
}'

1
const url = 'https://retidal.com/api/auth/register';
2
const options = {
3
  method: 'POST',
4
  headers: {'Content-Type': 'application/json'},
5
  body: '{"email":"<string>","password":"<string>"}'
6
};
7

8
try {
9
  const response = await fetch(url, options);
10
  const data = await response.json();
11
  console.log(data);
12
} catch (error) {
13
  console.error(error);
14
}

1
import requests
2

3
url = "https://retidal.com/api/auth/register"
4

5
payload = {
6
    "email": "<string>",
7
    "password": "<string>"
8
}
9
headers = {"Content-Type": "application/json"}
10

11
response = requests.post(url, json=payload, headers=headers)
12

13
print(response.json())

1
import httpx
2
import json
3

4
url = "https://retidal.com/api/auth/register"
5

6
payload = json.loads("{\n  \"email\": \"<string>\",\n  \"password\": \"<string>\"\n}")
7

8
response = httpx.post(url, json=payload)
9

10
print(response.json())

1
package main
2

3
import (
4
  "fmt"
5
  "strings"
6
  "net/http"
7
  "io"
8
)
9

10
func main() {
11

12
  url := "https://retidal.com/api/auth/register"
13

14
  payload := strings.NewReader("{\n  \"email\": \"<string>\",\n  \"password\": \"<string>\"\n}")
15

16
  req, _ := http.NewRequest("POST", url, payload)
17

18
  req.Header.Add("Content-Type", "application/json")
19

20
  res, _ := http.DefaultClient.Do(req)
21

22
  defer res.Body.Close()
23
  body, _ := io.ReadAll(res.Body)
24

25
  fmt.Println(res)
26
  fmt.Println(string(body))
27

28
}

202Verification pending (uniform response)

1
{
2
  "ok": true,
3
  "pendingVerification": true
4
}

Self-serve register (email + password)

Request Bodyrequired

Examplegenerated

Responses

202

400

Examplegenerated

429

Examplegenerated

503

Example

Request Body^required

Example^generated

Example^generated

Example^generated