> ## Documentation Index
> Fetch the complete documentation index at: https://actianvectorai-ml-crtx-1153-academy-tutorial-rewrites.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Reset admin password

> Resets the built-in admin user's password. The username is always fixed to `admin`.

This endpoint can only be called from localhost (the same machine as the server). The new password must satisfy the same password policy as the create endpoint.




## OpenAPI

````yaml post /auth/admin/reset-password
openapi: 3.0.3
info:
  title: Actian VectorAI DB - Authentication API
  description: Access token and admin user management for VectorAI DB.
  version: 1.0.0
  contact:
    name: Actian Corporation
    url: https://www.actian.com
servers:
  - url: http://localhost:6573
    description: Local development server (REST API)
  - url: https://api.vectorai.actian.com
    description: Production server
security:
  - bearerAuth: []
tags:
  - name: Access Tokens
    description: Create, list, rotate, and delete access tokens.
  - name: Admin User
    description: Create and manage the admin user, login, and authentication settings.
paths:
  /auth/admin/reset-password:
    post:
      tags:
        - Admin User
      summary: Reset admin password
      description: >
        Resets the built-in admin user's password. The username is always fixed
        to `admin`.


        This endpoint can only be called from localhost (the same machine as the
        server). The new password must satisfy the same password policy as the
        create endpoint.
      operationId: reset_admin_password
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - password
              properties:
                password:
                  type: string
                  description: >-
                    New password for the admin user. Must satisfy the password
                    policy.
      responses:
        '200':
          description: Password reset successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatusResponse'
              examples:
                success:
                  value:
                    status: success
                    message: Password reset successfully
        '400':
          description: Missing or invalid password.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                missing_password:
                  value:
                    status: error
                    message: 'Missing required field: password'
        '404':
          description: Admin user does not exist.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                not_found:
                  value:
                    status: error
                    message: User not found
      x-codeSamples:
        - lang: cURL
          label: Reset admin password
          source: |
            curl -X POST http://localhost:6575/auth/admin/reset-password \
              -H "Content-Type: application/json" \
              -H 'Authorization: Bearer <admin-jwt-or-access-token>' \
              -d '{
                "password": "MyNewSecurePwd!2"
              }'
components:
  schemas:
    StatusResponse:
      type: object
      properties:
        status:
          type: string
          description: Operation result status.
        message:
          type: string
          description: Human-readable status message.
    ErrorResponse:
      type: object
      properties:
        status:
          type: string
          description: Error status indicator.
        message:
          type: string
          description: Human-readable error description.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Admin JWT obtained from the login endpoint.

````