Skip to main content
GET /workflows/:id/prompt-history Read an agent’s prompt version history — every snapshot taken when the base prompt, a channel override, or the funnel structure changed.

​
Path Parameters

ParameterTypeRequiredDescription
idstring (uuid)YesAgent ID

​
Query Parameters

ParameterTypeRequiredDescription
limitintegerNoMax versions to return, newest first. Default 20, max 50

​
Responses

​
200 — Successful response

{
  "success": true,
  "versions": [
    {
      "version_number": 4,
      "global_prompt": "You are Iris, a friendly sales rep for Acme...",
      "channel_prompts": { "whatsapp": "Keep replies under 2 sentences." },
      "changed_fields": ["global_prompt"],
      "changed_by_email": "founder@acme.com",
      "change_source": "api",
      "change_note": null,
      "activated_at": "2026-02-01T12:00:00Z",
      "superseded_at": null,
      "created_at": "2026-02-01T12:00:00Z"
    }
  ]
}

​
Response Fields — PromptVersion

FieldTypeDescription
version_numberintegerSequential version number
global_promptstringThe base prompt as of this version
channel_promptsobjectPer-channel overrides as of this version
changed_fieldsstring[]Which fields changed in this version
changed_by_emailstring | nullWho made the change
change_sourcestringWhere the change came from, e.g. dashboard, api, training
change_notestring | nullOptional annotation (see Update Structure for editing structure alongside prompts)
activated_atstring (date-time) | nullWhen this version became live
superseded_atstring (date-time) | nullWhen a later version replaced it
created_atstring (date-time)When this version was recorded

​
401 — Authentication error

See Authentication.

​
404 — Not found

{
  "error": "Not found",
  "message": "Workflow not found"
}

​
500 — Internal server error

Last modified on July 10, 2026