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

# List Documents - GET /v1/workspaces/:workspace_id/documents

> Return documents under a workspace via GET /v1/workspaces/:workspace_id/documents, optionally filtered by kb_id. Minimum role viewer.

Return documents under a workspace, optionally scoped to a single KB via the `kb_id` query parameter.

## Endpoint

```http theme={null}
GET /v1/workspaces/:workspace_id/documents
```

## Authentication

`Authorization: Bearer <jwt>` or `X-API-Key <sk_...>`. Minimum role: **viewer**.

## Path parameters

**workspace\_id** `string` *required*

Workspace id.

## Query parameters

**kb\_id** `string`

Only return documents in this KB.

## Response

The response is an array; each element is a document:

**id** `string`

Document id.

**kb\_id** `string`

Owning KB id.

**workspace\_id** `string`

Owning workspace id.

**name** `string`

File name.

**path** `string`

Storage path.

**mime** `string`

MIME type.

**status** `string`

Parse status (`parsing` / `parsed` / `failed`).

**created\_at** `string`

Upload time (RFC3339).

## Example

```bash cURL theme={null}
curl "https://memo.ariacompute.com/v1/workspaces/ws_01a2b3c4d5e6/documents?kb_id=kb_01a2b3c4d5e6" \
  -H "Authorization: Bearer <jwt>"
```

```json 200 theme={null}
[
  {
    "id": "doc_01a2b3c4d5e6",
    "kb_id": "kb_01a2b3c4d5e6",
    "workspace_id": "ws_01a2b3c4d5e6",
    "name": "product.pdf",
    "path": "kb_01a2b3c4d5e6/product.pdf",
    "mime": "application/pdf",
    "status": "parsed",
    "created_at": "2026-10-12T08:02:00Z"
  }
]
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.