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

# Delete Superagent message

> <Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Deletes a message from one of your conversations with a Superagent.

The agent no longer sees the message in the conversation's history. Deleting a message that doesn't exist, or was already deleted, also succeeds.

<Note>This endpoint accepts a personal API key or personal access token belonging to a user with access to the agent. Workspace API keys are not accepted.</Note>



## OpenAPI

````yaml /developers/references/app-management/app-management-openapi.json delete /api/agents/{agent_id}/conversations/{conversation_id}/messages/{message_id}
openapi: 3.1.0
info:
  title: Base44 App Management API
  version: 1.0.0
servers:
  - url: https://app.base44.com
security:
  - PersonalAccessTokenAuth: []
paths:
  /api/agents/{agent_id}/conversations/{conversation_id}/messages/{message_id}:
    delete:
      summary: Delete Superagent message
      description: >-
        <Info>This API is in beta. Endpoints, fields, and behavior may still
        change, so avoid depending on it in production.</Info>


        Deletes a message from one of your conversations with a Superagent.


        The agent no longer sees the message in the conversation's history.
        Deleting a message that doesn't exist, or was already deleted, also
        succeeds.


        <Note>This endpoint accepts a personal API key or personal access token
        belonging to a user with access to the agent. Workspace API keys are not
        accepted.</Note>
      operationId: >-
        delete_message_api_agents__agent_id__conversations__conversation_id__messages__message_id__delete
      parameters:
        - name: conversation_id
          in: path
          required: true
          schema:
            type: string
            description: >-
              ID of the conversation the message is in. Get it from [Create
              Superagent
              conversation](/api-reference/create-superagent-conversation) or
              [List Superagent
              conversations](/api-reference/list-superagent-conversations).
            title: Conversation Id
          description: >-
            ID of the conversation the message is in. Get it from [Create
            Superagent
            conversation](/api-reference/create-superagent-conversation) or
            [List Superagent
            conversations](/api-reference/list-superagent-conversations).
          example: 68a1c2e4f0b9d3002e7a5c11
        - name: message_id
          in: path
          required: true
          schema:
            type: string
            description: >-
              ID of the message to delete. Get it from `messages` in [Get
              Superagent
              conversation](/api-reference/get-superagent-conversation).
            title: Message Id
          description: >-
            ID of the message to delete. Get it from `messages` in [Get
            Superagent
            conversation](/api-reference/get-superagent-conversation).
          example: 3f2504e0-4f89-41d3-9a0c-0305e82c3301
        - name: agent_id
          in: path
          required: true
          schema:
            type: string
            description: >-
              ID of the Superagent. It's the agent's app ID, shown in the
              agent's developer settings.
            title: Agent Id
          description: >-
            ID of the Superagent. It's the agent's app ID, shown in the agent's
            developer settings.
          example: 6820f3a4e7b91d003c45a1f2
      responses:
        '200':
          description: The message is deleted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeletedSuperagentMessage'
        '400':
          description: '`agent_id` belongs to an app that isn''t a Superagent.'
        '401':
          description: Missing or invalid credentials.
        '403':
          description: >-
            You don't have access to this agent, your API key is read-only, or
            the conversation belongs to another user or another agent.
        '404':
          description: Agent or conversation not found.
        '429':
          description: Rate limit exceeded (100 requests per minute).
components:
  schemas:
    DeletedSuperagentMessage:
      properties:
        message:
          type: string
          const: Message deleted
          title: Message
          description: Always `Message deleted`.
          example: Message deleted
      type: object
      required:
        - message
      title: DeletedSuperagentMessage
      description: Confirms the message is gone.
  securitySchemes:
    PersonalAccessTokenAuth:
      type: http
      scheme: bearer
      description: 'Personal access token, sent as `Authorization: Bearer <token>`.'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.