---
title: "Cancel Notetaker before it joins"
method: DELETE
path: "/v3/grants/{grant_id}/notetakers/{notetaker_id}/cancel"
tags: ["Notetaker"]
---

# Cancel Notetaker before it joins

`DELETE /v3/grants/{grant_id}/notetakers/{notetaker_id}/cancel`

## Request

- Base URL: `https://api.us.nylas.com`
- URL: `https://api.us.nylas.com/v3/grants/{grant_id}/notetakers/{notetaker_id}/cancel`
- Auth: HTTP bearer

Cancels a Notetaker while its status is `scheduled`, `connecting`, or `waiting_for_entry`, preventing it from joining the meeting. After the Notetaker joins the meeting, use the leave endpoint. To permanently delete a Notetaker in any state, use the delete endpoint instead.

## Response `200`

OK

- object
  - `request_id` string: The ID of the request.

## Other responses

- `401`: Unauthorized
- `404`: Not Found
- `409`: Conflict
- `429`: Rate limited. The provider or Nylas throttled the request. If a provider throttles a request and says how long to wait, the `Retry-After` header gives that number of seconds. When the header is missing, retry with exponential backoff. See [429 rate limit errors by provider](/docs/api/errors/400-response/#429-rate-limit-errors-by-provider).

## Changes

- **2026-09-26** `763d6b969cd7`: 1 info
  - added the optional property `error/provider_error` to the response with the `429` status

[Operation history](https://skmtc.dev/nylas/apis/nylas-api/changes/v3/grants/:grant_id/notetakers/:notetaker_id/cancel/delete.md)

---

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