---
title: "Create Query Plan"
method: POST
path: "/api/v1/admin/query-plans"
tags: ["Query Plans"]
---

# Create Query Plan

`POST /api/v1/admin/query-plans`

## Request body

- object
  - `slug` string — Optional; auto-generated if omitted
  - `primaryLocale` string — Primary locale (e.g. zh)
  - `supportedLocales` string[] — Supported locales
  - `translations` object, required — Locale-keyed { name, description? } (e.g. { zh: {...}, en: {...} })
  - `queryableFields` object[], required
    - `field` string, required
    - `label` string, required
    - `allowMultiple` boolean, required
    - `required` boolean
  - `returnFields` string[], required
  - `status` 'active' | 'inactive'

## Response `201`

Created

- object — Created
  - `success` boolean, required
  - `data` object, required

## Other responses

- `400` — Validation failed

---

[API](https://skmtc.dev/newapi/apis/qn-platform-api.md) · [All operations](https://skmtc.dev/newapi/apis/qn-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/newapi/qn-platform-api/revisions/d61f11e363ff/schema)