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

# Delete Learning

> Idempotently deletes a canonical learning from PostgreSQL, the LanceDB knowledge index, and patterned-learning caches. Enterprise plan and learning:write permission required.

export const EnterprisePlanBadge = ({tip = "This feature is available exclusively as part of the Enterprise plan. Please refer to our pricing page for more information about our plans and features.", title = "Enterprise Plan", cta = "Read more", href = "https://coderabbit.ai/pricing", disabled = false}) => {
  return <Tooltip tip={tip} cta={cta} href={href}>
        <Badge icon="building-2" disabled={disabled || undefined}>
            {title}
        </Badge>
    </Tooltip>;
};

<EnterprisePlanBadge />

## Delete Learning

<Info>
  Requires the `learning:write` permission. Workspace API key owners must also remain workspace admins.
</Info>

## API key eligibility

User and workspace API keys can delete Learnings. Legacy organization API keys and agentic API keys cannot use this endpoint. A workspace API key must select one organization for every request by providing that organization's Git provider ID as `org_id`.

## Deletion behavior

Deletion is idempotent. CodeRabbit removes the canonical record and the vector used for review retrieval even when either is already absent, so retrying the request is safe.

## Rate limit

The Learnings write endpoints share a limit of 10 requests per minute per organization.


## OpenAPI

````yaml delete /v1/learnings/{learning_id}
openapi: 3.0.3
info:
  title: CodeRabbit API spec
  version: 1.0.0
servers:
  - url: https://api.coderabbit.ai
security:
  - ApiKeyAuth: []
paths:
  /v1/learnings/{learning_id}:
    delete:
      tags:
        - Learnings
      summary: Delete a learning
      description: >-
        Idempotently deletes a canonical learning from PostgreSQL, the LanceDB
        knowledge index, and patterned-learning caches. Enterprise plan and
        learning:write permission required.
      operationId: learnings-delete
      parameters:
        - in: path
          name: learning_id
          required: true
          schema:
            type: string
          description: Learning ID returned by GET or POST /v1/learnings.
        - in: query
          name: org_id
          required: false
          schema:
            type: string
          description: >-
            Required for workspace API keys; the git-provider organization ID to
            target. Ignored for organization keys.
      responses:
        '204':
          description: Learning deleted or already absent.
        '400':
          description: Invalid learning ID or missing workspace org_id.
        '401':
          description: Invalid key or missing authenticated identity.
        '403':
          description: >-
            Enterprise plan or learning:write permission required; agentic keys
            are forbidden.
        '404':
          description: The selected organization is not in the workspace.
        '410':
          description: Legacy organization keys cannot delete learnings.
        '429':
          description: Rate limit exceeded.
        '500':
          description: PostgreSQL, LanceDB, or internal service deletion failed.
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-coderabbitai-api-key
      description: >-
        API key for authentication. You can create an API key from the
        CodeRabbit dashboard.

````