(日本語版)Notion API - Public Beta
  1. ブロック
(日本語版)Notion API - Public Beta
  • 概要
  • インテグレーション機能
  • リクエスト制限
  • ステータス コード
  • ブロック
  • ユーザー
  • コメント
  • リンク プレビューのUnfurl属性オブジェクト
  • バージョン変更
    • バージョニング
    • バージョンによる変更
  • ページ
    • ページ
    • ページのプロパティ
  • データベース
    • データベース
    • データベースのプロパティ
  • その他
    • 絵文字オブジェクト
    • ファイルオブジェクト
    • 親オブジェクト
    • リッチテキストオブジェクト
  • エンドポイント
    • 認証
      • 認証
      • Tokenを作成
    • ブロック
      • ブロックを取得
        GET
      • ブロックを更新
        PATCH
      • ブロックの子を取得
        GET
      • ブロックの子を追加
        PATCH
      • ブロックを削除
        DELETE
    • データベース
      • データベース エントリのフィルタ
      • データベース エントリの並べ替え
      • データベースのプロパティを更新する
      • データベースを作成
      • データベースを取得
      • データベースを更新
      • データベースにクエリを実行
    • ユーザー
      • 全てユーザーのリストを取得
      • トークンのボットユーザーを取得
      • ユーザーを取得
    • ページ
      • ページをアーカイブ
      • ページを作成
      • ページを取得
      • ページプロパティアイテムを取得
      • ページプロパティを更新
    • コメント
      • コメントを作成
      • コメントを取得
    • 検索
      • タイトルで検索
  1. ブロック

ブロックを削除

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

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

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

エラー#

ブロックが存在しない場合、または統合がブロックにアクセスできない場合は、404 HTTP 応答を返します。
リクエストがリクエスト制限を超えた場合、400 または 429 HTTP レスポンスを返します。
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request DELETE 'https://api.notion.com/v1/blocks/ ' \
--header 'Notion-Version;'
Response Response Example
{
  "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"
  }
}

Requestパラメータ

Pathパラメータ
block_id
string 
必須
Notionブロックの識別子
Headerパラメータ
Notion-Version
string 
可選

Response

🟢200OK
application/json
Body
object
string 
必須
id
string 
必須
parent
object 
必須
type
string 
必須
page_id
string 
必須
created_time
string 
必須
last_edited_time
string 
必須
created_by
object 
必須
object
string 
必須
id
string 
必須
last_edited_by
object 
必須
object
string 
必須
id
string 
必須
has_children
boolean 
必須
archived
boolean 
必須
type
string 
必須
paragraph
object 
必須
rich_text
array[string]
必須
color
string 
必須
更新日時 2023-04-28 10:38:59
前へ
ブロックの子を追加
次へ
データベース エントリのフィルタ
Built with