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

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
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
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"
        }
    }
}
Modified at 2023-04-28 09:36:15
Previous
Retrieve a Page
Next
Retrieve a page property item
Built with