Audiences

Confirm column mapping overrides for a matched audience

Stores confirmed column mapping overrides for this audience's matched member segment. Call this after reviewing the POST /v1/match/{id}/analyze response to correct any incorrect predictions. Sets mapping_confirmed: true so the platform skips its own analysis and uses these mappings directly.

If the underlying segment was refreshed with hitl: true, the upload is still staged — this call also moves the staged file into place and starts identity resolution, which is why it can return 500 STAGING_COPY_FAILED if that move fails (the segment is left unchanged in that case; retry the call). Use POST /v1/audiences/{id}/mappings/cancel instead to abort a staged upload without confirming. Requires 'creator' scope.

post/v1/audiences/{id}/mappings

Request

  • Base URL: https://api.infiniteaudience.ai
  • URL: https://api.infiniteaudience.ai/v1/audiences/{id}/mappings
  • Auth: HTTP bearer

Path parameters

idstring required

Audience document ID.

Request body

column_mappingsobject required

Map of source column name → standard identity attribute name. Use "(skip)" as the value to explicitly exclude a column. Skip entries are stored and echoed back; a skipped column is never used for matching, even if its name equals a standard attribute (e.g. a column literally named email).

Response

Mappings saved.

okboolean required
column_mappingsobject required

Changes

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