DELETE - Remove
The App Data API enables you to create, update, delete and list data you associated to your application. App Data lets you create tables of key/value pairs. It is for application centric data as opposed to user centric data. You can use the data in your targeting queries and/or in a message template.
The App Data API exposes a DELETE endpoint that allows to delete a table:
Here is a valid cURL example:
curl -H "Content-Type: application/json" -H "X-Authorization: BATCH_REST_API_KEY" -X DELETE "https://api.batch.com/1.0/BATCH_API_KEY/app-data/TABLE_NAME"
TABLE_NAME value must be a string that only contains letters, numbers or the following characters:
NOTE: Make sure before deletion that this App Data table is not used by any campaign.
BATCH_API_KEY value is either your Live, Dev or SDK Batch API key from the settings page of your app within the dashboard (⚙ Settings → General).
In order to authenticate with the API, you need to provide your company REST API Key as the value of the
X-Authorization header. You can find it in ⚙ Settings → General.
If the call to the API endpoint is successful you will receive an HTTP 200 confirmation and an empty json payload.
If the POST data does not meet the API requirements you will receive an actionable error message. Contact us at email@example.com if you need further support.
AUTHENTICATION_INVALID(Http status code: 401, Error code: 10)
ROUTE_NOT_FOUND(Http status code: 404, Error code: 20)
MISSING_PARAMETER(Http status code: 400, Error code: 30)
MALFORMED_PARAMETER(Http status code: 400, Error code: 31)
MALFORMED_JSON_BODY(Http status code: 400, Error code: 32)
SERVER_ERROR(Http status code: 500, Error code: 1)
MAINTENANCE_ERROR(Http status code: 503, Error code: 2)