For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dashboard
User GuideDeveloper GuidesAPI Reference
User GuideDeveloper GuidesAPI Reference
    • Overview
  • Runtype API
      • GETList discovered WebMCP tools
      • GETList observed page origins
      • GETList surfaces
Dashboard
LogoLogo
Runtype APISurfaces

List observed page origins

GET
/v1/products/:productId/surfaces/:surfaceId/observed-origins
GET
/v1/products/:productId/surfaces/:surfaceId/observed-origins
$curl https://api.runtype.com/v1/products/productId/surfaces/surfaceId/observed-origins \
>     -H "Authorization: <apiKey>" \
>     -H "Content-Type: application/json"
1{
2  "origins": [
3    {
4      "allowed": true,
5      "firstSeenAt": "2024-06-10T08:15:30Z",
6      "lastSeenAt": "2024-06-16T17:45:00Z",
7      "origin": "https://app.example.com/dashboard"
8    },
9    {
10      "allowed": false,
11      "firstSeenAt": "2024-06-11T09:00:00Z",
12      "lastSeenAt": "2024-06-15T20:30:00Z",
13      "origin": "https://malicious-site.com"
14    }
15  ],
16  "windowDays": 7
17}
List the page origins observed sending requests to this chat surface over the trailing 7 days. Each origin carries an allowed flag indicating whether any active client token linked to this surface would admit it via the same validateOrigin check used by chat dispatch.
Was this page helpful?
Previous

List surfaces

Next
Built with

Authentication

AuthorizationBearer
API key or Clerk session token

Path parameters

productIdstringRequired
surfaceIdstringRequired

Response

Observed origins with allowed flags
originslist of objects
windowDaysdouble

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error