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
      • Create a page
      • Retrieve a Page
      • Update Page properties
    • 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
        GET
      • Update Page properties
        PATCH
      • Retrieve a page property item
        GET
      • Create a page
        POST
    • 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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
curl --location --request PATCH '/v1/pages/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "properties": {
        "Status": {
            "select": {
                "name": "Reading"
            }
        }
    }
}'
Response Response Example
200 - 200 Success - Update Page properties
{
    "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

🟠400Bad Request-Update page properties
🟠400Bad Request-Update page properties
🟠404Record Not Found
🟠429Result-Update page properties
Modified at over 2 years ago
Previous
Retrieve a Page
Next
Retrieve a page property item
Built with