List Observation Revisions
Legal information
Conversation Memory, including the APIs, may use artificial intelligence or machine learning technologies and is subject to the terms of the Predictive and Generative AI/ML Features Addendum. For more details on AI usage and data, see the AI Nutrition Facts.
Conversation Memory is not a HIPAA Eligible Service or PCI compliant and should not be enabled in workflows that are subject to HIPAA or PCI.
Conversation Memory is not intended for use with sensitive information about individuals. Twilio does not control what information comes from conversation channels and relies on you to ensure the data in customer profiles aligns with our acceptable use policy. Twilio does have limited guardrails in the form of a prompt exclusion that is designed to provide a minimal screening against inclusion of GDPR special category data. As a reminder our profile technology uses generative artificial intelligence. Because generative artificial intelligence can make mistakes, review all outputs to ensure that the profile is correct.
Conversations products are only available in the new Twilio Console. If your account hasn't been migrated, you'll be redirected to the legacy Console where these products won't appear.
GET/v1/Stores/{storeId}/Profiles/{profileId}/Observations/{observationId}/Revisions
Base url: https://memory.twilio.com (base url)
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.
Compression algorithms supported by the client (e.g., gzip, deflate, br)
gzip, deflate, brPattern: ^[a-zA-Z0-9, .-]*$Max length: 200A unique Memory Store ID using Twilio Type ID (TTID) format
mem_store_00000000000000000000000000Pattern: ^mem_(store|service)_[0-7][0-9a-z]{25}$The unique identifier for the profile using Twilio Type ID (TTID) format.
mem_profile_00000000000000000000000000Pattern: ^mem_profile_[0-7][0-9a-z]{25}$The observation ID.
mem_observation_00000000000000000000000000Pattern: ^mem_observation_[0-7][0-9a-z]{25}$The maximum number of items to return per page, maximum of 1000.
50Minimum: 1Maximum: 1000The token for the page of results to retrieve.
500A chronologically ordered list of observation revisions.
1// Download the helper library from https://www.twilio.com/docs/node/install2const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";34// Find your Account SID and Auth Token at twilio.com/console5// and set the environment variables. See http://twil.io/secure6const accountSid = process.env.TWILIO_ACCOUNT_SID;7const authToken = process.env.TWILIO_AUTH_TOKEN;8const client = twilio(accountSid, authToken);910async function listObservationRevisions() {11const revisions = await client.memory.v112.revisions(13"mem_store_00000000000000000000000000",14"mem_profile_00000000000000000000000000",15"mem_observation_00000000000000000000000000"16)17.list({ limit: 20 });1819revisions.forEach((r) => console.log(r.content));20}2122listObservationRevisions();
Response
1{2"revisions": [3{4"id": "mem_observation_00000000000000000000000001",5"content": "Updated: Customer expressed satisfaction with recent product update during support call. Follow-up scheduled.",6"source": "customer_service",7"occurredAt": "2025-01-15T14:30:00Z",8"createdAt": "2025-01-15T10:30:45Z",9"updatedAt": "2025-01-15T14:20:15Z"10},11{12"id": "mem_observation_00000000000000000000000001",13"content": "Customer expressed frustration with billing process during call on 2025-01-15. Mentioned difficulty understanding charges.",14"source": "customer_service",15"occurredAt": "2025-01-15T14:30:00Z",16"createdAt": "2025-01-15T10:30:45Z",17"updatedAt": "2025-01-15T10:30:45Z"18}19],20"meta": {21"pageSize": 2,22"nextToken": "eyJlYXN0ZXIiOiJlZ2cifQ",23"key": "revisions"24}25}