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

# List documents



## OpenAPI

````yaml /api-reference/openapi.json get /v1/knowledge-base/documents
openapi: 3.0.0
info:
  title: Zeptar API
  description: >-
    The Zeptar API is organized around REST. All requests and responses are
    JSON. Endpoints are scoped to the authenticated user’s active organization
    unless the path specifies an organization explicitly.
  version: v1
  contact: {}
servers:
  - url: https://api.zeptar.com
    description: Production
  - url: http://localhost:3001
    description: Local development
security: []
tags:
  - name: dashboard
    description: Workspace analytics dashboard
  - name: api-keys
    description: Create, list, update, and revoke API keys
  - name: request-log
    description: Browse, filter, and export the history of authenticated API requests
  - name: voices
    description: Voices available for speech synthesis
  - name: llm
    description: Large language models available for agents
  - name: convai/agents
    description: CRUD on conversational AI agents
  - name: convai/conversations
    description: Start a preview conversation against an agent
  - name: conversations
    description: Browse conversation history, transcripts, tags, and analysis
  - name: organizations
    description: List and look up workspaces (organizations)
  - name: organizations/members
    description: Add and remove members from an org
  - name: me
    description: The current authenticated user
  - name: me/workspace-invitations
    description: Pending workspace invites for the current user
paths:
  /v1/knowledge-base/documents:
    get:
      tags:
        - Knowledge base documents
      summary: List documents
      operationId: KnowledgeDocumentsController_list
      parameters:
        - name: cursor
          required: false
          in: query
          description: Opaque pagination cursor from a prior response.
          schema:
            type: string
        - name: page_size
          required: false
          in: query
          description: Page size. Default 30, max 100.
          schema:
            type: number
        - name: folder_id
          required: false
          in: query
          description: Filter to one folder. Pass 'null' for root only.
          schema:
            type: string
        - name: ids
          required: false
          in: query
          description: Comma-separated document IDs for batch get.
          schema:
            type: string
        - name: types
          required: false
          in: query
          description: Filter by document type. Repeat the param for multiple.
          schema:
            type: array
            items:
              type: string
              enum:
                - text
                - file
                - url
        - name: search
          required: false
          in: query
          description: Case-insensitive substring search on the document name.
          schema:
            type: string
      responses:
        '200':
          description: ''
      security:
        - apiKey: []
        - cookie: []
components:
  securitySchemes:
    apiKey:
      scheme: bearer
      bearerFormat: zsk_…
      type: http
      description: >-
        API key issued via `POST /v1/api-keys`. Prefix is `zsk_`. Pass as
        `Authorization: Bearer zsk_…`. Scopes are enforced per key.
    cookie:
      type: apiKey
      in: cookie
      name: better-auth.session_token
      description: >-
        Session cookie set by `auth.api.signInEmail` (or the OAuth flow).
        Forwarded automatically by the browser; copy via `document.cookie` for
        server-to-server calls during development.

````