---
title: "Create Prompt"
method: POST
path: "/api/prompts"
tags: ["Generation"]
---

# Create Prompt

`POST /api/prompts`

## Request body

- PromptRequest
  - `text` string, required
  - `db_connection_id` string, required
  - `metadata` object

## Response `201`

Successful Response

- PromptResponse
  - `id` string, required
  - `text` string, required
  - `db_connection_id` string, required
  - `metadata` PromptMetadata
    - `dh_internal` DHPromptMetadata
      - `generation_status` 'INITIALIZED' | 'IN_PROGRESS' | 'NOT_VERIFIED' | 'VERIFIED' | 'ERROR' | 'REJECTED' — An enumeration.
      - `created_by` string
      - `updated_by` string
      - `organization_id` string
      - `display_id` string
      - `slack_info` SlackInfo
        - `user_id` string
        - `channel_id` string
        - `thread_ts` string
        - `username` string
      - `message` string
  - `created_at` string, date-time

## Other responses

- `404` — Not found
- `422` — Validation Error

---

[API](https://skmtc.net/dataherald/apis/fastapi.md) · [All operations](https://skmtc.net/dataherald/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dataherald/fastapi/versions/e168e98625a8/schema)