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

# Update Account

> Update an existing account's profile information including name, organization, image, instruction, job title, role type, company name, and knowledges. Requires authentication via x-api-key or Authorization Bearer token. The authenticated account may update itself or a permitted account_id override.



## OpenAPI

````yaml api-reference/openapi/accounts.json PATCH /api/accounts
openapi: 3.1.0
info:
  title: Recoup API - Accounts
  description: >-
    API documentation for the Recoup platform - an AI agent platform for the
    music industry
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.recoupable.dev
security: []
paths:
  /api/accounts:
    patch:
      description: >-
        Update an existing account's profile information including name,
        organization, image, instruction, job title, role type, company name,
        and knowledges. Requires authentication via x-api-key or Authorization
        Bearer token. The authenticated account may update itself or a permitted
        account_id override.
      requestBody:
        description: Account fields to update
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateAccountRequest'
      responses:
        '200':
          description: Account updated successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountDataResponse'
        '400':
          description: Bad request - account not found or update failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountErrorResponse'
        '401':
          description: Unauthorized - missing or invalid credentials
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountErrorResponse'
        '403':
          description: Forbidden - account override not permitted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountErrorResponse'
components:
  schemas:
    UpdateAccountRequest:
      type: object
      required:
        - accountId
      properties:
        accountId:
          type: string
          format: uuid
          description: The unique identifier of the account to update
        name:
          type: string
          description: Display name for the account
        instruction:
          type: string
          description: Custom instruction or bio for the account
        organization:
          type: string
          description: Organization name associated with the account
        image:
          type: string
          format: uri
          description: URL of the account's profile image
        jobTitle:
          type: string
          description: Job title of the account holder
        roleType:
          type: string
          description: Role type within the organization
        companyName:
          type: string
          description: Company name associated with the account
        knowledges:
          type: array
          items:
            $ref: '#/components/schemas/Knowledge'
          description: Knowledge base files attached to this account
    AccountDataResponse:
      type: object
      required:
        - data
      properties:
        data:
          $ref: '#/components/schemas/AccountData'
          description: The account data
    AccountErrorResponse:
      type: object
      required:
        - status
        - message
      properties:
        status:
          type: string
          enum:
            - error
          description: Status of the request
        message:
          type: string
          description: Error message describing what went wrong
    Knowledge:
      type: object
      properties:
        url:
          type: string
          description: URL to the knowledge file
        name:
          type: string
          description: Name of the knowledge file
        type:
          type: string
          description: MIME type of the file
    AccountData:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: The unique identifier of the account
        account_id:
          type: string
          format: uuid
          description: The account ID (same as id, for consistency)
        name:
          type: string
          description: Display name of the account
        email:
          type: string
          format: email
          description: Email address associated with the account
        wallet:
          type: string
          description: Wallet address associated with the account
        image:
          type: string
          format: uri
          description: URL of the account's profile image
        instruction:
          type: string
          description: Custom instruction or bio
        organization:
          type: string
          description: Organization name
        job_title:
          type: string
          description: Job title
        role_type:
          type: string
          description: Role type
        company_name:
          type: string
          description: Company name
        knowledges:
          type: array
          items:
            $ref: '#/components/schemas/Knowledge'
          description: Knowledge base files attached to this account

````