Docs
Update Import Mapping
PUT /importMappings/{importMappingId}
PUT
/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`. |
Renames a saved mapping and sets or clears its default flag. Nothing else.
The permission is the target's, read from the stored mapping — you do not pass the target here.
Body
| Field | Type | Required | Description |
|---|---|---|---|
| name | string | Required | Non-empty. |
| isDefault | bool | Optional | Setting it clears the flag from whichever other mapping held it for this target and organization. |
target and configuration are not updatable
Deliberately absent from the body. A changed mapping is a new save, not an edit — a mapping's configuration is the record of what applied when it was created, and letting it be rewritten in place would make a shared mapping change under everyone using it.
To change what a mapping maps: build it in the wizard and save it again.
Response
200 with no body.
Errors
| Status | Meaning |
|---|---|
400 | name is empty. |
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. The two answer identically on purpose, so this route cannot be used to probe for ids. |