---
title: "Design, price and run a study from a plain-English objective"
method: POST
path: "/api/research-lab/autopilot"
---

# Design, price and run a study from a plain-English objective

`POST /api/research-lab/autopilot`

## Request

- Base URL: `https://api.aetherya.ai`
- URL: `https://api.aetherya.ai/api/research-lab/autopilot`
- Auth: HTTP bearer

Aetherya designs the study, picks or builds the audience and prices it. Nothing is spent until the run is confirmed.

## Headers

- `X-Aetherya-Workspace-Id` string

## Request body

- object
  - `request` string, required: The decision or question, in plain English. Include the variants to compare.

## Response `200`

The autopilot run.

- object
  - `id` string
  - `status` 'queued' | 'running' | 'awaiting_clarification' | 'awaiting_confirm' | 'completed' | 'failed' | 'cancelled'
  - `step` string
  - `estimate` object
    - `sessions` number: The figure to pass back as acceptedSessions.
  - `brief` object: Decision brief once completed: answer, confidence, reasons, risks, doNext, caveat.
  - `error` string

---

[API](https://skmtc.dev/aetherya/apis/aetherya-api.md) · [All operations](https://skmtc.dev/aetherya/apis/aetherya-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aetherya/apis/aetherya-api/revisions/afa076131ee1?raw)