User Management

Manage your Pro user profile and accounts. All endpoints require Authorization: Bearer td_....

Get Profile

GET /api/user/me

Response (200):

{
  "id": "...",
  "email": "user@example.com",
  "plan": "pro",
  "role": "user",
  "status": "active",
  "max_domains": 3,
  "ops_used": 1234,
  "ops_limit": 100000,
  "domain_count": 1,
  "created_at": "2025-01-15T10:30:00Z",
  "downgraded": false
}

List All Accounts

GET /api/user/accounts

Lists all email accounts owned by the Pro user.

Response (200):

{
  "accounts": [
    {
      "id": "a1b2c3d4-...",
      "address": "hello@mydomain.com",
      "quota": 52428800,
      "used": 1234567,
      "created_at": "2025-01-15T10:30:00Z"
    }
  ]
}

Use the id from this list as {account_id} in the unified API endpoints:

GET /api/accounts/{account_id}/messages

Reset Mailbox Password

PUT /api/user/accounts/{id}/reset-password

Resets the password of a mailbox owned by the Pro user. The Pro user must be logged in — this is not a "forgot password" flow.

Request:

curl -X PUT https://api.mail.td/api/user/accounts/a1b2c3d4-.../reset-password \
  -H "Authorization: Bearer td_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"password":"newpassword123"}'

Field	Type	Required	Description
password	string	Yes	New mailbox password

Response (200):

{
  "message": "password_reset"
}

Errors:

Status	Error Code	Description
400	password_too_short	Password too short
404	not_found	Mailbox not found or not owned by this user