Skip to main content
GET
/
api
/
v1
/
assistants
/
{assistant_id}
/
documents
List Documents
curl --request GET \
  --url https://api.example.com/api/v1/assistants/{assistant_id}/documents \
  --header 'Authorization: Bearer <token>'
{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}
This endpoint retrieves a list of all documents that have been uploaded to a specific assistant’s knowledge base.

​
Path Parameters

  • assistant_id (string, required): The unique identifier of the assistant whose documents you want to list.

​
Response

The response is a JSON array of document objects, each containing details about a specific document.
Response
[
  {
    "id": "doc_1234567890",
    "user_id": "user_12345",
    "organization_id": "org_67890",
    "assistant_id": "asst_a1b2c3d4e5f67890",
    "name": "product_faq.pdf",
    "status": "completed",
    "created_at": "2023-10-28T16:00:00Z",
    "updated_at": "2023-10-28T16:05:00Z"
  },
  {
    "id": "doc_abcdefghij",
    "user_id": "user_12345",
    "organization_id": "org_67890",
    "assistant_id": "asst_a1b2c3d4e5f67890",
    "name": "onboarding_guide.docx",
    "status": "completed",
    "created_at": "2023-10-29T10:00:00Z",
    "updated_at": "2023-10-29T10:02:00Z"
  }
]

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
assistant_id
integer
required

Response

Successful Response