Delete Import Mapping Documentation

DELETE/importMappings/{importMappingId}

Required Tokens

Field	Type	Required	Description
Bearer	Authorization: Bearer <api-key>	Optional	Your API key. Pass it as the Bearer token on every request.
Event token	x-Event-Token	Optional	Run Get Tokens in the Authorization folder. Required when the mapping's target is `proposalLineItems`.
Organization token	x-Organization-Token	Optional	Run Get Tokens in the Organization API collection, then set `orgToken` as a variable here. Required when the mapping's target is `events`.

Removes a saved mapping. Because mappings are shared at their organization rather than owned by a user, this removes it for everyone.

Deleting the default simply leaves that target with no default — a legal state, not an error. Nothing is promoted in its place.

Imports created using the mapping are unaffected: each Import snapshots its own column mapping, so the receipt of a past import survives the mapping being deleted.

The permission is the target's, read from the stored mapping.

Response

200 with no body.

Errors

Status	Meaning
`403`	The caller lacks the target's declared permission, or sent the wrong token audience for it.
`404`	No such mapping, or it belongs to another organization.