--- title: "Retrieve a list of OperatorResults" method: GET path: "/v3/OperatorResults" tags: ["OperatorResults"] --- # Retrieve a list of OperatorResults `GET /v3/OperatorResults` ## Query parameters - `conversationId` string — The `id` of the Conversation attached to the Operator Result. - `intelligenceConfigurationId` string — Unique identifier for a Intelligence Configuration that generated the Operator Result. Assigned by Twilio (TTID). - `operatorId` string — The unique identifier for the Language Operator. Assigned by Twilio (TTID). - `pageSize` integer - `pageToken` string ## Response `200` An array of Operator Results. - object - `items` OperatorResultsResponseV1[], required — List of Operator Results matching the query. - union - object - `outputFormat` string, required — The output format set on the Operator that generated this result. Determines the structure of the `result` object. - `id` string, required — A unique identifier for the Operator Result. Assigned by Twilio (TTID). - `accountId` string, required — The ID of the Account that created the Language Operator. - `intelligenceConfiguration` IntelligenceConfigurationReference, required — Reference to the Intelligence Configuration that generated the Operator Result. - `id` string, required — Unique identifier for a Intelligence Configuration that generated the Operator Result. Assigned by Twilio (TTID). - `ruleId` string, required — Unique identifier of the rule of the Intelligence Configuration that triggered the result. Assigned by Twilio (TTID). - `version` integer, required — Version of the Intelligence Configuration used to generate the Operator Result. - `conversationId` string, required — The `id` of the Conversation attached to the Operator Result. - `operator` OperatorReference, required — Reference to the Language Operator that generated the Operator Result. - `id` string, required — The `id` of the Language Operator. - `version` integer, required — Version of the Language Operator used to generate the Operator Result. - `parameters` object, required — Parameter values used for Operator execution, provided by the Rule at runtime. This object contains a dictionary of parameter keys and their corresponding values. - `dateCreated` string, date-time, required — Timestamp for when the Operator Result was created. - `referenceIds` string[], required — The `id`s of objects related to this Operator Result. - `executionDetails` ExecutionDetails, required — Details about the conditions under which the Operator executed. - `trigger` object, required — Metadata for the trigger that generated this Operator Result. - `on` string, required — The conversational lifecycle event that activated execution of the Rule. Available values are: - `COMMUNICATION`: Trigger the Rule on each communication within the Conversation. - `CONVERSATION_END`: Trigger the Rule when the Conversation moves to the `closed` state. - `CONVERSATION_INACTIVE`: Trigger the Rule when the Conversation moves to the `inactive` state. - `timestamp` string, date-time, required — Timestamp of when the trigger was activated. - `communications` object, required — Range of first and last communications in the Conversation that were processed during this Operator execution. - `first` string, required — Starting communication `id` from the attached Conversation. - `last` string, required — Ending communication `id` from the attached Conversation. - `channels` string[], required — Communication channels included in the Conversation when this Operator was executed. - `participants` object[], required — Metadata for the participants included in the Conversation when this Operator executed. - `id` string, required — The `id` of the Participant in the Conversation. - `profileId` string — Customer Memory Profile identifier - `type` string — Type of participant in the conversation. Available types: - `CUSTOMER` - `HUMAN_AGENT` - `AI_AGENT` - `AGENT` - `UNKNOWN` - `resolvedContext` ResolvedContext — The context that was actually used by the operator during execution - `memory` object — The customer profile that was accessed. null if no memory was accessed. Either observations and/or traits from the profile were used by the LLM to generate the result. - … - `knowledge` object, nullable — Knowledge source IDs with their respective knowledge base ID that was accessed and used by the LLM to generate the result. null if no knowledge was accessed. - … - `metadata` object, required - `system` SystemMetaData, required - `resolvedModel` string — The underlying LLM model used for this execution. - `latencyMs` integer, required — Operator execution time in milliseconds. - `inputCharacters` integer, required — Number of characters in the input sent to the model. Aligns with the billing unit. - `outputCharacters` integer, required — Number of characters in the model's response. Aligns with the billing unit. - `inputTruncated` boolean, required — Whether the conversation input was truncated to fit the model's context window. - `result` object, required — The actual result from executing the Language Operator with `TEXT` output format. - `text` string, required — The plaintext result produced by the Language Operator. - object - `outputFormat` string, required — The output format set on the Operator that generated this result. Determines the structure of the `result` object. - `id` string, required — A unique identifier for the Operator Result. Assigned by Twilio (TTID). - `accountId` string, required — The ID of the Account that created the Language Operator. - `intelligenceConfiguration` IntelligenceConfigurationReference, required — Reference to the Intelligence Configuration that generated the Operator Result. - `id` string, required — Unique identifier for a Intelligence Configuration that generated the Operator Result. Assigned by Twilio (TTID). - `ruleId` string, required — Unique identifier of the rule of the Intelligence Configuration that triggered the result. Assigned by Twilio (TTID). - `version` integer, required — Version of the Intelligence Configuration used to generate the Operator Result. - `conversationId` string, required — The `id` of the Conversation attached to the Operator Result. - `operator` OperatorReference, required — Reference to the Language Operator that generated the Operator Result. - `id` string, required — The `id` of the Language Operator. - `version` integer, required — Version of the Language Operator used to generate the Operator Result. - `parameters` object, required — Parameter values used for Operator execution, provided by the Rule at runtime. This object contains a dictionary of parameter keys and their corresponding values. - `dateCreated` string, date-time, required — Timestamp for when the Operator Result was created. - `referenceIds` string[], required — The `id`s of objects related to this Operator Result. - `executionDetails` ExecutionDetails, required — Details about the conditions under which the Operator executed. - `trigger` object, required — Metadata for the trigger that generated this Operator Result. - `on` string, required — The conversational lifecycle event that activated execution of the Rule. Available values are: - `COMMUNICATION`: Trigger the Rule on each communication within the Conversation. - `CONVERSATION_END`: Trigger the Rule when the Conversation moves to the `closed` state. - `CONVERSATION_INACTIVE`: Trigger the Rule when the Conversation moves to the `inactive` state. - `timestamp` string, date-time, required — Timestamp of when the trigger was activated. - `communications` object, required — Range of first and last communications in the Conversation that were processed during this Operator execution. - `first` string, required — Starting communication `id` from the attached Conversation. - `last` string, required — Ending communication `id` from the attached Conversation. - `channels` string[], required — Communication channels included in the Conversation when this Operator was executed. - `participants` object[], required — Metadata for the participants included in the Conversation when this Operator executed. - `id` string, required — The `id` of the Participant in the Conversation. - `profileId` string — Customer Memory Profile identifier - `type` string — Type of participant in the conversation. Available types: - `CUSTOMER` - `HUMAN_AGENT` - `AI_AGENT` - `AGENT` - `UNKNOWN` - `resolvedContext` ResolvedContext — The context that was actually used by the operator during execution - `memory` object — The customer profile that was accessed. null if no memory was accessed. Either observations and/or traits from the profile were used by the LLM to generate the result. - … - `knowledge` object, nullable — Knowledge source IDs with their respective knowledge base ID that was accessed and used by the LLM to generate the result. null if no knowledge was accessed. - … - `metadata` object, required - `system` SystemMetaData, required - `resolvedModel` string — The underlying LLM model used for this execution. - `latencyMs` integer, required — Operator execution time in milliseconds. - `inputCharacters` integer, required — Number of characters in the input sent to the model. Aligns with the billing unit. - `outputCharacters` integer, required — Number of characters in the model's response. Aligns with the billing unit. - `inputTruncated` boolean, required — Whether the conversation input was truncated to fit the model's context window. - `result` object, required — The actual result from executing the Language Operator with `JSON` output format. Its structure depends on the `outputSchema` defined on the Operator. - object - `outputFormat` string, required — The output format set on the Operator that generated this result. Determines the structure of the `result` object. - `id` string, required — A unique identifier for the Operator Result. Assigned by Twilio (TTID). - `accountId` string, required — The ID of the Account that created the Language Operator. - `intelligenceConfiguration` IntelligenceConfigurationReference, required — Reference to the Intelligence Configuration that generated the Operator Result. - `id` string, required — Unique identifier for a Intelligence Configuration that generated the Operator Result. Assigned by Twilio (TTID). - `ruleId` string, required — Unique identifier of the rule of the Intelligence Configuration that triggered the result. Assigned by Twilio (TTID). - `version` integer, required — Version of the Intelligence Configuration used to generate the Operator Result. - `conversationId` string, required — The `id` of the Conversation attached to the Operator Result. - `operator` OperatorReference, required — Reference to the Language Operator that generated the Operator Result. - `id` string, required — The `id` of the Language Operator. - `version` integer, required — Version of the Language Operator used to generate the Operator Result. - `parameters` object, required — Parameter values used for Operator execution, provided by the Rule at runtime. This object contains a dictionary of parameter keys and their corresponding values. - `dateCreated` string, date-time, required — Timestamp for when the Operator Result was created. - `referenceIds` string[], required — The `id`s of objects related to this Operator Result. - `executionDetails` ExecutionDetails, required — Details about the conditions under which the Operator executed. - `trigger` object, required — Metadata for the trigger that generated this Operator Result. - `on` string, required — The conversational lifecycle event that activated execution of the Rule. Available values are: - `COMMUNICATION`: Trigger the Rule on each communication within the Conversation. - `CONVERSATION_END`: Trigger the Rule when the Conversation moves to the `closed` state. - `CONVERSATION_INACTIVE`: Trigger the Rule when the Conversation moves to the `inactive` state. - `timestamp` string, date-time, required — Timestamp of when the trigger was activated. - `communications` object, required — Range of first and last communications in the Conversation that were processed during this Operator execution. - `first` string, required — Starting communication `id` from the attached Conversation. - `last` string, required — Ending communication `id` from the attached Conversation. - `channels` string[], required — Communication channels included in the Conversation when this Operator was executed. - `participants` object[], required — Metadata for the participants included in the Conversation when this Operator executed. - `id` string, required — The `id` of the Participant in the Conversation. - `profileId` string — Customer Memory Profile identifier - `type` string — Type of participant in the conversation. Available types: - `CUSTOMER` - `HUMAN_AGENT` - `AI_AGENT` - `AGENT` - `UNKNOWN` - `resolvedContext` ResolvedContext — The context that was actually used by the operator during execution - `memory` object — The customer profile that was accessed. null if no memory was accessed. Either observations and/or traits from the profile were used by the LLM to generate the result. - … - `knowledge` object, nullable — Knowledge source IDs with their respective knowledge base ID that was accessed and used by the LLM to generate the result. null if no knowledge was accessed. - … - `metadata` object, required - `system` SystemMetaData, required - `resolvedModel` string — The underlying LLM model used for this execution. - `latencyMs` integer, required — Operator execution time in milliseconds. - `inputCharacters` integer, required — Number of characters in the input sent to the model. Aligns with the billing unit. - `outputCharacters` integer, required — Number of characters in the model's response. Aligns with the billing unit. - `inputTruncated` boolean, required — Whether the conversation input was truncated to fit the model's context window. - `result` object, required — The actual result from executing the Language Operator with `CLASSIFICATION` output format. - `label` string, required — The predicted label assigned by the Language Operator. - object - `outputFormat` string, required — The output format set on the Operator that generated this result. Determines the structure of the `result` object. - `id` string, required — A unique identifier for the Operator Result. Assigned by Twilio (TTID). - `accountId` string, required — The ID of the Account that created the Language Operator. - `intelligenceConfiguration` IntelligenceConfigurationReference, required — Reference to the Intelligence Configuration that generated the Operator Result. - `id` string, required — Unique identifier for a Intelligence Configuration that generated the Operator Result. Assigned by Twilio (TTID). - `ruleId` string, required — Unique identifier of the rule of the Intelligence Configuration that triggered the result. Assigned by Twilio (TTID). - `version` integer, required — Version of the Intelligence Configuration used to generate the Operator Result. - `conversationId` string, required — The `id` of the Conversation attached to the Operator Result. - `operator` OperatorReference, required — Reference to the Language Operator that generated the Operator Result. - `id` string, required — The `id` of the Language Operator. - `version` integer, required — Version of the Language Operator used to generate the Operator Result. - `parameters` object, required — Parameter values used for Operator execution, provided by the Rule at runtime. This object contains a dictionary of parameter keys and their corresponding values. - `dateCreated` string, date-time, required — Timestamp for when the Operator Result was created. - `referenceIds` string[], required — The `id`s of objects related to this Operator Result. - `executionDetails` ExecutionDetails, required — Details about the conditions under which the Operator executed. - `trigger` object, required — Metadata for the trigger that generated this Operator Result. - `on` string, required — The conversational lifecycle event that activated execution of the Rule. Available values are: - `COMMUNICATION`: Trigger the Rule on each communication within the Conversation. - `CONVERSATION_END`: Trigger the Rule when the Conversation moves to the `closed` state. - `CONVERSATION_INACTIVE`: Trigger the Rule when the Conversation moves to the `inactive` state. - `timestamp` string, date-time, required — Timestamp of when the trigger was activated. - `communications` object, required — Range of first and last communications in the Conversation that were processed during this Operator execution. - `first` string, required — Starting communication `id` from the attached Conversation. - `last` string, required — Ending communication `id` from the attached Conversation. - `channels` string[], required — Communication channels included in the Conversation when this Operator was executed. - `participants` object[], required — Metadata for the participants included in the Conversation when this Operator executed. - `id` string, required — The `id` of the Participant in the Conversation. - `profileId` string — Customer Memory Profile identifier - `type` string — Type of participant in the conversation. Available types: - `CUSTOMER` - `HUMAN_AGENT` - `AI_AGENT` - `AGENT` - `UNKNOWN` - `resolvedContext` ResolvedContext — The context that was actually used by the operator during execution - `memory` object — The customer profile that was accessed. null if no memory was accessed. Either observations and/or traits from the profile were used by the LLM to generate the result. - … - `knowledge` object, nullable — Knowledge source IDs with their respective knowledge base ID that was accessed and used by the LLM to generate the result. null if no knowledge was accessed. - … - `metadata` object, required - `system` SystemMetaData, required - `resolvedModel` string — The underlying LLM model used for this execution. - `latencyMs` integer, required — Operator execution time in milliseconds. - `inputCharacters` integer, required — Number of characters in the input sent to the model. Aligns with the billing unit. - `outputCharacters` integer, required — Number of characters in the model's response. Aligns with the billing unit. - `inputTruncated` boolean, required — Whether the conversation input was truncated to fit the model's context window. - `result` object, required — The actual result from executing the Language Operator with `EXTRACTION` output format. - `entities` object[], required — List of extracted entities from the Conversation. - `text` string, required — The actual text of the extracted entity as it appears in the Conversation. - `label` string, required — The label for the extracted entity (e.g., `PERSON`, `LOCATION`). - `meta` object, required - `key` string, required — A key, sibling to the `meta` object that holds the actual list of resources - `pageSize` integer, required — The actual number of resources returned in the response - `previousToken` string - `nextToken` string ## Other responses - `400` — Bad request - `429` — Too Many requests (rate limit exceeded for request originating from public API) - `500` — Internal server error --- [API](https://skmtc.net/twilio/apis/twilio-intelligence.md) · [All operations](https://skmtc.net/twilio/apis/twilio-intelligence/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twilio/twilio-intelligence/revisions/3a830979326d/schema)