Segments

Confirm column mapping overrides for a matched segment

Stores confirmed column mapping overrides for a matched-subtype 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.

column_mappings may be omitted entirely — the platform then re-runs column analysis on the currently active upload itself and accepts its own suggested mapping as-is (the same behavior as reviewing POST /v1/match/{id}/analyze and confirming without edits, in one call). This can return 409 FILE_NOT_YET_UPLOADED if the file hasn't finished uploading yet, or 422/400 on other analysis failures — pass column_mappings explicitly to skip re-analysis entirely.

If the segment was created or refreshed with hitl: true, the upload is still staged (not yet at the path that triggers automatic resolution) — 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/segments/{id}/mappings/cancel instead to abort a staged upload without confirming. Requires 'creator' scope.

post/v1/segments/{id}/mappings

Request

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

Path parameters

idstring required

Segment document ID.

Request body

column_mappingsobject

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). Omit entirely (send {} or no body) to accept the platform's own fresh column analysis of the active upload as-is.

Response

Mappings saved.

okboolean required
column_mappingsobject required

Changes

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