Prompts
List the versions of a prompt
const url = 'https://app.whatsetter.com/api/v1/campaigns/example/prompts/conversation/versions?variant=A&limit=25';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}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.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Query Parameters
Section titled “Query Parameters”Only the versions of this variant.
Opaque cursor from the previous page’s pagination.next_cursor.
Responses
Section titled “Responses”A page of versions
object
object
The name a person gave the variant when publishing, if any. A date written by the dashboard is not a name: read created_at.
live = what the agent reads now; draft = saved, never published; inactive = replaced, or out of the rotation.
Where the version was written.
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.
The first 160 characters, on one line.
Only on GET …/versions/{versionId}.
object
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
object
object
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)
object
object
Examplegenerated
{ "error": { "code": "example", "message": "example" }}Resource not found in this workspace
object
object
Examplegenerated
{ "error": { "code": "example", "message": "example" }}This text keeps no history (follow-ups, group texts)
object
object
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)
object
object
Examplegenerated
{ "error": { "code": "example", "message": "example" }}