Conversations & Memories

DealDome's AI agents (Alfred, Roos, Elisa) maintain conversations with users and store long-term memories for context. The conversation endpoints let you browse chat history, while the memory endpoints let you manage persistent knowledge the agents use to personalize their responses. You can also send new queries to the AI agents directly via the API.

The conversation model

Each conversation represents a chat session between a user and one of the AI agents.

Properties

Name
id
Type
integer
Description
Unique identifier for the conversation.
Name
agent
Type
string
Description
The agent this conversation belongs to — alfred, roos, or elisa.
Name
user_id
Type
integer
Description
The ID of the user who started the conversation.
Name
summary
Type
string
Description
An auto-generated summary of the conversation topic.
Name
created_at
Type
timestamp
Description
Timestamp of when the conversation was created.

The message model

Messages are the individual exchanges within a conversation.

Properties

Name
id
Type
integer
Description
Unique identifier for the message.
Name
conversation_id
Type
integer
Description
The conversation this message belongs to.
Name
role
Type
string
Description
Who sent the message — user or assistant.
Name
content
Type
string
Description
The message text content.
Name
created_at
Type
timestamp
Description
Timestamp of when the message was created.

The memory model

Memories are persistent facts the agents remember across conversations, like user preferences or business context.

Properties

Name
id
Type
integer
Description
Unique identifier for the memory.
Name
content
Type
string
Description
The memory content — a fact or piece of context to remember.
Name
category
Type
string
Description
The category of the memory (e.g., preference, business, product).
Name
created_at
Type
timestamp
Description
Timestamp of when the memory was created.

GET/conversations

List conversations

This endpoint returns a list of all conversations. You can filter by agent to only see conversations with a specific AI agent.

Optional attributes

Name
agent
Type
string
Description
Filter by agent — alfred, roos, or elisa.
Name
limit
Type
integer
Description
Limit the number of conversations returned.
Name
offset
Type
integer
Description
Offset for pagination.

Request

GET

/conversations

curl -G https://api.dealdome.eu/conversations \
  -H "Authorization: Bearer {token}" \
  -d agent=alfred \
  -d limit=10

Response

{
  "data": [
    {
      "id": 42,
      "agent": "alfred",
      "user_id": 1,
      "summary": "Discussed ROAS targets and scaling strategy for Q2",
      "created_at": "2026-04-13T10:15:00Z"
    },
    {
      "id": 38,
      "agent": "alfred",
      "user_id": 1,
      "summary": "Reviewed yesterday's P&L and ad performance",
      "created_at": "2026-04-12T08:30:00Z"
    }
  ]
}

GET/conversations/:id/messages

Get conversation messages

This endpoint returns all messages in a specific conversation, ordered chronologically. Use this to review the full chat history between a user and an agent.

Optional attributes

Name
limit
Type
integer
Description
Limit the number of messages returned.
Name
offset
Type
integer
Description
Offset for pagination.

Request

GET

/conversations/42/messages

curl https://api.dealdome.eu/conversations/42/messages \
  -H "Authorization: Bearer {token}"

Response

{
  "data": [
    {
      "id": 301,
      "conversation_id": 42,
      "role": "user",
      "content": "What was my ROAS this week?",
      "created_at": "2026-04-13T10:15:00Z"
    },
    {
      "id": 302,
      "conversation_id": 42,
      "role": "assistant",
      "content": "Your overall ROAS this week is 3.86. Meta is performing best at 4.12, while TikTok is at 2.95. Want me to break it down by product?",
      "created_at": "2026-04-13T10:15:02Z"
    }
  ]
}

GET/memories

List memories

This endpoint returns all stored memories. These are persistent facts the agents use for context across conversations.

Optional attributes

Name
category
Type
string
Description
Filter by category — e.g., preference, business, product.
Name
limit
Type
integer
Description
Limit the number of memories returned.

Request

GET

/memories

curl -G https://api.dealdome.eu/memories \
  -H "Authorization: Bearer {token}"

Response

{
  "data": [
    {
      "id": 1,
      "content": "User prefers ROAS targets above 3.0 before scaling",
      "category": "preference",
      "created_at": "2026-03-01T14:00:00Z"
    },
    {
      "id": 2,
      "content": "Main store is my-store.myshopify.com, selling in EU market",
      "category": "business",
      "created_at": "2026-01-15T09:00:00Z"
    },
    {
      "id": 3,
      "content": "Posture Corrector Pro has a cost price of 4.20 EUR and ships from China warehouse",
      "category": "product",
      "created_at": "2026-02-10T11:30:00Z"
    }
  ]
}

POST/memories

Create a memory

This endpoint lets you manually add a memory. Agents also create memories automatically during conversations, but you can use this to seed important context.

Required attributes

Name
content
Type
string
Description
The fact or context to remember.
Name
category
Type
string
Description
The category — e.g., preference, business, product.

Request

POST

/memories

curl https://api.dealdome.eu/memories \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"content": "Target CPA for Meta ads is under 15 EUR", "category": "preference"}'

Response

{
  "id": 4,
  "content": "Target CPA for Meta ads is under 15 EUR",
  "category": "preference",
  "created_at": "2026-04-13T12:00:00Z"
}

DELETE/memories/:id

Delete a memory

This endpoint permanently deletes a memory. Use this to remove outdated or incorrect context that the agents should no longer reference.

Request

DELETE

/memories/3

curl -X DELETE https://api.dealdome.eu/memories/3 \
  -H "Authorization: Bearer {token}"

POST/query

Ask a question

This endpoint sends a question to DealDome's AI agents and returns the response. The system automatically routes your query to the most relevant agent (Alfred for business/financial questions, Roos for ad strategy, Elisa for knowledge/video content).

Required attributes

Name
message
Type
string
Description
The question or instruction to send to the AI agent.

Optional attributes

Name
agent
Type
string
Description
Force routing to a specific agent — alfred, roos, or elisa. If omitted, the system routes automatically.
Name
conversation_id
Type
integer
Description
Continue an existing conversation instead of starting a new one.

Request

POST

/query

curl https://api.dealdome.eu/query \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"message": "What was my best performing product this week?"}'

Response

{
  "conversation_id": 43,
  "agent": "alfred",
  "response": "Your best performing product this week is the Posture Corrector Pro with a ROAS of 4.12 and 156 units sold. It generated €3,890 in revenue on €945 ad spend. The LED Sunset Lamp came in second at 3.45 ROAS.",
  "created_at": "2026-04-13T12:30:00Z"
}