Prompts
Get one version of a prompt
const url = 'https://app.whatsetter.com/api/v1/campaigns/example/prompts/conversation/versions/example';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/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.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”A version id from the versions list
Responses
Section titled “Responses”The version
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}.
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
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
object
object
Examplegenerated
{ "error": { "code": "example", "message": "example" }}