Delete block

Deletes block by ID

Parameters

Function DeleteBlock(Val Token, Val BlockID) Export

Parameter	CLI option	Type	Required	Description
Token	--token	String	✔	Token
BlockID	--block	String	✔	Block ID

Returns

Map Of KeyAndValue - serialized JSON response from Notion

Advanced call ?

Parameter	Description
proxy	InternetProxy or a structure with fields Protocol, Host, Port, User, Password, UseOSAuthentication
timeout	Request execution timeout
adv_response	Formats the response as a complete HTTP structure with fields code, body, and headers
retries	Number of HTTP request send attempts on 5** status codes or internal client errors
dontwait	Creates a background job and returns its data (for 1C and OneScript only)

1C:Enterprise/OneScript code example

    Token = "secret_9RsfMrRMqZwqp0Zl0B...";
    Block = "29d82aa7-fc4e-8196-bfa0-e3dd8f77f4ee";

    Result = OPI_Notion.DeleteBlock(Token, Block);

Bash

    oint notion DeleteBlock \
      --token "***" \
      --block "36c82aa7-fc4e-8134-b281-e86e4ee0b96d"

CMD/Bat

    oint notion DeleteBlock ^
      --token "***" ^
      --block "36c82aa7-fc4e-8134-b281-e86e4ee0b96d"

Result

{
 "object": "block",
 "id": "36c82aa7-fc4e-8134-b281-e86e4ee0b96d",
 "parent": {
  "type": "page_id",
  "page_id": "5dd94c34-fab0-4bff-986b-7511c0779f77"
 },
 "created_time": "2026-05-26T14:05:00Z",
 "last_edited_time": "2026-05-26T14:05:00Z",
 "created_by": {
  "object": "user",
  "id": "8b07422e-eeea-40d1-8d5e-c784211825b0"
 },
 "last_edited_by": {
  "object": "user",
  "id": "8b07422e-eeea-40d1-8d5e-c784211825b0"
 },
 "has_children": false,
 "in_trash": true,
 "type": "to_do",
 "to_do": {
  "rich_text": [
   {
    "type": "text",
    "text": {
     "content": "YoYO",
     "link": null
    },
    "annotations": {
     "bold": false,
     "italic": false,
     "strikethrough": false,
     "underline": false,
     "code": false,
     "color": "default"
    },
    "plain_text": "YoYO",
    "href": null
   }
  ],
  "checked": false,
  "color": "default"
 },
 "archived": true,
 "request_id": "2b2584d9-4b4b-4b8f-a54e-f52124cb7b97"
}