curl --request GET \
--url 'https://api-prod.usefini.com/v2/hc-interactions/11111111-1111-4111-8111-111111111111/memories/public' \
--header 'Authorization: Bearer fini_your_api_key'
const response = await fetch(
"https://api-prod.usefini.com/v2/hc-interactions/11111111-1111-4111-8111-111111111111/memories/public",
{ headers: { Authorization: "Bearer fini_your_api_key" } }
);
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const memories = await response.json();
import requests
response = requests.get(
"https://api-prod.usefini.com/v2/hc-interactions/11111111-1111-4111-8111-111111111111/memories/public",
headers={"Authorization": "Bearer fini_your_api_key"},
)
response.raise_for_status()
memories = response.json()
[
{
"id": "22222222-2222-4222-8222-222222222222",
"summary": "The customer prefers written setup instructions and has completed the initial account setup.",
"conversationEndedAt": "2026-10-10T14:30:00.000Z",
"sourceInteractionId": "33333333-3333-4333-8333-333333333333",
"fromThisConversation": false
}
]
Conversations
Get conversation memories
Read stored summaries for the end user and agent associated with a native-ticketing conversation.
GET
/
v2
/
hc-interactions
/
{id}
/
memories
/
public
curl --request GET \
--url 'https://api-prod.usefini.com/v2/hc-interactions/11111111-1111-4111-8111-111111111111/memories/public' \
--header 'Authorization: Bearer fini_your_api_key'
const response = await fetch(
"https://api-prod.usefini.com/v2/hc-interactions/11111111-1111-4111-8111-111111111111/memories/public",
{ headers: { Authorization: "Bearer fini_your_api_key" } }
);
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const memories = await response.json();
import requests
response = requests.get(
"https://api-prod.usefini.com/v2/hc-interactions/11111111-1111-4111-8111-111111111111/memories/public",
headers={"Authorization": "Bearer fini_your_api_key"},
)
response.raise_for_status()
memories = response.json()
[
{
"id": "22222222-2222-4222-8222-222222222222",
"summary": "The customer prefers written setup instructions and has completed the initial account setup.",
"conversationEndedAt": "2026-10-10T14:30:00.000Z",
"sourceInteractionId": "33333333-3333-4333-8333-333333333333",
"fromThisConversation": false
}
]
Returns up to 10 stored memory summaries for the conversation’s end-user email and agent, scoped to the workspace associated with your API key. Results are ordered by conversation end time, newest first, with undated memories last. This read does not create memories or change the conversation.
These are the summaries available in the ticket’s Memories card, not the subset selected for a particular reply. Use Get event metadata to inspect the trace for an individual reply. See Inbox for the dashboard workflow.
Native ticketing must be enabled for the workspace. The conversation must use the widget or native email source. Helpdesk-mirrored, API, and synthetic conversations are not supported by this endpoint.
Headers
string
required
Bearer token containing your Fini workspace API key. The key needs
read scope.Path parameters
string
required
Non-empty conversation ID in the authenticated workspace, not its ticket number.
Selection and empty results
The lookup uses the first non-blank value in the conversation’semail, User Email, or collectedEmail user attributes, normalized by trimming and lowercasing. It only returns memories marked worth remembering for that email and the same agent. You cannot supply a different email or agent, change the limit, or paginate this route.
A successful response is an array, not a wrapped object. An empty array is intentional when the conversation has no end-user email, no agent, or no matching stored memories. It does not establish that a particular reply did or did not use memory.
Response fields
Each array item has these fields:string
Memory ID.
string
Stored summary of the source conversation.
string | null
Source conversation’s end timestamp, or
null when unavailable.string
Conversation ID from which the memory was created.
boolean
Whether the source conversation is the conversation requested in
id.Errors
400: the conversation source is not supported by native ticketing, or the request fails validation.403: native ticketing is not enabled for the workspace.
curl --request GET \
--url 'https://api-prod.usefini.com/v2/hc-interactions/11111111-1111-4111-8111-111111111111/memories/public' \
--header 'Authorization: Bearer fini_your_api_key'
const response = await fetch(
"https://api-prod.usefini.com/v2/hc-interactions/11111111-1111-4111-8111-111111111111/memories/public",
{ headers: { Authorization: "Bearer fini_your_api_key" } }
);
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const memories = await response.json();
import requests
response = requests.get(
"https://api-prod.usefini.com/v2/hc-interactions/11111111-1111-4111-8111-111111111111/memories/public",
headers={"Authorization": "Bearer fini_your_api_key"},
)
response.raise_for_status()
memories = response.json()
[
{
"id": "22222222-2222-4222-8222-222222222222",
"summary": "The customer prefers written setup instructions and has completed the initial account setup.",
"conversationEndedAt": "2026-10-10T14:30:00.000Z",
"sourceInteractionId": "33333333-3333-4333-8333-333333333333",
"fromThisConversation": false
}
]
Was this page helpful?

