---
title: "Create Prompt"
method: POST
path: "/api/v1/intelligence/prompts"
tags: ["prompts-ddd", "Admin - Prompts"]
---

# Create Prompt

`POST /api/v1/intelligence/prompts`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/api/v1/intelligence/prompts`
- Auth: none declared

Create a new prompt.

## Headers

- `Authorization` string

## Request body

- PromptCreate: Model for creating a new prompt.
  - `name` string, required: Prompt name
  - `description` string, required: Prompt description
  - `category` string, required: Prompt category
  - `system_prompt` string, nullable: System message for LLM
  - `user_prompt_template` string, required: User prompt template with variables
  - `subcategory` string, nullable: Subcategory for more specific classification
  - `model_preferences` object, nullable: Preferred models and settings
  - `parameters` object, nullable: LLM parameters (temperature, max_tokens, etc)
  - `input_variables` string[], nullable: List of expected template variables
  - `output_format` object, nullable: Expected output structure
  - `status` string: Prompt status
  - `is_default` boolean: Set as default for category
  - `test_inputs` object, nullable: Sample inputs for testing
  - `expected_outputs` object, nullable: Expected outputs for validation

## Response `201`

Successful Response

- StandardResponse: Standard API response wrapper.
  - `success` boolean, required
  - `data` unknown
  - `message` string, nullable
  - `error` string, nullable
  - `meta` object, nullable

## Other responses

- `422`: Validation Error

---

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