Use this method to expire subset of individual audience IDs within an existing audience segment. This action will remove the audience IDs from an existing active (live) audience segment within 24 hrs.

Endpoint: PUT /v1/audiences/{viantSegmentId}/data?action=expireSpecificAudience

Request Body:

Make sure to match the segment ID form the end point URL in the request body
Make sure to match the data type you input when creating this segment.

{
  "segmentId" : "fpsegm123123123",
  "dataType"  : "email_sha256",
  "values"    : [ 
      "54de994b6f7ec60471b6018e05d87434e9ae93787eda6f45fdbbd5ee640713ee",
      "9209fha090930923h0fa0980923hh09a09fu0923j90u09fu09q309uf09u90u93",
      (...)
  ]
}

Response (Success):

HTTP Response Code: 200
{
  "created"    : "2025-07-23T04:37:07.123988031Z",
  "job_id"     : "12345678-abcd-1234-abcd-123456789123",
  "message"    : "Expire specific audience request created successfully",
  "segment_id" : "fpsegm123123123",
  "status"     : "REQUESTED"
}

Response (Failure):

HTTP Response Code: 400
{
  "error" : "error message"
}