Remove NotionBlock

Remove-NotionBlock

SYNOPSIS

Deletes a Notion block from a page.

SYNTAX

ById

Remove-NotionBlock -BlockId <String> [-WhatIf] [-Confirm]
 [<CommonParameters>]

ByObject

Remove-NotionBlock -Block <notion_block> [-WhatIf] [-Confirm]
 [<CommonParameters>]

DESCRIPTION

This function removes a block from a Notion page by using the Notion API. It supports deletion via block ID or a Notion_Block object.

EXAMPLES

EXAMPLE 1

Remove-NotionBlock -BlockId "abc123"
Deletes the specified Notion block.

EXAMPLE 2

$Block = Get-NotionBlock -BlockId "abc123"
Remove-NotionBlock -Block $Block
Deletes the specified Notion block using a Notion_Block object.

PARAMETERS

-Block

A Notion_Block object representing the block to delete.

Type: notion_block
Parameter Sets: ByObject
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-BlockId

The ID of the Notion block to delete.

Type: String
Parameter Sets: ById
Aliases: id

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

Returns a [notion_block] object representing the deleted block.

NOTES

RELATED LINKS

https://developers.notion.com/reference/delete-a-block