Skip to main content
PUT
/
api
/
v1
/
prompts
/
{slug}
curl -X PUT https://app.tracia.io/api/v1/prompts/welcome-email \
  -H "Authorization: Bearer tr_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Welcome Email",
    "content": [
      {
        "id": "msg_1",
        "role": "user",
        "content": "Write a friendly welcome email for {{name}} at {{company}}."
      }
    ]
  }'

{
  "id": "clx1abc123",
  "slug": "welcome-email",
  "name": "Updated Welcome Email",
  "description": "A welcome email template",
  "model": "gpt-4",
  "modelConfigurationId": "clx0xyz789",
  "currentVersion": 4,
  "content": [
    {
      "id": "msg_1",
      "role": "user",
      "content": "Write a friendly welcome email for {{name}} at {{company}}."
    }
  ],
  "variables": ["name", "company"],
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-22T08:45:00.000Z"
}
Update a prompt’s metadata or content. If the content changes, a new version is automatically created.

​
Request

​
Authorization
string
required
Bearer token with your API key: Bearer tr_your_api_key
​
slug
string
required
The prompt slug to update
​
name
string
New display name
​
slug
string
New URL-friendly identifier
​
description
string
New description (set to empty string to clear)
​
content
array
New array of prompt messages. If different from current content, creates a new version.
​
modelConfigurationId
string | null
ID of a model configuration (set to null to clear)

​
Response

Returns the updated prompt object with the new version number if content changed. 
curl -X PUT https://app.tracia.io/api/v1/prompts/welcome-email \
  -H "Authorization: Bearer tr_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Welcome Email",
    "content": [
      {
        "id": "msg_1",
        "role": "user",
        "content": "Write a friendly welcome email for {{name}} at {{company}}."
      }
    ]
  }'

{
  "id": "clx1abc123",
  "slug": "welcome-email",
  "name": "Updated Welcome Email",
  "description": "A welcome email template",
  "model": "gpt-4",
  "modelConfigurationId": "clx0xyz789",
  "currentVersion": 4,
  "content": [
    {
      "id": "msg_1",
      "role": "user",
      "content": "Write a friendly welcome email for {{name}} at {{company}}."
    }
  ],
  "variables": ["name", "company"],
  "createdAt": "2024-01-15T10:30:00.000Z",
  "updatedAt": "2024-01-22T08:45:00.000Z"
}