Delete report schedule

Call this endpoint to delete an existing report schedule. Use it when you no longer need Walmart to generate a report on a recurring cadence.

Note: Deleting a schedule stops future report generation for that schedule. This action cannot be undone. Keep the scheduleId if you need to recreate the schedule later.

For more information, refer to the Reports Scheduler API reference.

Endpoint

DELETE https://marketplace.walmartapis.com/v3/reports/schedules/{scheduleId}

Sample request

This sample request deletes a schedule by scheduleId. It uses the required path parameter and required headers.

Scheduling workflow

  1. Find the schedule you want to delete and capture its scheduleId.
  2. Call DELETE /v3/reports/schedules/{scheduleId}.
  3. Confirm the response returns a success message.
curl -X DELETE "https://marketplace.walmartapis.com/v3/reports/schedules/468849ca-81c4-4e0c-881d-1c750efe2a7d" \ -H 'WM_SEC.ACCESS_TOKEN: eyJraWQiOiIzZjVhYTFmNS1hYWE5LTQzM.....' \ -H 'WM_QOS.CORRELATION_ID: b3261d2d-028a-4ef7-8602-633c23200af6' \ -H 'WM_SVC.NAME: Walmart Marketplace' \ -H 'Accept: application/json'
import requests schedule_id = "468849ca-81c4-4e0c-881d-1c750efe2a7d"
url = f"https://marketplace.walmartapis.com/v3/reports/schedules/{schedule_id}" headers = { "WM_SEC.ACCESS_TOKEN": "<ACCESS_TOKEN>", "WM_SVC.NAME": "Walmart Marketplace", "WM_QOS.CORRELATION_ID": "<CORRELATION_ID>", "Accept": "application/json",
} response = requests.delete(url, headers=headers)
print("Status code:", response.status_code)
print("Response JSON:", response.json())

Modify your code

  • Use a unique WM_QOS.CORRELATION_ID for each request.
  • Replace WM_SEC.ACCESS_TOKEN with your valid access token obtained through authentication.
  • Replace {scheduleId} with the schedule ID you want to delete.

Sample response

{ "message": "Schedule deleted successfully"
}

Result

If the request is successful, the API returns HTTP 200 OK with a JSON body that confirms the schedule was deleted.

After you delete a schedule, it will not appear in GET /v3/reports/schedules results, and Walmart will stop generating reports for that schedule.