Zatomic
Zatomic API

The Version Object

Properties
version_id
string
 Unique ID of the version.
prompt_id
string
 The ID of the parent prompt.
created
datetime
 UTC timestamp for when the version was created.
created_by
string
 The name of the user who created the version or the name of the API key that created the version.
updated
datetime
 UTC timestamp for when the version was updated.
updated_by
string
 The name of the user who updated the version or the name of the API key that updated the version.
name
string, nullable
 Name of the version.
is_primary
boolean
 Use case description for the prompt.
content
string
 The content of the prompt version.
variables
list of key-value pairs
 List of variables for the version; can be empty. Variables are "template tags", designated by either double curly braces {{ }} or double square brackets [[ ]], and can be used to create prompt templates.
token_info
object

Contains token data about the prompt version.

model
string
 Name of the AI model used to calculate the token count and cost.
token_count
integer
 Number of tokens for the prompt version.
cost_per_use
decimal
 Cost of the tokens per use, in USD.
cost_per_1k
decimal
 Cost of the tokens per thousand uses, in USD.
cost_per_1m
decimal
 Cost of the tokens per million uses, in USD.
scoring
scoring object, nullable
 The scoring object for the prompt version, if scoring has been performed.
risk
risk object, nullable
 The risk object for the prompt version, if the risk has been analyzed.
balance
balance object, nullable
 The balance object for the prompt version, if the balance has been analyzed.
heatmap
heatmap object, nullable
 The heatmap object for the prompt version, if the heatmap has been generated.
The Version Object - Fully Expanded 
{
   "version_id": "ver_2qRzu8qzlNOMhTrini2EKCDh5r6",
   "prompt_id": "prm_2qRzu8geIvfudcJTwP0pur4TbMJ",
   "created": "2024-12-19T20:33:16.076891Z",
   "created_by": "Han Solo",
   "updated": "2024-12-19T20:39:13.026997Z",
   "updated_by": "Han Solo",
   "name": null,
   "is_primary": true,
   "content": "You are a knowledgeable and friendly assistant...",
   "variables": [
      "{{variable1}}",
      "[[variable2]]"
   ],
   "token_info": {
      "model": "gpt-4.1",
      "token_count": 0,
      "cost_per_use": 0.0,
      "cost_per_1k": 0.0,
      "cost_per_1m": 0.0
   },
   "scoring": {
      "version_timestamp": "2024-12-19T20:33:15.971617Z",
      "scoring_timestamp": "2024-12-19T20:33:15.971617Z",
      "overall_score": 0,
      "rating": "Excellent",
      "summary": {
         "strengths": "The strengths of the prompt.",
         "areas_for_improvement": "Areas where the prompt could improve.",
         "overall_feedback": "Overall feedback for the prompt."
      },
      "criteria": {
         "criteria_id": "sca_2rjp9HFpIsiYQrAiSbZlz85r3GC",
         "name": "Default",
         "criterion_results": [
            {
               "slug": "criterion_slug",
               "score": 0,
               "weight": 0,
               "weighted_score": 0,
               "feedback": "Specific feedback for the criterion."
            }
         ]
      }
   },
   "risk": {
      "version_timestamp": "2025-06-22T14:45:19.144393Z",
      "risk_timestamp": "2025-06-22T18:52:20.1727176Z",
      "summary": {
         "overall_feedback": "Overall feedback for the risk analysis.",
         "overall_risk_level": "low|medium|high"
      },
      "bias_analysis": {
         "risk_level": "low|medium|high",
         "feedback": "Feedback for the bias analysis.",
         "issues": [
            {
               "issue": "Potential bias.",
               "parts": [
                  {
                     "part": "Affected part of the prompt.",
                     "revision": "Suggested revision for the prompt part."
                  }
               ]
            }
         ]
      },
      "ethical_analysis": {
      "risk_level": "low|medium|high",
      "feedback": "Feedback for the ethical analysis.",
      "issues": [
            {
               "issue": "Ethical concern.",
               "parts": [
                  {
                     "part": "Affected part of the prompt.",
                     "revision": "Suggested revision for the prompt part."
                  }
               ]
            }
         ]
      },
      "safety_analysis": {
      "risk_level": "low|medium|high",
      "feedback": "Feedback for the safety analysis.",
      "issues": [
            {
               "issue": "Safety issue.",
               "parts": [
                  {
                     "part": "Affected part of the prompt.",
                     "revision": "Suggested revision for the prompt part."
                  }
               ]
            }
         ]
      }
   },
   "balance": {
      "version_timestamp": "2024-12-19T20:33:15.971617Z",
      "balance_timestamp": "2024-12-19T20:33:15.971617Z",
      "summary": {
         "overall_feedback": "Overall feedback based on the prompt balance.",
         "recommendations": "Recommendations to improve the prompt balance."
      },
      "categories": [
         {
            "category": "The category name.",
            "feedback": "Feedback about the balance of category in the prompt.",
            "phrase_count": 0,
            "phrase_percent": 0.0,
            "distribution": "The category distribution."
         }
      ],
      "phrases": [
         {
            "phrase": "The prompt phrase.",
            "category": "The prompt category.",
            "reason": "Reason the phrase was assigned to its category."
         }
      ]
   },
   "heatmap": {
      "version_timestamp": "2024-12-19T20:33:15.971617Z",
      "heatmap_timestamp": "2024-12-19T20:33:15.971617Z",
      "summary": "Summary of the heatmap.",
      "phrases": [
         {
            "phrase": "The prompt phrase.",
            "attention_score": 1,
            "color": "The color level assigned to the phrase.",
            "reason": "The reason why the AI model assigned the phrase its attention score."
         }
      ]
   }
}