v3

latestOpenAPI 3.0.1Apache 2.0raw.githubusercontent.com2026-08-014669239.7 KB
Observations

List Observation Revisions

Retrieve a chronologically ordered list of all past revisions of a specific observation by its ID. Revisions represent the complete history of updates and modifications made to an observation, with each revision capturing the full state at the time of change. Revisions are sorted by update time in descending order (newest first), allowing you to track how an observation has evolved through updates over time.

get/v1/Stores/{storeId}/Profiles/{profileId}/Observations/{observationId}/Revisions

Query parameters

pageSizeinteger

The maximum number of items to return per page, maximum of 1000.

pageTokenstring

The token for the page of results to retrieve.

Headers

Accept-Encodingstring
Example:gzip, deflate, br

Compression algorithms supported by the client (e.g., gzip, deflate, br)

Response

A chronologically ordered list of observation revisions.

Example response

{
  "revisions": [
    {
      "content": "Customer expressed satisfaction with recent product update during support call.",
      "occurredAt": "2025-01-15T10:15:30Z",
      "source": "conversational-intelligence",
      "conversationIds": [
        "conv_conversation_00000000000000000000000000"
      ],
      "id": "mem_observation_00000000000000000000000000",
      "createdAt": "2025-01-15T10:30:45Z",
      "updatedAt": "2025-01-15T10:30:45Z"
    }
  ],
  "meta": {
    "key": "observations",
    "nextToken": "eyJlYXN0ZXIiOiJlZ2cifQ",
    "previousToken": "eyJlYXN0ZXIiOiJlZ2cifQ"
  }
}