---
title: "Delete an event"
method: DELETE
path: "/v3/schedules/{id}/rotations/{rotation_id}/events/{event_id}"
tags: ["Schedules_v3"]
---

# Delete an event

`DELETE /v3/schedules/{id}/rotations/{rotation_id}/events/{event_id}`

## Request

- Base URL: `https://api.pagerduty.com`
- URL: `https://api.pagerduty.com/v3/schedules/{id}/rotations/{rotation_id}/events/{event_id}`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/pagerduty/apis/rest-api/docs/v3/schedules/:id/rotations/:rotation_id/events/:event_id/delete.ts> (a function with typed inputs; its response is checked against the schema)

<!-- theme: info -->

> **Important note:** Shift-based schedules use the V3 API and are not compatible with V2 automations. **To create automations for Shift-Based Schedules, you need to:**
>
> 1. **Update your automations** to use the V3 API for all new shift-based schedules
> 2. **Keep the V2 endpoint** for your existing schedules
>
> An upgrade tool for existing schedules is coming soon; your legacy schedules will keep working in the meantime. [Learn more](https://support.pagerduty.com/main/docs/shift-based-schedules-api-upgrade-examples).

Delete an event from a rotation.

## Path parameters

- `id` string, required
- `rotation_id` string, required
- `event_id` string, required

## Response `204`

Event deleted successfully

## Other responses

- `401`: Caller did not supply credentials or did not provide the correct credentials. If you are using an API key, it may be invalid or your Authorization header may be malformed.
- `403`: Caller is not authorized to view the requested resource. While your authentication is valid, the authenticated user or token does not have permission to perform this action.
- `404`: The requested resource was not found.
- `500`: Internal Server Error the PagerDuty server experienced an error.

---

[API](https://skmtc.dev/pagerduty/apis/rest-api.md) - [All operations](https://skmtc.dev/pagerduty/apis/rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pagerduty/apis/rest-api/revisions/b679a8f3f02c?raw)