---
title: "Auth Password Verification Email Change"
method: POST
path: "/api/auth/password/verification/email"
tags: ["Auth"]
---

# Auth Password Verification Email Change

`POST /api/auth/password/verification/email`

## Request

- Base URL: `https://mcp.usertold.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://mcp.usertold.ai/api/auth/password/verification/email`
- Auth: none declared

Execute the UserTold auth password verification email change operation.

## Request body

- object
  - `email` string, required
  - `returnTo` string

## Response `200`

Success

- object
  - `accepted` true, required
  - `user` object
    - `id` number, required
    - `email` string, required
    - `name` string, required
    - `google_id` string, nullable, required
    - `github_id` string, nullable, required
    - `connected_auth_providers` string[], required
    - `personal_org_handle` string, nullable, required
    - `last_visited_org_handle` string, nullable, required
    - `personal_org_name` string, nullable, required
    - `terms_accepted_version` string, nullable, required
    - `terms_accepted_at` string, nullable, required
    - `personal_org_reviewed_at` string, nullable, required
    - `needs_onboarding` boolean, required
    - `needs_terms_acceptance` boolean, required
    - `terms_update_available` boolean, required
    - `legal_notices` object[]
      - `id` string, required
      - `publishedAt` string, required
      - `effectiveAt` string, required
      - `summary` string, required
      - `documents` object[], required
        - `document` 'terms' | 'privacy' | 'dpa', required
        - `version` string, required
        - `url` string, uri, required
      - `requiresAffirmativeConsent` boolean, required
    - `needs_org_handle_review` boolean, required
    - `gpc_opt_out_at` string, nullable, required
    - `is_admin` boolean, required
    - `created_at` string, required
    - `updated_at` string, required
    - `account_state` 'provisional' | 'active' | 'reclaimed', required
    - `email_verified_at` string, nullable, required
    - `capabilities` object, required
      - `profile_workspace_edit` boolean, required
      - `draft_research` boolean, required
      - `paid_inference` boolean, required
      - `promotional_credit` boolean, required
      - `study_launch` boolean, required
      - `billing_changes` boolean, required
      - `exports` boolean, required
      - `invitations` boolean, required
      - `integrations` boolean, required
      - `cli_mcp_grants` boolean, required
  - `landing_path` string

## Other responses

- `400`: Bad request
- `401`: Not authenticated
- `404`: Not found
- `422`: Domain error (non-retryable)
- `500`: Internal server error
- `503`: Domain error (retryable)

---

[API](https://skmtc.dev/usertold/apis/usertold-ai-api.md) · [All operations](https://skmtc.dev/usertold/apis/usertold-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usertold/apis/usertold-ai-api/revisions/37d5b4f88d38?raw)