Skip to main content
GET
/
v2
/
bots
/
{id}
/
hc-prompt
/
public
Get prompts
curl --request GET \
  --url https://api-prod.usefini.com/v2/bots/{id}/hc-prompt/public \
  --header 'Authorization: <authorization>'
Returns the current prompt configuration for one agent as a merged view of the workspace template plus the agent’s latest saved prompt version.
If the agent has no saved prompt version yet, this route still returns prompt content by falling back to the workspace template. In that case, the metadata comes from the template prompt, but botId is still the requested agent ID.

​
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 prompts you want to read. Use List agents to get the botId.

​
Response

Returns one merged Prompt object.

​
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 the prompt data from storage.