> ## 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. # List saved Learnings > Uses the existing paginated Learning management read. Usage freshness describes recorded activity, not guaranteed live delivery. ## OpenAPI ````yaml /openapi.json get /v1/knowledge/learnings openapi: 3.0.3 info: title: CodeRabbit API spec version: 1.0.0 servers: - url: https://api.coderabbit.ai security: - ApiKeyAuth: [] paths: /v1/knowledge/learnings: get: tags: - Learnings summary: List saved Learnings description: >- Uses the existing paginated Learning management read. Usage freshness describes recorded activity, not guaranteed live delivery. operationId: list_learnings parameters: - name: page in: query schema: type: integer minimum: 1 maximum: 9007199254740991 default: 1 allowEmptyValue: true allowReserved: true - name: pageSize in: query schema: type: integer minimum: 1 maximum: 100 default: 10 allowEmptyValue: true allowReserved: true - name: sortField in: query schema: enum: - learning - usage_count - last_used - createdAt - updatedAt type: string default: createdAt allowEmptyValue: true allowReserved: true - name: sortDirection in: query schema: enum: - asc - desc type: string default: desc allowEmptyValue: true allowReserved: true - name: search in: query schema: type: string allowEmptyValue: true allowReserved: true - name: repoNames in: query schema: type: array items: type: string style: form explode: true allowEmptyValue: true allowReserved: true - name: files in: query schema: type: array items: type: string style: form explode: true allowEmptyValue: true allowReserved: true - name: users in: query schema: type: array items: type: string style: form explode: true allowEmptyValue: true allowReserved: true - name: statFilter in: query schema: enum: - total - active - neverUsed - createdThisWeek type: string allowEmptyValue: true allowReserved: true - name: activitySince in: query schema: type: string format: date-time allowEmptyValue: true allowReserved: true - name: activityUntil in: query schema: type: string format: date-time allowEmptyValue: true allowReserved: true - name: org_id in: query schema: type: string minLength: 1 description: >- Git-provider organization ID. Required for workspace keys; omit for organization keys. This differs from the CodeRabbit organization ID in scope.id. allowEmptyValue: true allowReserved: true responses: '200': description: OK content: application/json: schema: type: object properties: items: type: array items: type: object properties: id: type: string repo_name: type: string repo_owner: type: string learning: type: string user: type: string file: anyOf: - type: string - type: string nullable: true enum: - null url: anyOf: - type: string - type: string nullable: true enum: - null pull_request: anyOf: - type: number - type: string nullable: true enum: - null start_line: anyOf: - type: number - type: string nullable: true enum: - null end_line: anyOf: - type: number - type: string nullable: true enum: - null top_level_comment_id: anyOf: - type: string - type: string nullable: true enum: - null createdAt: type: string updatedAt: type: string usage_count: type: number last_used: anyOf: - type: string - type: string nullable: true enum: - null usageFreshness: type: object properties: kind: enum: - canonical_recorded_usage queriedAt: type: string liveDelivery: enum: - best_effort historicalCoverage: enum: - best_effort_observed required: - kind - queriedAt - liveDelivery - historicalCoverage required: - id - repo_name - repo_owner - learning - user - file - url - pull_request - start_line - end_line - top_level_comment_id - createdAt - updatedAt - usage_count - last_used totalCount: type: number usageFreshness: type: object properties: kind: enum: - canonical_recorded_usage queriedAt: type: string liveDelivery: enum: - best_effort historicalCoverage: enum: - best_effort_observed required: - kind - queriedAt - liveDelivery - historicalCoverage required: - items - totalCount '400': description: '400' content: application/json: schema: type: object properties: error: type: object properties: code: enum: - invalid_request type: string message: type: string retry_after: type: integer minimum: 0 maximum: 9007199254740991 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false '401': description: '401' content: application/json: schema: type: object properties: error: type: object properties: code: enum: - unauthenticated type: string message: type: string retry_after: type: integer minimum: 0 maximum: 9007199254740991 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false '403': description: '403' content: application/json: schema: type: object properties: error: type: object properties: code: enum: - forbidden type: string message: type: string retry_after: type: integer minimum: 0 maximum: 9007199254740991 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false '404': description: '404' content: application/json: schema: type: object properties: error: type: object properties: code: enum: - not_found type: string message: type: string retry_after: type: integer minimum: 0 maximum: 9007199254740991 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false '409': description: '409' content: application/json: schema: type: object properties: error: type: object properties: code: enum: - head_changed - conflict type: string message: type: string retry_after: type: integer minimum: 0 maximum: 9007199254740991 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false '412': description: '412' content: application/json: schema: type: object properties: error: type: object properties: code: enum: - precondition_failed type: string message: type: string retry_after: type: integer minimum: 0 maximum: 9007199254740991 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false '413': description: '413' content: application/json: schema: type: object properties: error: type: object properties: code: enum: - payload_too_large type: string message: type: string retry_after: type: integer minimum: 0 maximum: 9007199254740991 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false '429': description: '429' content: application/json: schema: type: object properties: error: type: object properties: code: enum: - rate_limit_exceeded type: string message: type: string retry_after: type: integer minimum: 0 maximum: 9007199254740991 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false '500': description: '500' content: application/json: schema: type: object properties: error: type: object properties: code: enum: - internal_error type: string message: type: string retry_after: type: integer minimum: 0 maximum: 9007199254740991 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false '503': description: '503' content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - unavailable message: type: string retry_after: type: integer minimum: 0 maximum: 9007199254740991 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false 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. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.