---
title: "List AI agent documents"
method: GET
path: "/api/v1/aiAgents/documents"
---

# List AI agent documents

`GET /api/v1/aiAgents/documents`

List every knowledge document in the organization.

## Query parameters

- `projectUuid` string

## Response `200`

Success

- ApiAiAgentDocumentSummaryListResponse
  - `results` AiAgentDocumentSummary[], required
    - `name` string, required
    - `uuid` string, required
    - `organizationUuid` string, required
    - `projectUuid` string, nullable, required
    - `updatedAt` string, date-time, required
    - `createdAt` string, date-time, required
    - `originalFilename` string, required
    - `mimeType` string, required
    - `contentSizeBytes` number, double, required
    - `alwaysIncludeInContext` boolean, required
    - `summary` AiAgentDocumentStructuredSummary, required
      - `warning` string, nullable, required
      - `relevance` 'high' | 'medium' | 'low' | 'none', required
      - `useWhen` string, required
      - `relatedExploreNames` string[], required
      - `definedTerms` string[], required
      - `description` string, required
    - `agentAccess` string[], required
    - `createdByUserUuid` string, nullable, required
    - `updatedByUserUuid` string, nullable, required
  - `status` 'ok', required

## Other responses

- `default` — Error

---

[API](https://skmtc.net/lightdash/apis/lightdash-api.md) · [All operations](https://skmtc.net/lightdash/apis/lightdash-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lightdash/lightdash-api/versions/40c933755c9a/schema)