# archived on PATCH /v1/blocks/{} is deprecated

Notion API deprecated PATCH /v1/blocks/{}, body parameter archived without giving a shutdown date yet.

The body parameter archived on PATCH /v1/blocks/{} has been deprecated without a shutdown date. The provider announced this change on April 1, 2024. Requests using this parameter will eventually fail once the removal takes effect.

## What to use instead

Send in_trash instead of archived when trashing or restoring a block.

- API: Notion API (api.notion.com)
- Kind: Endpoint removal
- Announced: April 1, 2024
- Takes effect: no date given yet
- Calls after that day: fail
- Calls it hits: `PATCH /v1/blocks/{}`, `body parameter archived`
- Source: [Announcement](https://developers.notion.com/guides/get-started/upgrade-guide-2026-03-11)
- Verified: October 26, 2026, against Notion API's own pages
- Page: https://www.okapi.bot/providers/notion-api/breaking-changes/archived-on-patch-v1-blocks-is-deprecated/

## Notion API's words

> The archived field was deprecated in April 2024.

Okapi finds the calls this change hits in your repo and opens the pull request with the fix: https://github.com/apps/okapi-agent