---
title: "Create a prompt"
method: POST
path: "/genai/{connection_id}/prompt"
tags: ["genai", "prompt"]
---

# Create a prompt

`POST /genai/{connection_id}/prompt`

## Path parameters

- `connection_id` string, required

## Query parameters

- `fields` string[]
- `raw` string

## Request body

- GenaiPrompt
  - `model_id` string
  - `messages` GenaiContent[]
    - `role` 'SYSTEM' | 'USER' | 'ASSISTANT'
    - `content` string, required
  - `temperature` number
  - `max_tokens` number
  - `responses` string[]
  - `tokens_used` number
  - `mcp_url` string
  - `mcp_deferred_tools` string[]
  - `mcp_authorization_token` string
  - `raw` object

## Response `200`

Successful

- GenaiPrompt
  - `model_id` string
  - `messages` GenaiContent[]
    - `role` 'SYSTEM' | 'USER' | 'ASSISTANT'
    - `content` string, required
  - `temperature` number
  - `max_tokens` number
  - `responses` string[]
  - `tokens_used` number
  - `mcp_url` string
  - `mcp_deferred_tools` string[]
  - `mcp_authorization_token` string
  - `raw` object

---

[API](https://skmtc.net/unified/apis/unified-to-api.md) · [All operations](https://skmtc.net/unified/apis/unified-to-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unified/unified-to-api/versions/1f72720916e4/schema)