Skip to content
Dashboard

List the versions of a prompt

GET
/campaigns/{id}/prompts/{type}/versions
curl --request GET \
--url 'https://app.whatsetter.com/api/v1/campaigns/example/prompts/conversation/versions?variant=A&limit=25' \
--header 'Authorization: Bearer <token>'

The history of conversation or first_message, newest first. Each entry has a status: live (what the agent reads now), draft (saved in the editor, never published) or inactive (replaced, or out of the rotation). The text itself is in GET …/versions/{versionId}; the list carries a preview.

A version marked snapshot: true was filed by the API itself: it is the text that was in service outside the history, kept the moment a change replaced it. Its date is the date of that change. Requires scope prompts:read.

id
required
string
type
required
string
Allowed values: conversation first_message
variant
string
Allowed values: A B C D

Only the versions of this variant.

limit
integer
default: 25 >= 1 <= 100
cursor
string

Opaque cursor from the previous page’s pagination.next_cursor.

A page of versions

Media typeapplication/json
object
data
Array<object>
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
pagination
object
has_more
boolean
next_cursor
string | null
Example
{
"data": [
{
"id": "68e61f7700093d5b1c02",
"version": 8,
"variant": "A",
"name": null,
"status": "live",
"author": "api",
"snapshot": false,
"created_at": "2026-10-08T14:02:11.000+00:00",
"characters": 175,
"preview": "## Identity You are {{agent_name}} from {{company_name}}. ## Goal Qualify the lead, then send {{goal_link}}."
},
{
"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}}."
}
],
"pagination": {
"has_more": false,
"next_cursor": "68e60d3100212c0a9b41"
}
}

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 (follow-ups, group texts)

Media typeapplication/json
object
error
object
code
string
message
string
Example
{
"error": {
"code": "invalid_state",
"message": "\"follow_up_cold_1\" keeps no history: only \"conversation\" and \"first_message\" are versioned. Its current text is in GET /campaigns/{id}/prompts/follow_up_cold_1."
}
}

Invalid parameter or body (also an invalid or expired cursor)

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