---
title: "Delete Schedule"
method: DELETE
path: "/organizations/{orgId}/dataexports/schedules/{id}"
tags: ["ExportSchedule"]
---

# Delete Schedule

`DELETE /organizations/{orgId}/dataexports/schedules/{id}`

Delete the Data Export Schedule for the given UUID. Each Schedule can be configured for exporting *only one* of either Usage or Operational data.

## Path parameters

- `orgId` string, required
- `id` string, required

## Response `200`

Returns the deleted Export Schedule.

- union
  - OperationalDataExportConfigurationResponse
    - `id` string, required — The UUID of the entity.
    - `operationalDataTypes` OperationalDataType[] — A list of the entities whose operational data is included in the data export.
    - `name` string — The name of the Data Export Schedule.
    - `code` string — Unique short code of the Data Export Schedule.
    - `sourceType` 'USAGE' | 'OPERATIONAL' — The type of data to export. Possible values: OPERATIONAL or USAGE.
    - `destinationIds` string[] — The Export Destination ids.
    - `scheduleType` 'HOUR' | 'DAY' | 'MINUTE' | 'AD_HOC' — The schedule type.
    - `period` integer — Defines the Schedule frequency for the Data Export to run in Hours, Days, or Minutes. Used in conjunction with the `scheduleType` parameter.
    - `offset` integer — Offset indicating starting point of the export within the configured scheduleType. For DAY, offset is in hours. For HOUR, offset is in minutes. Offset is not valid for MINUTE.
    - `cronExpression` string — A cron expression (https://en.wikipedia.org/wiki/Cron) describing the frequency of the expression. Executions cannot be more frequent than every 15 minutes.
    - `exportFileFormat` 'CSV' | 'JSONL' — The export file format.
    - `dtCreated` string, date-time — The DateTime when the Data Export Schedule was created.
    - `dtLastModified` string, date-time — The DateTime when the Schedule was last modified.
    - `createdBy` string — The id of the user who created this Schedule.
    - `lastModifiedBy` string — The id of the user who last modified this Data Export Schedule.
    - `version` integer — The version number: - **Create:** On initial Create to insert a new entity, the version is set at 1 in the response. - **Update:** On successful Update, the version is incremented by 1 in the response.
  - UsageDataExportConfigurationResponseV2
    - `id` string, required — The UUID of the entity.
    - `meterIds` string[] — List of meter IDs for which the usage data will be exported.
    - `accountIds` string[] — List of account IDs for which the usage data will be exported.
    - `timePeriod` 'TODAY' | 'YESTERDAY' | 'WEEK_TO_DATE' | 'MONTH_TO_DATE' | 'YEAR_TO_DATE' | 'PREVIOUS_WEEK' | 'PREVIOUS_MONTH' | 'PREVIOUS_QUARTER' | 'PREVIOUS_YEAR' | 'LAST_12_HOURS' | 'LAST_7_DAYS' | 'LAST_30_DAYS' | 'LAST_35_DAYS' | 'LAST_90_DAYS' | 'LAST_120_DAYS' | 'LAST_YEAR' — Time period for which the usage data should be exported.
    - `dimensionFilters` DataExplorerDimensionFilter[] — List of dimension filters to apply
      - `meterId` string, required — Meter ID
      - `fieldCode` string, required — Field code
    - `aggregations` DataExplorerAggregation[] — List of aggregations to apply
      - `meterId` string, required — Meter ID
      - `fieldCode` string, required — Field code
    - `groups` DataExplorerGroup[] — List of groups to apply
      - `groupType` 'ACCOUNT' | 'DIMENSION' | 'TIME' — Type of group
    - `name` string — The name of the Data Export Schedule.
    - `code` string — Unique short code of the Data Export Schedule.
    - `sourceType` 'USAGE' | 'OPERATIONAL' — The type of data to export. Possible values: OPERATIONAL or USAGE.
    - `destinationIds` string[] — The Export Destination ids.
    - `scheduleType` 'HOUR' | 'DAY' | 'MINUTE' | 'AD_HOC' — The schedule type.
    - `period` integer — Defines the Schedule frequency for the Data Export to run in Hours, Days, or Minutes. Used in conjunction with the `scheduleType` parameter.
    - `offset` integer — Offset indicating starting point of the export within the configured scheduleType. For DAY, offset is in hours. For HOUR, offset is in minutes. Offset is not valid for MINUTE.
    - `cronExpression` string — A cron expression (https://en.wikipedia.org/wiki/Cron) describing the frequency of the expression. Executions cannot be more frequent than every 15 minutes.
    - `exportFileFormat` 'CSV' | 'JSONL' — The export file format.
    - `dtCreated` string, date-time — The DateTime when the Data Export Schedule was created.
    - `dtLastModified` string, date-time — The DateTime when the Schedule was last modified.
    - `createdBy` string — The id of the user who created this Schedule.
    - `lastModifiedBy` string — The id of the user who last modified this Data Export Schedule.
    - `version` integer — The version number: - **Create:** On initial Create to insert a new entity, the version is set at 1 in the response. - **Update:** On successful Update, the version is incremented by 1 in the response.

## Other responses

- `4XX` — Error message
- `5XX` — Error message

## Changes

- **2025-12-03** `ac93d1a9e6d9` — 1 warning, 6 info
  - added the new `CHARGES` enum value to the `anyOf[#/components/schemas/OperationalDataExportConfigurationResponse]/operationalDataTypes/items/` response property for the response status `200`
  - added the optional property `anyOf[#/components/schemas/OperationalDataExportConfigurationResponse]/allOf[#/components/schemas/DataExportConfigurationResponseBase]/cronExpression` to the response with the `200` status
  - added the optional property `anyOf[#/components/schemas/OperationalDataExportConfigurationResponse]/allOf[#/components/schemas/DataExportConfigurationResponseBase]/offset` to the response with the `200` status
  - added the optional property `anyOf[#/components/schemas/UsageDataExportConfigurationResponseV2]/allOf[#/components/schemas/DataExportConfigurationResponseBase]/cronExpression` to the response with the `200` status
  - …3 more
- …earlier changes not shown

[Full history](https://skmtc.dev/m3ter-com/apis/m3ter-api/changes/organizations/:orgId/dataexports/schedules/:id/delete.md)

---

[API](https://skmtc.dev/m3ter-com/apis/m3ter-api.md) · [All operations](https://skmtc.dev/m3ter-com/apis/m3ter-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/m3ter-com/m3ter-api/revisions/ac93d1a9e6d9/schema)