Models
Get Started
Integrations
Block
Create Block
POST
/
v1
/
documentation
/
{parent_id}
/
blocks
curl --request POST \
--url http://localhost:8000/api/v1/documentation/{parent_id}/blocks \
--header 'Content-Type: application/json' \
--data '{
"data": [
{
"block_type": "bookmark",
"content": [
{
"annotations": {
"bold": "<string>",
"italic": "<string>",
"strikethrough": "<string>",
"underline": "<string>",
"code": "<string>",
"color": "<string>"
},
"plain_text": "<string>",
"href": "<string>"
}
]
}
]
}'{
"data": {
"block_type": "bookmark",
"id": "<string>",
"parent_id": "<string>",
"content": [
{
"annotations": {
"bold": "<string>",
"italic": "<string>",
"strikethrough": "<string>",
"underline": "<string>",
"code": "<string>",
"color": "<string>"
},
"plain_text": "<string>",
"href": "<string>"
}
]
},
"meta": {}
}Path Parameters
This will be parent id of the block you want to create
Query Parameters
Include raw response. When you want more data from the source
Body
application/json
Type of the block
Available options:
bookmark, breadcrumb, bulleted_list_item, callout, child_database, child_page, column, column_list, divider, embed, equation, file, heading_1, heading_2, heading_3, image, link_preview, link_to_page, numbered_list_item, paragraph, pdf, quote, synced_block, table, table_of_contents, table_row, template, to_do, toggle, unsupported, video Content of the block
Text for the block
Link for the block. Example blocks: Youtube, Bookmarks
Response
201
application/json
Type of the block
Available options:
bookmark, breadcrumb, bulleted_list_item, callout, child_database, child_page, column, column_list, divider, embed, equation, file, heading_1, heading_2, heading_3, image, link_preview, link_to_page, numbered_list_item, paragraph, pdf, quote, synced_block, table, table_of_contents, table_row, template, to_do, toggle, unsupported, video A unique identifier for the block.
Content of the block
The text in the block
All the properties about the text
Id of the parent block
curl --request POST \
--url http://localhost:8000/api/v1/documentation/{parent_id}/blocks \
--header 'Content-Type: application/json' \
--data '{
"data": [
{
"block_type": "bookmark",
"content": [
{
"annotations": {
"bold": "<string>",
"italic": "<string>",
"strikethrough": "<string>",
"underline": "<string>",
"code": "<string>",
"color": "<string>"
},
"plain_text": "<string>",
"href": "<string>"
}
]
}
]
}'{
"data": {
"block_type": "bookmark",
"id": "<string>",
"parent_id": "<string>",
"content": [
{
"annotations": {
"bold": "<string>",
"italic": "<string>",
"strikethrough": "<string>",
"underline": "<string>",
"code": "<string>",
"color": "<string>"
},
"plain_text": "<string>",
"href": "<string>"
}
]
},
"meta": {}
}