Webpage Awareness

List webpage context pages.

Changed on

Returns all webpage context entries for an agent, with optional URL filtering and pagination. Requires the Webpage Awareness tool to be enabled on the agent.

get/api/v1/projects/{projectId}/contextual-rag/pages

Request

Path parameters

projectIdinteger required
Example:1

The unique identifier of the agent.

Query parameters

urlstring
Example:https://example.com/pricing

Filter pages by URL. Returns only the page matching this exact URL.

limitinteger
Example:50

Maximum number of pages to return. Defaults to 50.

pageinteger
Example:1

Page number for pagination. Defaults to 1.

Response

Paginated list of webpage context entries for the agent.

status'error' | 'success'

The status of the response

Example response

{
  "status": "success",
  "data": {
    "contexts": [
      {
        "id": "20de6083-efe3-419e-a8ca-9ff18e6f1646",
        "agent_id": 1,
        "url": "https://example.com/pricing",
        "title": "Pricing | Example",
        "summary": "This page describes pricing plans and targets visitors comparing options.",
        "auto_message": "What pricing plan is right for me?",
        "display_message": "Welcome to our pricing page! How can I help?",
        "updated_at": "2025-12-23T14:15:23"
      }
    ],
    "total": 42,
    "page": 1,
    "limit": 50
  }
}

Changes