Skip to main content
POST
/
prompts
curl -X POST https://app.tracia.io/api/v1/prompts \
  -H "Authorization: Bearer tr_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Welcome Email",
    "description": "A welcome email template",
    "content": [
      {
        "id": "msg_1",
        "role": "system",
        "content": "You are a helpful assistant."
      },
      {
        "id": "msg_2",
        "role": "user",
        "content": "Write a welcome email for {{name}}."
      }
    ]
  }'
{
  "id": "clx1abc123",
  "slug": "welcome-email",
  "name": "Welcome Email",
  "description": "A welcome email template",
  "provider": null,
  "model": null,
  "temperature": null,
  "topP": null,
  "maxOutputTokens": null,
  "currentVersion": 1,
  "content": [
    {
      "id": "msg_1",
      "role": "system",
      "content": "You are a helpful assistant."
    },
    {
      "id": "msg_2",
      "role": "user",
      "content": "Write a welcome email for {{name}}."
    }
  ],
  "variables": ["name"],
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-15T10:30:00.000Z"
}

Request

Authorization
string
required
Bearer token with your API key: Bearer tr_your_api_key
name
string
required
Display name for the prompt
slug
string
URL-friendly identifier. Auto-generated from name if not provided.
description
string
Description of the prompt
content
array
required
Array of prompt messages. Each message must have:
  • id (string): Unique identifier
  • role (string): system, user, or assistant
  • content (string): Message content

Response

Returns the created prompt object.
curl -X POST https://app.tracia.io/api/v1/prompts \
  -H "Authorization: Bearer tr_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Welcome Email",
    "description": "A welcome email template",
    "content": [
      {
        "id": "msg_1",
        "role": "system",
        "content": "You are a helpful assistant."
      },
      {
        "id": "msg_2",
        "role": "user",
        "content": "Write a welcome email for {{name}}."
      }
    ]
  }'
{
  "id": "clx1abc123",
  "slug": "welcome-email",
  "name": "Welcome Email",
  "description": "A welcome email template",
  "provider": null,
  "model": null,
  "temperature": null,
  "topP": null,
  "maxOutputTokens": null,
  "currentVersion": 1,
  "content": [
    {
      "id": "msg_1",
      "role": "system",
      "content": "You are a helpful assistant."
    },
    {
      "id": "msg_2",
      "role": "user",
      "content": "Write a welcome email for {{name}}."
    }
  ],
  "variables": ["name"],
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-15T10:30:00.000Z"
}

Authorizations

Authorization
string
header
required

API key starting with tr_

Body

application/json
name
string
required

Display name for the prompt

content
object[]
required

Array of prompt messages

slug
string

URL-friendly identifier. Auto-generated from name if not provided.

description
string

Description of the prompt

Response

Prompt created

id
string

Unique identifier for the prompt

slug
string

URL-friendly identifier

name
string

Display name of the prompt

description
string | null

Description of the prompt

provider
enum<string> | null

Model provider

Available options:
OPENAI,
ANTHROPIC,
GOOGLE
model
string | null

Default model for this prompt

temperature
number | null

Temperature setting for the model (0-2)

topP
number | null

Top-p (nucleus) sampling setting (0-1)

maxOutputTokens
integer | null

Maximum output tokens limit

currentVersion
integer

Current version number

content
object[]

Array of prompt messages

variables
string[]

List of template variables extracted from content

createdAt
string<date-time>

ISO 8601 timestamp of creation

updatedAt
string<date-time>

ISO 8601 timestamp of last update