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
id
string
required
Body Params application/json
properties
object
optional
Status
object
optional
Example
{
"properties": {
"Status": {
"select": {
"name": "Reading"
}
}
}
}
Request samples
Responses
200 Success - Update Page properties(200)
200 Success - Update Page properties
HTTP Code: 200
Content Type : JSONapplication/json
Data Schema
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
Example200 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"
}
}
}
Last modified: 2 years ago