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

# research_create

> Create an async research task that searches, analyzes sources, and generates a cited report. Poll results with research_get.

<div className="tool-route"><span className="tool-row-method" data-method="POST">POST</span><code>{"https://api.tavily.com/research"}</code></div>

```python tavily_research_create.py theme={null}
from charter.packs import tavily

result = await tavily.research_create.ainvoke({"input": ...})
```

## Body

<div className="reference-table">
  | Field                                                         | Type                                                                    | Description                                                                                                                                                                    |
  | ------------------------------------------------------------- | ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
  | `input` <span className="required" title="required">\*</span> | `string`                                                                | Research task or question.                                                                                                                                                     |
  | `model`                                                       | [ResearchModel](/charter/charter/packs/tavily/research/objects#researchmodel)   | Research agent model tier. The server applies `auto` when this is absent.                                                                                                      |
  | `outputSchema`                                                | [OutputSchema](/charter/charter/packs/tavily/research/objects#outputschema)     | JSON Schema defining structured output shape.                                                                                                                                  |
  | `citationFormat`                                              | [CitationFormat](/charter/charter/packs/tavily/research/objects#citationformat) | Citation format in the report. The server applies `numbered` when this is absent.                                                                                              |
  | `includeDomains`                                              | `string`\[]                                                             | Soft source preference (max 20). Host-based subdomain matching. <span className="field-constraints">max 20 items</span>                                                        |
  | `excludeDomains`                                              | `string`\[]                                                             | Hard blocklist (max 20). Downward subdomain matching only. <span className="field-constraints">max 20 items</span>                                                             |
  | `outputLength`                                                | [OutputLength](/charter/charter/packs/tavily/research/objects#outputlength)     | Target response size. The server applies `standard` when this is absent.                                                                                                       |
  | `files`                                                       | [ResearchFile](/charter/charter/packs/tavily/research/objects#researchfile)\[]  | Attach up to 5 files as additional sources. Each file may be at most 80,000 words; combined total at most 80,000 words. <span className="field-constraints">max 5 items</span> |
</div>