List computed trait definitions
Beta
Twilio Cohorts is currently available as a Private Beta product and the information contained in this document is subject to change. You acknowledge and agree that your use of Twilio Cohorts is subject to the terms of the Services in Private Beta. This means that some features are not yet implemented and others may be changed before the product is declared as Generally Available. Private Beta products are not covered by the Twilio Support Terms or Twilio Service Level Agreement.
Not a HIPAA Eligible Service or PCI Compliant
Twilio Cohorts is not a HIPAA Eligible Service or PCI compliant and should not be enabled in workflows that are subject to HIPAA or PCI.
GET/preview/ComputedTraitDefinitions
Base url: https://audiences.twilio.com (base url)
The discovery call, and the first step of the customer flow.
All filters are optional and combine with AND logic.
Token-based pagination via pageSize and pageToken (see meta.nextToken).
Optional
Exact-match filter on the definition's trait key
SendIntelligence.weeklyCapMax length: 256Optional
Match resources by one or many tags. If more than one tag is specified in the query, the search returns resources that have all the tags (AND logic).
Format: key1:value1,key2:value2
Example: tags=environment:production,campaign:q1-2026
Filter character set: tag keys and values must match [a-zA-Z0-9._~-]+
(URL-safe unreserved characters). This is the same character set enforced when
tags are written, so every tag that can be stored on a resource can also be
filtered on here.
Reserved (twilio__) tag keys are rejected; filter on those through their
dedicated query parameters (e.g. storeType/storeId) instead.
^[a-zA-Z0-9._~-]+:[a-zA-Z0-9._~-]+(,[a-zA-Z0-9._~-]+:[a-zA-Z0-9._~-]+)*$Optional
Maximum number of items to return in a single response. Must be between 1 and 100. Defaults to 20 when omitted.
20Minimum: 1Maximum: 100Optional
An opaque, URL-safe cursor identifying the page of results to return. Pass
back meta.nextToken from a response to fetch the page after it, or
meta.previousToken to fetch the page before it; a response carries a token
only for a page that exists. If omitted, the API returns the first page of
results.
The token's encoding and contents are an implementation detail and may change without notice, so do not decode, construct or modify one -- a malformed token is rejected. Carry it through unchanged.
500OK - A page of computed trait definitions
Optional
List of computed trait definitions
100Optional
Pagination metadata for list responses
1curl -X GET "https://audiences.twilio.com/preview/ComputedTraitDefinitions?PageSize=20" \2-u $TWILIO_API_KEY:$TWILIO_API_SECRET
Response
1{2"computedTraitDefinitions": [3{4"id": "twilio.frequency_cap",5"displayName": "Frequency cap",6"description": "Whether the profile has reached its marketing send cap within the window.",7"tags": {},8"traitKey": "SendIntelligence.frequencyCapped",9"valueType": "BOOLEAN",10"parameterSchema": [11{12"slug": "windowDays",13"description": "Rolling window the sends are counted over, in days",14"dataType": "NUMBER",15"validationRule": {16"ruleType": "NUMBER",17"min": 1,18"max": 36519},20"required": false,21"defaultValue": 722}23]24}25],26"meta": {27"key": "computedTraitDefinitions",28"pageSize": 129}30}