ブロックを削除

DELETE/v1/blocks/ {block_id}

指定された ID を使用するように、ページブロックを含むBlock オブジェクトをarchived: trueに設定します。注: Notion UI アプリケーションでは、ブロックは「ゴミ箱」に移動され、引き続きアクセスして復元することができます。

API を使用してブロックを復元するには、ブロックの更新または更新ページをそれぞれ使用します。

📘インテグレーション機能

このエンドポイントでは、コンテンツの更新機能を備えた統合が必要です。更新コンテンツ機能なしでこの API を呼び出そうとすると、403 ステータスコードを含む HTTP 応答が返されます。統合機能の詳細については、機能ガイドを参照してください。

エラー

ブロックが存在しない場合、または統合がブロックにアクセスできない場合は、404 HTTP 応答を返します。

リクエストがリクエスト制限を超えた場合、400 または 429 HTTP レスポンスを返します。

Requestパラメータ

Pathパラメータ

block_id

string

必須

Notionブロックの識別子

Headerパラメータ

Notion-Version

string

可選

サンプルコード

Response

OK(200)

HTTPステータスコード: 200

コンテンツ形式: JSONapplication/json

object

string

必須

string

必須

parent

object

必須

type

string

必須

page_id

string

必須

created_time

string

必須

last_edited_time

string

必須

created_by

object

必須

object

string

必須

string

必須

last_edited_by

object

必須

object

string

必須

string

必須

has_children

boolean

必須

archived

boolean

必須

type

string

必須

paragraph

object

必須

rich_text

array[string]

必須

color

string

必須

{
  "object": "block",
  "id": "7985540b-2e77-4ac6-8615-c3047e36f872",
  "parent": {
    "type": "page_id",
    "page_id": "59833787-2cf9-4fdf-8782-e53db20768a5"
  },
  "created_time": "2022-07-06T19:52:00.000Z",
  "last_edited_time": "2022-07-06T19:52:00.000Z",
  "created_by": {
    "object": "user",
    "id": "0c3e9826-b8f7-4f73-927d-2caaf86f1103"
  },
  "last_edited_by": {
    "object": "user",
    "id": "ee5f0f84-409a-440f-983a-a5315961c6e4"
  },
  "has_children": false,
  "archived": true,
  "type": "paragraph",
  "paragraph": {
    "rich_text": [],
    "color": "default"
  }
}

最終更新： 2 years ago