Replaces the items within an existing exception list by uploading a .CSV/.XLSX file with all items meant for a particular exception list. To update specific items in an exception list, use the create an item for an exception list endpoint with the Upsert parameter.
Parameters
File optional
File optionalA .CSV/.XLSX file containing the column headers found below and the exception list's item's information. One exception list item per row. Cannot use alongside any other parameter.
| View column headers | ||
|---|---|---|
Value | required | The CATEGORY or SKU value that the exception list looks at, depending on the exception list's Type. |
Name | optional | Item's display name for contracting purposes. |
ActiveStartDate | optional | The date and time that the item will be added to the exception list. See ISO 8601. |
ActiveEndDate | optional | The date and time that the item will be removed from the exception list. See ISO 8601. |
TimeZone | optional | The time zone that govern ActiveStartDate and ActiveEndDate. See impact.com's supported currencies. |
Returns
Returns the status of the request and the URI of the exception list item list. Returns an error if create parameters are invalid or if a required parameter is missing.
Example Request
curl 'https://api.impact.com/Advertisers/<AccountSID>/ExceptionLists/<ExceptionListId>/Items' \
-X PATCH \
-u '<AccountSID>:<AuthToken>' \
-H 'Content-Type: multipart/form-data' \
-F 'File=@"path/to/a/file.csv"'
Example Response
{
"Status": "OK",
"Uri": "/Advertisers/<AccountSID>/ExceptionLists/10002/Items/"
}
