User Guide

Set Primary Version

The primary version of a prompt only comes into play when retrieving prompts with the Zatomic API. For instance, to retrieve a prompt in the API you can use this endpoint:

GET /v1/prompts/{promptId}

This will return info about the prompt as well as the content for prompt's primary version. By contrast, you can specify which prompt version to retrieve with this endpoint:

GET /v1/prompts/{promptId}/versions/{versionId}

When you create a new prompt, its first version is set as the primary by default. As you create additional versions, you can set a different version as the primary by clicking the 3 vertical dots at the top-right of the prompt editor and selecting the Set as primary option.

The Set as primary option only appears for prompt versions not currently designated as the primary.

Set version as primary
Set version as primary

Now when you call the endpoint GET /v1/prompts/{promptId} from the API, it will return the newly designated primary version as part of its output.

You'll also see that the version now has a crown icon reflected in the header of all of its pages, and will also have the crown icon next to it in the version list of its prompt parent.

Prompt version with crown icon
Prompt version with crown icon