Delete a cohort definition

(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. 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.

DELETE/preview/Cohorts/{cohortId}

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

Initiates deletion of a cohort definition and all cohort snapshots sourced from it.

Processed asynchronously: returns 202 Accepted with an Operation resource that can be polled via CohortOperations to track deletion progress.

Request

Authentication

Basic Auth

Headers

Property nameTypeRequiredDescription

If-Matchstring

Optional

Used for optimistic concurrency control on mutating requests (PATCH, PUT, DELETE). The value should be the ETag returned from a previous GET request for this resource.

If the current ETag does not match, the server returns 412 Precondition Failed, indicating the resource has been modified since it was last retrieved.

When omitted, the write proceeds without ETag validation.

Max length: 100

Path parameters

Property nameTypeRequiredDescription

cohortIdstring

required

The cohortId identifier

Responses

202400401403404412422429500

Accepted - Operation accepted for asynchronous processing. Poll the CohortOperations endpoint to check status.

SchemaExample

Property nameTypeRequiredDescriptionChild properties

operationIdstring

read-only

Optional

Unique identifier for the operation following TTID format. Format: cmp_operation_{uuidv7-encoded}

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

statusenum<string>

read-only

Optional

Current status of the operation.

PENDING: Operation is waiting to be processed
RUNNING: Operation is in progress
COMPLETED: Operation finished successfully
FAILED: Operation failed (check error field)
CANCELLED: Operation was cancelled by the user

Example: RUNNINGPossible values:

PENDINGRUNNINGCOMPLETEDFAILEDCANCELLED

statusUrlstring<uri-reference>

read-only

Optional

URL to poll for operation status

Example: /preview/CohortOperations/cmp_operation_01h9d8r0vte3hz8tykdj329t7rMax length: 500

createdAtstring<date-time>

read-only

Optional

Timestamp when the operation was created

Example: 2026-01-15T10:00:00Z

completedAtstring<date-time>

read-only

Optional

Timestamp when the operation completed (present for terminal states)

Example: 2026-01-15T10:03:45Z

payloadobject

read-only

Optional

Operation-specific metadata and progress information for a Cohort operation.

Show payload properties

resultUrlstring<uri-reference>

read-only

Optional

URL of the resulting resource. Present when status is COMPLETED and the operation produced or modified a resource.

Not present for deletion operations (DELETE, SNAPSHOT_DELETE) since the resource no longer exists after completion.

Example: /preview/CohortSnapshots/cmp_cohortsnapshot_01h9d8r0vte3hz8tykdj329t7rMax length: 500

resultobject

read-only

Optional

Operation-specific output data. Only present when status is COMPLETED. Fields present depend on operationType:

SNAPSHOT: cohortSnapshotId, cohortId (COHORT-sourced only), profileCount, partitionCount, updatedAt
SNAPSHOT_DELETE: cohortSnapshotId, cohortId (COHORT-sourced only)
UPDATE: cohortId, updatedAt
DELETE: cohortId

Show result properties

errorobject

read-only

Optional

Detailed error information following RFC 9457 Problem Details standard. Only present when status is FAILED.

Show error properties

Delete a cohort definition

1curl -X DELETE "https://audiences.twilio.com/preview/Cohorts/cohortId" \
2-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN

Response

1{
2  "operationId": "cmp_operation_01h9d8r0vte3hz8tykdj329t7r",
3  "status": "PENDING",
4  "statusUrl": "/preview/CohortOperations/cmp_operation_01h9d8r0vte3hz8tykdj329t7r",
5  "createdAt": "2026-01-15T10:00:00Z"
6}