Skip to main content
GET
Get prompt version
Returns one saved prompt version as a merged view of that version plus the current workspace template.
Use Get prompt history to find saved promptId values. Template sections missing from the saved version are included in this response with merged-read helper fields such as defaultPrompt and custom.

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 that owns the prompt version. Use List agents to get the botId.
promptId
string
required
Saved prompt version ID returned by Get prompt history.

Response

Returns one merged Prompt object.

Errors

The agent ID or prompt version ID is not a valid UUID.
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.
The agent belongs to a different workspace, or the prompt version does not belong to the agent in the path.
Fini failed while loading the prompt version or workspace template.