Skip to content
Dashboard

Get one version of a prompt

GET
/campaigns/{id}/prompts/{type}/versions/{versionId}
curl --request GET \
--url https://app.whatsetter.com/api/v1/campaigns/example/prompts/conversation/versions/example \
--header 'Authorization: Bearer <token>'

One version with its full text, to read what the agent ran on at a given date. To see what changed between two versions, use GET …/versions/{versionId}/compare. Requires scope prompts:read.

id
required
string
type
required
string
Allowed values: conversation first_message
versionId
required

A version id from the versions list

string

The version

Media typeapplication/json
object
data
object
id
string
version
integer
variant
string
Allowed values: A B C D
name

The name a person gave the variant when publishing, if any. A date written by the dashboard is not a name: read created_at.

string | null
status

live = what the agent reads now; draft = saved, never published; inactive = replaced, or out of the rotation.

string
Allowed values: live draft inactive
author

Where the version was written.

string
Allowed values: dashboard api
snapshot

true on a version the API filed itself: the text that was in service outside the history, kept the moment a change replaced it. Its created_at is the date of that change, not the day the text was written.

boolean
created_at
string | null format: date-time
characters
integer
preview

The first 160 characters, on one line.

string
body

Only on GET …/versions/{versionId}.

string
Example
{
"data": {
"id": "68e60d3100212c0a9b41",
"version": 7,
"variant": "A",
"name": null,
"status": "inactive",
"author": "dashboard",
"snapshot": false,
"created_at": "2026-10-07T09:18:22.000+00:00",
"characters": 109,
"preview": "## Identity You are {{agent_name}} from {{company_name}}. ## Goal Qualify the lead, then send {{goal_link}}.",
"body": "## Identity\nYou are {{agent_name}} from {{company_name}}.\n\n## Goal\nQualify the lead, then send {{goal_link}}."
}
}

Missing, unknown or revoked API key

Media typeapplication/json
object
error
object
code
string
message
string
Examplegenerated
{
"error": {
"code": "example",
"message": "example"
}
}

The key lacks the required scope (insufficient_scope), the plan does not have this part of the API (not_in_plan), or Instagram is not enabled on the workspace (instagram_not_enabled, Instagram routes)

Media typeapplication/json
object
error
object
code
string
message
string
Examplegenerated
{
"error": {
"code": "example",
"message": "example"
}
}

Resource not found in this workspace

Media typeapplication/json
object
error
object
code
string
message
string
Examplegenerated
{
"error": {
"code": "example",
"message": "example"
}
}

This text keeps no history

Media typeapplication/json
object
error
object
code
string
message
string
Examplegenerated
{
"error": {
"code": "example",
"message": "example"
}
}