> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vos.verolabs.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Bắt đầu khôi phục mật khẩu

> Bắt đầu khôi phục mật khẩu



## OpenAPI

````yaml openapi.oms.vi.json POST /api/auth/recovery/start
openapi: 3.0.3
info:
  title: VOS OMS Public API
  version: 1.0.0
  description: >-
    Public REST API surface for Vero OMS. Authentication requests use
    platform.verolabs.co. REST API requests use api-oms.verolabs.co.
servers:
  - url: https://platform.verolabs.co
    description: Authentication host
  - url: https://api-oms.verolabs.co
    description: REST API host
security: []
tags:
  - name: Authentication
    description: Xác thực tài khoản và khôi phục mật khẩu.
  - name: Trading
    description: Order entry, quote, IOI, and trading activity APIs.
  - name: Portfolio & Risk
    description: Accounts, holdings, mappings, and risk-rule read APIs.
  - name: Administration
    description: Permissions, groups, workflow, reference data, and audit APIs.
  - name: System & Diagnostics
    description: Health and latency endpoints.
paths:
  /api/auth/recovery/start:
    post:
      tags:
        - Authentication
      summary: Bắt đầu khôi phục mật khẩu
      description: >-
        Gửi mã khôi phục dùng một lần đến email của tài khoản và tạo phiên khôi
        phục ngắn hạn. Lưu cookie trong phản hồi để gửi cùng các yêu cầu xác
        minh và đặt lại mật khẩu.
      operationId: post_api_auth_recovery_start
      requestBody:
        required: true
        description: Địa chỉ email của tài khoản.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AuthRecoveryStartRequest'
      responses:
        '200':
          description: Yêu cầu gửi mã khôi phục đã được chấp nhận
          headers:
            Set-Cookie:
              description: >-
                Cookie phiên khôi phục ngắn hạn bắt buộc cho yêu cầu khôi phục
                tiếp theo.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuthRecoveryStartResponse'
        '400':
          $ref: '#/components/responses/AuthError'
        '502':
          $ref: '#/components/responses/AuthError'
      servers:
        - url: https://platform.verolabs.co
components:
  schemas:
    AuthRecoveryStartRequest:
      type: object
      properties:
        email:
          type: string
          format: email
          description: Địa chỉ email liên kết với tài khoản Vero OMS.
      required:
        - email
      description: Yêu cầu gửi mã khôi phục mật khẩu dùng một lần.
      additionalProperties: false
    AuthRecoveryStartResponse:
      type: object
      properties:
        status:
          type: string
          enum:
            - code_sent
          description: Cho biết yêu cầu gửi mã khôi phục đã được chấp nhận.
      required:
        - status
      description: Trạng thái bắt đầu khôi phục mật khẩu.
      additionalProperties: false
    AuthError:
      type: object
      properties:
        error:
          type: string
          description: Machine-readable error code or error category.
        message:
          type: string
          description: Human-readable error message.
        status:
          type: integer
          format: int32
          description: Status value returned by the API.
      required:
        - error
        - message
        - status
      description: AuthError schema.
  responses:
    AuthError:
      description: Authentication error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/AuthError'

````