Kagura AI Account Password API

openapi: 3.2.0
info:
  title: Kagura Memory Cloud Account Password API
  description: Universal AI Memory Platform - Remote MCP Server + Web Management
  version: 0.158.1
tags:
- name: account-password
  description: 'Set up, change or remove the signed-in account''s password (Issue #1678). Session-only auth (no API keys).'
paths:
  /api/v1/me/password/setup-request:
    post:
      tags:
      - account-password
      summary: Request Password Setup
      description: 'Email a set-a-password link to the signed-in account''s address.


        409 when the account already has a password; 400 for a local CLI account;

        429 after a few requests; 503 when the email could not be sent.'
      operationId: request_password_setup_api_v1_me_password_setup_request_post
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      responses:
        '202':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PasswordSetupRequestedResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/me/password/change:
    post:
      tags:
      - account-password
      summary: Change Password
      description: 'Change the password; every other browser session is revoked.


        403 when ``current_password`` is wrong; 409 when there is no password;

        422 when the new password breaks the policy. The owner is emailed a

        security notice.'
      operationId: change_password_api_v1_me_password_change_post
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PasswordChangeBody'
      responses:
        '204':
          description: Successful Response
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/me/password:
    delete:
      tags:
      - account-password
      summary: Remove Password
      description: 'Remove the password. Refused (409) while no OAuth provider is linked.


        403 when ``current_password`` is wrong. Every other browser session is

        revoked. The owner is emailed a security notice (sign-in method removed).'
      operationId: remove_password_api_v1_me_password_delete
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PasswordRemoveBody'
      responses:
        '204':
          description: Successful Response
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    PasswordRemoveBody:
      properties:
        current_password:
          type: string
          title: Current Password
      type: object
      required:
      - current_password
      title: PasswordRemoveBody
      description: Body for DELETE /me/password.
    PasswordChangeBody:
      properties:
        current_password:
          type: string
          title: Current Password
        new_password:
          type: string
          title: New Password
      type: object
      required:
      - current_password
      - new_password
      title: PasswordChangeBody
      description: Body for POST /me/password/change.
    PasswordSetupRequestedResponse:
      properties:
        status:
          type: string
          const: sent
          title: Status
          default: sent
      type: object
      title: PasswordSetupRequestedResponse
      description: Returned once the set-up link was emailed to the signed-in user.