---
title: "Measure outcome page changes (v2)"
method: POST
path: "/api/v1/business/outcome-page-changes/measure-v2"
tags: ["business"]
---

# Measure outcome page changes (v2)

`POST /api/v1/business/outcome-page-changes/measure-v2`

## Request

- Base URL: `https://point11.ai`
- URL: `https://point11.ai/api/v1/business/outcome-page-changes/measure-v2`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://auth.point11.ai/oauth2/authorize`, token URL `https://auth.point11.ai/oauth2/token`)

Measure how AI-assistant visits to sets of changed pages moved against the rest of the site's AI-assistant visits, before and after each change, in the organization's first chosen source (a Google Analytics property, a Shopify shop, or a Vercel project). Each change names its pages (URLs or paths) and the days the change went live between; the answer compares up to 56 days before with up to 56 days after and reports the relative change with an approximate 90% range, or says why it cannot (not connected, too early, too few visits, nothing to compare with). It measures a provider's visit counts only and changes nothing; it is sent as a write only because each change is an object.

## Headers

- `Point11-Organization` string, uuid
- `Idempotency-Key` string, uuid, required

## Request body

- BusinessOutcomePageChangesMeasureV2Request
  - `changes` object[], required
    - `key` string, required
    - `pages` string[], required
    - `changedFrom` string, date, required
    - `changedThrough` string, date, required

## Response `200`

Success.

- BusinessOutcomePageChangesMeasureV2Response
  - `source` BusinessItem2, required
    - `id` string, uuid, required
    - `connectionId` string, uuid, required
    - `kind` 'ga4_property' | 'vercel_project' | 'shopify_shop', required
    - `externalId` string, required
    - `name` string, nullable, required
    - `parentName` string, nullable, required
    - `currencyCode` string, nullable, required
    - `status` 'available' | 'selected' | 'access_lost', required
    - `syncedThrough` string, nullable, required
    - `lastCheckAttemptAt` string, nullable, required
    - `lastCheckErrorCode` string, nullable, required
  - `syncedThrough` string, nullable, required
  - `windowDays` integer, required
  - `minAfterDays` integer, required
  - `changes` object[], required
    - `key` string, required
    - `status` 'measured' | 'too_few_visits' | 'no_comparison' | 'not_connected' | 'too_early', required
    - `before` object, nullable, required
      - `from` string, required
      - `through` string, required
    - `after` object, nullable, required
      - `from` string, required
      - `through` string, required
    - `changed` object, nullable, required
      - `before` number, required
      - `after` number, required
    - `rest` object, nullable, required
      - `before` number, required
      - `after` number, required
    - `changePct` number, nullable, required
    - `lowPct` number, nullable, required
    - `highPct` number, nullable, required

## Other responses

- `400`: The input, query, or Idempotency-Key is invalid.
- `401`: The bearer is missing, expired, or not accepted.
- `402`: Billing refused the write: the code names the reason and `details.reason` carries it.
- `403`: The credential lacks the operation's scope or role, or the operation needs a different door.
- `404`: The resource or organization does not exist for this caller.
- `405`: This path takes another HTTP method, named in `Allow`.
- `409`: The request conflicts with current state or with prior use of its Idempotency-Key.
- `413`: The request, or the answer it asks for, is too large; narrow it.
- `429`: The credential's rate budget is spent; retry after `Retry-After` seconds.
- `500`: An unexpected server failure; retry later. Only `request_id` identifies it.
- `503`: A dependency is temporarily unavailable; retry after `Retry-After` seconds.
- `default`: Another status a product answers for its own refusal (for example `415` for an unsupported attachment); branch on `code`.

---

[API](https://skmtc.dev/point11/apis/point11-api.md) · [All operations](https://skmtc.dev/point11/apis/point11-api/llms.txt) · [OpenAPI document](https://skmtc.dev/point11/apis/point11-api/revisions/5241805fe425?raw)
