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}
Pages
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
id
string 
required
Body Params application/json
properties
object 
optional
Status
object 
optional
Examples

Responses

🟢200200 Success - Update Page properties
application/json
Body
archived
boolean 
optional
Example:
false
created_time
string 
optional
Example:
2021-04-27T20:38:19.437Z
id
string 
optional
Example:
a1712d54-53e4-4893-a69d-4d581cd2c845
last_edited_time
string 
optional
Example:
2021-04-28T23:12:53.160Z
object
string 
optional
Example:
page
parent
object 
optional
database_id
string 
optional
Example:
8e2c2b76-9e1d-47d2-87b9-ed3035d607ae
type
string 
optional
Example:
database_id
properties
object 
optional
Author
object 
optional
Link
object 
optional
Name
object 
optional
Publisher
object 
optional
Publishing/Release Date
object 
optional
Read
object 
optional
Score /5
object 
optional
Status
object 
optional
Summary
object 
optional
Type
object 
optional
Modified at 2023-04-27 10:02:23
Previous
Retrieve a Page
Next
List all users
Built with