curl -X POST https://app.tracia.io/api/v1/prompts/welcome-email/run \
  -H "Authorization: Bearer tr_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "variables": {
      "name": "Alice",
      "product": "Tracia"
    },
    "tags": ["onboarding", "email"],
    "userId": "user_123"
  }'

const result = await tracia.prompts.run('welcome-email', {
  name: 'Alice',
  product: 'Tracia'
}, {
  tags: ['onboarding', 'email'],
  userId: 'user_123'
});

{
  "text": "Dear Alice,\n\nWelcome to Tracia! We're thrilled to have you join our community...",
  "spanId": "sp_abc123xyz",
  "traceId": "tr_session789",
  "promptVersion": 3,
  "latencyMs": 1250,
  "usage": {
    "inputTokens": 45,
    "outputTokens": 120,
    "totalTokens": 165
  },
  "cost": 0.0049,
  "finishReason": "stop",
  "toolCalls": null,
  "structuredOutput": null
}

{
  "text": "{\"sentiment\": \"positive\", \"confidence\": 0.95}",
  "spanId": "sp_def456uvw",
  "traceId": "tr_session789",
  "promptVersion": 2,
  "latencyMs": 890,
  "usage": {
    "inputTokens": 60,
    "outputTokens": 25,
    "totalTokens": 85
  },
  "cost": 0.0012,
  "finishReason": "stop",
  "toolCalls": null,
  "structuredOutput": {
    "sentiment": "positive",
    "confidence": 0.95
  }
}

{
  "error": {
    "code": "MISSING_VARIABLES",
    "message": "Missing required variables: product"
  }
}

{
  "error": {
    "code": "MISSING_PROVIDER_KEY",
    "message": "No OpenAI API key configured. Add one in Settings > Providers."
  }
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Prompt not found: welcome-email"
  }
}

{
  "error": {
    "code": "PROVIDER_ERROR",
    "message": "OpenAI error: Rate limit exceeded"
  }
}