Segments

Report that a matched segment's client-side re-upload failed

Called when a matched segment's re-upload (kicked off by POST /v1/segments/{id}/refresh or POST /v1/audiences/{id}/refresh) fails client-side before ever reaching storage — e.g. a browser-side network or CORS failure on the presigned upload PUT. The async pipeline that would normally fail the segment never starts in that case, since no upload ever arrived, so without this call the segment (and any linked audience) would otherwise stay pending until a much slower backstop eventually catches it.

Idempotent — a no-op (already_resolved: true) if the segment has already moved past pending (e.g. the upload actually succeeded). Only valid for matched-subtype segments. Requires 'creator' scope.

post/v1/segments/{id}/upload-failed

Request

  • Base URL: https://api.infiniteaudience.ai
  • URL: https://api.infiniteaudience.ai/v1/segments/{id}/upload-failed
  • Auth: HTTP bearer

Path parameters

idstring required

Segment document ID.

Request body

audience_idstring

Optional linked audience to also mark failed, in addition to the segment's own linked audience (if any).

reasonstring

Human-readable failure reason.

Response

Segment (and any linked audience) marked failed, or already resolved.

okboolean required
already_resolvedboolean required

True if the segment had already moved past pending before this call.

Changes

No recorded changes to this operation across all 1 revision of this API.