Skip to contentSkip to navigationSkip to topbar

Fetch a computed trait's status


(new)

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(link takes you to an external page). 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.

(warning)

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/ComputedTraits/{computedTraitId}/Status

Base url: https://audiences.twilio.com (base url)

Whether the computed trait's values are readable and being kept current. The ongoing signal, as opposed to a ComputedTraitOperation, which tracks one change. A NOT_COMPUTING status always carries detail.reason, a human-readable explanation of the issue and how to fix it, and may carry detail.detectedAt.


Request

fetch-computed-trait-status-request page anchor

Path parameters

fetch-computed-trait-status-path-parameters page anchor
Property nameTypeRequiredDescription
computedTraitIdstring
required

The computedTraitId identifier


200401403404429500

OK - The computed trait's status

SchemaExample
Property nameTypeRequiredDescriptionChild properties
computedTraitIdstring
read-only

Optional

Unique identifier for a computed trait following TTID format. Format: cmp_computedtrait_{uuidv7-encoded}

Example: cmp_computedtrait_01h9d8r0vte3hz8tykdj329t9fPattern: ^cmp_computedtrait_[a-zA-Z0-9]{26}$Max length: 100

statusenum<string>

Optional

  • UPDATING: values do not yet reflect the current configuration. Entered on create, enable, or a parameter change; never on a scheduled recompute.
  • CURRENT: values reflect the configuration and are maintained under the freshness SLA.
  • NOT_COMPUTING: the computation has hit an underlying issue and is not running successfully. Values already written stay on profiles, but we can't guarantee they are within the freshness SLA: they are not definitively stale, but if the issue is not resolved they will fall outside it. detail.reason says what is wrong and how to fix it. The next successful run returns to CURRENT. Transient errors are retried internally and do not surface here.
  • DISABLED: isEnabled is false and values are no longer maintained.
Example: CURRENTPossible values:
UPDATINGCURRENTNOT_COMPUTINGDISABLED

detailobject

Optional

The underlying issue behind a NOT_COMPUTING status. Present only while NOT_COMPUTING.


updatedAtstring<date-time>
read-only

Optional

When the status last changed

Example: 2026-09-16T14:31:05Z
Fetch a computed trait's statusLink to code sample: Fetch a computed trait's status
1
curl -X GET "https://audiences.twilio.com/preview/ComputedTraits/computedTraitId/Status" \
2
-u $TWILIO_API_KEY:$TWILIO_API_SECRET

Response

Note about this response
1
{
2
"computedTraitId": "cmp_computedtrait_01h9d8r0vte3hz8tykdj329t9f",
3
"status": "CURRENT",
4
"updatedAt": "2026-09-16T14:31:05Z"
5
}