Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

next
json 592 lines 20.5 KB
Raw
1 {
2 "slug": "NOTION_DELETE_BLOCK",
3 "name": "Delete a block",
4 "description": "Archives a Notion block, page, or database using its ID, which sets its 'archived' property to true (like moving to \"Trash\" in the UI) and allows it to be restored later. Note: This operation will fail if the block has an archived parent or ancestor in the hierarchy. You must unarchive the ancestor before archiving/deleting its descendants.",
5 "available_versions": ["20260113_00"],
6 "version": "20260113_00",
7 "toolkit": {
8 "slug": "notion",
9 "name": "notion",
10 "logo": "https://logos.composio.dev/api/notion"
11 },
12 "input_parameters": {
13 "description": "Request model for deleting (archiving) a Notion block.",
14 "properties": {
15 "block_id": {
16 "description": "Identifier of the block, page, or database to be deleted (archived). Must be a valid Notion block/page/database ID in UUID format (with or without hyphens). To find page IDs and their titles, consider using an action like `NOTION_FETCH_DATA`.",
17 "examples": ["59833787-2cf9-4fdf-8782-e53db20768a5"],
18 "title": "Block Id",
19 "type": "string"
20 }
21 },
22 "required": ["block_id"],
23 "title": "DeleteBlockRequest",
24 "type": "object"
25 },
26 "output_parameters": {
27 "properties": {
28 "data": {
29 "additionalProperties": true,
30 "description": "Data from the action execution",
31 "properties": {
32 "archived": {
33 "description": "Whether the block is archived (deleted). Set to true after deletion, which moves the block to Trash in the Notion UI.",
34 "title": "Archived",
35 "type": "boolean"
36 },
37 "created_by": {
38 "additionalProperties": false,
39 "description": "User object representing who created the block.",
40 "properties": {
41 "avatar_url": {
42 "anyOf": [
43 {
44 "type": "string"
45 },
46 {
47 "type": "null"
48 }
49 ],
50 "default": null,
51 "description": "URL of the user's chosen avatar image.",
52 "title": "Avatar Url"
53 },
54 "bot": {
55 "anyOf": [
56 {
57 "properties": {
58 "owner": {
59 "anyOf": [
60 {
61 "properties": {
62 "type": {
63 "anyOf": [
64 {
65 "type": "string"
66 },
67 {
68 "type": "null"
69 }
70 ],
71 "default": null,
72 "description": "Either 'workspace' or 'user'.",
73 "title": "Type"
74 }
75 },
76 "title": "BotOwner",
77 "type": "object"
78 },
79 {
80 "type": "null"
81 }
82 ],
83 "default": null,
84 "description": "Owner information for the bot."
85 },
86 "workspace_id": {
87 "anyOf": [
88 {
89 "type": "string"
90 },
91 {
92 "type": "null"
93 }
94 ],
95 "default": null,
96 "description": "ID of the bot's workspace.",
97 "title": "Workspace Id"
98 },
99 "workspace_limits": {
100 "anyOf": [
101 {
102 "properties": {
103 "max_file_upload_size_in_bytes": {
104 "anyOf": [
105 {
106 "type": "integer"
107 },
108 {
109 "type": "null"
110 }
111 ],
112 "default": null,
113 "description": "Maximum file upload size in bytes.",
114 "title": "Max File Upload Size In Bytes"
115 }
116 },
117 "title": "WorkspaceLimits",
118 "type": "object"
119 },
120 {
121 "type": "null"
122 }
123 ],
124 "default": null,
125 "description": "Workspace restrictions for the bot."
126 },
127 "workspace_name": {
128 "anyOf": [
129 {
130 "type": "string"
131 },
132 {
133 "type": "null"
134 }
135 ],
136 "default": null,
137 "description": "Name of the bot's workspace. Null if owner type is 'user'.",
138 "title": "Workspace Name"
139 }
140 },
141 "title": "BotDetails",
142 "type": "object"
143 },
144 {
145 "type": "null"
146 }
147 ],
148 "default": null,
149 "description": "Present when type is 'bot'.",
150 "title": "Bot"
151 },
152 "id": {
153 "description": "Unique identifier for the user in UUID format.",
154 "title": "Id",
155 "type": "string"
156 },
157 "name": {
158 "anyOf": [
159 {
160 "type": "string"
161 },
162 {
163 "type": "null"
164 }
165 ],
166 "default": null,
167 "description": "User's name as displayed in Notion.",
168 "title": "Name"
169 },
170 "object": {
171 "description": "Always 'user'.",
172 "title": "Object",
173 "type": "string"
174 },
175 "person": {
176 "anyOf": [
177 {
178 "properties": {
179 "email": {
180 "anyOf": [
181 {
182 "type": "string"
183 },
184 {
185 "type": "null"
186 }
187 ],
188 "default": null,
189 "description": "Email address. Present only if integration has user capability access.",
190 "title": "Email"
191 }
192 },
193 "title": "PersonDetails",
194 "type": "object"
195 },
196 {
197 "type": "null"
198 }
199 ],
200 "default": null,
201 "description": "Present when type is 'person'.",
202 "title": "Person"
203 },
204 "type": {
205 "anyOf": [
206 {
207 "type": "string"
208 },
209 {
210 "type": "null"
211 }
212 ],
213 "default": null,
214 "description": "Type of user. Either 'person' or 'bot'.",
215 "title": "Type"
216 }
217 },
218 "required": ["object", "id"],
219 "title": "Created By",
220 "type": "object"
221 },
222 "created_time": {
223 "description": "ISO 8601 timestamp of when the block was created.",
224 "title": "Created Time",
225 "type": "string"
226 },
227 "has_children": {
228 "description": "Whether the block has child blocks.",
229 "title": "Has Children",
230 "type": "boolean"
231 },
232 "id": {
233 "description": "Unique identifier for the block in UUIDv4 format.",
234 "title": "Id",
235 "type": "string"
236 },
237 "in_trash": {
238 "description": "Whether the block is in trash (deleted).",
239 "title": "In Trash",
240 "type": "boolean"
241 },
242 "last_edited_by": {
243 "additionalProperties": false,
244 "description": "User object representing who last edited the block.",
245 "properties": {
246 "avatar_url": {
247 "anyOf": [
248 {
249 "type": "string"
250 },
251 {
252 "type": "null"
253 }
254 ],
255 "default": null,
256 "description": "URL of the user's chosen avatar image.",
257 "title": "Avatar Url"
258 },
259 "bot": {
260 "anyOf": [
261 {
262 "properties": {
263 "owner": {
264 "anyOf": [
265 {
266 "properties": {
267 "type": {
268 "anyOf": [
269 {
270 "type": "string"
271 },
272 {
273 "type": "null"
274 }
275 ],
276 "default": null,
277 "description": "Either 'workspace' or 'user'.",
278 "title": "Type"
279 }
280 },
281 "title": "BotOwner",
282 "type": "object"
283 },
284 {
285 "type": "null"
286 }
287 ],
288 "default": null,
289 "description": "Owner information for the bot."
290 },
291 "workspace_id": {
292 "anyOf": [
293 {
294 "type": "string"
295 },
296 {
297 "type": "null"
298 }
299 ],
300 "default": null,
301 "description": "ID of the bot's workspace.",
302 "title": "Workspace Id"
303 },
304 "workspace_limits": {
305 "anyOf": [
306 {
307 "properties": {
308 "max_file_upload_size_in_bytes": {
309 "anyOf": [
310 {
311 "type": "integer"
312 },
313 {
314 "type": "null"
315 }
316 ],
317 "default": null,
318 "description": "Maximum file upload size in bytes.",
319 "title": "Max File Upload Size In Bytes"
320 }
321 },
322 "title": "WorkspaceLimits",
323 "type": "object"
324 },
325 {
326 "type": "null"
327 }
328 ],
329 "default": null,
330 "description": "Workspace restrictions for the bot."
331 },
332 "workspace_name": {
333 "anyOf": [
334 {
335 "type": "string"
336 },
337 {
338 "type": "null"
339 }
340 ],
341 "default": null,
342 "description": "Name of the bot's workspace. Null if owner type is 'user'.",
343 "title": "Workspace Name"
344 }
345 },
346 "title": "BotDetails",
347 "type": "object"
348 },
349 {
350 "type": "null"
351 }
352 ],
353 "default": null,
354 "description": "Present when type is 'bot'.",
355 "title": "Bot"
356 },
357 "id": {
358 "description": "Unique identifier for the user in UUID format.",
359 "title": "Id",
360 "type": "string"
361 },
362 "name": {
363 "anyOf": [
364 {
365 "type": "string"
366 },
367 {
368 "type": "null"
369 }
370 ],
371 "default": null,
372 "description": "User's name as displayed in Notion.",
373 "title": "Name"
374 },
375 "object": {
376 "description": "Always 'user'.",
377 "title": "Object",
378 "type": "string"
379 },
380 "person": {
381 "anyOf": [
382 {
383 "properties": {
384 "email": {
385 "anyOf": [
386 {
387 "type": "string"
388 },
389 {
390 "type": "null"
391 }
392 ],
393 "default": null,
394 "description": "Email address. Present only if integration has user capability access.",
395 "title": "Email"
396 }
397 },
398 "title": "PersonDetails",
399 "type": "object"
400 },
401 {
402 "type": "null"
403 }
404 ],
405 "default": null,
406 "description": "Present when type is 'person'.",
407 "title": "Person"
408 },
409 "type": {
410 "anyOf": [
411 {
412 "type": "string"
413 },
414 {
415 "type": "null"
416 }
417 ],
418 "default": null,
419 "description": "Type of user. Either 'person' or 'bot'.",
420 "title": "Type"
421 }
422 },
423 "required": ["object", "id"],
424 "title": "Last Edited By",
425 "type": "object"
426 },
427 "last_edited_time": {
428 "description": "ISO 8601 timestamp of when the block was last edited.",
429 "title": "Last Edited Time",
430 "type": "string"
431 },
432 "object": {
433 "description": "Always \"block\".",
434 "title": "Object",
435 "type": "string"
436 },
437 "parent": {
438 "anyOf": [
439 {
440 "properties": {
441 "database_id": {
442 "description": "ID of parent database in UUIDv4 format.",
443 "title": "Database Id",
444 "type": "string"
445 },
446 "type": {
447 "const": "database_id",
448 "description": "Type of parent.",
449 "title": "Type",
450 "type": "string"
451 }
452 },
453 "required": ["type", "database_id"],
454 "title": "DatabaseIdParent",
455 "type": "object"
456 },
457 {
458 "properties": {
459 "page_id": {
460 "description": "ID of parent page in UUIDv4 format.",
461 "title": "Page Id",
462 "type": "string"
463 },
464 "type": {
465 "const": "page_id",
466 "description": "Type of parent.",
467 "title": "Type",
468 "type": "string"
469 }
470 },
471 "required": ["type", "page_id"],
472 "title": "PageIdParent",
473 "type": "object"
474 },
475 {
476 "properties": {
477 "block_id": {
478 "description": "ID of parent block in UUIDv4 format.",
479 "title": "Block Id",
480 "type": "string"
481 },
482 "type": {
483 "const": "block_id",
484 "description": "Type of parent.",
485 "title": "Type",
486 "type": "string"
487 }
488 },
489 "required": ["type", "block_id"],
490 "title": "BlockIdParent",
491 "type": "object"
492 },
493 {
494 "properties": {
495 "type": {
496 "const": "workspace",
497 "description": "Type of parent.",
498 "title": "Type",
499 "type": "string"
500 },
501 "workspace": {
502 "description": "Always true when type is 'workspace'.",
503 "title": "Workspace",
504 "type": "boolean"
505 }
506 },
507 "required": ["type", "workspace"],
508 "title": "WorkspaceParent",
509 "type": "object"
510 },
511 {
512 "properties": {
513 "data_source_id": {
514 "description": "ID of parent data source in UUIDv4 format.",
515 "title": "Data Source Id",
516 "type": "string"
517 },
518 "type": {
519 "const": "data_source_id",
520 "description": "Type of parent.",
521 "title": "Type",
522 "type": "string"
523 }
524 },
525 "required": ["type", "data_source_id"],
526 "title": "DataSourceIdParent",
527 "type": "object"
528 }
529 ],
530 "description": "Information about the block's parent container.",
531 "title": "Parent"
532 },
533 "type": {
534 "description": "Type of block (e.g., 'paragraph', 'heading_1', 'heading_2', 'heading_3', 'bulleted_list_item', 'numbered_list_item', 'to_do', etc.).",
535 "title": "Type",
536 "type": "string"
537 }
538 },
539 "required": [
540 "object",
541 "id",
542 "parent",
543 "type",
544 "created_time",
545 "created_by",
546 "last_edited_time",
547 "last_edited_by",
548 "archived",
549 "in_trash",
550 "has_children"
551 ],
552 "title": "Data",
553 "type": "object"
554 },
555 "error": {
556 "anyOf": [
557 {
558 "type": "string"
559 },
560 {
561 "type": "null"
562 }
563 ],
564 "default": null,
565 "description": "Error if any occurred during the execution of the action",
566 "title": "Error"
567 },
568 "successful": {
569 "description": "Whether or not the action execution was successful or not",
570 "title": "Successful",
571 "type": "boolean"
572 }
573 },
574 "required": ["data", "successful"],
575 "title": "DeleteBlockResponseWrapper",
576 "type": "object"
577 },
578 "scopes": ["Read content", "Update content", "Insert content"],
579 "tags": ["destructiveHint", "important", "openWorldHint"],
580 "no_auth": false,
581 "status": "active",
582 "is_deprecated": false,
583 "deprecated": {
584 "displayName": "Delete a block",
585 "version": "20260113_00",
586 "available_versions": ["20260113_00"],
587 "is_deprecated": false,
588 "toolkit": {
589 "logo": "https://logos.composio.dev/api/notion"
590 }
591 }
592 }