{ "openapi": "3.0.3", "servers": [ { "url": "https://api.notion.com" } ], "info": { "x-ballerina-display": { "label": "Notion", "iconPath": "icon.png" }, "contact": {}, "description": "This is a generated connector for [Notion API v1](https://developers.notion.com/reference/intro) OpenAPI Specification. \nNotion API provides capability to access all-in-one workspace where you can write, plan, collaborate and get organized. it has components such as notes, databases, kanban boards, wikis, calendars, and reminders. You can connect these components to take notes, add tasks, manage projects & more. Notion provides the building blocks and you can create your own layouts and toolkit to get work done. This ballerina connector allows you to connect Notion through its [REST API](https://developers.notion.com/docs).", "title": "Notion API - Public Beta", "version": "1.0.0", "x-apisguru-categories": [ "collaboration" ], "x-logo": { "url": "https://notion.com/front-static/logo-ios.png" }, "x-origin": [ { "format": "postman", "url": "https://www.postman.com/collections/15568543-d990f9b7-98d3-47d3-9131-4866ab9c6df2", "version": "2.x" } ], "x-providerName": "notion.com", "x-ballerina-init-description": "The connector initialization requires setting the API credentials. \nCreate a [Notion account](https://www.notion.so/) and obtain tokens following [this guide](https://developers.notion.com/docs/authorization)." }, "tags": [ { "name": "Users" }, { "name": "Databases" }, { "name": "Pages" }, { "name": "Blocks" }, { "name": "Search" } ], "paths": { "/v1/blocks/{id}/children": { "get": { "description": "Retrieve block children", "operationId": "retrieveBlockChildren", "parameters": [ { "in": "query", "name": "page_size", "description": "Page size", "schema": { "example": "100", "type": "string" } }, { "in": "header", "name": "Notion-Version", "description": "API Version", "schema": { "example": "", "type": "string", "default": "2021-05-13" } } ], "responses": { "200": { "content": { "application/json": { "examples": { "200 Success - Retrieve block children": { "value": { "has_more": false, "next_cursor": null, "object": "list", "results": [ { "created_time": "2021-04-27T20:38:19.437Z", "has_children": false, "id": "48c1ffb5-2789-4025-937b-2c35eaaaab3f", "last_edited_time": "2021-04-27T20:38:19.437Z", "object": "block", "type": "unsupported", "unsupported": {} }, { "created_time": "2021-04-27T20:38:19.437Z", "has_children": false, "id": "e381a0a3-4efb-4ba9-aa93-45b70fa9ce7f", "last_edited_time": "2021-04-27T20:38:19.437Z", "object": "block", "paragraph": { "text": [ { "annotations": { "bold": false, "code": false, "color": "default", "italic": false, "strikethrough": false, "underline": false }, "href": null, "plain_text": "I think we can all agree that Silicon Valley needs more adult supervision right about now.", "text": { "content": "I think we can all agree that Silicon Valley needs more adult supervision right about now.", "link": null }, "type": "text" } ] }, "type": "paragraph" }, { "created_time": "2021-04-27T20:38:19.437Z", "has_children": false, "id": "ce5f79ac-8145-44ab-be3b-8ad143d6f8a7", "last_edited_time": "2021-04-27T20:38:19.437Z", "object": "block", "paragraph": { "text": [ { "annotations": { "bold": false, "code": false, "color": "default", "italic": false, "strikethrough": false, "underline": false }, "href": null, "plain_text": "Is the solution for its companies to hire a chief ethics officer?", "text": { "content": "Is the solution for its companies to hire a chief ethics officer?", "link": null }, "type": "text" } ] }, "type": "paragraph" }, { "created_time": "2021-04-27T20:38:19.437Z", "has_children": false, "id": "0387b374-7847-4ddc-bc53-6b0813ce4ed4", "last_edited_time": "2021-04-27T20:38:19.437Z", "object": "block", "paragraph": { "text": [ { "annotations": { "bold": false, "code": false, "color": "default", "italic": false, "strikethrough": false, "underline": false }, "href": null, "plain_text": "While some tech companies like Google have top compliance officers and others turn to legal teams to police themselves, no big tech companies that I know of have yet taken this step. But a lot of them seem to be talking about it, and I’ve discussed the idea with several chief executives recently. Why? Because slowly, then all at once, it feels like too many digital leaders have lost their minds.", "text": { "content": "While some tech companies like Google have top compliance officers and others turn to legal teams to police themselves, no big tech companies that I know of have yet taken this step. But a lot of them seem to be talking about it, and I’ve discussed the idea with several chief executives recently. Why? Because slowly, then all at once, it feels like too many digital leaders have lost their minds.", "link": null }, "type": "text" } ] }, "type": "paragraph" }, { "created_time": "2021-04-27T20:38:19.437Z", "has_children": false, "id": "da035311-5af3-48bc-8279-d28d9f4ef2e2", "last_edited_time": "2021-04-27T20:38:19.437Z", "object": "block", "paragraph": { "text": [ { "annotations": { "bold": false, "code": false, "color": "default", "italic": false, "strikethrough": false, "underline": false }, "href": null, "plain_text": "It’s probably no surprise, considering the complex problems the tech industry faces. As one ethical quandary after another has hit its profoundly ill-prepared executives, their once-pristine reputations have fallen like palm trees in a hurricane. These last two weeks alone show how tech is stumbling to react to big world issues armed with only bubble world skills:", "text": { "content": "It’s probably no surprise, considering the complex problems the tech industry faces. As one ethical quandary after another has hit its profoundly ill-prepared executives, their once-pristine reputations have fallen like palm trees in a hurricane. These last two weeks alone show how tech is stumbling to react to big world issues armed with only bubble world skills:", "link": null }, "type": "text" } ] }, "type": "paragraph" }, { "created_time": "2021-04-27T20:38:19.437Z", "has_children": false, "id": "63a60fca-4a11-43eb-8773-c5f0164a3117", "last_edited_time": "2021-04-27T20:38:19.437Z", "object": "block", "paragraph": { "text": [ { "annotations": { "bold": false, "code": false, "color": "default", "italic": false, "strikethrough": false, "underline": false }, "href": null, "plain_text": "As a journalist is beheaded and dismembered at the direction of Saudi Arabian leaders (allegedly, but the killers did bring a bone saw), Silicon Valley is swimming in oceans of money from the kingdom’s Public Investment Fund. Saudi funding includes hundreds of millions for Magic Leap, and huge investments in hot public companies like Tesla. Most significantly: Saudis have invested about $45 billion in SoftBank’s giant Vision Fund, which has in turn doused the tech landscape — $4.4 billion to WeWork, $250 million to Slack, and $300 million to the dog-walking app Wag. In total Uber has gotten almost $14 billion, either through direct investments from the Public Investment Fund or through the Saudis’ funding of the Vision Fund. A billion here, a billion there and it all adds up.", "text": { "content": "As a journalist is beheaded and dismembered at the direction of Saudi Arabian leaders (allegedly, but the killers did bring a bone saw), Silicon Valley is swimming in oceans of money from the kingdom’s Public Investment Fund. Saudi funding includes hundreds of millions for Magic Leap, and huge investments in hot public companies like Tesla. Most significantly: Saudis have invested about $45 billion in SoftBank’s giant Vision Fund, which has in turn doused the tech landscape — $4.4 billion to WeWork, $250 million to Slack, and $300 million to the dog-walking app Wag. In total Uber has gotten almost $14 billion, either through direct investments from the Public Investment Fund or through the Saudis’ funding of the Vision Fund. A billion here, a billion there and it all adds up.", "link": null }, "type": "text" } ] }, "type": "paragraph" }, { "created_time": "2021-04-27T20:38:19.437Z", "has_children": false, "id": "8c58c8f1-86ae-4a14-b6b9-74f5fa579620", "last_edited_time": "2021-04-27T20:38:19.437Z", "object": "block", "paragraph": { "text": [ { "annotations": { "bold": false, "code": false, "color": "default", "italic": false, "strikethrough": false, "underline": false }, "href": null, "plain_text": "[", "text": { "content": "[", "link": null }, "type": "text" }, { "annotations": { "bold": false, "code": false, "color": "default", "italic": true, "strikethrough": false, "underline": false }, "href": null, "plain_text": "Kara Swisher answered your questions about her column ", "text": { "content": "Kara Swisher answered your questions about her column ", "link": null }, "type": "text" }, { "annotations": { "bold": false, "code": false, "color": "default", "italic": true, "strikethrough": false, "underline": false }, "href": "https://twitter.com/karaswisher/status/1054842303922298880", "plain_text": "on Twitter", "text": { "content": "on Twitter", "link": { "url": "https://twitter.com/karaswisher/status/1054842303922298880" } }, "type": "text" }, { "annotations": { "bold": false, "code": false, "color": "default", "italic": true, "strikethrough": false, "underline": false }, "href": null, "plain_text": ".", "text": { "content": ".", "link": null }, "type": "text" }, { "annotations": { "bold": false, "code": false, "color": "default", "italic": false, "strikethrough": false, "underline": false }, "href": null, "plain_text": "]", "text": { "content": "]", "link": null }, "type": "text" } ] }, "type": "paragraph" }, { "created_time": "2021-04-27T20:38:19.437Z", "has_children": false, "id": "875d3aff-086b-45da-9ed1-bc3ddb185229", "last_edited_time": "2021-04-27T20:38:19.437Z", "object": "block", "paragraph": { "text": [ { "annotations": { "bold": false, "code": false, "color": "default", "italic": false, "strikethrough": false, "underline": false }, "href": null, "plain_text": "Facebook introduced a new home video device called Portal, and promised that what could be seen as a surveillance tool would not share data for the sake of ad targeting. Soon after, as ", "text": { "content": "Facebook introduced a new home video device called Portal, and promised that what could be seen as a surveillance tool would not share data for the sake of ad targeting. Soon after, as ", "link": null }, "type": "text" }, { "annotations": { "bold": false, "code": false, "color": "default", "italic": false, "strikethrough": false, "underline": false }, "href": "https://www.recode.net/2018/10/16/17966102/facebook-portal-ad-targeting-data-collection", "plain_text": "reported by Recode", "text": { "content": "reported by Recode", "link": { "url": "https://www.recode.net/2018/10/16/17966102/facebook-portal-ad-targeting-data-collection" } }, "type": "text" }, { "annotations": { "bold": false, "code": false, "color": "default", "italic": false, "strikethrough": false, "underline": false }, "href": null, "plain_text": ", Facebook admitted that “data about who you call and data about which apps you use on Portal ", "text": { "content": ", Facebook admitted that “data about who you call and data about which apps you use on Portal ", "link": null }, "type": "text" }, { "annotations": { "bold": false, "code": false, "color": "default", "italic": true, "strikethrough": false, "underline": false }, "href": null, "plain_text": "can", "text": { "content": "can", "link": null }, "type": "text" }, { "annotations": { "bold": false, "code": false, "color": "default", "italic": false, "strikethrough": false, "underline": false }, "href": null, "plain_text": " be used to target you with ads on other Facebook-owned properties.” Oh. Um. That’s awkward.", "text": { "content": " be used to target you with ads on other Facebook-owned properties.” Oh. Um. That’s awkward.", "link": null }, "type": "text" } ] }, "type": "paragraph" }, { "created_time": "2021-04-27T20:38:19.437Z", "has_children": false, "id": "306ab0fb-6daa-4c5b-b1f7-f51a5f92b6ff", "last_edited_time": "2021-04-27T20:38:19.437Z", "object": "block", "paragraph": { "text": [ { "annotations": { "bold": false, "code": false, "color": "default", "italic": false, "strikethrough": false, "underline": false }, "href": null, "plain_text": "After agreeing to pay $20 million to the Securities and Exchange Commission for an ill-advised tweet about possible funding (from the Saudis, by the way), the Tesla co-founder Elon Musk proceeded to troll the regulatory agency on, you got it, Twitter. And even though the ", "text": { "content": "After agreeing to pay $20 million to the Securities and Exchange Commission for an ill-advised tweet about possible funding (from the Saudis, by the way), the Tesla co-founder Elon Musk proceeded to troll the regulatory agency on, you got it, Twitter. And even though the ", "link": null }, "type": "text" }, { "annotations": { "bold": false, "code": false, "color": "default", "italic": false, "strikethrough": false, "underline": false }, "href": "https://www.sec.gov/news/press-release/2018-226", "plain_text": "settlement called for some kind of control of his communications", "text": { "content": "settlement called for some kind of control of his communications", "link": { "url": "https://www.sec.gov/news/press-release/2018-226" } }, "type": "text" }, { "annotations": { "bold": false, "code": false, "color": "default", "italic": false, "strikethrough": false, "underline": false }, "href": null, "plain_text": ", it appears that Mr. Musk will continue tweeting until someone steals his phone.", "text": { "content": ", it appears that Mr. Musk will continue tweeting until someone steals his phone.", "link": null }, "type": "text" } ] }, "type": "paragraph" }, { "created_time": "2021-04-27T20:38:19.437Z", "has_children": false, "id": "122b1457-4129-4513-abaa-7cce7d66e4a1", "last_edited_time": "2021-04-27T20:38:19.437Z", "object": "block", "paragraph": { "text": [ { "annotations": { "bold": false, "code": false, "color": "default", "italic": false, "strikethrough": false, "underline": false }, "href": null, "plain_text": "Finally, Google took six months to make public that user data on its social network, Google Plus, ", "text": { "content": "Finally, Google took six months to make public that user data on its social network, Google Plus, ", "link": null }, "type": "text" }, { "annotations": { "bold": false, "code": false, "color": "default", "italic": false, "strikethrough": false, "underline": false }, "href": "https://www.nytimes.com/2018/10/08/technology/google-plus-security-disclosure.html?module=inline", "plain_text": "had been exposed", "text": { "content": "had been exposed", "link": { "url": "https://www.nytimes.com/2018/10/08/technology/google-plus-security-disclosure.html?module=inline" } }, "type": "text" }, { "annotations": { "bold": false, "code": false, "color": "default", "italic": false, "strikethrough": false, "underline": false }, "href": null, "plain_text": " and that profiles of up to 500,000 users may have been compromised. While the service failed long ago, because it was pretty much designed by antisocial people, this lack of concern for privacy was profound.", "text": { "content": " and that profiles of up to 500,000 users may have been compromised. While the service failed long ago, because it was pretty much designed by antisocial people, this lack of concern for privacy was profound.", "link": null }, "type": "text" } ] }, "type": "paragraph" }, { "created_time": "2021-04-27T20:38:19.437Z", "has_children": false, "id": "4d4af599-556f-4d8b-af8e-4d01ebe2aa27", "last_edited_time": "2021-04-27T20:38:19.437Z", "object": "block", "paragraph": { "text": [ { "annotations": { "bold": false, "code": false, "color": "default", "italic": false, "strikethrough": false, "underline": false }, "href": null, "plain_text": "Grappling with what to say and do about the disasters they themselves create is only the beginning. Then there are the broader issues that the denizens of Silicon Valley expect their employers to have a stance on: immigration, income inequality, artificial intelligence, automation, transgender rights, climate change, privacy, data rights and whether tech companies should be helping the government do controversial things. It’s an ethical swamp out there.", "text": { "content": "Grappling with what to say and do about the disasters they themselves create is only the beginning. Then there are the broader issues that the denizens of Silicon Valley expect their employers to have a stance on: immigration, income inequality, artificial intelligence, automation, transgender rights, climate change, privacy, data rights and whether tech companies should be helping the government do controversial things. It’s an ethical swamp out there.", "link": null }, "type": "text" } ] }, "type": "paragraph" }, { "created_time": "2021-04-27T20:38:19.437Z", "has_children": false, "id": "f5775df5-59eb-4533-a2cb-e150412ec4f6", "last_edited_time": "2021-04-27T20:38:19.437Z", "object": "block", "paragraph": { "text": [ { "annotations": { "bold": false, "code": false, "color": "default", "italic": false, "strikethrough": false, "underline": false }, "href": null, "plain_text": "That’s why, in a recent interview, Marc Benioff, the co-chief executive and a founder of Salesforce, told me he was in the process of hiring a chief ethical officer to help anticipate and address any thorny conundrums it might encounter as a business — like the decision it had to make a few months back about whether it should stop providing recruitment software for Customs and Border Protection because of the government’s policy of separating immigrant families at the border.", "text": { "content": "That’s why, in a recent interview, Marc Benioff, the co-chief executive and a founder of Salesforce, told me he was in the process of hiring a chief ethical officer to help anticipate and address any thorny conundrums it might encounter as a business — like the decision it had to make a few months back about whether it should stop providing recruitment software for Customs and Border Protection because of the government’s policy of separating immigrant families at the border.", "link": null }, "type": "text" } ] }, "type": "paragraph" }, { "created_time": "2021-04-27T20:38:19.437Z", "has_children": false, "id": "31405c6e-7ece-4667-8c4d-36c9d79a0bfa", "last_edited_time": "2021-04-27T20:38:19.437Z", "object": "block", "paragraph": { "text": [ { "annotations": { "bold": false, "code": false, "color": "default", "italic": false, "strikethrough": false, "underline": false }, "href": null, "plain_text": "Amid much criticism, Mr. Benioff decided to keep the contract, but said he would focus more on social and political issues.", "text": { "content": "Amid much criticism, Mr. Benioff decided to keep the contract, but said he would focus more on social and political issues.", "link": null }, "type": "text" } ] }, "type": "paragraph" }, { "created_time": "2021-04-27T20:38:19.437Z", "has_children": false, "id": "a2ab7e8a-d521-401d-89ae-9eb27efb9990", "last_edited_time": "2021-04-27T20:38:19.437Z", "object": "block", "paragraph": { "text": [ { "annotations": { "bold": false, "code": false, "color": "default", "italic": false, "strikethrough": false, "underline": false }, "href": null, "plain_text": "At a recent company event, he elaborated: “We can have a structured conversation not just with our own employees myopically, but by bringing in the key advisers, supporters and pundits and philosophers and everybody necessary to ask the question if what we are doing today is ethical and humane.”", "text": { "content": "At a recent company event, he elaborated: “We can have a structured conversation not just with our own employees myopically, but by bringing in the key advisers, supporters and pundits and philosophers and everybody necessary to ask the question if what we are doing today is ethical and humane.”", "link": null }, "type": "text" } ] }, "type": "paragraph" }, { "created_time": "2021-04-27T20:38:19.437Z", "has_children": false, "id": "a4498e1e-8b85-48d7-802a-db447ca7d1ac", "last_edited_time": "2021-04-27T20:38:19.437Z", "object": "block", "paragraph": { "text": [ { "annotations": { "bold": false, "code": false, "color": "default", "italic": false, "strikethrough": false, "underline": false }, "href": null, "plain_text": "23andMe has also toyed with the idea of hiring a chief ethics officer. In an interview I did this week with its chief executive, Anne Wojcicki, she said the genetics company had even interviewed candidates, but that many of them wanted to remain in academia to be freer to ponder these issues. She acknowledged that the collection of DNA data is rife with ethical considerations, but said, “I think it has to be our management and leaders who have to add this to our skill set, rather than just hire one person to determine this.”", "text": { "content": "23andMe has also toyed with the idea of hiring a chief ethics officer. In an interview I did this week with its chief executive, Anne Wojcicki, she said the genetics company had even interviewed candidates, but that many of them wanted to remain in academia to be freer to ponder these issues. She acknowledged that the collection of DNA data is rife with ethical considerations, but said, “I think it has to be our management and leaders who have to add this to our skill set, rather than just hire one person to determine this.”", "link": null }, "type": "text" } ] }, "type": "paragraph" }, { "created_time": "2021-04-27T20:38:19.437Z", "has_children": false, "id": "cbf7e7e0-5552-4b3f-b09e-9dcca120931c", "last_edited_time": "2021-04-27T20:38:19.437Z", "object": "block", "paragraph": { "text": [ { "annotations": { "bold": false, "code": false, "color": "default", "italic": false, "strikethrough": false, "underline": false }, "href": null, "plain_text": "When asked about the idea of a single source of wisdom on ethics, some point out that legal or diversity/inclusion departments are designed for that purpose and that the ethics should really come from the top — the chief executive.", "text": { "content": "When asked about the idea of a single source of wisdom on ethics, some point out that legal or diversity/inclusion departments are designed for that purpose and that the ethics should really come from the top — the chief executive.", "link": null }, "type": "text" } ] }, "type": "paragraph" }, { "created_time": "2021-04-27T20:38:19.437Z", "has_children": false, "id": "d24b2887-0f1f-4e91-99c1-c295bed8ad65", "last_edited_time": "2021-04-27T20:38:19.437Z", "object": "block", "paragraph": { "text": [ { "annotations": { "bold": false, "code": false, "color": "default", "italic": false, "strikethrough": false, "underline": false }, "href": null, "plain_text": "Also of concern is the possibility that a single person would not get listened to or, worse, get steamrollered. And, if the person was bad at the job, of course, it could drag the whole thing down.", "text": { "content": "Also of concern is the possibility that a single person would not get listened to or, worse, get steamrollered. And, if the person was bad at the job, of course, it could drag the whole thing down.", "link": null }, "type": "text" } ] }, "type": "paragraph" }, { "created_time": "2021-04-27T20:38:19.437Z", "has_children": false, "id": "78c55f65-c8b8-4364-a369-c40699968e90", "last_edited_time": "2021-04-27T20:38:19.437Z", "object": "block", "paragraph": { "text": [ { "annotations": { "bold": false, "code": false, "color": "default", "italic": false, "strikethrough": false, "underline": false }, "href": null, "plain_text": "Others are more worried that the move would be nothing but window dressing. One consultant who focuses on ethics, but did not want to be named, told me: “We haven’t even defined ethics, so what even is ethical use, especially for Silicon Valley companies that are babies in this game?”", "text": { "content": "Others are more worried that the move would be nothing but window dressing. One consultant who focuses on ethics, but did not want to be named, told me: “We haven’t even defined ethics, so what even is ethical use, especially for Silicon Valley companies that are babies in this game?”", "link": null }, "type": "text" } ] }, "type": "paragraph" }, { "created_time": "2021-04-27T20:38:19.437Z", "has_children": false, "id": "0b492111-1586-4a73-8848-04f0c391aadc", "last_edited_time": "2021-04-27T20:38:19.437Z", "object": "block", "paragraph": { "text": [ { "annotations": { "bold": false, "code": false, "color": "default", "italic": false, "strikethrough": false, "underline": false }, "href": null, "plain_text": "How can an industry that, unlike other business sectors, persistently promotes itself as doing good, learn to do that in reality? Do you want to not do harm, or do you want to do good? These are two totally different things.", "text": { "content": "How can an industry that, unlike other business sectors, persistently promotes itself as doing good, learn to do that in reality? Do you want to not do harm, or do you want to do good? These are two totally different things.", "link": null }, "type": "text" } ] }, "type": "paragraph" }, { "created_time": "2021-04-27T20:38:19.437Z", "has_children": false, "id": "302f8229-2404-460b-8c3c-e7058b4365e5", "last_edited_time": "2021-04-27T20:38:19.437Z", "object": "block", "paragraph": { "text": [ { "annotations": { "bold": false, "code": false, "color": "default", "italic": false, "strikethrough": false, "underline": false }, "href": null, "plain_text": "And how do you put an official ethical system in place without it seeming like you’re telling everyone how to behave? Who gets to decide those rules anyway, setting a moral path for the industry and — considering tech companies’ enormous power — the world.", "text": { "content": "And how do you put an official ethical system in place without it seeming like you’re telling everyone how to behave? Who gets to decide those rules anyway, setting a moral path for the industry and — considering tech companies’ enormous power — the world.", "link": null }, "type": "text" } ] }, "type": "paragraph" }, { "created_time": "2021-04-27T20:38:19.437Z", "has_children": false, "id": "8f9bc91c-5662-4b3f-a110-809f46b79f49", "last_edited_time": "2021-04-27T20:38:19.437Z", "object": "block", "paragraph": { "text": [ { "annotations": { "bold": false, "code": false, "color": "default", "italic": false, "strikethrough": false, "underline": false }, "href": null, "plain_text": "Like I said, adult supervision. Or maybe, better still, Silicon Valley itself has to grow up.", "text": { "content": "Like I said, adult supervision. Or maybe, better still, Silicon Valley itself has to grow up.", "link": null }, "type": "text" } ] }, "type": "paragraph" }, { "created_time": "2021-04-27T20:38:19.437Z", "has_children": false, "id": "7bea1831-a25c-4b3e-8c9b-b37de814f948", "last_edited_time": "2021-04-27T20:38:19.437Z", "object": "block", "paragraph": { "text": [ { "annotations": { "bold": false, "code": false, "color": "default", "italic": true, "strikethrough": false, "underline": false }, "href": null, "plain_text": "Follow The New York Times Opinion section on ", "text": { "content": "Follow The New York Times Opinion section on ", "link": null }, "type": "text" }, { "annotations": { "bold": false, "code": false, "color": "default", "italic": true, "strikethrough": false, "underline": false }, "href": "https://www.facebook.com/nytopinion", "plain_text": "Facebook", "text": { "content": "Facebook", "link": { "url": "https://www.facebook.com/nytopinion" } }, "type": "text" }, { "annotations": { "bold": false, "code": false, "color": "default", "italic": true, "strikethrough": false, "underline": false }, "href": null, "plain_text": ", ", "text": { "content": ", ", "link": null }, "type": "text" }, { "annotations": { "bold": false, "code": false, "color": "default", "italic": true, "strikethrough": false, "underline": false }, "href": "http://twitter.com/NYTOpinion", "plain_text": "Twitter (@NYTopinion)", "text": { "content": "Twitter (@NYTopinion)", "link": { "url": "http://twitter.com/NYTOpinion" } }, "type": "text" }, { "annotations": { "bold": false, "code": false, "color": "default", "italic": true, "strikethrough": false, "underline": false }, "href": null, "plain_text": " and ", "text": { "content": " and ", "link": null }, "type": "text" }, { "annotations": { "bold": false, "code": false, "color": "default", "italic": true, "strikethrough": false, "underline": false }, "href": "https://www.instagram.com/nytopinion/", "plain_text": "Instagram", "text": { "content": "Instagram", "link": { "url": "https://www.instagram.com/nytopinion/" } }, "type": "text" }, { "annotations": { "bold": false, "code": false, "color": "default", "italic": true, "strikethrough": false, "underline": false }, "href": null, "plain_text": ", and sign up for the ", "text": { "content": ", and sign up for the ", "link": null }, "type": "text" }, { "annotations": { "bold": false, "code": false, "color": "default", "italic": true, "strikethrough": false, "underline": false }, "href": "http://www.nytimes.com/newsletters/opiniontoday/", "plain_text": "Opinion Today newsletter", "text": { "content": "Opinion Today newsletter", "link": { "url": "http://www.nytimes.com/newsletters/opiniontoday/" } }, "type": "text" }, { "annotations": { "bold": false, "code": false, "color": "default", "italic": true, "strikethrough": false, "underline": false }, "href": null, "plain_text": ".", "text": { "content": ".", "link": null }, "type": "text" } ] }, "type": "paragraph" } ] } } }, "schema": { "$ref": "#/components/schemas/BlockChildrenResponse" } } }, "description": "200 Success - Retrieve block children", "headers": { "CF-Cache-Status": { "schema": { "example": "DYNAMIC", "type": "string" } }, "CF-RAY": { "schema": { "example": "647435237cce6dc4-SJC", "type": "string" } }, "Connection": { "schema": { "example": "keep-alive", "type": "string" } }, "Content-Encoding": { "schema": { "example": "gzip", "type": "string" } }, "Content-Security-Policy": { "schema": { "example": "script-src 'self' 'unsafe-inline' 'unsafe-eval' https://gist.github.com https://apis.google.com https://api.amplitude.com https://widget.intercom.io https://js.intercomcdn.com https://logs-01.loggly.com https://cdn.segment.com https://analytics.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com/v3 https://embed.typeform.com https://admin.typeform.com https://platform.twitter.com https://cdn.syndication.twimg.com https://www.googletagmanager.com https://x.clearbitjs.com; connect-src 'self' https://msgstore.www.notion.so wss://msgstore.www.notion.so ws://localhost:* https://notion-emojis.s3-us-west-2.amazonaws.com https://s3-us-west-2.amazonaws.com https://s3.us-west-2.amazonaws.com https://notion-production-snapshots-2.s3.us-west-2.amazonaws.com https: http: https://api.amplitude.com https://api.embed.ly https://js.intercomcdn.com https://api-iam.intercom.io wss://nexus-websocket-a.intercom.io https://logs-01.loggly.com https://api.segment.io https://api.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com/v3 https://cdn.contentful.com https://preview.contentful.com https://images.ctfassets.net https://api.unsplash.com https://boards-api.greenhouse.io; font-src 'self' data: https://cdnjs.cloudflare.com https://js.intercomcdn.com; img-src 'self' data: blob: https: https://platform.twitter.com https://syndication.twitter.com https://pbs.twimg.com https://ton.twimg.com www.googletagmanager.com; style-src 'self' 'unsafe-inline' https://cdnjs.cloudflare.com https://github.githubassets.com https://platform.twitter.com https://ton.twimg.com; frame-src https: http:; media-src https: http:", "type": "string" } }, "Date": { "schema": { "example": "Wed, 28 Apr 2021 23:53:00 GMT", "type": "string" } }, "ETag": { "schema": { "example": "W/\"65f3-d0AArGizyGsk597xfjWN7976xCc\"", "type": "string" } }, "Expect-CT": { "schema": { "example": "max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\"", "type": "string" } }, "Referrer-Policy": { "schema": { "example": "same-origin", "type": "string" } }, "Server": { "schema": { "example": "cloudflare", "type": "string" } }, "Set-Cookie": { "schema": { "example": "notion_browser_id=a1b1f1dd-7731-4a2b-b968-10b475e3b526; Domain=www.notion.so; Path=/; Expires=Sun, 05 Jan 2053 01:39:40 GMT; Secure", "type": "string" } }, "Strict-Transport-Security": { "schema": { "example": "max-age=5184000; includeSubDomains", "type": "string" } }, "Transfer-Encoding": { "schema": { "example": "chunked", "type": "string" } }, "Vary": { "schema": { "example": "Accept-Encoding", "type": "string" } }, "X-Content-Security-Policy": { "schema": { "example": "script-src 'self' 'unsafe-inline' 'unsafe-eval' https://gist.github.com https://apis.google.com https://api.amplitude.com https://widget.intercom.io https://js.intercomcdn.com https://logs-01.loggly.com https://cdn.segment.com https://analytics.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com/v3 https://embed.typeform.com https://admin.typeform.com https://platform.twitter.com https://cdn.syndication.twimg.com https://www.googletagmanager.com https://x.clearbitjs.com; connect-src 'self' https://msgstore.www.notion.so wss://msgstore.www.notion.so ws://localhost:* https://notion-emojis.s3-us-west-2.amazonaws.com https://s3-us-west-2.amazonaws.com https://s3.us-west-2.amazonaws.com https://notion-production-snapshots-2.s3.us-west-2.amazonaws.com https: http: https://api.amplitude.com https://api.embed.ly https://js.intercomcdn.com https://api-iam.intercom.io wss://nexus-websocket-a.intercom.io https://logs-01.loggly.com https://api.segment.io https://api.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com/v3 https://cdn.contentful.com https://preview.contentful.com https://images.ctfassets.net https://api.unsplash.com https://boards-api.greenhouse.io; font-src 'self' data: https://cdnjs.cloudflare.com https://js.intercomcdn.com; img-src 'self' data: blob: https: https://platform.twitter.com https://syndication.twitter.com https://pbs.twimg.com https://ton.twimg.com www.googletagmanager.com; style-src 'self' 'unsafe-inline' https://cdnjs.cloudflare.com https://github.githubassets.com https://platform.twitter.com https://ton.twimg.com; frame-src https: http:; media-src https: http:", "type": "string" } }, "X-Content-Type-Options": { "schema": { "example": "nosniff", "type": "string" } }, "X-DNS-Prefetch-Control": { "schema": { "example": "off", "type": "string" } }, "X-Download-Options": { "schema": { "example": "noopen", "type": "string" } }, "X-Frame-Options": { "schema": { "example": "SAMEORIGIN", "type": "string" } }, "X-WebKit-CSP": { "schema": { "example": "script-src 'self' 'unsafe-inline' 'unsafe-eval' https://gist.github.com https://apis.google.com https://api.amplitude.com https://widget.intercom.io https://js.intercomcdn.com https://logs-01.loggly.com https://cdn.segment.com https://analytics.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com/v3 https://embed.typeform.com https://admin.typeform.com https://platform.twitter.com https://cdn.syndication.twimg.com https://www.googletagmanager.com https://x.clearbitjs.com; connect-src 'self' https://msgstore.www.notion.so wss://msgstore.www.notion.so ws://localhost:* https://notion-emojis.s3-us-west-2.amazonaws.com https://s3-us-west-2.amazonaws.com https://s3.us-west-2.amazonaws.com https://notion-production-snapshots-2.s3.us-west-2.amazonaws.com https: http: https://api.amplitude.com https://api.embed.ly https://js.intercomcdn.com https://api-iam.intercom.io wss://nexus-websocket-a.intercom.io https://logs-01.loggly.com https://api.segment.io https://api.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com/v3 https://cdn.contentful.com https://preview.contentful.com https://images.ctfassets.net https://api.unsplash.com https://boards-api.greenhouse.io; font-src 'self' data: https://cdnjs.cloudflare.com https://js.intercomcdn.com; img-src 'self' data: blob: https: https://platform.twitter.com https://syndication.twitter.com https://pbs.twimg.com https://ton.twimg.com www.googletagmanager.com; style-src 'self' 'unsafe-inline' https://cdnjs.cloudflare.com https://github.githubassets.com https://platform.twitter.com https://ton.twimg.com; frame-src https: http:; media-src https: http:", "type": "string" } }, "X-XSS-Protection": { "schema": { "example": "1; mode=block", "type": "string" } }, "cf-request-id": { "schema": { "example": "09bc7f8a2a00006dc41a11e000000001", "type": "string" } } } } }, "summary": "Retrieve block children", "tags": [ "Blocks" ] }, "parameters": [ { "in": "path", "name": "id", "description": "block children ID", "required": true, "schema": { "example": "{{PAGE_ID}}", "type": "string" } }, { "in": "header", "name": "Notion-Version", "description": "API Version", "schema": { "example": "", "type": "string", "default": "2021-05-13" } } ], "patch": { "description": "Append block children", "operationId": "appendBlockChildren", "requestBody": { "content": { "application/json": { "example": { "children": [ { "heading_2": { "text": [ { "text": { "content": "Lacinato kale" }, "type": "text" } ] }, "object": "block", "type": "heading_2" }, { "object": "block", "paragraph": { "text": [ { "text": { "content": "Lacinato kale is a variety of kale with a long tradition in Italian cuisine, especially that of Tuscany. It is also known as Tuscan kale, Italian kale, dinosaur kale, kale, flat back kale, palm tree kale, or black Tuscan palm.", "link": { "url": "https://en.wikipedia.org/wiki/Lacinato_kale" } }, "type": "text" } ] }, "type": "paragraph" } ] }, "schema": { "$ref": "#/components/schemas/PageUpdateRequestBody" } } } }, "responses": { "200": { "content": { "application/json": { "examples": { "200 Success - Append block children": { "value": { "child_page": { "title": "Who Will Teach Silicon Valley to Be Ethical? " }, "created_time": "2021-04-27T20:38:19.437Z", "has_children": true, "id": "a1712d54-53e4-4893-a69d-4d581cd2c845", "last_edited_time": "2021-05-12T06:07:37.724Z", "object": "block", "type": "child_page" } } }, "schema": { "$ref": "#/components/schemas/ChildBlockContent" } } }, "description": "200 Success - Append block children", "headers": { "CF-Cache-Status": { "schema": { "example": "DYNAMIC", "type": "string" } }, "CF-RAY": { "schema": { "example": "64e177c41a820231-SJC", "type": "string" } }, "Connection": { "schema": { "example": "keep-alive", "type": "string" } }, "Content-Encoding": { "schema": { "example": "gzip", "type": "string" } }, "Content-Security-Policy": { "schema": { "example": "script-src 'self' 'unsafe-inline' 'unsafe-eval' https://gist.github.com https://apis.google.com https://api.amplitude.com https://widget.intercom.io https://js.intercomcdn.com https://logs-01.loggly.com https://cdn.segment.com https://analytics.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com https://embed.typeform.com https://admin.typeform.com https://public.profitwell.com js.sentry-cdn.com https://platform.twitter.com https://cdn.syndication.twimg.com https://www.googletagmanager.com https://x.clearbitjs.com; connect-src 'self' https://msgstore.www.notion.so wss://msgstore.www.notion.so ws://localhost:* https://notion-emojis.s3-us-west-2.amazonaws.com https://s3-us-west-2.amazonaws.com https://s3.us-west-2.amazonaws.com https://notion-production-snapshots-2.s3.us-west-2.amazonaws.com https: http: https://api.amplitude.com https://api.embed.ly https://js.intercomcdn.com https://api-iam.intercom.io wss://nexus-websocket-a.intercom.io https://logs-01.loggly.com https://api.segment.io https://api.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com https://cdn.contentful.com https://preview.contentful.com https://images.ctfassets.net https://www2.profitwell.com https://api.unsplash.com https://boards-api.greenhouse.io; font-src 'self' data: https://cdnjs.cloudflare.com https://js.intercomcdn.com; img-src 'self' data: blob: https: https://platform.twitter.com https://syndication.twitter.com https://pbs.twimg.com https://ton.twimg.com www.googletagmanager.com; style-src 'self' 'unsafe-inline' https://cdnjs.cloudflare.com https://github.githubassets.com https://platform.twitter.com https://ton.twimg.com; frame-src https: http:; media-src https: http:", "type": "string" } }, "Date": { "schema": { "example": "Wed, 12 May 2021 06:07:37 GMT", "type": "string" } }, "ETag": { "schema": { "example": "W/\"105-p1Ka6kLp+wkCMX+oZhcjZAtwEtc\"", "type": "string" } }, "Expect-CT": { "schema": { "example": "max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\"", "type": "string" } }, "Referrer-Policy": { "schema": { "example": "same-origin", "type": "string" } }, "Server": { "schema": { "example": "cloudflare", "type": "string" } }, "Set-Cookie": { "schema": { "example": "notion_browser_id=0724819e-ad9a-4b7f-b50e-e5c75d6763dd; Domain=www.notion.so; Path=/; Expires=Sat, 18 Jan 2053 07:54:17 GMT; Secure", "type": "string" } }, "Strict-Transport-Security": { "schema": { "example": "max-age=5184000; includeSubDomains", "type": "string" } }, "Transfer-Encoding": { "schema": { "example": "chunked", "type": "string" } }, "Vary": { "schema": { "example": "Accept-Encoding", "type": "string" } }, "X-Content-Security-Policy": { "schema": { "example": "script-src 'self' 'unsafe-inline' 'unsafe-eval' https://gist.github.com https://apis.google.com https://api.amplitude.com https://widget.intercom.io https://js.intercomcdn.com https://logs-01.loggly.com https://cdn.segment.com https://analytics.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com https://embed.typeform.com https://admin.typeform.com https://public.profitwell.com js.sentry-cdn.com https://platform.twitter.com https://cdn.syndication.twimg.com https://www.googletagmanager.com https://x.clearbitjs.com; connect-src 'self' https://msgstore.www.notion.so wss://msgstore.www.notion.so ws://localhost:* https://notion-emojis.s3-us-west-2.amazonaws.com https://s3-us-west-2.amazonaws.com https://s3.us-west-2.amazonaws.com https://notion-production-snapshots-2.s3.us-west-2.amazonaws.com https: http: https://api.amplitude.com https://api.embed.ly https://js.intercomcdn.com https://api-iam.intercom.io wss://nexus-websocket-a.intercom.io https://logs-01.loggly.com https://api.segment.io https://api.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com https://cdn.contentful.com https://preview.contentful.com https://images.ctfassets.net https://www2.profitwell.com https://api.unsplash.com https://boards-api.greenhouse.io; font-src 'self' data: https://cdnjs.cloudflare.com https://js.intercomcdn.com; img-src 'self' data: blob: https: https://platform.twitter.com https://syndication.twitter.com https://pbs.twimg.com https://ton.twimg.com www.googletagmanager.com; style-src 'self' 'unsafe-inline' https://cdnjs.cloudflare.com https://github.githubassets.com https://platform.twitter.com https://ton.twimg.com; frame-src https: http:; media-src https: http:", "type": "string" } }, "X-Content-Type-Options": { "schema": { "example": "nosniff", "type": "string" } }, "X-DNS-Prefetch-Control": { "schema": { "example": "off", "type": "string" } }, "X-Download-Options": { "schema": { "example": "noopen", "type": "string" } }, "X-Frame-Options": { "schema": { "example": "SAMEORIGIN", "type": "string" } }, "X-WebKit-CSP": { "schema": { "example": "script-src 'self' 'unsafe-inline' 'unsafe-eval' https://gist.github.com https://apis.google.com https://api.amplitude.com https://widget.intercom.io https://js.intercomcdn.com https://logs-01.loggly.com https://cdn.segment.com https://analytics.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com https://embed.typeform.com https://admin.typeform.com https://public.profitwell.com js.sentry-cdn.com https://platform.twitter.com https://cdn.syndication.twimg.com https://www.googletagmanager.com https://x.clearbitjs.com; connect-src 'self' https://msgstore.www.notion.so wss://msgstore.www.notion.so ws://localhost:* https://notion-emojis.s3-us-west-2.amazonaws.com https://s3-us-west-2.amazonaws.com https://s3.us-west-2.amazonaws.com https://notion-production-snapshots-2.s3.us-west-2.amazonaws.com https: http: https://api.amplitude.com https://api.embed.ly https://js.intercomcdn.com https://api-iam.intercom.io wss://nexus-websocket-a.intercom.io https://logs-01.loggly.com https://api.segment.io https://api.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com https://cdn.contentful.com https://preview.contentful.com https://images.ctfassets.net https://www2.profitwell.com https://api.unsplash.com https://boards-api.greenhouse.io; font-src 'self' data: https://cdnjs.cloudflare.com https://js.intercomcdn.com; img-src 'self' data: blob: https: https://platform.twitter.com https://syndication.twitter.com https://pbs.twimg.com https://ton.twimg.com www.googletagmanager.com; style-src 'self' 'unsafe-inline' https://cdnjs.cloudflare.com https://github.githubassets.com https://platform.twitter.com https://ton.twimg.com; frame-src https: http:; media-src https: http:", "type": "string" } }, "X-XSS-Protection": { "schema": { "example": "1; mode=block", "type": "string" } }, "cf-request-id": { "schema": { "example": "0a00c92e8d00000231bf82c000000001", "type": "string" } } } } }, "summary": "Append block children", "tags": [ "Blocks" ] } }, "/v1/databases": { "post": { "description": "Create a database", "operationId": "createDatabase", "parameters": [ { "in": "header", "name": "Notion-Version", "description": "API Version", "schema": { "type": "string", "default": "2021-05-13" } } ], "requestBody": { "description": "Page information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DatabaseBodyParams" } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DatabaseBodyParams" } } }, "description": "200 Success - Create a database" } }, "summary": "Create a database", "tags": [ "Database" ] }, "get": { "description": "Returns a paginated list of databases for the workspace", "operationId": "listAllDatabases", "parameters": [ { "in": "query", "name": "start_cursor", "required": false, "description": "If supplied, this endpoint will return a page of results starting after the cursor provided. If not supplied, this endpoint will return the first page of results.", "schema": { "type": "string" } }, { "in": "query", "name": "page_size", "required": false, "description": "The number of items from the full list desired in the response. Maximum- 100", "schema": { "type": "integer" } }, { "in": "header", "name": "Notion-Version", "description": "API Version", "schema": { "type": "string", "default": "2021-05-13" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DatabaseResponse" } } }, "description": "200 Success - List all databases" } }, "summary": "List all databases", "tags": [ "Database" ] } }, "/v1/databases/{id}": { "get": { "description": "Retrieves a database object using the ID specified in the request path. ", "operationId": "retrieveDatabase", "responses": { "200": { "content": { "application/json": { "examples": { "200 Success - Retrieve a database": { "value": { "created_time": "2021-04-27T20:38:19.437Z", "id": "8e2c2b76-9e1d-47d2-87b9-ed3035d607ae", "last_edited_time": "2021-04-27T21:15:00.000Z", "object": "database", "properties": { "Author": { "id": "qNw_", "multi_select": { "options": [ { "color": "default", "id": "15592971-7b30-43d5-9406-2eb69b13fcae", "name": "Spencer Greenberg" }, { "color": "default", "id": "b80a988e-dccf-4f74-b764-6ca0e49ed1b8", "name": "Seth Stephens-Davidowitz" }, { "color": "default", "id": "0e71ee06-199d-46a4-834c-01084c8f76cb", "name": "Andrew Russell" }, { "color": "default", "id": "5807ec38-4879-4455-9f30-5352e90e8b79", "name": "Lee Vinsel" }, { "color": "default", "id": "4cf10a64-f3da-449c-8e04-ce6e338bbdbd", "name": "Megan Greenwell" }, { "color": "default", "id": "833e2c78-35ed-4601-badc-50c323341d76", "name": "Kara Swisher" }, { "color": "default", "id": "82e594e2-b1c5-4271-ac19-1a723a94a533", "name": "Paul Romer" }, { "color": "default", "id": "ae3a2cbe-1fc9-4376-be35-331628b34623", "name": "Karen Swallow Prior" }, { "color": "default", "id": "da068e78-dfe2-4434-9fd7-b7450b3e5830", "name": "Judith Shulevitz" } ] }, "type": "multi_select" }, "Link": { "id": "VVMi", "type": "url", "url": {} }, "Name": { "id": "title", "title": {}, "type": "title" }, "Publisher": { "id": ">$Pb", "select": { "options": [ { "color": "default", "id": "c5ee409a-f307-4176-99ee-6e424fa89afa", "name": "NYT" }, { "color": "blue", "id": "1b9b0c0c-17b0-4292-ad12-1364a51849de", "name": "Netflix" }, { "color": "brown", "id": "f3533637-278f-4501-b394-d9753bf3c101", "name": "Indie" }, { "color": "yellow", "id": "e70d713c-4be4-4b40-a44d-fb413c8b9d7e", "name": "Bon Appetit" }, { "color": "pink", "id": "9c2bd667-0a10-4be4-a044-35a537a14ab9", "name": "Franklin Institute" }, { "color": "orange", "id": "6849b5f0-e641-4ec5-83cb-1ffe23011060", "name": "Springer" }, { "color": "gray", "id": "6a5bff63-a72d-4464-a5d0-1a601af2adf6", "name": "Emerald Group" }, { "color": "red", "id": "01f82d08-aa1f-4884-a4e0-3bc32f909ec4", "name": "The Atlantic" } ] }, "type": "select" }, "Publishing/Release Date": { "date": {}, "id": "?ex+", "type": "date" }, "Read": { "checkbox": {}, "id": "_MWJ", "type": "checkbox" }, "Score /5": { "id": ")Y7\"", "select": { "options": [ { "color": "default", "id": "5c944de7-3f4b-4567-b3a1-fa2c71c540b6", "name": "⭐️⭐️⭐️⭐️⭐️" }, { "color": "default", "id": "b7307e35-c80a-4cb5-bb6b-6054523b394a", "name": "⭐️⭐️⭐️⭐️" }, { "color": "default", "id": "9b1e1349-8e24-40ba-bbca-84a61296bc81", "name": "⭐️⭐️⭐️" }, { "color": "default", "id": "66d3d050-086c-4a91-8c56-d55dc67e7789", "name": "⭐️⭐️" }, { "color": "default", "id": "d3782c76-0396-467f-928e-46bf0c9d5fba", "name": "⭐️" } ] }, "type": "select" }, "Status": { "id": "`zz5", "select": { "options": [ { "color": "yellow", "id": "8c4a056e-6709-4dd1-ba58-d34d9480855a", "name": "Ready to Start" }, { "color": "red", "id": "5925ba22-0126-4b58-90c7-b8bbb2c3c895", "name": "Reading" }, { "color": "blue", "id": "59aa9043-07b4-4bf4-8734-3164b13af44a", "name": "Finished" }, { "color": "red", "id": "f961978d-02eb-4998-933a-33c2ec378564", "name": "Listening" }, { "color": "red", "id": "1d450853-b27a-45e2-979f-448aa1bd35de", "name": "Watching" } ] }, "type": "select" }, "Summary": { "id": "?\\25", "text": {}, "type": "text" }, "Type": { "id": "/7eo", "select": { "options": [ { "color": "default", "id": "f96d0d0a-5564-4a20-ab15-5f040d49759e", "name": "Article" }, { "color": "default", "id": "4ac85597-5db1-4e0a-9c02-445575c38f76", "name": "TV Series" }, { "color": "default", "id": "2991748a-5745-4c3b-9c9b-2d6846a6fa1f", "name": "Film" }, { "color": "default", "id": "82f3bace-be25-410d-87fe-561c9c22492f", "name": "Podcast" }, { "color": "default", "id": "861f1076-1cc4-429a-a781-54947d727a4a", "name": "Academic Journal" }, { "color": "default", "id": "9cc30548-59d6-4cd3-94bc-d234081525c4", "name": "Essay Resource" } ] }, "type": "select" } }, "title": [ { "annotations": { "bold": false, "code": false, "color": "default", "italic": false, "strikethrough": false, "underline": false }, "href": null, "plain_text": "Media", "text": { "content": "Media", "link": null }, "type": "text" } ] } } }, "schema": { "$ref": "#/components/schemas/Database" } } }, "description": "200 Success - Retrieve a database", "headers": { "CF-Cache-Status": { "schema": { "example": "DYNAMIC", "type": "string" } }, "CF-RAY": { "schema": { "example": "646b122b5e6d269a-SJC", "type": "string" } }, "Connection": { "schema": { "example": "keep-alive", "type": "string" } }, "Content-Encoding": { "schema": { "example": "gzip", "type": "string" } }, "Content-Security-Policy": { "schema": { "example": "script-src 'self' 'unsafe-inline' 'unsafe-eval' https://gist.github.com https://apis.google.com https://api.amplitude.com https://widget.intercom.io https://js.intercomcdn.com https://logs-01.loggly.com https://cdn.segment.com https://analytics.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com/v3 https://embed.typeform.com https://admin.typeform.com https://platform.twitter.com https://cdn.syndication.twimg.com https://www.googletagmanager.com https://x.clearbitjs.com; connect-src 'self' https://msgstore.www.notion.so wss://msgstore.www.notion.so ws://localhost:* https://notion-emojis.s3-us-west-2.amazonaws.com https://s3-us-west-2.amazonaws.com https://s3.us-west-2.amazonaws.com https://notion-production-snapshots-2.s3.us-west-2.amazonaws.com https: http: https://api.amplitude.com https://api.embed.ly https://js.intercomcdn.com https://api-iam.intercom.io wss://nexus-websocket-a.intercom.io https://logs-01.loggly.com https://api.segment.io https://api.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com/v3 https://cdn.contentful.com https://preview.contentful.com https://images.ctfassets.net https://api.unsplash.com https://boards-api.greenhouse.io; font-src 'self' data: https://cdnjs.cloudflare.com https://js.intercomcdn.com; img-src 'self' data: blob: https: https://platform.twitter.com https://syndication.twitter.com https://pbs.twimg.com https://ton.twimg.com www.googletagmanager.com; style-src 'self' 'unsafe-inline' https://cdnjs.cloudflare.com https://github.githubassets.com https://platform.twitter.com https://ton.twimg.com; frame-src https: http:; media-src https: http:", "type": "string" } }, "Date": { "schema": { "example": "Tue, 27 Apr 2021 21:16:17 GMT", "type": "string" } }, "ETag": { "schema": { "example": "W/\"ec4-zjtg92X8dlV+o+GOEWHEth+DGEk\"", "type": "string" } }, "Expect-CT": { "schema": { "example": "max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\"", "type": "string" } }, "Referrer-Policy": { "schema": { "example": "same-origin", "type": "string" } }, "Server": { "schema": { "example": "cloudflare", "type": "string" } }, "Set-Cookie": { "schema": { "example": "notion_browser_id=9122a199-c9bd-4be0-9313-ef4af9d1a2bc; Domain=www.notion.so; Path=/; Expires=Fri, 03 Jan 2053 23:02:57 GMT; Secure", "type": "string" } }, "Strict-Transport-Security": { "schema": { "example": "max-age=5184000; includeSubDomains", "type": "string" } }, "Transfer-Encoding": { "schema": { "example": "chunked", "type": "string" } }, "Vary": { "schema": { "example": "Accept-Encoding", "type": "string" } }, "X-Content-Security-Policy": { "schema": { "example": "script-src 'self' 'unsafe-inline' 'unsafe-eval' https://gist.github.com https://apis.google.com https://api.amplitude.com https://widget.intercom.io https://js.intercomcdn.com https://logs-01.loggly.com https://cdn.segment.com https://analytics.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com/v3 https://embed.typeform.com https://admin.typeform.com https://platform.twitter.com https://cdn.syndication.twimg.com https://www.googletagmanager.com https://x.clearbitjs.com; connect-src 'self' https://msgstore.www.notion.so wss://msgstore.www.notion.so ws://localhost:* https://notion-emojis.s3-us-west-2.amazonaws.com https://s3-us-west-2.amazonaws.com https://s3.us-west-2.amazonaws.com https://notion-production-snapshots-2.s3.us-west-2.amazonaws.com https: http: https://api.amplitude.com https://api.embed.ly https://js.intercomcdn.com https://api-iam.intercom.io wss://nexus-websocket-a.intercom.io https://logs-01.loggly.com https://api.segment.io https://api.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com/v3 https://cdn.contentful.com https://preview.contentful.com https://images.ctfassets.net https://api.unsplash.com https://boards-api.greenhouse.io; font-src 'self' data: https://cdnjs.cloudflare.com https://js.intercomcdn.com; img-src 'self' data: blob: https: https://platform.twitter.com https://syndication.twitter.com https://pbs.twimg.com https://ton.twimg.com www.googletagmanager.com; style-src 'self' 'unsafe-inline' https://cdnjs.cloudflare.com https://github.githubassets.com https://platform.twitter.com https://ton.twimg.com; frame-src https: http:; media-src https: http:", "type": "string" } }, "X-Content-Type-Options": { "schema": { "example": "nosniff", "type": "string" } }, "X-DNS-Prefetch-Control": { "schema": { "example": "off", "type": "string" } }, "X-Download-Options": { "schema": { "example": "noopen", "type": "string" } }, "X-Frame-Options": { "schema": { "example": "SAMEORIGIN", "type": "string" } }, "X-WebKit-CSP": { "schema": { "example": "script-src 'self' 'unsafe-inline' 'unsafe-eval' https://gist.github.com https://apis.google.com https://api.amplitude.com https://widget.intercom.io https://js.intercomcdn.com https://logs-01.loggly.com https://cdn.segment.com https://analytics.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com/v3 https://embed.typeform.com https://admin.typeform.com https://platform.twitter.com https://cdn.syndication.twimg.com https://www.googletagmanager.com https://x.clearbitjs.com; connect-src 'self' https://msgstore.www.notion.so wss://msgstore.www.notion.so ws://localhost:* https://notion-emojis.s3-us-west-2.amazonaws.com https://s3-us-west-2.amazonaws.com https://s3.us-west-2.amazonaws.com https://notion-production-snapshots-2.s3.us-west-2.amazonaws.com https: http: https://api.amplitude.com https://api.embed.ly https://js.intercomcdn.com https://api-iam.intercom.io wss://nexus-websocket-a.intercom.io https://logs-01.loggly.com https://api.segment.io https://api.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com/v3 https://cdn.contentful.com https://preview.contentful.com https://images.ctfassets.net https://api.unsplash.com https://boards-api.greenhouse.io; font-src 'self' data: https://cdnjs.cloudflare.com https://js.intercomcdn.com; img-src 'self' data: blob: https: https://platform.twitter.com https://syndication.twitter.com https://pbs.twimg.com https://ton.twimg.com www.googletagmanager.com; style-src 'self' 'unsafe-inline' https://cdnjs.cloudflare.com https://github.githubassets.com https://platform.twitter.com https://ton.twimg.com; frame-src https: http:; media-src https: http:", "type": "string" } }, "X-XSS-Protection": { "schema": { "example": "1; mode=block", "type": "string" } }, "cf-request-id": { "schema": { "example": "09b6c9af130000269a31192000000001", "type": "string" } } } } }, "summary": "Retrieve a database", "tags": [ "Databases" ] }, "parameters": [ { "in": "path", "name": "id", "description": "Database ID", "required": true, "schema": { "example": "{{DATABASE_ID}}", "type": "string" } }, { "in": "header", "name": "Notion-Version", "description": "API Version", "schema": { "example": "", "type": "string", "default": "2021-05-13" } } ] }, "/v1/databases/{id}/query": { "parameters": [ { "in": "path", "name": "id", "description": "Database ID", "required": true, "schema": { "example": "{{DATABASE_ID}}", "type": "string" } }, { "in": "header", "name": "Notion-Version", "description": "API Version", "schema": { "example": "", "type": "string", "default": "2021-05-13" } } ], "post": { "description": "Query a Database", "operationId": "queryDatabase", "requestBody": { "content": { "application/json": { "example": { "filter": { "or": [ { "property": "Status", "select": { "equals": "Reading" } }, { "property": "Publisher", "select": { "equals": "NYT" } } ] }, "sorts": [ { "direction": "ascending", "property": "Score /5" } ] }, "schema": { "$ref": "#/components/schemas/DatabaseContent" } } } }, "responses": { "200": { "content": { "application/json": { "examples": { "200 Success - Query a Database (Single Filter)": { "value": { "has_more": false, "next_cursor": null, "object": "list", "results": [ { "archived": false, "created_time": "2021-04-27T20:38:19.437Z", "id": "557ef501-bfdb-4586-918e-4434f31bca8c", "last_edited_time": "2021-04-27T20:38:19.437Z", "object": "page", "parent": { "database_id": "8e2c2b76-9e1d-47d2-87b9-ed3035d607ae", "type": "database_id" }, "properties": { "Author": { "id": "qNw_", "multi_select": [ { "color": "default", "id": "ae3a2cbe-1fc9-4376-be35-331628b34623", "name": "Karen Swallow Prior" } ], "type": "multi_select" }, "Link": { "id": "VVMi", "type": "url", "url": "https://www.theatlantic.com/entertainment/archive/2016/03/how-jane-eyre-created-the-modern-self/460461/" }, "Name": { "id": "title", "title": [ { "annotations": { "bold": false, "code": false, "color": "default", "italic": true, "strikethrough": false, "underline": false }, "href": null, "plain_text": "Jane Eyre", "text": { "content": "Jane Eyre", "link": null }, "type": "text" }, { "annotations": { "bold": false, "code": false, "color": "default", "italic": false, "strikethrough": false, "underline": false }, "href": null, "plain_text": " and the Invention of Self", "text": { "content": " and the Invention of Self", "link": null }, "type": "text" } ], "type": "title" }, "Publisher": { "id": ">$Pb", "select": { "color": "red", "id": "01f82d08-aa1f-4884-a4e0-3bc32f909ec4", "name": "The Atlantic" }, "type": "select" }, "Publishing/Release Date": { "date": { "end": null, "start": "2016-10-03T00:00:00.000Z" }, "id": "?ex+", "type": "date" }, "Read": { "checkbox": false, "id": "_MWJ", "type": "checkbox" }, "Score /5": { "id": ")Y7\"", "select": { "color": "default", "id": "66d3d050-086c-4a91-8c56-d55dc67e7789", "name": "⭐️⭐️" }, "type": "select" }, "Status": { "id": "`zz5", "select": { "color": "red", "id": "5925ba22-0126-4b58-90c7-b8bbb2c3c895", "name": "Reading" }, "type": "select" }, "Summary": { "id": "?\\25", "text": [], "type": "text" }, "Type": { "id": "/7eo", "select": { "color": "default", "id": "9cc30548-59d6-4cd3-94bc-d234081525c4", "name": "Essay Resource" }, "type": "select" } } }, { "archived": false, "created_time": "2021-04-27T20:38:19.437Z", "id": "a1712d54-53e4-4893-a69d-4d581cd2c845", "last_edited_time": "2021-04-28T23:12:53.160Z", "object": "page", "parent": { "database_id": "8e2c2b76-9e1d-47d2-87b9-ed3035d607ae", "type": "database_id" }, "properties": { "Author": { "id": "qNw_", "multi_select": [ { "color": "default", "id": "833e2c78-35ed-4601-badc-50c323341d76", "name": "Kara Swisher" } ], "type": "multi_select" }, "Link": { "id": "VVMi", "type": "url", "url": "https://www.nytimes.com/2018/10/21/opinion/who-will-teach-silicon-valley-to-be-ethical.html" }, "Name": { "id": "title", "title": [ { "annotations": { "bold": false, "code": false, "color": "default", "italic": false, "strikethrough": false, "underline": false }, "href": null, "plain_text": "Who Will Teach Silicon Valley to Be Ethical? ", "text": { "content": "Who Will Teach Silicon Valley to Be Ethical? ", "link": null }, "type": "text" } ], "type": "title" }, "Publisher": { "id": ">$Pb", "select": { "color": "default", "id": "c5ee409a-f307-4176-99ee-6e424fa89afa", "name": "NYT" }, "type": "select" }, "Publishing/Release Date": { "date": { "end": null, "start": "2018-10-21T00:00:00.000Z" }, "id": "?ex+", "type": "date" }, "Read": { "checkbox": true, "id": "_MWJ", "type": "checkbox" }, "Score /5": { "id": ")Y7\"", "select": { "color": "default", "id": "b7307e35-c80a-4cb5-bb6b-6054523b394a", "name": "⭐️⭐️⭐️⭐️" }, "type": "select" }, "Status": { "id": "`zz5", "select": { "color": "red", "id": "5925ba22-0126-4b58-90c7-b8bbb2c3c895", "name": "Reading" }, "type": "select" }, "Summary": { "id": "?\\25", "text": [ { "annotations": { "bold": false, "code": false, "color": "default", "italic": false, "strikethrough": false, "underline": false }, "href": null, "plain_text": "Some think chief ethics officers could help technology companies navigate political and social questions.", "text": { "content": "Some think chief ethics officers could help technology companies navigate political and social questions.", "link": null }, "type": "text" } ], "type": "text" }, "Type": { "id": "/7eo", "select": { "color": "default", "id": "f96d0d0a-5564-4a20-ab15-5f040d49759e", "name": "Article" }, "type": "select" } } } ] } } }, "schema": { "$ref": "#/components/schemas/DatabaseResponse" } } }, "description": "200 Success - Query a Database (Single Filter)", "headers": { "CF-Cache-Status": { "schema": { "example": "DYNAMIC", "type": "string" } }, "CF-RAY": { "schema": { "example": "64742bf94bcc6dc4-SJC", "type": "string" } }, "Connection": { "schema": { "example": "keep-alive", "type": "string" } }, "Content-Encoding": { "schema": { "example": "gzip", "type": "string" } }, "Content-Security-Policy": { "schema": { "example": "script-src 'self' 'unsafe-inline' 'unsafe-eval' https://gist.github.com https://apis.google.com https://api.amplitude.com https://widget.intercom.io https://js.intercomcdn.com https://logs-01.loggly.com https://cdn.segment.com https://analytics.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com/v3 https://embed.typeform.com https://admin.typeform.com https://platform.twitter.com https://cdn.syndication.twimg.com https://www.googletagmanager.com https://x.clearbitjs.com; connect-src 'self' https://msgstore.www.notion.so wss://msgstore.www.notion.so ws://localhost:* https://notion-emojis.s3-us-west-2.amazonaws.com https://s3-us-west-2.amazonaws.com https://s3.us-west-2.amazonaws.com https://notion-production-snapshots-2.s3.us-west-2.amazonaws.com https: http: https://api.amplitude.com https://api.embed.ly https://js.intercomcdn.com https://api-iam.intercom.io wss://nexus-websocket-a.intercom.io https://logs-01.loggly.com https://api.segment.io https://api.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com/v3 https://cdn.contentful.com https://preview.contentful.com https://images.ctfassets.net https://api.unsplash.com https://boards-api.greenhouse.io; font-src 'self' data: https://cdnjs.cloudflare.com https://js.intercomcdn.com; img-src 'self' data: blob: https: https://platform.twitter.com https://syndication.twitter.com https://pbs.twimg.com https://ton.twimg.com www.googletagmanager.com; style-src 'self' 'unsafe-inline' https://cdnjs.cloudflare.com https://github.githubassets.com https://platform.twitter.com https://ton.twimg.com; frame-src https: http:; media-src https: http:", "type": "string" } }, "Date": { "schema": { "example": "Wed, 28 Apr 2021 23:46:45 GMT", "type": "string" } }, "ETag": { "schema": { "example": "W/\"f21-yS6Mhxpuh9b1qQqwcnv0VnpDQvE\"", "type": "string" } }, "Expect-CT": { "schema": { "example": "max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\"", "type": "string" } }, "Referrer-Policy": { "schema": { "example": "same-origin", "type": "string" } }, "Server": { "schema": { "example": "cloudflare", "type": "string" } }, "Set-Cookie": { "schema": { "example": "notion_browser_id=b428cd25-ff7b-4760-9db6-a0607bba5f75; Domain=www.notion.so; Path=/; Expires=Sun, 05 Jan 2053 01:33:25 GMT; Secure", "type": "string" } }, "Strict-Transport-Security": { "schema": { "example": "max-age=5184000; includeSubDomains", "type": "string" } }, "Transfer-Encoding": { "schema": { "example": "chunked", "type": "string" } }, "Vary": { "schema": { "example": "Accept-Encoding", "type": "string" } }, "X-Content-Security-Policy": { "schema": { "example": "script-src 'self' 'unsafe-inline' 'unsafe-eval' https://gist.github.com https://apis.google.com https://api.amplitude.com https://widget.intercom.io https://js.intercomcdn.com https://logs-01.loggly.com https://cdn.segment.com https://analytics.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com/v3 https://embed.typeform.com https://admin.typeform.com https://platform.twitter.com https://cdn.syndication.twimg.com https://www.googletagmanager.com https://x.clearbitjs.com; connect-src 'self' https://msgstore.www.notion.so wss://msgstore.www.notion.so ws://localhost:* https://notion-emojis.s3-us-west-2.amazonaws.com https://s3-us-west-2.amazonaws.com https://s3.us-west-2.amazonaws.com https://notion-production-snapshots-2.s3.us-west-2.amazonaws.com https: http: https://api.amplitude.com https://api.embed.ly https://js.intercomcdn.com https://api-iam.intercom.io wss://nexus-websocket-a.intercom.io https://logs-01.loggly.com https://api.segment.io https://api.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com/v3 https://cdn.contentful.com https://preview.contentful.com https://images.ctfassets.net https://api.unsplash.com https://boards-api.greenhouse.io; font-src 'self' data: https://cdnjs.cloudflare.com https://js.intercomcdn.com; img-src 'self' data: blob: https: https://platform.twitter.com https://syndication.twitter.com https://pbs.twimg.com https://ton.twimg.com www.googletagmanager.com; style-src 'self' 'unsafe-inline' https://cdnjs.cloudflare.com https://github.githubassets.com https://platform.twitter.com https://ton.twimg.com; frame-src https: http:; media-src https: http:", "type": "string" } }, "X-Content-Type-Options": { "schema": { "example": "nosniff", "type": "string" } }, "X-DNS-Prefetch-Control": { "schema": { "example": "off", "type": "string" } }, "X-Download-Options": { "schema": { "example": "noopen", "type": "string" } }, "X-Frame-Options": { "schema": { "example": "SAMEORIGIN", "type": "string" } }, "X-WebKit-CSP": { "schema": { "example": "script-src 'self' 'unsafe-inline' 'unsafe-eval' https://gist.github.com https://apis.google.com https://api.amplitude.com https://widget.intercom.io https://js.intercomcdn.com https://logs-01.loggly.com https://cdn.segment.com https://analytics.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com/v3 https://embed.typeform.com https://admin.typeform.com https://platform.twitter.com https://cdn.syndication.twimg.com https://www.googletagmanager.com https://x.clearbitjs.com; connect-src 'self' https://msgstore.www.notion.so wss://msgstore.www.notion.so ws://localhost:* https://notion-emojis.s3-us-west-2.amazonaws.com https://s3-us-west-2.amazonaws.com https://s3.us-west-2.amazonaws.com https://notion-production-snapshots-2.s3.us-west-2.amazonaws.com https: http: https://api.amplitude.com https://api.embed.ly https://js.intercomcdn.com https://api-iam.intercom.io wss://nexus-websocket-a.intercom.io https://logs-01.loggly.com https://api.segment.io https://api.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com/v3 https://cdn.contentful.com https://preview.contentful.com https://images.ctfassets.net https://api.unsplash.com https://boards-api.greenhouse.io; font-src 'self' data: https://cdnjs.cloudflare.com https://js.intercomcdn.com; img-src 'self' data: blob: https: https://platform.twitter.com https://syndication.twitter.com https://pbs.twimg.com https://ton.twimg.com www.googletagmanager.com; style-src 'self' 'unsafe-inline' https://cdnjs.cloudflare.com https://github.githubassets.com https://platform.twitter.com https://ton.twimg.com; frame-src https: http:; media-src https: http:", "type": "string" } }, "X-XSS-Protection": { "schema": { "example": "1; mode=block", "type": "string" } }, "cf-request-id": { "schema": { "example": "09bc79cfca00006dc430903000000001", "type": "string" } } } } }, "summary": "Query a Database", "tags": [ "Databases" ] } }, "/v1/pages": { "post": { "description": "Creates a new page in the specified database or as a child of an existing page", "operationId": "createPage", "summary": "Create a page", "parameters": [ { "in": "header", "name": "Notion-Version", "description": "API Version", "schema": { "type": "string", "default": "2021-05-13" } } ], "tags": [ "Pages" ], "requestBody": { "description": "Page information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PageBodyParams" } } } }, "responses": { "200": { "description": "200 Success - Create Page", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PageResponse" } } } } } } }, "/v1/pages/{id}": { "get": { "description": "Retrieves a Page object using the ID in the request path. This endpoint exposes page properties, not page content. ", "operationId": "retrievePage", "responses": { "200": { "content": { "application/json": { "examples": { "200 Success - Retrieve a Page": { "value": { "archived": false, "created_time": "2021-04-27T20:38:19.437Z", "id": "a1712d54-53e4-4893-a69d-4d581cd2c845", "last_edited_time": "2021-04-27T20:38:19.437Z", "object": "page", "parent": { "database_id": "8e2c2b76-9e1d-47d2-87b9-ed3035d607ae", "type": "database_id" }, "properties": { "Author": { "id": "qNw_", "multi_select": [ { "color": "default", "id": "833e2c78-35ed-4601-badc-50c323341d76", "name": "Kara Swisher" } ], "type": "multi_select" }, "Link": { "id": "VVMi", "type": "url", "url": "https://www.nytimes.com/2018/10/21/opinion/who-will-teach-silicon-valley-to-be-ethical.html" }, "Name": { "id": "title", "title": [ { "annotations": { "bold": false, "code": false, "color": "default", "italic": false, "strikethrough": false, "underline": false }, "href": null, "plain_text": "Who Will Teach Silicon Valley to Be Ethical? ", "text": { "content": "Who Will Teach Silicon Valley to Be Ethical? ", "link": null }, "type": "text" } ], "type": "title" }, "Publisher": { "id": ">$Pb", "select": { "color": "default", "id": "c5ee409a-f307-4176-99ee-6e424fa89afa", "name": "NYT" }, "type": "select" }, "Publishing/Release Date": { "date": { "end": null, "start": "2018-10-21T00:00:00.000Z" }, "id": "?ex+", "type": "date" }, "Read": { "checkbox": false, "id": "_MWJ", "type": "checkbox" }, "Status": { "id": "`zz5", "select": { "color": "yellow", "id": "8c4a056e-6709-4dd1-ba58-d34d9480855a", "name": "Ready to Start" }, "type": "select" }, "Summary": { "id": "?\\25", "text": [ { "annotations": { "bold": false, "code": false, "color": "default", "italic": false, "strikethrough": false, "underline": false }, "href": null, "plain_text": "Some think chief ethics officers could help technology companies navigate political and social questions.", "text": { "content": "Some think chief ethics officers could help technology companies navigate political and social questions.", "link": null }, "type": "text" } ], "type": "text" }, "Type": { "id": "/7eo", "select": { "color": "default", "id": "f96d0d0a-5564-4a20-ab15-5f040d49759e", "name": "Article" }, "type": "select" } } } } }, "schema": { "$ref": "#/components/schemas/PageResponse" } } }, "description": "200 Success - Retrieve a Page", "headers": { "CF-Cache-Status": { "schema": { "example": "DYNAMIC", "type": "string" } }, "CF-RAY": { "schema": { "example": "6473e2c6efdf1fbf-SJC", "type": "string" } }, "Connection": { "schema": { "example": "keep-alive", "type": "string" } }, "Content-Encoding": { "schema": { "example": "gzip", "type": "string" } }, "Content-Security-Policy": { "schema": { "example": "script-src 'self' 'unsafe-inline' 'unsafe-eval' https://gist.github.com https://apis.google.com https://api.amplitude.com https://widget.intercom.io https://js.intercomcdn.com https://logs-01.loggly.com https://cdn.segment.com https://analytics.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com/v3 https://embed.typeform.com https://admin.typeform.com https://platform.twitter.com https://cdn.syndication.twimg.com https://www.googletagmanager.com https://x.clearbitjs.com; connect-src 'self' https://msgstore.www.notion.so wss://msgstore.www.notion.so ws://localhost:* https://notion-emojis.s3-us-west-2.amazonaws.com https://s3-us-west-2.amazonaws.com https://s3.us-west-2.amazonaws.com https://notion-production-snapshots-2.s3.us-west-2.amazonaws.com https: http: https://api.amplitude.com https://api.embed.ly https://js.intercomcdn.com https://api-iam.intercom.io wss://nexus-websocket-a.intercom.io https://logs-01.loggly.com https://api.segment.io https://api.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com/v3 https://cdn.contentful.com https://preview.contentful.com https://images.ctfassets.net https://api.unsplash.com https://boards-api.greenhouse.io; font-src 'self' data: https://cdnjs.cloudflare.com https://js.intercomcdn.com; img-src 'self' data: blob: https: https://platform.twitter.com https://syndication.twitter.com https://pbs.twimg.com https://ton.twimg.com www.googletagmanager.com; style-src 'self' 'unsafe-inline' https://cdnjs.cloudflare.com https://github.githubassets.com https://platform.twitter.com https://ton.twimg.com; frame-src https: http:; media-src https: http:", "type": "string" } }, "Date": { "schema": { "example": "Wed, 28 Apr 2021 22:56:47 GMT", "type": "string" } }, "ETag": { "schema": { "example": "W/\"74e-OOTyxxjrH/jUfdxafOC5PJJkAf8\"", "type": "string" } }, "Expect-CT": { "schema": { "example": "max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\"", "type": "string" } }, "Referrer-Policy": { "schema": { "example": "same-origin", "type": "string" } }, "Server": { "schema": { "example": "cloudflare", "type": "string" } }, "Set-Cookie": { "schema": { "example": "notion_browser_id=38d6e64f-a286-4cdc-929d-6c077386ad73; Domain=www.notion.so; Path=/; Expires=Sun, 05 Jan 2053 00:43:27 GMT; Secure", "type": "string" } }, "Strict-Transport-Security": { "schema": { "example": "max-age=5184000; includeSubDomains", "type": "string" } }, "Transfer-Encoding": { "schema": { "example": "chunked", "type": "string" } }, "Vary": { "schema": { "example": "Accept-Encoding", "type": "string" } }, "X-Content-Security-Policy": { "schema": { "example": "script-src 'self' 'unsafe-inline' 'unsafe-eval' https://gist.github.com https://apis.google.com https://api.amplitude.com https://widget.intercom.io https://js.intercomcdn.com https://logs-01.loggly.com https://cdn.segment.com https://analytics.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com/v3 https://embed.typeform.com https://admin.typeform.com https://platform.twitter.com https://cdn.syndication.twimg.com https://www.googletagmanager.com https://x.clearbitjs.com; connect-src 'self' https://msgstore.www.notion.so wss://msgstore.www.notion.so ws://localhost:* https://notion-emojis.s3-us-west-2.amazonaws.com https://s3-us-west-2.amazonaws.com https://s3.us-west-2.amazonaws.com https://notion-production-snapshots-2.s3.us-west-2.amazonaws.com https: http: https://api.amplitude.com https://api.embed.ly https://js.intercomcdn.com https://api-iam.intercom.io wss://nexus-websocket-a.intercom.io https://logs-01.loggly.com https://api.segment.io https://api.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com/v3 https://cdn.contentful.com https://preview.contentful.com https://images.ctfassets.net https://api.unsplash.com https://boards-api.greenhouse.io; font-src 'self' data: https://cdnjs.cloudflare.com https://js.intercomcdn.com; img-src 'self' data: blob: https: https://platform.twitter.com https://syndication.twitter.com https://pbs.twimg.com https://ton.twimg.com www.googletagmanager.com; style-src 'self' 'unsafe-inline' https://cdnjs.cloudflare.com https://github.githubassets.com https://platform.twitter.com https://ton.twimg.com; frame-src https: http:; media-src https: http:", "type": "string" } }, "X-Content-Type-Options": { "schema": { "example": "nosniff", "type": "string" } }, "X-DNS-Prefetch-Control": { "schema": { "example": "off", "type": "string" } }, "X-Download-Options": { "schema": { "example": "noopen", "type": "string" } }, "X-Frame-Options": { "schema": { "example": "SAMEORIGIN", "type": "string" } }, "X-WebKit-CSP": { "schema": { "example": "script-src 'self' 'unsafe-inline' 'unsafe-eval' https://gist.github.com https://apis.google.com https://api.amplitude.com https://widget.intercom.io https://js.intercomcdn.com https://logs-01.loggly.com https://cdn.segment.com https://analytics.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com/v3 https://embed.typeform.com https://admin.typeform.com https://platform.twitter.com https://cdn.syndication.twimg.com https://www.googletagmanager.com https://x.clearbitjs.com; connect-src 'self' https://msgstore.www.notion.so wss://msgstore.www.notion.so ws://localhost:* https://notion-emojis.s3-us-west-2.amazonaws.com https://s3-us-west-2.amazonaws.com https://s3.us-west-2.amazonaws.com https://notion-production-snapshots-2.s3.us-west-2.amazonaws.com https: http: https://api.amplitude.com https://api.embed.ly https://js.intercomcdn.com https://api-iam.intercom.io wss://nexus-websocket-a.intercom.io https://logs-01.loggly.com https://api.segment.io https://api.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com/v3 https://cdn.contentful.com https://preview.contentful.com https://images.ctfassets.net https://api.unsplash.com https://boards-api.greenhouse.io; font-src 'self' data: https://cdnjs.cloudflare.com https://js.intercomcdn.com; img-src 'self' data: blob: https: https://platform.twitter.com https://syndication.twitter.com https://pbs.twimg.com https://ton.twimg.com www.googletagmanager.com; style-src 'self' 'unsafe-inline' https://cdnjs.cloudflare.com https://github.githubassets.com https://platform.twitter.com https://ton.twimg.com; frame-src https: http:; media-src https: http:", "type": "string" } }, "X-XSS-Protection": { "schema": { "example": "1; mode=block", "type": "string" } }, "cf-request-id": { "schema": { "example": "09bc4c105500001fbf82b30000000001", "type": "string" } } } } }, "summary": "Retrieve a Page", "tags": [ "Pages" ] }, "parameters": [ { "in": "path", "name": "id", "description": "Page ID", "required": true, "schema": { "example": "{{PAGE_ID}}", "type": "string" } }, { "in": "header", "name": "Notion-Version", "description": "API Version", "schema": { "example": "", "type": "string", "default": "2021-05-13" } } ], "patch": { "description": "Updates a page by setting the values of any properties specified in the JSON body of the request. Properties not updated via parameters will remain unchanged. ", "operationId": "updatePageProperties", "requestBody": { "content": { "application/json": { "example": { "properties": { "Status": { "select": { "name": "Reading" } } } }, "schema": { "$ref": "#/components/schemas/PageContent" } } } }, "responses": { "200": { "content": { "application/json": { "examples": { "200 Success - Update Page properties": { "value": { "archived": false, "created_time": "2021-04-27T20:38:19.437Z", "id": "a1712d54-53e4-4893-a69d-4d581cd2c845", "last_edited_time": "2021-04-28T23:12:53.160Z", "object": "page", "parent": { "database_id": "8e2c2b76-9e1d-47d2-87b9-ed3035d607ae", "type": "database_id" }, "properties": { "Author": { "id": "qNw_", "multi_select": [ { "color": "default", "id": "833e2c78-35ed-4601-badc-50c323341d76", "name": "Kara Swisher" } ], "type": "multi_select" }, "Link": { "id": "VVMi", "type": "url", "url": "https://www.nytimes.com/2018/10/21/opinion/who-will-teach-silicon-valley-to-be-ethical.html" }, "Name": { "id": "title", "title": [ { "annotations": { "bold": false, "code": false, "color": "default", "italic": false, "strikethrough": false, "underline": false }, "href": null, "plain_text": "Who Will Teach Silicon Valley to Be Ethical? ", "text": { "content": "Who Will Teach Silicon Valley to Be Ethical? ", "link": null }, "type": "text" } ], "type": "title" }, "Publisher": { "id": ">$Pb", "select": { "color": "default", "id": "c5ee409a-f307-4176-99ee-6e424fa89afa", "name": "NYT" }, "type": "select" }, "Publishing/Release Date": { "date": { "end": null, "start": "2018-10-21T00:00:00.000Z" }, "id": "?ex+", "type": "date" }, "Read": { "checkbox": true, "id": "_MWJ", "type": "checkbox" }, "Score /5": { "id": ")Y7\"", "select": { "color": "default", "id": "b7307e35-c80a-4cb5-bb6b-6054523b394a", "name": "⭐️⭐️⭐️⭐️" }, "type": "select" }, "Status": { "id": "`zz5", "select": { "color": "red", "id": "5925ba22-0126-4b58-90c7-b8bbb2c3c895", "name": "Reading" }, "type": "select" }, "Summary": { "id": "?\\25", "rich_text": [ { "annotations": { "bold": false, "code": false, "color": "default", "italic": false, "strikethrough": false, "underline": false }, "href": null, "plain_text": "Some think chief ethics officers could help technology companies navigate political and social questions.", "text": { "content": "Some think chief ethics officers could help technology companies navigate political and social questions.", "link": null }, "type": "text" } ], "type": "rich_text" }, "Type": { "id": "/7eo", "select": { "color": "default", "id": "f96d0d0a-5564-4a20-ab15-5f040d49759e", "name": "Article" }, "type": "select" } } } } }, "schema": { "$ref": "#/components/schemas/PageUpdatedProperties" } } }, "description": "200 Success - Update Page properties", "headers": { "CF-Cache-Status": { "schema": { "example": "DYNAMIC", "type": "string" } }, "CF-RAY": { "schema": { "example": "64e173ce6ca20231-SJC", "type": "string" } }, "Connection": { "schema": { "example": "keep-alive", "type": "string" } }, "Content-Encoding": { "schema": { "example": "gzip", "type": "string" } }, "Content-Security-Policy": { "schema": { "example": "script-src 'self' 'unsafe-inline' 'unsafe-eval' https://gist.github.com https://apis.google.com https://api.amplitude.com https://widget.intercom.io https://js.intercomcdn.com https://logs-01.loggly.com https://cdn.segment.com https://analytics.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com https://embed.typeform.com https://admin.typeform.com https://public.profitwell.com js.sentry-cdn.com https://platform.twitter.com https://cdn.syndication.twimg.com https://www.googletagmanager.com https://x.clearbitjs.com; connect-src 'self' https://msgstore.www.notion.so wss://msgstore.www.notion.so ws://localhost:* https://notion-emojis.s3-us-west-2.amazonaws.com https://s3-us-west-2.amazonaws.com https://s3.us-west-2.amazonaws.com https://notion-production-snapshots-2.s3.us-west-2.amazonaws.com https: http: https://api.amplitude.com https://api.embed.ly https://js.intercomcdn.com https://api-iam.intercom.io wss://nexus-websocket-a.intercom.io https://logs-01.loggly.com https://api.segment.io https://api.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com https://cdn.contentful.com https://preview.contentful.com https://images.ctfassets.net https://www2.profitwell.com https://api.unsplash.com https://boards-api.greenhouse.io; font-src 'self' data: https://cdnjs.cloudflare.com https://js.intercomcdn.com; img-src 'self' data: blob: https: https://platform.twitter.com https://syndication.twitter.com https://pbs.twimg.com https://ton.twimg.com www.googletagmanager.com; style-src 'self' 'unsafe-inline' https://cdnjs.cloudflare.com https://github.githubassets.com https://platform.twitter.com https://ton.twimg.com; frame-src https: http:; media-src https: http:", "type": "string" } }, "Date": { "schema": { "example": "Wed, 12 May 2021 06:04:55 GMT", "type": "string" } }, "ETag": { "schema": { "example": "W/\"7d8-jG4gaWNQPTIf72vp10FvF9p/N3Q\"", "type": "string" } }, "Expect-CT": { "schema": { "example": "max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\"", "type": "string" } }, "Referrer-Policy": { "schema": { "example": "same-origin", "type": "string" } }, "Server": { "schema": { "example": "cloudflare", "type": "string" } }, "Set-Cookie": { "schema": { "example": "notion_browser_id=64874c87-50ce-4a41-af6f-3ecf1626325e; Domain=www.notion.so; Path=/; Expires=Sat, 18 Jan 2053 07:51:35 GMT; Secure", "type": "string" } }, "Strict-Transport-Security": { "schema": { "example": "max-age=5184000; includeSubDomains", "type": "string" } }, "Transfer-Encoding": { "schema": { "example": "chunked", "type": "string" } }, "Vary": { "schema": { "example": "Accept-Encoding", "type": "string" } }, "X-Content-Security-Policy": { "schema": { "example": "script-src 'self' 'unsafe-inline' 'unsafe-eval' https://gist.github.com https://apis.google.com https://api.amplitude.com https://widget.intercom.io https://js.intercomcdn.com https://logs-01.loggly.com https://cdn.segment.com https://analytics.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com https://embed.typeform.com https://admin.typeform.com https://public.profitwell.com js.sentry-cdn.com https://platform.twitter.com https://cdn.syndication.twimg.com https://www.googletagmanager.com https://x.clearbitjs.com; connect-src 'self' https://msgstore.www.notion.so wss://msgstore.www.notion.so ws://localhost:* https://notion-emojis.s3-us-west-2.amazonaws.com https://s3-us-west-2.amazonaws.com https://s3.us-west-2.amazonaws.com https://notion-production-snapshots-2.s3.us-west-2.amazonaws.com https: http: https://api.amplitude.com https://api.embed.ly https://js.intercomcdn.com https://api-iam.intercom.io wss://nexus-websocket-a.intercom.io https://logs-01.loggly.com https://api.segment.io https://api.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com https://cdn.contentful.com https://preview.contentful.com https://images.ctfassets.net https://www2.profitwell.com https://api.unsplash.com https://boards-api.greenhouse.io; font-src 'self' data: https://cdnjs.cloudflare.com https://js.intercomcdn.com; img-src 'self' data: blob: https: https://platform.twitter.com https://syndication.twitter.com https://pbs.twimg.com https://ton.twimg.com www.googletagmanager.com; style-src 'self' 'unsafe-inline' https://cdnjs.cloudflare.com https://github.githubassets.com https://platform.twitter.com https://ton.twimg.com; frame-src https: http:; media-src https: http:", "type": "string" } }, "X-Content-Type-Options": { "schema": { "example": "nosniff", "type": "string" } }, "X-DNS-Prefetch-Control": { "schema": { "example": "off", "type": "string" } }, "X-Download-Options": { "schema": { "example": "noopen", "type": "string" } }, "X-Frame-Options": { "schema": { "example": "SAMEORIGIN", "type": "string" } }, "X-WebKit-CSP": { "schema": { "example": "script-src 'self' 'unsafe-inline' 'unsafe-eval' https://gist.github.com https://apis.google.com https://api.amplitude.com https://widget.intercom.io https://js.intercomcdn.com https://logs-01.loggly.com https://cdn.segment.com https://analytics.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com https://embed.typeform.com https://admin.typeform.com https://public.profitwell.com js.sentry-cdn.com https://platform.twitter.com https://cdn.syndication.twimg.com https://www.googletagmanager.com https://x.clearbitjs.com; connect-src 'self' https://msgstore.www.notion.so wss://msgstore.www.notion.so ws://localhost:* https://notion-emojis.s3-us-west-2.amazonaws.com https://s3-us-west-2.amazonaws.com https://s3.us-west-2.amazonaws.com https://notion-production-snapshots-2.s3.us-west-2.amazonaws.com https: http: https://api.amplitude.com https://api.embed.ly https://js.intercomcdn.com https://api-iam.intercom.io wss://nexus-websocket-a.intercom.io https://logs-01.loggly.com https://api.segment.io https://api.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com https://cdn.contentful.com https://preview.contentful.com https://images.ctfassets.net https://www2.profitwell.com https://api.unsplash.com https://boards-api.greenhouse.io; font-src 'self' data: https://cdnjs.cloudflare.com https://js.intercomcdn.com; img-src 'self' data: blob: https: https://platform.twitter.com https://syndication.twitter.com https://pbs.twimg.com https://ton.twimg.com www.googletagmanager.com; style-src 'self' 'unsafe-inline' https://cdnjs.cloudflare.com https://github.githubassets.com https://platform.twitter.com https://ton.twimg.com; frame-src https: http:; media-src https: http:", "type": "string" } }, "X-XSS-Protection": { "schema": { "example": "1; mode=block", "type": "string" } }, "cf-request-id": { "schema": { "example": "0a00c6b50400000231ecbbc000000001", "type": "string" } } } } }, "summary": "Update Page properties ", "tags": [ "Pages" ] } }, "/v1/users": { "get": { "description": "Returns a paginated list of Users for the workspace", "operationId": "listAllUsers", "parameters": [ { "in": "query", "name": "start_cursor", "required": false, "description": "If supplied, this endpoint will return a page of results starting after the cursor provided. If not supplied, this endpoint will return the first page of results.", "schema": { "type": "string" } }, { "in": "query", "name": "page_size", "required": false, "description": "The number of items from the full list desired in the response. Maximum- 100", "schema": { "type": "integer" } }, { "in": "header", "name": "Notion-Version", "description": "API Version", "schema": { "type": "string", "default": "2021-05-13" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedUsers" } } }, "description": "200 Success - List all users" } }, "summary": "List all users", "tags": [ "Users" ] } }, "/v1/users/{id}": { "get": { "description": "Retrieve a user object using the ID specified in the request path.", "operationId": "retrieveUser", "responses": { "200": { "content": { "application/json": { "examples": { "200 Success - Retrieve a user": { "value": { "avatar_url": null, "id": "6794760a-1f15-45cd-9c65-0dfe42f5135a", "name": "Aman Gupta", "object": "user", "person": { "email": "XXXXXXX@makenotion.com" }, "type": "person" } } }, "schema": { "$ref": "#/components/schemas/User" } } }, "description": "200 Success - Retrieve a user", "headers": { "CF-Cache-Status": { "schema": { "example": "DYNAMIC", "type": "string" } }, "CF-RAY": { "schema": { "example": "646ad4bbeabc1fa1-SJC", "type": "string" } }, "Connection": { "schema": { "example": "keep-alive", "type": "string" } }, "Content-Encoding": { "schema": { "example": "gzip", "type": "string" } }, "Content-Security-Policy": { "schema": { "example": "script-src 'self' 'unsafe-inline' 'unsafe-eval' https://gist.github.com https://apis.google.com https://api.amplitude.com https://widget.intercom.io https://js.intercomcdn.com https://logs-01.loggly.com https://cdn.segment.com https://analytics.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com/v3 https://embed.typeform.com https://admin.typeform.com https://platform.twitter.com https://cdn.syndication.twimg.com https://www.googletagmanager.com https://x.clearbitjs.com; connect-src 'self' https://msgstore.www.notion.so wss://msgstore.www.notion.so ws://localhost:* https://notion-emojis.s3-us-west-2.amazonaws.com https://s3-us-west-2.amazonaws.com https://s3.us-west-2.amazonaws.com https://notion-production-snapshots-2.s3.us-west-2.amazonaws.com https: http: https://api.amplitude.com https://api.embed.ly https://js.intercomcdn.com https://api-iam.intercom.io wss://nexus-websocket-a.intercom.io https://logs-01.loggly.com https://api.segment.io https://api.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com/v3 https://cdn.contentful.com https://preview.contentful.com https://images.ctfassets.net https://api.unsplash.com https://boards-api.greenhouse.io; font-src 'self' data: https://cdnjs.cloudflare.com https://js.intercomcdn.com; img-src 'self' data: blob: https: https://platform.twitter.com https://syndication.twitter.com https://pbs.twimg.com https://ton.twimg.com www.googletagmanager.com; style-src 'self' 'unsafe-inline' https://cdnjs.cloudflare.com https://github.githubassets.com https://platform.twitter.com https://ton.twimg.com; frame-src https: http:; media-src https: http:", "type": "string" } }, "Date": { "schema": { "example": "Tue, 27 Apr 2021 20:34:20 GMT", "type": "string" } }, "ETag": { "schema": { "example": "W/\"9b-qoibMBKquYk09T0oogqvLGu9qu4\"", "type": "string" } }, "Expect-CT": { "schema": { "example": "max-age=604800, report-uri=\"https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct\"", "type": "string" } }, "Referrer-Policy": { "schema": { "example": "same-origin", "type": "string" } }, "Server": { "schema": { "example": "cloudflare", "type": "string" } }, "Set-Cookie": { "schema": { "example": "notion_browser_id=f50d0c06-4f74-4a3d-8e10-c0a2e9bd1cd2; Domain=www.notion.so; Path=/; Expires=Fri, 03 Jan 2053 22:21:00 GMT; Secure", "type": "string" } }, "Strict-Transport-Security": { "schema": { "example": "max-age=5184000; includeSubDomains", "type": "string" } }, "Transfer-Encoding": { "schema": { "example": "chunked", "type": "string" } }, "Vary": { "schema": { "example": "Accept-Encoding", "type": "string" } }, "X-Content-Security-Policy": { "schema": { "example": "script-src 'self' 'unsafe-inline' 'unsafe-eval' https://gist.github.com https://apis.google.com https://api.amplitude.com https://widget.intercom.io https://js.intercomcdn.com https://logs-01.loggly.com https://cdn.segment.com https://analytics.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com/v3 https://embed.typeform.com https://admin.typeform.com https://platform.twitter.com https://cdn.syndication.twimg.com https://www.googletagmanager.com https://x.clearbitjs.com; connect-src 'self' https://msgstore.www.notion.so wss://msgstore.www.notion.so ws://localhost:* https://notion-emojis.s3-us-west-2.amazonaws.com https://s3-us-west-2.amazonaws.com https://s3.us-west-2.amazonaws.com https://notion-production-snapshots-2.s3.us-west-2.amazonaws.com https: http: https://api.amplitude.com https://api.embed.ly https://js.intercomcdn.com https://api-iam.intercom.io wss://nexus-websocket-a.intercom.io https://logs-01.loggly.com https://api.segment.io https://api.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com/v3 https://cdn.contentful.com https://preview.contentful.com https://images.ctfassets.net https://api.unsplash.com https://boards-api.greenhouse.io; font-src 'self' data: https://cdnjs.cloudflare.com https://js.intercomcdn.com; img-src 'self' data: blob: https: https://platform.twitter.com https://syndication.twitter.com https://pbs.twimg.com https://ton.twimg.com www.googletagmanager.com; style-src 'self' 'unsafe-inline' https://cdnjs.cloudflare.com https://github.githubassets.com https://platform.twitter.com https://ton.twimg.com; frame-src https: http:; media-src https: http:", "type": "string" } }, "X-Content-Type-Options": { "schema": { "example": "nosniff", "type": "string" } }, "X-DNS-Prefetch-Control": { "schema": { "example": "off", "type": "string" } }, "X-Download-Options": { "schema": { "example": "noopen", "type": "string" } }, "X-Frame-Options": { "schema": { "example": "SAMEORIGIN", "type": "string" } }, "X-WebKit-CSP": { "schema": { "example": "script-src 'self' 'unsafe-inline' 'unsafe-eval' https://gist.github.com https://apis.google.com https://api.amplitude.com https://widget.intercom.io https://js.intercomcdn.com https://logs-01.loggly.com https://cdn.segment.com https://analytics.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com/v3 https://embed.typeform.com https://admin.typeform.com https://platform.twitter.com https://cdn.syndication.twimg.com https://www.googletagmanager.com https://x.clearbitjs.com; connect-src 'self' https://msgstore.www.notion.so wss://msgstore.www.notion.so ws://localhost:* https://notion-emojis.s3-us-west-2.amazonaws.com https://s3-us-west-2.amazonaws.com https://s3.us-west-2.amazonaws.com https://notion-production-snapshots-2.s3.us-west-2.amazonaws.com https: http: https://api.amplitude.com https://api.embed.ly https://js.intercomcdn.com https://api-iam.intercom.io wss://nexus-websocket-a.intercom.io https://logs-01.loggly.com https://api.segment.io https://api.pgncs.notion.so https://checkout.stripe.com https://js.stripe.com/v3 https://cdn.contentful.com https://preview.contentful.com https://images.ctfassets.net https://api.unsplash.com https://boards-api.greenhouse.io; font-src 'self' data: https://cdnjs.cloudflare.com https://js.intercomcdn.com; img-src 'self' data: blob: https: https://platform.twitter.com https://syndication.twitter.com https://pbs.twimg.com https://ton.twimg.com www.googletagmanager.com; style-src 'self' 'unsafe-inline' https://cdnjs.cloudflare.com https://github.githubassets.com https://platform.twitter.com https://ton.twimg.com; frame-src https: http:; media-src https: http:", "type": "string" } }, "X-XSS-Protection": { "schema": { "example": "1; mode=block", "type": "string" } }, "cf-request-id": { "schema": { "example": "09b6a3497100001fa1b8a29000000001", "type": "string" } } } } }, "summary": "Retrieve a user", "tags": [ "Users" ] }, "parameters": [ { "in": "path", "name": "id", "required": true, "description": "User ID", "schema": { "example": "", "type": "string" } }, { "in": "header", "name": "Notion-Version", "description": "API Version", "schema": { "example": "", "type": "string", "default": "2021-05-13" } } ] }, "/v1/search": { "post": { "description": "Searches all pages and child pages that are shared with the integration and the results may include databases", "operationId": "searchPages", "summary": "Searches all pages and child pages", "parameters": [ { "in": "header", "name": "Notion-Version", "description": "API Version", "schema": { "type": "string", "default": "2021-05-13" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "200 Success - List all user" } } } } }, "components": { "securitySchemes": { "BearerToken": { "type": "http", "scheme": "bearer" } }, "schemas": { "SearchBody": { "description": "Search request body parameters", "properties": { "query": { "type": "string", "description": "When supplied, limits which pages are returned by comparing the query to the page title" }, "sort": { "$ref": "#/components/schemas/Sorting" }, "filter": { "$ref": "#/components/schemas/Filtering" }, "start_cursor": { "type": "string", "description": "If supplied, this endpoint will return a page of results starting after the cursor provided or else this endpoint will return the first page of results" }, "page_size": { "type": "integer", "description": "The number of items from the full list desired in the response. Maximum- 100" } } }, "Sorting": { "description": "When supplied, sorts the results based on the provided criteria", "properties": { "direction": { "description": "The direction to sort. Possible values include ascending and descending", "type": "string" }, "timestamp": { "description": "The name of the timestamp to sort against. Possible values include last_edited_time", "type": "string" } } }, "Filtering": { "description": "When supplied, filters the results based on the provided criteria", "properties": { "value": { "description": "The value of the property to filter the results by and Possible values for object type include page or database", "type": "string" }, "property": { "description": "The name of the property to filter by.", "type": "string" } } }, "PaginatedUsers": { "description": "The response body for users list", "properties": { "results": { "description": "Array of Users", "type": "array", "items": { "$ref": "#/components/schemas/User" } }, "next_cursor": { "type": "string", "nullable": true, "description": "Next curser position of the user list" }, "has_more": { "type": "boolean", "description": "Indicates whether there are more user records or not" } } }, "PageUpdateRequestBody": { "description": "The request body for page update", "properties": { "children": { "description": "Children pages", "items": { "description": "page items", "properties": { "heading_2": { "description": "Page heading", "properties": { "text": { "description": "Page text", "items": { "description": "Page text items", "properties": { "text": { "description": "Text value", "properties": { "content": { "description": "Text content", "example": "Lacinato kale", "type": "string" } }, "type": "object" }, "type": { "description": "The type of the object", "example": "text", "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "object": { "description": "The page object \"block\"", "example": "block", "type": "string" }, "type": { "description": "The type of the object", "example": "heading_2", "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "PaginatedDatabases": { "description": "The response body for users list", "properties": { "results": { "description": "Array of Users", "type": "array", "items": { "$ref": "#/components/schemas/Database" } }, "next_cursor": { "type": "string", "nullable": true, "description": "Next curser position of the user list" }, "has_more": { "type": "boolean", "description": "Indicates whether there are more user records or not" } } }, "ObjectProperties": { "description": "Object Properties", "properties": { "Author": { "description": "Author of the database", "properties": { "id": { "description": "Author ID", "example": "qNw_", "type": "string" }, "multi_select": { "description": "multi_select values", "properties": { "options": { "description": "The multi_select option", "items": { "description": "The option items", "properties": { "color": { "description": "Color of the database", "example": "default", "type": "string" }, "id": { "description": "ID of the database", "example": "15592971-7b30-43d5-9406-2eb69b13fcae", "type": "string" }, "name": { "description": "Name of the Database", "example": "Spencer Greenberg", "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "type": { "description": "The type of the object", "example": "multi_select", "type": "string" } }, "type": "object" }, "Link": { "description": "Related links", "properties": { "id": { "description": "Link ID", "example": "VVMi", "type": "string" }, "type": { "description": "Link type", "example": "url", "type": "string" }, "url": { "description": "URL", "properties": {}, "type": "object" } }, "type": "object" }, "Name": { "description": "The name of the object", "properties": { "id": { "description": "Name ID", "example": "title", "type": "string" }, "title": { "description": "tilte", "properties": {}, "type": "object" }, "type": { "description": "title Type", "example": "title", "type": "string" } }, "type": "object" }, "Publisher": { "description": "Publisher Detail", "properties": { "id": { "description": "Publisher ID", "example": ">$Pb", "type": "string" }, "select": { "description": "Select details of publisher", "properties": { "options": { "description": "The set of options", "items": { "description": "The set of items in options", "properties": { "color": { "description": "The color", "example": "default", "type": "string" }, "id": { "description": "The ID of the option", "example": "c5ee409a-f307-4176-99ee-6e424fa89afa", "type": "string" }, "name": { "description": "The name of the option", "example": "NYT", "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "type": { "description": "The type of the object", "example": "select", "type": "string" } }, "type": "object" }, "Publishing/Release Date": { "description": "Publishing/Releasing Date", "properties": { "date": { "description": "The date of publishing/release", "properties": {}, "type": "object" }, "id": { "description": "ID of date", "example": "?ex+", "type": "string" }, "type": { "description": "Type of the object", "example": "date", "type": "string" } }, "type": "object" }, "Read": { "description": "Read details", "properties": { "checkbox": { "description": "checkbox details", "properties": {}, "type": "object" }, "id": { "description": "ID of the checkbox", "example": "_MWJ", "type": "string" }, "type": { "description": "The object type", "example": "checkbox", "type": "string" } }, "type": "object" }, "Status": { "description": "The status ID", "properties": { "id": { "description": "The ID of the status", "example": "`zz5", "type": "string" }, "select": { "description": "Select details of publisher", "properties": { "options": { "description": "The set of options", "items": { "description": "The set of items in options", "properties": { "color": { "description": "The color", "example": "default", "type": "string" }, "id": { "description": "The ID of the option", "example": "c5ee409a-f307-4176-99ee-6e424fa89afa", "type": "string" }, "name": { "description": "The name of the option", "example": "NYT", "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "type": { "description": "The object type", "example": "select", "type": "string" } }, "type": "object" }, "Summary": { "description": "The summary of the database", "properties": { "id": { "description": "The ID of the summary", "example": "?\\25", "type": "string" }, "text": { "description": "The summary content", "properties": {}, "type": "object" }, "type": { "description": "The type of the object", "example": "text", "type": "string" } }, "type": "object" }, "Type": { "description": "The database type details", "properties": { "id": { "description": "The type ID", "example": "/7eo", "type": "string" }, "select": { "description": "Select details of publisher", "properties": { "options": { "description": "The set of options", "items": { "description": "The set of items in options", "properties": { "color": { "description": "The color", "example": "default", "type": "string" }, "id": { "description": "The ID of the option", "example": "c5ee409a-f307-4176-99ee-6e424fa89afa", "type": "string" }, "name": { "description": "The name of the option", "example": "NYT", "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "type": { "description": "The object type", "example": "select", "type": "string" } }, "type": "object" } }, "type": "object" }, "ResultDetails": { "description": "Result Details", "properties": { "created_time": { "description": "The created date/time", "example": "2021-04-27T20:38:19.437Z", "type": "string" }, "has_children": { "description": "Indicates whether it has child object or not", "example": false, "type": "boolean" }, "id": { "description": "Object ID", "example": "48c1ffb5-2789-4025-937b-2c35eaaaab3f", "type": "string" }, "last_edited_time": { "description": "The last date/time", "example": "2021-04-27T20:38:19.437Z", "type": "string" }, "object": { "description": "Object Category", "example": "block", "type": "string" }, "type": { "example": "unsupported", "type": "string", "description": "object type" }, "unsupported": { "properties": {}, "type": "object", "description": "Unsupported" } }, "type": "object" }, "BlockChildrenResponse": { "description": "The response for block children", "properties": { "has_more": { "description": "Indicates whether it has more objects or not", "example": false, "type": "boolean" }, "next_cursor": { "description": "Incidates the position of the response list", "example": null, "nullable": true }, "object": { "description": "The response object", "example": "list", "type": "string" }, "results": { "description": "The array of result details", "items": { "$ref": "#/components/schemas/ResultDetails" }, "type": "array" } }, "type": "object" }, "ChildBlockContent": { "description": "Child block details", "properties": { "child_page": { "description": "Child page", "properties": { "title": { "description": "Title of the page", "example": "Who Will Teach Silicon Valley to Be Ethical? ", "type": "string" } }, "type": "object" }, "created_time": { "description": "The created date/time", "example": "2021-04-27T20:38:19.437Z", "type": "string" }, "has_children": { "description": "Indicates whether it has children blocks", "example": true, "type": "boolean" }, "id": { "description": "ID of the block", "example": "a1712d54-53e4-4893-a69d-4d581cd2c845", "type": "string" }, "last_edited_time": { "description": "The last edited date/time", "example": "2021-05-12T06:07:37.724Z", "type": "string" }, "object": { "description": "Always \"block\" for block types", "example": "block", "type": "string" }, "type": { "description": "Type of the block. Possible values include \"paragraph\", \"heading_1\", \"heading_2\", \"heading_3\", \"bulleted_list_item\" etc.", "example": "child_page", "type": "string" } }, "type": "object" }, "Database": { "description": "The database object", "properties": { "created_time": { "description": "The created date/time", "example": "2021-04-27T20:38:19.437Z", "type": "string" }, "id": { "description": "Database ID", "example": "8e2c2b76-9e1d-47d2-87b9-ed3035d607ae", "type": "string" }, "last_edited_time": { "description": "The last edited date/time", "example": "2021-04-27T21:15:00.000Z", "type": "string" }, "object": { "description": "Object type \"database\"", "example": "database", "type": "string" }, "properties": { "$ref": "#/components/schemas/ObjectProperties" }, "title": { "description": "Title of the database", "items": { "description": "The item sets", "properties": { "annotations": { "description": "The annotation", "properties": { "bold": { "description": "Indicates whether the title is bold or not", "example": false, "type": "boolean" }, "code": { "description": "Indicates whether the title is code or not", "example": false, "type": "boolean" }, "color": { "description": "Indicates whether the title is color or not", "example": "default", "type": "string" }, "italic": { "description": "Indicates whether the title is italic or not", "example": false, "type": "boolean" }, "strikethrough": { "description": "Indicates whether the title is strikethrough or not", "example": false, "type": "boolean" }, "underline": { "description": "Indicates whether the title is underline or not", "example": false, "type": "boolean" } }, "type": "object" }, "href": { "description": "HyperLink", "example": null, "nullable": true }, "plain_text": { "description": "Plain text", "example": "Media", "type": "string" }, "text": { "description": "The text detail", "properties": { "content": { "description": "The text content", "example": "Media", "type": "string" }, "link": { "description": "The link to the text", "example": null, "nullable": true } }, "type": "object" }, "type": { "description": "The type of the object", "example": "text", "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "DatabaseContent": { "description": "Database content", "properties": { "filter": { "description": "Filter detail", "properties": { "or": { "description": "The filter set", "items": { "description": "The filter item", "properties": { "property": { "description": "The filter property", "example": "Status", "type": "string" }, "select": { "description": "The select details", "properties": { "equals": { "description": "The equals values", "example": "Reading", "type": "string" } }, "type": "object" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "sorts": { "description": "Sorting details", "items": { "description": "Sort items", "properties": { "direction": { "description": "The sort direction", "example": "ascending", "type": "string" }, "property": { "description": "The sort property", "example": "Score /5", "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "DatabaseResponse": { "description": "Database response content", "properties": { "has_more": { "description": "Indicates whether has more objects", "example": false, "type": "boolean" }, "next_cursor": { "description": "The next position of the result", "example": null, "nullable": true }, "object": { "description": "Object Type \"list\"", "example": "list", "type": "string" }, "results": { "description": "Database results", "items": { "description": "The databases", "properties": { "archived": { "description": "Indicates whether the database is archived or not", "example": false, "type": "boolean" }, "created_time": { "description": "Indicates whether the database is archived or not", "example": "2021-04-27T20:38:19.437Z", "type": "string" }, "id": { "description": "The ID of the database", "example": "557ef501-bfdb-4586-918e-4434f31bca8c", "type": "string" }, "last_edited_time": { "description": "The last edited time", "example": "2021-04-27T20:38:19.437Z", "type": "string" }, "object": { "description": "The object type \"page\"", "example": "page", "type": "string" }, "parent": { "description": "The parent database", "properties": { "database_id": { "description": "Database ID", "example": "8e2c2b76-9e1d-47d2-87b9-ed3035d607ae", "type": "string" }, "type": { "description": "The type of object", "example": "database_id", "type": "string" } }, "type": "object" }, "properties": { "$ref": "#/components/schemas/ObjectProperties" } } }, "type": "array" } }, "type": "object" }, "PageResponse": { "description": "Page Details", "properties": { "archived": { "description": "Indicates whether it is archived or not", "example": false, "type": "boolean" }, "created_time": { "description": "The created date/time", "example": "2021-04-27T20:38:19.437Z", "type": "string" }, "id": { "description": "ID of the page", "example": "a1712d54-53e4-4893-a69d-4d581cd2c845", "type": "string" }, "last_edited_time": { "description": "The last edited date/time", "example": "2021-04-27T20:38:19.437Z", "type": "string" }, "object": { "description": "The object type \"page\"", "example": "page", "type": "string" }, "parent": { "description": "Parent Page", "properties": { "database_id": { "description": "Database ID", "example": "8e2c2b76-9e1d-47d2-87b9-ed3035d607ae", "type": "string" }, "type": { "description": "The type of the object", "example": "database_id", "type": "string" } }, "type": "object" }, "properties": { "$ref": "#/components/schemas/ObjectProperties" } }, "type": "object" }, "PageContent": { "description": "Page content", "properties": { "properties": { "description": "Page properties", "properties": { "Status": { "description": "Status properties", "properties": { "select": { "description": "Select properties", "properties": { "name": { "description": "page content name", "example": "Reading", "type": "string" } }, "type": "object" } }, "type": "object" } }, "type": "object" } }, "type": "object" }, "PageUpdatedProperties": { "description": "The page content after update", "properties": { "archived": { "description": "Indicates whether it is archived or not", "example": false, "type": "boolean" }, "created_time": { "description": "The created date/time", "example": "2021-04-27T20:38:19.437Z", "type": "string" }, "id": { "description": "The ID of the Page", "example": "a1712d54-53e4-4893-a69d-4d581cd2c845", "type": "string" }, "last_edited_time": { "description": "The last edited date/time", "example": "2021-04-28T23:12:53.160Z", "type": "string" }, "object": { "description": "The object type \"page\"", "example": "page", "type": "string" }, "properties": { "$ref": "#/components/schemas/ObjectProperties" } }, "type": "object" }, "User": { "description": "User detail", "properties": { "avatar_url": { "description": "avatar URL", "example": null, "nullable": true }, "id": { "description": "User ID", "example": "6794760a-1f15-45cd-9c65-0dfe42f5135a", "type": "string" }, "name": { "description": "Name of the User", "example": "Aman Gupta", "type": "string" }, "object": { "description": "The object type User", "example": "user", "type": "string" }, "person": { "description": "The contact detail", "properties": { "email": { "description": "Email address", "example": "XXXXXXX@makenotion.com", "type": "string" } }, "type": "object" }, "type": { "description": "The object type", "example": "person", "type": "string" } }, "type": "object" }, "PageProperties": { "description": "Page properties", "properties": { "name": { "description": "The ID of the property", "type": "string" }, "type": { "type": "string", "description": "Type of the property" } }, "type": "object" }, "DatabaseTitle": { "description": "Page properties", "properties": { "plain_text": { "description": "The plain text without annotations", "type": "string" }, "href": { "description": "The URL of any link or internal Notion mention in this text, if any", "type": "string" }, "type": { "type": "string", "description": "Type of this rich text object. Possible values are- \"text\", \"mention\", \"equation\"" }, "annotation": { "$ref": "#/components/schemas/Annotations" } }, "type": "object" }, "Annotations": { "description": "Style information which applies to the whole rich text object", "properties": { "bold": { "type": "boolean", "description": "Whether the text is bolded" }, "italic": { "type": "boolean", "description": "Whether the text is italic" }, "strikethrough": { "type": "boolean", "description": "Whether the text is struck through" }, "underline": { "type": "boolean", "description": "Whether the text is underlined" }, "code": { "type": "boolean", "description": "Whether the text is \"code style\"" }, "color": { "type": "string", "description": "Color of the text. Possible values are- \"default\", \"gray\", \"brown\", \"orange\", \"yellow\", \"green\", \"blue\", \"purple\", \"pink\", \"red\", \"gray_background\", \"brown_background\", \"orange_background\", \"yellow_background\", \"green_background\", \"blue_background\", \"purple_background\", \"pink_background\", \"red_background\"" } } }, "PageParent": { "description": "Parent Page Detail", "properties": { "database_id": { "description": "Database ID", "type": "string" } }, "type": "object" }, "DatabaseParent": { "description": "Parent Page Detail", "properties": { "page_id": { "description": "Database ID", "type": "string" } }, "type": "object" }, "PageChildren": { "description": "Page content for the new page", "type": "array", "items": { "type": "object", "description": "Page content for the new pag", "properties": { "object": { "description": "Always \"block\"", "type": "string", "default": "block" }, "type": { "description": "Type of block", "type": "string" }, "paragraph": { "$ref": "#/components/schemas/blockContent" }, "heading_1": { "$ref": "#/components/schemas/blockContent" }, "heading_2": { "$ref": "#/components/schemas/blockContent" }, "heading_3": { "$ref": "#/components/schemas/blockContent" }, "bulleted_list_item": { "$ref": "#/components/schemas/blockContent" }, "numbered_list_item": { "$ref": "#/components/schemas/blockContent" }, "to_do": { "$ref": "#/components/schemas/blockContent" }, "child_page": { "$ref": "#/components/schemas/blockContent" } } } }, "PageBodyParams": { "description": "PageDetail", "properties": { "properties": { "$ref": "#/components/schemas/PageProperties" }, "parent": { "$ref": "#/components/schemas/PageParent" }, "children": { "$ref": "#/components/schemas/PageChildren" } } }, "DatabaseBodyParams": { "description": "DatabaseDetails", "properties": { "properties": { "description": "Property schema of database", "$ref": "#/components/schemas/DatabaseProperties" }, "parent": { "description": "A page parent", "$ref": "#/components/schemas/DatabaseParent" }, "title": { "description": "Property schema of database", "type": "array", "items": { "$ref": "#/components/schemas/DatabaseTitle" } } } }, "DatabaseProperties": { "description": "Property schema of database. The keys are the names of properties as they appear in Notion and the values are property schema objects", "properties": { "title": { "type": "string", "description": "Each database must have exactly one database property schema object of type \"title\". This database property controls the title that appears at the top of the page when the page is opened." }, "rich_text": { "type": "string", "description": "Text database property schema objects" }, "number": { "description": "Number database property schema object", "type": "object", "properties": { "format": { "description": "How the number is displayed in Notion. Potential values include- number, number_with_commas, percent, dollar, euro, pound, yen, ruble, rupee, won, yuan", "type": "string" } } }, "select": { "description": "Select database property schema object", "$ref": "#/components/schemas/SelectOptions" }, "multi_select": { "type": "array", "description": "Multi-select database property schema object", "items": { "$ref": "#/components/schemas/SelectOptions" } }, "date": { "type": "string", "description": "Date database property schema" }, "people": { "type": "string", "description": "People database property schema" }, "files": { "type": "string", "description": "File database property schema object" }, "checkbox": { "type": "string", "description": "Checkbox database property schema object" }, "url": { "type": "string", "description": "URL database property schema object" }, "email": { "type": "string", "description": "Email database property schema object" }, "phone_number": { "type": "string", "description": "Phone number database property schema object" }, "last_edited_time": { "type": "string", "description": "Last edited time database property schema object" }, "last_edited_by": { "type": "string", "description": "Last edited by database property schema object" }, "created_time": { "type": "string", "description": "Created time database property schema object" }, "created_by": { "type": "string", "description": "Created by database property schema object" } } }, "SelectOptions": { "description": "Select option", "type": "object", "properties": { "name": { "type": "string", "description": "Name of the option as it appears in Notion" }, "color": { "type": "string", "description": "Color of the option. Possible values include- default, gray, brown, orange, yellow, green, blue, purple, pink, red" } } }, "blockContent": { "description": "Block content", "type": "object", "properties": { "text": { "description": "block objects", "type": "array", "items": { "type": "object", "properties": { "text": { "description": "block objects", "type": "array", "items": { "$ref": "#/components/schemas/blockContent" } }, "children": { "description": "Any nested children blocks", "type": "array", "items": { "$ref": "#/components/schemas/blockContent" } }, "checked": { "description": "Whether the to_do is checked or not", "type": "boolean" }, "content": { "description": "Content of a block element", "type": "string" } } } } } } } } }