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

# documents_list

> List documents. Filter by project or initiative to scope them.

<div className="tool-route"><span className="tool-row-method" data-method="POST">POST</span><code>{"https://api.linear.app/graphql"}</code></div>

```python linear_documents_list.py theme={null}
from charter.packs import linear

result = await linear.documents_list.ainvoke({})
```

<Note>
  Posts a GraphQL document to `POST /graphql`, as every tool in this pack does. Pages by cursor: `pageInfo.endCursor` is sent back as `variables.after`.
</Note>

## Body

<div className="reference-table">
  | Field       | Type                                                                                     | Description           |
  | ----------- | ---------------------------------------------------------------------------------------- | --------------------- |
  | `variables` | [DocumentsListVariables](/charter/charter/packs/linear/documents/objects#documentslistvariables) | Paging and filtering. |
</div>