NotionNotion 协作工作区 API
GET/v1/async_tasks/{task_id}
查询异步任务
返回异步任务的状态、错误与结果。
通过官方版本化 Notion API 管理页面、块、数据源/数据库、评论、文件上传、视图、用户与搜索，并支持 OAuth 与异步任务。完整边界为官方 OpenAPI 快照中的 49 个 Endpoint；工作区数据为私有用户内容，Pontx 不代理、缓存或聚合，调用方使用本地 SDK/CLI 直连。
请求
- operationId
retrieveAsyncTask- 服务器
https://api.notion.com- 认证
- bearerAuth, basicAuth
请求参数
task_id
pathstring必填
异步任务 ID。
0ab51e95-9373-4d42-97f8-1b5b0a5c0b52
Notion-Version
headerstring必填
请求使用的 API 版本日期；当前最新版本为 2026-03-11。
2026-03-11
响应
200
stringapplication/json
请求成功。
400
error_api_400application/json
请求参数无效。
401
error_api_401application/json
未认证或令牌无效。
403
error_api_403application/json
无权限访问该资源。
404
error_api_404application/json
未找到指定资源。
406
error_api_406application/json
请求无法按要求表示。
409
error_api_409application/json
请求与资源当前状态冲突。
429
error_api_429application/json
请求频率超限，请遵循 Retry-After 后重试。
500
error_api_500application/json
上游服务内部错误。
503
error_api_503application/json
上游服务暂时不可用。
504
error_api_504application/json
上游网关超时。
529
error_api_529application/json
上游服务过载，请按 429 相同方式重试。