#The AgentDisplayMessageAttachment is a file attached to a message object

AgentDisplayMessageAttachment is a file attached to a message

mimeType

string

name

string

GET

/v1/agent/conversation

Requires auth

#Get agent conversation

Get the display-ready chat history for a specific context.

#Parameters

query parameters

contextType

string

query

dashboard id — the dashboard does not exist yet while the user and the assistant are still agreeing on what it should show. Once it exists, editing it happens under AGENT_CONTEXT_TYPE_ANALYTICS_DASHBOARD instead. id is the EVENT id, not the link id: two visits to the same link are two different subjects, and sharing a thread between them lets one visitor's details bleed into answers about another. the WORKSPACE id: this thread is not about any one link, dashboard or design, and every capability the resource-scoped agents have is available from it. One conversation per workspace, so it survives navigation.

Allowed values

AGENT_CONTEXT_TYPE_LINK_ANALYTICS

Building a link's analytics dashboard. context_id is the LINK id, not a

AGENT_CONTEXT_TYPE_LEAD_SCORE

A conversation about one visit and the lead score it produced. The context

AGENT_CONTEXT_TYPE_WORKSPACE

The workspace-wide assistant, with no resource selected. The context id is

contextId

string

query

#Response

200

Everything worked as expected.

messages

array<object>

unreadCount

integer (int32)

Assistant messages in this conversation the member has not seen yet.

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object

Required

Wrapped error response.

Example request (cURL)

curl -X GET "https://api.linkbreakers.com/v1/agent/conversation?contextType={contextType}&contextId={contextId}" \
  -H "Authorization: Bearer YOUR_TOKEN"

Typical response

{
  "messages": [
    {
      "attachments": [
        {}
      ],
      "id": "string",
      "readAt": "2026-10-02T05:07:49.446Z",
      "sender": "string",
      "text": "string",
      "timestamp": "2026-10-02T05:07:49.446Z"
    }
  ],
  "unreadCount": 0
}

Base URL: https://api.linkbreakers.com

POST

/v1/agent/conversation/read

Requires auth

#Mark agent conversation read

Record that the member has seen every assistant reply in this conversation. Call it when the thread is actually on screen, not when history is fetched.

#Parameters

This endpoint does not accept any parameters.

#Request body

contextId

string

contextType

string (enum)

dashboard id — the dashboard does not exist yet while the user and the assistant are still agreeing on what it should show. Once it exists, editing it happens under AGENT_CONTEXT_TYPE_ANALYTICS_DASHBOARD instead. id is the EVENT id, not the link id: two visits to the same link are two different subjects, and sharing a thread between them lets one visitor's details bleed into answers about another. the WORKSPACE id: this thread is not about any one link, dashboard or design, and every capability the resource-scoped agents have is available from it. One conversation per workspace, so it survives navigation.

Allowed values

AGENT_CONTEXT_TYPE_UNSPECIFIED

AGENT_CONTEXT_TYPE_ANALYTICS_DASHBOARD

AGENT_CONTEXT_TYPE_WORKFLOW

AGENT_CONTEXT_TYPE_LINK

AGENT_CONTEXT_TYPE_QRCODE_DESIGN

AGENT_CONTEXT_TYPE_PAGE_THEME

AGENT_CONTEXT_TYPE_LINK_ANALYTICS

Building a link's analytics dashboard. context_id is the LINK id, not a

AGENT_CONTEXT_TYPE_LEAD_SCORE

A conversation about one visit and the lead score it produced. The context

AGENT_CONTEXT_TYPE_WORKSPACE

The workspace-wide assistant, with no resource selected. The context id is

#Response

200

Everything worked as expected.

markedCount

integer (int32)

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object

Required

Wrapped error response.

Example request (cURL)

curl -X POST "https://api.linkbreakers.com/v1/agent/conversation/read" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"contextId":"string","contextType":"AGENT_CONTEXT_TYPE_UNSPECIFIED"}'

Sample payload (application/json)

{
  "contextId": "string",
  "contextType": "AGENT_CONTEXT_TYPE_UNSPECIFIED"
}

Typical response

{
  "markedCount": 0
}

Base URL: https://api.linkbreakers.com

POST

/v1/agent/upload

Requires auth

#Upload file for agent chat

Upload a file to attach to the next agent message. Returns a temporary file ID. Files expire after 5 minutes. Max 20MB.

#Parameters

This endpoint does not accept any parameters.

#Request body

content

string

File content (base64-encoded in JSON)

mimeType

string

MIME type (e.g. "image/png", "application/pdf")

name

string

Original filename

#Response

200

Everything worked as expected.

fileId

string

Temporary file ID to include in agent message attachments

mimeType

string

MIME type (echoed back)

name

string

Original filename (echoed back)

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object

Required

Wrapped error response.

Example request (cURL)

curl -X POST "https://api.linkbreakers.com/v1/agent/upload" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"content":"string","mimeType":"string","name":"string"}'

Sample payload (application/json)

{
  "content": "string",
  "mimeType": "string",
  "name": "string"
}

Typical response

{
  "fileId": "string",
  "mimeType": "string",
  "name": "string"
}

Base URL: https://api.linkbreakers.com

DELETE

/v1/agent/conversation

Requires auth

#Clear agent conversation

Clear the conversation history for a specific context.

#Parameters

query parameters

contextType

string

query

dashboard id — the dashboard does not exist yet while the user and the assistant are still agreeing on what it should show. Once it exists, editing it happens under AGENT_CONTEXT_TYPE_ANALYTICS_DASHBOARD instead. id is the EVENT id, not the link id: two visits to the same link are two different subjects, and sharing a thread between them lets one visitor's details bleed into answers about another. the WORKSPACE id: this thread is not about any one link, dashboard or design, and every capability the resource-scoped agents have is available from it. One conversation per workspace, so it survives navigation.

Allowed values

AGENT_CONTEXT_TYPE_LINK_ANALYTICS

Building a link's analytics dashboard. context_id is the LINK id, not a

AGENT_CONTEXT_TYPE_LEAD_SCORE

A conversation about one visit and the lead score it produced. The context

AGENT_CONTEXT_TYPE_WORKSPACE

The workspace-wide assistant, with no resource selected. The context id is

contextId

string

query

#Response

200

Everything worked as expected.

No structured schema available for this section.

#Error response

400-599

All endpoints may return an unexpected error payload when a request cannot be processed.

error

object

Required

Wrapped error response.

Example request (cURL)

curl -X DELETE "https://api.linkbreakers.com/v1/agent/conversation?contextType={contextType}&contextId={contextId}" \
  -H "Authorization: Bearer YOUR_TOKEN"

Typical response

{}

Base URL: https://api.linkbreakers.com