Run Prompt

curl https://gateway.yourapp.com/v1/prompts/my-translator/run \
  -H "Content-Type: application/json" \
  -H "Authorization: GatelitKey sk_live_..." \
  -d '{
    "variables": {
      "source_language": "English",
      "target_language": "French",
      "text": "Hello, how are you?"
    }
  }'

{
  "id": "<string>",
  "object": "chat.completion",
  "created": 123,
  "model": "<string>",
  "choices": [
    {
      "index": 123,
      "message": {
        "role": "user",
        "content": "Explain quantum entanglement in one sentence."
      }
    }
  ],
  "usage": {
    "prompt_tokens": 123,
    "completion_tokens": 123,
    "total_tokens": 123
  }
}

{
  "error": true,
  "code": "gateway_error",
  "message": "Missing required variable: user_name"
}

{
  "error": true,
  "message": "<string>"
}

{
  "error": true,
  "code": "gateway_error",
  "message": "Prompt not found or has no published version"
}

POST

prompts

{slug}

run

curl https://gateway.yourapp.com/v1/prompts/my-translator/run \
  -H "Content-Type: application/json" \
  -H "Authorization: GatelitKey sk_live_..." \
  -d '{
    "variables": {
      "source_language": "English",
      "target_language": "French",
      "text": "Hello, how are you?"
    }
  }'

{
  "id": "<string>",
  "object": "chat.completion",
  "created": 123,
  "model": "<string>",
  "choices": [
    {
      "index": 123,
      "message": {
        "role": "user",
        "content": "Explain quantum entanglement in one sentence."
      }
    }
  ],
  "usage": {
    "prompt_tokens": 123,
    "completion_tokens": 123,
    "total_tokens": 123
  }
}

{
  "error": true,
  "code": "gateway_error",
  "message": "Missing required variable: user_name"
}

{
  "error": true,
  "message": "<string>"
}

{
  "error": true,
  "code": "gateway_error",
  "message": "Prompt not found or has no published version"
}

POST /v1/prompts/{slug}/run Execute a saved prompt from the dashboard by its slug. The gateway fetches the published version, interpolates your variables into the template, and routes through the normal chat completions pipeline.

Auth

All three schemes are accepted:

Authorization: GatelitKey sk_live_...
Authorization: GatelitSigned <signed-token>

Bearer (OIDC) is supported but in Alpha. Contact us if you need OIDC auth.

Path parameters

Parameter	Type	Description
`slug`	`string`	The prompt slug from the dashboard

Request body

Field	Type	Required	Description
`variables`	`object`	No	Key-value map of variable name → value
`stream`	`boolean`	No	Enable SSE streaming (default: `false`)
`max_tokens`	`integer`	No	Override the prompt’s default max tokens
`temperature`	`number`	No	Override the prompt’s default temperature

Examples

curl https://gateway.gatelit.dev/v1/prompts/customer-support/run \
  -H "Content-Type: application/json" \
  -H "Authorization: GatelitKey sk_live_..." \
  -d '{
    "variables": {
      "tone": "friendly and professional",
      "language": "Spanish",
      "user_message": "My order hasn't arrived."
    }
  }'

curl https://gateway.gatelit.dev/v1/prompts/my-assistant/run \
  -H "Content-Type: application/json" \
  -H "Authorization: GatelitKey sk_live_..." \
  -d '{
    "variables": { "user_name": "Alice" },
    "stream": true
  }'

Response

Same shape as /v1/chat/completions. Response headers include x-gatelit-request-id and x-gatelit-model.

Errors

Status	Code	Meaning
400	`gateway_error`	Missing required variables
401	`unauthorized`	Missing or invalid token
404	`gateway_error`	Prompt not found or no published version

Authorizations

Authorization

string

header

required

OIDC JWT issued by your auth provider (Alpha). Full self-serve configuration is coming soon — contact us for early access. Use this for browser/frontend clients where a user is signed in.

Path Parameters

slug

string

required

The prompt slug from the dashboard.

Pattern: ^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$

Body

application/json

Variables to inject into the saved prompt's template. Which variables are required depends on the prompt's definition in the dashboard.

variables

object

Key-value map of variable name → value.

Show child attributes

stream

boolean

default:false

max_tokens

integer

temperature

number

Required range: 0 <= x <= 2

Response

Same response shape as /v1/chat/completions. Headers include x-gatelit-request-id and x-gatelit-model.

OpenAI-compatible chat completion response. Returned when stream is false (default).

string

object

string

Example:

"chat.completion"

created

integer

model

string

The upstream model that handled the request.

choices

object[]

Show child attributes

usage

object

Show child attributes

Chat Completions Health Check

How it works

API Reference

Auth

Path parameters

Request body

Examples

Response

Errors

Authorizations

Path Parameters

Body

Response

​Auth

​Path parameters

​Request body

​Examples

​Response

​Errors

Authorizations

Path Parameters

Body

Response

Auth

Path parameters

Request body

Examples

Response

Errors