Skip to main content
GET
/
v2
/
bots
/
{id}
/
hc-prompt
/
history
/
public
Get prompt history
curl --request GET \
  --url https://api-prod.usefini.com/v2/bots/{id}/hc-prompt/history/public \
  --header 'Authorization: <authorization>'
Returns every saved prompt version for one agent, ordered by createdAt descending.
This history is agent-specific. It does not synthesize the workspace template as a history entry, so agents with no saved prompt versions return an empty array rather than a template row.

​
Headers

​
Authorization
string
required
Bearer token containing your Fini workspace API key. Format: Bearer fini_... The key needs read scope.

​
Path parameters

​
id
string
required
Agent ID whose prompt history you want to read. Use List agents to get the botId.

​
Response

Returns a top-level array of merged Prompt objects, newest first.

​
Errors

The API key is missing, malformed, revoked, or invalid.
The API key does not include the read scope required for this route.
The agent ID does not exist.
Current controller behavior: if the agent belongs to a different workspace, this route returns 406 with an invalid-agent message rather than 403.
Fini failed while loading prompt history from storage.