> ## 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.

# search_issues

> Search issues by text, across titles and descriptions. Set `include_comments` to search inside comments too. This is full-text search; to filter on fields such as state or assignee, use `issues_list`.

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

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

result = await linear.search_issues.ainvoke({"variables": ...})
```

<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>

<Warning>
  This tool's JSON schema is 33 KB, because it models the whole resource this endpoint writes.
  That is more context than most tasks. Narrow it at the call site
  with [`Tool.derived`](/charter/charter/reference/tool#tool-derived):

  ```python theme={null}
  narrowed = linear.search_issues.derived(
      name="search_issues_narrowed",
      drop={"variables.filter"},
  )
  ```

  Those are its heaviest branches by schema size, not a recommendation: which ones you can spare is yours to decide. The tool underneath is unchanged.
  See [Projections](/charter/charter/tools/projections).
</Warning>

## Body

<div className="reference-table">
  | Field                                                             | Type                                                                                | Description         |
  | ----------------------------------------------------------------- | ----------------------------------------------------------------------------------- | ------------------- |
  | `variables` <span className="required" title="required">\*</span> | [SearchIssuesVariables](/charter/charter/packs/linear/search/objects#searchissuesvariables) | What to search for. |
</div>