---
updatedAt: 2026-07-09T21:27:20.000Z
---

# Delete a 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](/us-marketplace/reference/post_v3-reports-schedules).

## Endpoint

```text
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 note its **`scheduleId`**.
2. Call **DELETE** `/v3/reports/schedules/{scheduleId}`.
3. Confirm the response returns a success message.

```curl
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'
```
```python
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

```json
{
  "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.