> ## 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 Chat

> Update a chat room's topic (display name). The chatId is required; the topic field will be updated. Topic must be between 3 and 50 characters.



## OpenAPI

````yaml patch /api/chats
openapi: 3.1.0
info:
  title: Recoup API - Research
  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/chats:
    patch:
      description: >-
        Update a chat room's topic (display name). The chatId is required; the
        topic field will be updated. Topic must be between 3 and 50 characters.
      requestBody:
        description: Chat fields to update
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateChatRequest'
      responses:
        '200':
          description: Chat updated successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateChatResponse'
        '400':
          description: Bad request - invalid parameters or validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateChatErrorResponse'
        '401':
          description: Unauthorized - invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Forbidden - API key does not have access to this chat
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Not found - chat room does not exist
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateChatErrorResponse'
components:
  schemas:
    UpdateChatRequest:
      type: object
      required:
        - chatId
        - topic
      properties:
        chatId:
          type: string
          format: uuid
          description: The unique identifier (UUID) of the chat room to update
        topic:
          type: string
          minLength: 3
          maxLength: 50
          description: >-
            The new display name for the chat room. Must be between 3 and 50
            characters.
    UpdateChatResponse:
      type: object
      required:
        - status
        - chat
      properties:
        status:
          type: string
          enum:
            - success
          description: Status of the request
          example: success
        chat:
          $ref: '#/components/schemas/ChatRoom'
          description: The updated chat room object
    UpdateChatErrorResponse:
      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
    Error:
      required:
        - error
        - message
      type: object
      properties:
        error:
          type: integer
          format: int32
        message:
          type: string
    ChatRoom:
      type: object
      required:
        - id
        - title
        - accountId
        - sessionId
        - updatedAt
      properties:
        id:
          type: string
          format: uuid
          description: Chat id.
        title:
          type: string
          description: Display title for the chat.
        accountId:
          type: string
          format: uuid
          description: Owning account for this chat.
        sessionId:
          type: string
          format: uuid
          description: >-
            Session that owns this chat. Combine with `id` to build the chat
            URL: `/sessions/{sessionId}/chats/{id}`.
        updatedAt:
          type: string
          format: date-time
          description: ISO timestamp of the last update.
        artistId:
          type: string
          format: uuid
          nullable: true
          description: >-
            Artist account id this chat's session was created in the context of,
            or `null` when no artist was associated. Inherited from
            `sessions.artist_id` on the owning session.

````