---
title: "Submit Query"
method: POST
path: "/api/v1/experts/queries"
tags: ["Expert Oracle"]
---

# Submit Query

`POST /api/v1/experts/queries`

## Request

- Base URL: `https://app.aimrank.io` (the document declares no server; this is the origin it was published from)
- URL: `https://app.aimrank.io/api/v1/experts/queries`
- Auth: none declared

Submit a question to the expert pool.

Returns immediately with a query_id + status='pending'. The agent
polls GET /queries/{id} until status='answered' or SLA expires.

## Request body

- ExpertQueryCreate
  - `question` string, required
  - `context` string, nullable
  - `domain_id` string, nullable
  - `sla_tier` string
  - `timeout_seconds` integer

## Response `201`

Successful Response

- ExpertQueryResponse
  - `id` string, required
  - `domain_id` string, nullable, required
  - `question` string, required
  - `context` string, nullable, required
  - `sla_tier` string, required
  - `status` string, required
  - `answer` string, nullable, required
  - `expert_user_id` string, nullable, required
  - `expert_kappa_at_answer` number, nullable, required
  - `llm_judge_fallback` boolean, required
  - `created_at` string, nullable, required
  - `expires_at` string, nullable, required
  - `answered_at` string, nullable, required

## Other responses

- `422`: Validation Error

---

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