Notion API - Public Beta (English)
  1. Pages
Notion API - Public Beta (English)
  • Introduction
  • Integration capabilities
  • Request limits
  • Status codes
  • ENDPOINTS
    • Authentication
      • Authentication
      • Token
    • Blocks
      • Delete a block
      • Append block children
      • Retrieve a block
      • Update a block
      • Retrieve block children
    • Databases
      • Filter database entries
      • Sort database entries
      • Update database properties
      • Retrieve a database
      • Update a database
      • Query a database
    • Pages
      • Archive a page
      • Retrieve a page property item
        GET
      • Create a page
        POST
      • Retrieve a Page
        GET
      • Update Page properties
        PATCH
    • Users
      • List all users
      • Retrieve your token's bot user
      • Retrieve a user
    • Comments
      • Create comment
      • Retrieve comments
    • Search
      • Search optimizations and limitations
      • Search by title
  • OBJECTS
    • Block
    • Comment
    • Unfurl attribute object for Link Previews
    • Page
      • Page
      • Page properties
    • Database
      • Database
      • Database properties
    • User
      • User
      • Comment
    • Other
      • Emoji object
      • File object
      • Parent object
      • Rich text object
  • Versioning
    • Versioning
    • Changes by version
  • ENDPOINTS Copy
    • Authentication
      • Authentication
      • Token
    • Blocks
      • Retrieve a block
      • Update a block
      • Retrieve block children
      • Delete a block
      • Append block children
    • Databases
      • Filter database entries
      • Sort database entries
      • Update database properties
      • Retrieve a database
      • Update a database
      • Query a database
      • Create a database
    • Pages
      • Archive a page
      • Retrieve a Page
      • Update Page properties
      • Retrieve a page property item
      • Create a page
    • Users
      • Retrieve a user
      • List all users
      • Retrieve your token's bot user
    • Comments
      • Create comment
      • Retrieve comments
  1. Pages

Update Page properties

PATCH
/v1/pages/{id}
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.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PATCH '/v1/pages/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "properties": {
        "Status": {
            "select": {
                "name": "Reading"
            }
        }
    }
}'
Response Response Example
{
    "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-21"
            },
            "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"
        }
    }
}

Request

Path Params

Body Params application/json

Examples

Responses

🟢200200 Success - Update Page properties
application/json
Body

Modified at 2023-04-27 10:02:23
Previous
Retrieve a Page
Next
List all users
Built with