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

# 获取文档列表

> 获取知识库中的文档列表

<ParamField header="Authorization" type="string" required>
  Bearer JWT Token
</ParamField>

<ParamField path="id" type="string" required>
  知识库 ID
</ParamField>

<ResponseField name="documents" type="array">
  文档列表

  <Expandable title="document object">
    <ResponseField name="id" type="string">
      文档唯一标识
    </ResponseField>

    <ResponseField name="fileName" type="string">
      文件名
    </ResponseField>

    <ResponseField name="fileType" type="string">
      文件 MIME 类型
    </ResponseField>

    <ResponseField name="fileSize" type="number">
      文件大小（字节）
    </ResponseField>

    <ResponseField name="status" type="string">
      处理状态：`pending` | `processing` | `completed` | `failed`
    </ResponseField>

    <ResponseField name="chunkCount" type="number">
      语义分块数量（处理完成后可用）
    </ResponseField>

    <ResponseField name="errorMessage" type="string">
      错误信息（`failed` 状态时可用）
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      上传时间（ISO 8601）
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url https://zeus-api.agentspro.cn/api/knowledge-base/kb_abc123/documents \
    --header 'Authorization: Bearer <token>'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "documents": [
      {
        "id": "doc_xyz789",
        "fileName": "product-guide.pdf",
        "fileType": "application/pdf",
        "fileSize": 2048576,
        "status": "completed",
        "chunkCount": 45,
        "errorMessage": null,
        "createdAt": "2025-06-10T08:00:00Z"
      }
    ]
  }
  ```
</ResponseExample>