---
title: "Execute Advanced Research Session"
method: POST
path: "/v1/advanced-research/completions"
tags: ["Advanced Research"]
---

# Execute Advanced Research Session

`POST /v1/advanced-research/completions`

Execute comprehensive research sessions with multi-source data collection, analysis, and synthesis capabilities.

## Headers

- `x-api-key` string, required

## Request body

- AdvancedResearchInputSchema
  - `config` AdvancedResearchConfig, required
    - `name` string, nullable — Name of the advanced research session
    - `description` string, nullable — Description of the advanced research session
    - `worker_model_name` string, nullable — Model name for worker agents
    - `director_agent_name` string, nullable — Name of the director agent
    - `director_model_name` string, nullable — Model name for the director agent
    - `director_max_tokens` integer, nullable — Maximum tokens for the director agent's output
    - `max_loops` integer, nullable — Number of research loops to run
    - `director_max_loops` integer, nullable — Maximum loops for the director agent
    - `exa_search_num_results` integer, nullable — Number of results to return from the Exa search tool
    - `exa_search_max_characters` integer, nullable — Maximum characters to return from the Exa search tool
  - `task` string, nullable, required — The task to be completed
  - `img` string, nullable — The image to be used for the advanced research

## Response `200`

Successful Response

- AdvancedResearchOutputSchema
  - `id` string, nullable, required — The id of the advanced research session
  - `name` string, nullable, required — The name of the advanced research session
  - `description` string, nullable, required — The description of the advanced research session
  - `outputs` unknown, required
  - `timestamp` string, nullable, required — The timestamp of the advanced research session
  - `sources` integer, nullable, required — The number of sources used for the advanced research session
  - `characters_per_source` integer, nullable, required — The number of characters per source used for the advanced research session
  - `usage` object, nullable, required — The usage of the advanced research session

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/the-swarm-corporation/apis/swarms-api.md) · [All operations](https://skmtc.net/the-swarm-corporation/apis/swarms-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/the-swarm-corporation/swarms-api/revisions/7618ad18b40e/schema)