NotionNotion collaborative workspace API
POST/v1/views/{view_id}/queries
Create a view query
Creates a view query and returns the first page of results.
Manage pages, blocks, data sources/databases, comments, file uploads, views, users, and search through the official versioned Notion API, with OAuth and async tasks. The complete boundary is the 49 endpoints in the official OpenAPI snapshot; workspace data is private user content, so Pontx does not proxy, cache, or aggregate it and callers use the local SDK/CLI directly.
Request
- operationId
createViewQuery- Server
https://api.notion.com- Authentication
- bearerAuth, basicAuth
Request parameters
view_id
pathidRequestrequired
Notion-Version
headerstringrequired
API version date for the request; the current latest version is 2026-03-11.
2026-03-11
Request body
createViewQueryRequestrequired
Properties: page_size
Responses
200
viewQueryResponseapplication/json
Request succeeded.
Properties: expires_athas_moreidnext_cursorobjectrequest_statusresultstotal_countview_id
400
error_api_400application/json
Request parameters are invalid.
401
error_api_401application/json
Unauthenticated or the token is invalid.
403
error_api_403application/json
Access to the resource is forbidden.
404
error_api_404application/json
The requested resource was not found.
406
error_api_406application/json
The request cannot be represented as requested.
409
error_api_409application/json
The request conflicts with the current state of the resource.
429
error_api_429application/json
Rate limited; retry after Retry-After.
500
error_api_500application/json
Upstream internal error.
503
error_api_503application/json
Upstream service temporarily unavailable.
504
error_api_504application/json
Upstream gateway timeout.
529
error_api_529application/json
Upstream overloaded; retry like a 429.
{
"expires_at": "2026-03-11T00:00:00.000Z",
"has_more": true,
"id": "0ab51e95-9373-4d42-97f8-1b5b0a5c0b52",
"object": "view_query",
"request_status": {
"incomplete_reason": "query_result_limit_reached",
"type": "complete"
},
"results": {
"id": "0ab51e95-9373-4d42-97f8-1b5b0a5c0b52",
"object": "example content"
},
"total_count": 1
}