Get prompt history

curl --request GET \
  --url 'https://api-prod.usefini.com/v2/bots/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/hc-prompt/history/public' \
  --header 'Authorization: Bearer fini_your_api_key'

const response = await fetch('https://api-prod.usefini.com/v2/bots/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/hc-prompt/history/public', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer fini_your_api_key'
  }
});

const data = await response.json();

import requests

response = requests.get(
    "https://api-prod.usefini.com/v2/bots/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/hc-prompt/history/public",
    headers={"Authorization": "Bearer fini_your_api_key"},
)

data = response.json()

[
  {
    "id": "a8b2a418-6f33-4f40-9d1e-4b581fd34d5e",
    "botId": "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3",
    "createdAt": "2026-07-21T06:12:31.456Z",
    "createdBy": "3d2abf0c-d80f-42cf-96e9-a2e26f18f0e8"
  }
]

GET

bots

{id}

hc-prompt

history

public

curl --request GET \
  --url 'https://api-prod.usefini.com/v2/bots/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/hc-prompt/history/public' \
  --header 'Authorization: Bearer fini_your_api_key'

const response = await fetch('https://api-prod.usefini.com/v2/bots/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/hc-prompt/history/public', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer fini_your_api_key'
  }
});

const data = await response.json();

import requests

response = requests.get(
    "https://api-prod.usefini.com/v2/bots/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/hc-prompt/history/public",
    headers={"Authorization": "Bearer fini_your_api_key"},
)

data = response.json()

[
  {
    "id": "a8b2a418-6f33-4f40-9d1e-4b581fd34d5e",
    "botId": "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3",
    "createdAt": "2026-07-21T06:12:31.456Z",
    "createdBy": "3d2abf0c-d80f-42cf-96e9-a2e26f18f0e8"
  }
]

Returns metadata for every saved prompt version for one agent, ordered by createdAt descending. The response does not include prompt section arrays.

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. Pass a returned id to Get prompt version to fetch that version’s full merged prompt object.

Headers

string

required

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

Path parameters

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 prompt-version metadata objects, newest first.

string

Prompt version ID. Pass this value as promptId to Get prompt version.

string

Agent ID the saved version belongs to.

string

ISO 8601 timestamp for when the prompt version was created.

string

Creator identifier recorded for the saved version.

curl --request GET \
  --url 'https://api-prod.usefini.com/v2/bots/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/hc-prompt/history/public' \
  --header 'Authorization: Bearer fini_your_api_key'

const response = await fetch('https://api-prod.usefini.com/v2/bots/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/hc-prompt/history/public', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer fini_your_api_key'
  }
});

const data = await response.json();

import requests

response = requests.get(
    "https://api-prod.usefini.com/v2/bots/4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3/hc-prompt/history/public",
    headers={"Authorization": "Bearer fini_your_api_key"},
)

data = response.json()

[
  {
    "id": "a8b2a418-6f33-4f40-9d1e-4b581fd34d5e",
    "botId": "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3",
    "createdAt": "2026-07-21T06:12:31.456Z",
    "createdBy": "3d2abf0c-d80f-42cf-96e9-a2e26f18f0e8"
  }
]

Errors

401 Unauthorized

The API key is missing, malformed, revoked, or invalid.

403 Forbidden

The API key does not include the read scope required for this route.

404 Not Found

The agent ID does not exist.

406 Not Acceptable

Current controller behavior: if the agent belongs to a different workspace, this route returns 406 with an invalid-agent message rather than 403.

500 Internal Server Error

Fini failed while loading prompt history from storage.

⌘I

​Headers

​Path parameters

​Response

​Errors

Headers

Path parameters

Response

Errors