Skip to content

Notion: Retrieve an async task

Notion asyncTasks.retrieveAsyncTask: arguments, response, policy and SDK examples.

← Async tasks operations · Get started

Operation notion.retrieve_async_task

Provider route: GET /v1/async_tasks/{task_id}. Alter supplies the connection’s credentials and routing.

Install @alter-ai/sdk @alter-ai/notion with npm, or alter-sdk-notion with pip. Supply your connected customer’s grant ID and the arguments described below.

import { App } from "@alter-ai/sdk";
import { NotionIntegration } from "@alter-ai/notion";
async function execute(input: Parameters<NotionIntegration["asyncTasks"]["retrieveAsyncTask"]>[0]) {
const app = new App({ apiKey: process.env.ALTER_API_KEY! });
try {
const provider = new NotionIntegration(app, { grantId: process.env.PROVIDER_GRANT_ID! });
const call = await provider.asyncTasks.retrieveAsyncTask(input);
const result = await call.wait();
return result.bodyJson();
} finally {
await app.close();
}
}
import os
from alter_sdk import App
from alter_sdk_notion import NotionIntegration
async def execute(arguments):
async with App(api_key=os.environ["ALTER_API_KEY"]) as app:
provider = NotionIntegration(app, {"grant_id": os.environ["PROVIDER_GRANT_ID"]})
call = await provider.async_tasks.retrieve_async_task(arguments)
result = await call.wait()
return result.body_json()
FieldTypePresenceDescription and constraints
$objectRootAdditional keys: not allowed
pathobjectRequired within parentAdditional keys: not allowed
path.task_idstringRequired within parentThe ID of the async task to retrieve.
Minimum length: 1

Response media type: application/json. The table describes the pinned successful response. Referenced models link to their complete fields.

FieldTypePresenceDescription and constraints
$JSONRoot
$ (anyOf 1)ModelAlternativeExpand Retrieve an async task — response body — object async_task, status: queued, running, retrying
$ (anyOf 2)objectAlternativeAdditional keys: allowed
$ (anyOf 2).created_timestringRequired within parentFormat: date-time
$ (anyOf 2).idstringRequired within parentMinimum length: 1
$ (anyOf 2).objectstringRequired within parentMust equal: async_task
$ (anyOf 2).operationobjectRequired within parentAdditional keys: allowed
$ (anyOf 2).operation.namestringRequired within parentMinimum length: 1
$ (anyOf 2).operation.surfacestringRequired within parentKnown values: rest, mcp
$ (anyOf 2).resultobjectRequired within parentAdditional keys: see wildcard field
$ (anyOf 2).result.*ModelAdditional keysExpand Retrieve an async task — response body — object async task, status succeeded result value
$ (anyOf 2).statusstringRequired within parentMust equal: succeeded
$ (anyOf 2).status_urlstringRequired within parentMinimum length: 1
$ (anyOf 3)objectAlternativeAdditional keys: allowed
$ (anyOf 3).created_timestringRequired within parentFormat: date-time
$ (anyOf 3).errorJSONRequired within parent
$ (anyOf 3).error (anyOf 1)objectAlternativeAdditional keys: allowed
$ (anyOf 3).error (anyOf 1).additional_dataobjectOptionalAdditional keys: see wildcard field
$ (anyOf 3).error (anyOf 1).additional_data.*JSONAdditional keys
$ (anyOf 3).error (anyOf 1).additional_data.* (anyOf 1)stringAlternative
$ (anyOf 3).error (anyOf 1).additional_data.* (anyOf 2)arrayAlternative
$ (anyOf 3).error (anyOf 1).additional_data.* (anyOf 2)[]stringEach item
$ (anyOf 3).error (anyOf 1).codestringRequired within parentMust equal: invalid_json
$ (anyOf 3).error (anyOf 1).messagestringRequired within parentMinimum length: 1
$ (anyOf 3).error (anyOf 1).objectstringRequired within parentMust equal: error
$ (anyOf 3).error (anyOf 1).statusJSONRequired within parent
$ (anyOf 3).error (anyOf 1).status (anyOf 1)integerAlternativeMust equal: 400
$ (anyOf 3).error (anyOf 1).status (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 3).error (anyOf 2)objectAlternativeAdditional keys: allowed
$ (anyOf 3).error (anyOf 2).additional_dataobjectOptionalAdditional keys: see wildcard field
$ (anyOf 3).error (anyOf 2).additional_data.*JSONAdditional keys
$ (anyOf 3).error (anyOf 2).additional_data.* (anyOf 1)stringAlternative
$ (anyOf 3).error (anyOf 2).additional_data.* (anyOf 2)arrayAlternative
$ (anyOf 3).error (anyOf 2).additional_data.* (anyOf 2)[]stringEach item
$ (anyOf 3).error (anyOf 2).codestringRequired within parentMust equal: invalid_request_url
$ (anyOf 3).error (anyOf 2).messagestringRequired within parentMinimum length: 1
$ (anyOf 3).error (anyOf 2).objectstringRequired within parentMust equal: error
$ (anyOf 3).error (anyOf 2).statusJSONRequired within parent
$ (anyOf 3).error (anyOf 2).status (anyOf 1)integerAlternativeMust equal: 400
$ (anyOf 3).error (anyOf 2).status (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 3).error (anyOf 3)objectAlternativeAdditional keys: allowed
$ (anyOf 3).error (anyOf 3).additional_dataobjectOptionalAdditional keys: see wildcard field
$ (anyOf 3).error (anyOf 3).additional_data.*JSONAdditional keys
$ (anyOf 3).error (anyOf 3).additional_data.* (anyOf 1)stringAlternative
$ (anyOf 3).error (anyOf 3).additional_data.* (anyOf 2)arrayAlternative
$ (anyOf 3).error (anyOf 3).additional_data.* (anyOf 2)[]stringEach item
$ (anyOf 3).error (anyOf 3).codestringRequired within parentMust equal: invalid_request
$ (anyOf 3).error (anyOf 3).messagestringRequired within parentMinimum length: 1
$ (anyOf 3).error (anyOf 3).objectstringRequired within parentMust equal: error
$ (anyOf 3).error (anyOf 3).statusJSONRequired within parent
$ (anyOf 3).error (anyOf 3).status (anyOf 1)integerAlternativeMust equal: 400
$ (anyOf 3).error (anyOf 3).status (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 3).error (anyOf 4)objectAlternativeAdditional keys: allowed
$ (anyOf 3).error (anyOf 4).additional_dataobjectOptionalAdditional keys: see wildcard field
$ (anyOf 3).error (anyOf 4).additional_data.*JSONAdditional keys
$ (anyOf 3).error (anyOf 4).additional_data.* (anyOf 1)stringAlternative
$ (anyOf 3).error (anyOf 4).additional_data.* (anyOf 2)arrayAlternative
$ (anyOf 3).error (anyOf 4).additional_data.* (anyOf 2)[]stringEach item
$ (anyOf 3).error (anyOf 4).codestringRequired within parentMust equal: missing_version
$ (anyOf 3).error (anyOf 4).messagestringRequired within parentMinimum length: 1
$ (anyOf 3).error (anyOf 4).objectstringRequired within parentMust equal: error
$ (anyOf 3).error (anyOf 4).statusJSONRequired within parent
$ (anyOf 3).error (anyOf 4).status (anyOf 1)integerAlternativeMust equal: 400
$ (anyOf 3).error (anyOf 4).status (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 3).error (anyOf 5)objectAlternativeAdditional keys: allowed
$ (anyOf 3).error (anyOf 5).additional_dataobjectOptionalAdditional keys: see wildcard field
$ (anyOf 3).error (anyOf 5).additional_data.*JSONAdditional keys
$ (anyOf 3).error (anyOf 5).additional_data.* (anyOf 1)stringAlternative
$ (anyOf 3).error (anyOf 5).additional_data.* (anyOf 2)arrayAlternative
$ (anyOf 3).error (anyOf 5).additional_data.* (anyOf 2)[]stringEach item
$ (anyOf 3).error (anyOf 5).codestringRequired within parentMust equal: invalid_beta
$ (anyOf 3).error (anyOf 5).messagestringRequired within parentMinimum length: 1
$ (anyOf 3).error (anyOf 5).objectstringRequired within parentMust equal: error
$ (anyOf 3).error (anyOf 5).statusJSONRequired within parent
$ (anyOf 3).error (anyOf 5).status (anyOf 1)integerAlternativeMust equal: 400
$ (anyOf 3).error (anyOf 5).status (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 3).error (anyOf 6)objectAlternativeAdditional keys: allowed
$ (anyOf 3).error (anyOf 6).additional_dataobjectOptionalAdditional keys: see wildcard field
$ (anyOf 3).error (anyOf 6).additional_data.*JSONAdditional keys
$ (anyOf 3).error (anyOf 6).additional_data.* (anyOf 1)stringAlternative
$ (anyOf 3).error (anyOf 6).additional_data.* (anyOf 2)arrayAlternative
$ (anyOf 3).error (anyOf 6).additional_data.* (anyOf 2)[]stringEach item
$ (anyOf 3).error (anyOf 6).codestringRequired within parentMust equal: validation_error
$ (anyOf 3).error (anyOf 6).messagestringRequired within parentMinimum length: 1
$ (anyOf 3).error (anyOf 6).objectstringRequired within parentMust equal: error
$ (anyOf 3).error (anyOf 6).statusJSONRequired within parent
$ (anyOf 3).error (anyOf 6).status (anyOf 1)integerAlternativeMust equal: 400
$ (anyOf 3).error (anyOf 6).status (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 3).error (anyOf 7)objectAlternativeAdditional keys: allowed
$ (anyOf 3).error (anyOf 7).additional_dataobjectOptionalAdditional keys: see wildcard field
$ (anyOf 3).error (anyOf 7).additional_data.*JSONAdditional keys
$ (anyOf 3).error (anyOf 7).additional_data.* (anyOf 1)stringAlternative
$ (anyOf 3).error (anyOf 7).additional_data.* (anyOf 2)arrayAlternative
$ (anyOf 3).error (anyOf 7).additional_data.* (anyOf 2)[]stringEach item
$ (anyOf 3).error (anyOf 7).codestringRequired within parentMust equal: unauthorized
$ (anyOf 3).error (anyOf 7).messagestringRequired within parentMinimum length: 1
$ (anyOf 3).error (anyOf 7).objectstringRequired within parentMust equal: error
$ (anyOf 3).error (anyOf 7).statusJSONRequired within parent
$ (anyOf 3).error (anyOf 7).status (anyOf 1)integerAlternativeMust equal: 401
$ (anyOf 3).error (anyOf 7).status (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 3).error (anyOf 8)objectAlternativeAdditional keys: allowed
$ (anyOf 3).error (anyOf 8).additional_dataobjectOptionalAdditional keys: see wildcard field
$ (anyOf 3).error (anyOf 8).additional_data.*JSONAdditional keys
$ (anyOf 3).error (anyOf 8).additional_data.* (anyOf 1)stringAlternative
$ (anyOf 3).error (anyOf 8).additional_data.* (anyOf 2)arrayAlternative
$ (anyOf 3).error (anyOf 8).additional_data.* (anyOf 2)[]stringEach item
$ (anyOf 3).error (anyOf 8).codestringRequired within parentMust equal: restricted_resource
$ (anyOf 3).error (anyOf 8).messagestringRequired within parentMinimum length: 1
$ (anyOf 3).error (anyOf 8).objectstringRequired within parentMust equal: error
$ (anyOf 3).error (anyOf 8).statusJSONRequired within parent
$ (anyOf 3).error (anyOf 8).status (anyOf 1)integerAlternativeMust equal: 403
$ (anyOf 3).error (anyOf 8).status (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 3).error (anyOf 9)objectAlternativeAdditional keys: allowed
$ (anyOf 3).error (anyOf 9).additional_dataobjectOptionalAdditional keys: see wildcard field
$ (anyOf 3).error (anyOf 9).additional_data.*JSONAdditional keys
$ (anyOf 3).error (anyOf 9).additional_data.* (anyOf 1)stringAlternative
$ (anyOf 3).error (anyOf 9).additional_data.* (anyOf 2)arrayAlternative
$ (anyOf 3).error (anyOf 9).additional_data.* (anyOf 2)[]stringEach item
$ (anyOf 3).error (anyOf 9).codestringRequired within parentMust equal: object_not_found
$ (anyOf 3).error (anyOf 9).messagestringRequired within parentMinimum length: 1
$ (anyOf 3).error (anyOf 9).objectstringRequired within parentMust equal: error
$ (anyOf 3).error (anyOf 9).statusJSONRequired within parent
$ (anyOf 3).error (anyOf 9).status (anyOf 1)integerAlternativeMust equal: 404
$ (anyOf 3).error (anyOf 9).status (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 3).error (anyOf 10)objectAlternativeAdditional keys: allowed
$ (anyOf 3).error (anyOf 10).additional_dataobjectOptionalAdditional keys: see wildcard field
$ (anyOf 3).error (anyOf 10).additional_data.*JSONAdditional keys
$ (anyOf 3).error (anyOf 10).additional_data.* (anyOf 1)stringAlternative
$ (anyOf 3).error (anyOf 10).additional_data.* (anyOf 2)arrayAlternative
$ (anyOf 3).error (anyOf 10).additional_data.* (anyOf 2)[]stringEach item
$ (anyOf 3).error (anyOf 10).codestringRequired within parentMust equal: directory_not_found
$ (anyOf 3).error (anyOf 10).messagestringRequired within parentMinimum length: 1
$ (anyOf 3).error (anyOf 10).objectstringRequired within parentMust equal: error
$ (anyOf 3).error (anyOf 10).statusJSONRequired within parent
$ (anyOf 3).error (anyOf 10).status (anyOf 1)integerAlternativeMust equal: 404
$ (anyOf 3).error (anyOf 10).status (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 3).error (anyOf 11)objectAlternativeAdditional keys: allowed
$ (anyOf 3).error (anyOf 11).additional_dataobjectOptionalAdditional keys: see wildcard field
$ (anyOf 3).error (anyOf 11).additional_data.*JSONAdditional keys
$ (anyOf 3).error (anyOf 11).additional_data.* (anyOf 1)stringAlternative
$ (anyOf 3).error (anyOf 11).additional_data.* (anyOf 2)arrayAlternative
$ (anyOf 3).error (anyOf 11).additional_data.* (anyOf 2)[]stringEach item
$ (anyOf 3).error (anyOf 11).codestringRequired within parentMust equal: rate_limited
$ (anyOf 3).error (anyOf 11).messagestringRequired within parentMinimum length: 1
$ (anyOf 3).error (anyOf 11).objectstringRequired within parentMust equal: error
$ (anyOf 3).error (anyOf 11).statusJSONRequired within parent
$ (anyOf 3).error (anyOf 11).status (anyOf 1)integerAlternativeMust equal: 429
$ (anyOf 3).error (anyOf 11).status (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 3).error (anyOf 12)objectAlternativeAdditional keys: allowed
$ (anyOf 3).error (anyOf 12).additional_dataobjectOptionalAdditional keys: see wildcard field
$ (anyOf 3).error (anyOf 12).additional_data.*JSONAdditional keys
$ (anyOf 3).error (anyOf 12).additional_data.* (anyOf 1)stringAlternative
$ (anyOf 3).error (anyOf 12).additional_data.* (anyOf 2)arrayAlternative
$ (anyOf 3).error (anyOf 12).additional_data.* (anyOf 2)[]stringEach item
$ (anyOf 3).error (anyOf 12).codestringRequired within parentMust equal: service_overload
$ (anyOf 3).error (anyOf 12).messagestringRequired within parentMinimum length: 1
$ (anyOf 3).error (anyOf 12).objectstringRequired within parentMust equal: error
$ (anyOf 3).error (anyOf 12).statusJSONRequired within parent
$ (anyOf 3).error (anyOf 12).status (anyOf 1)integerAlternativeMust equal: 529
$ (anyOf 3).error (anyOf 12).status (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 3).error (anyOf 13)objectAlternativeAdditional keys: allowed
$ (anyOf 3).error (anyOf 13).additional_dataobjectOptionalAdditional keys: see wildcard field
$ (anyOf 3).error (anyOf 13).additional_data.*JSONAdditional keys
$ (anyOf 3).error (anyOf 13).additional_data.* (anyOf 1)stringAlternative
$ (anyOf 3).error (anyOf 13).additional_data.* (anyOf 2)arrayAlternative
$ (anyOf 3).error (anyOf 13).additional_data.* (anyOf 2)[]stringEach item
$ (anyOf 3).error (anyOf 13).codestringRequired within parentMust equal: internal_server_error
$ (anyOf 3).error (anyOf 13).messagestringRequired within parentMinimum length: 1
$ (anyOf 3).error (anyOf 13).objectstringRequired within parentMust equal: error
$ (anyOf 3).error (anyOf 13).statusJSONRequired within parent
$ (anyOf 3).error (anyOf 13).status (anyOf 1)integerAlternativeMust equal: 500
$ (anyOf 3).error (anyOf 13).status (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 3).error (anyOf 14)objectAlternativeAdditional keys: allowed
$ (anyOf 3).error (anyOf 14).additional_dataobjectOptionalAdditional keys: see wildcard field
$ (anyOf 3).error (anyOf 14).additional_data.*JSONAdditional keys
$ (anyOf 3).error (anyOf 14).additional_data.* (anyOf 1)stringAlternative
$ (anyOf 3).error (anyOf 14).additional_data.* (anyOf 2)arrayAlternative
$ (anyOf 3).error (anyOf 14).additional_data.* (anyOf 2)[]stringEach item
$ (anyOf 3).error (anyOf 14).codestringRequired within parentMust equal: service_unavailable
$ (anyOf 3).error (anyOf 14).messagestringRequired within parentMinimum length: 1
$ (anyOf 3).error (anyOf 14).objectstringRequired within parentMust equal: error
$ (anyOf 3).error (anyOf 14).statusJSONRequired within parent
$ (anyOf 3).error (anyOf 14).status (anyOf 1)integerAlternativeMust equal: 503
$ (anyOf 3).error (anyOf 14).status (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 3).error (anyOf 15)objectAlternativeAdditional keys: allowed
$ (anyOf 3).error (anyOf 15).additional_dataobjectOptionalAdditional keys: see wildcard field
$ (anyOf 3).error (anyOf 15).additional_data.*JSONAdditional keys
$ (anyOf 3).error (anyOf 15).additional_data.* (anyOf 1)stringAlternative
$ (anyOf 3).error (anyOf 15).additional_data.* (anyOf 2)arrayAlternative
$ (anyOf 3).error (anyOf 15).additional_data.* (anyOf 2)[]stringEach item
$ (anyOf 3).error (anyOf 15).codestringRequired within parentMust equal: gateway_timeout
$ (anyOf 3).error (anyOf 15).messagestringRequired within parentMinimum length: 1
$ (anyOf 3).error (anyOf 15).objectstringRequired within parentMust equal: error
$ (anyOf 3).error (anyOf 15).statusJSONRequired within parent
$ (anyOf 3).error (anyOf 15).status (anyOf 1)integerAlternativeMust equal: 504
$ (anyOf 3).error (anyOf 15).status (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 3).error (anyOf 16)objectAlternativeAdditional keys: allowed
$ (anyOf 3).error (anyOf 16).additional_dataobjectOptionalAdditional keys: see wildcard field
$ (anyOf 3).error (anyOf 16).additional_data.*JSONAdditional keys
$ (anyOf 3).error (anyOf 16).additional_data.* (anyOf 1)stringAlternative
$ (anyOf 3).error (anyOf 16).additional_data.* (anyOf 2)arrayAlternative
$ (anyOf 3).error (anyOf 16).additional_data.* (anyOf 2)[]stringEach item
$ (anyOf 3).error (anyOf 16).codestringRequired within parentMust equal: conflict_error
$ (anyOf 3).error (anyOf 16).messagestringRequired within parentMinimum length: 1
$ (anyOf 3).error (anyOf 16).objectstringRequired within parentMust equal: error
$ (anyOf 3).error (anyOf 16).statusJSONRequired within parent
$ (anyOf 3).error (anyOf 16).status (anyOf 1)integerAlternativeMust equal: 409
$ (anyOf 3).error (anyOf 16).status (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 3).error (anyOf 17)objectAlternativeAdditional keys: allowed
$ (anyOf 3).error (anyOf 17).additional_dataobjectOptionalAdditional keys: see wildcard field
$ (anyOf 3).error (anyOf 17).additional_data.*JSONAdditional keys
$ (anyOf 3).error (anyOf 17).additional_data.* (anyOf 1)stringAlternative
$ (anyOf 3).error (anyOf 17).additional_data.* (anyOf 2)arrayAlternative
$ (anyOf 3).error (anyOf 17).additional_data.* (anyOf 2)[]stringEach item
$ (anyOf 3).error (anyOf 17).codestringRequired within parentMust equal: idempotency_key_reused
$ (anyOf 3).error (anyOf 17).messagestringRequired within parentMinimum length: 1
$ (anyOf 3).error (anyOf 17).objectstringRequired within parentMust equal: error
$ (anyOf 3).error (anyOf 17).statusJSONRequired within parent
$ (anyOf 3).error (anyOf 17).status (anyOf 1)integerAlternativeMust equal: 409
$ (anyOf 3).error (anyOf 17).status (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 3).error (anyOf 18)objectAlternativeAdditional keys: allowed
$ (anyOf 3).error (anyOf 18).additional_dataobjectOptionalAdditional keys: see wildcard field
$ (anyOf 3).error (anyOf 18).additional_data.*JSONAdditional keys
$ (anyOf 3).error (anyOf 18).additional_data.* (anyOf 1)stringAlternative
$ (anyOf 3).error (anyOf 18).additional_data.* (anyOf 2)arrayAlternative
$ (anyOf 3).error (anyOf 18).additional_data.* (anyOf 2)[]stringEach item
$ (anyOf 3).error (anyOf 18).codestringRequired within parentMust equal: row_limit_exceeded
$ (anyOf 3).error (anyOf 18).messagestringRequired within parentMinimum length: 1
$ (anyOf 3).error (anyOf 18).objectstringRequired within parentMust equal: error
$ (anyOf 3).error (anyOf 18).statusJSONRequired within parent
$ (anyOf 3).error (anyOf 18).status (anyOf 1)integerAlternativeMust equal: 406
$ (anyOf 3).error (anyOf 18).status (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 3).error (anyOf 19)objectAlternativeAdditional keys: allowed
$ (anyOf 3).error (anyOf 19).additional_dataobjectOptionalAdditional keys: see wildcard field
$ (anyOf 3).error (anyOf 19).additional_data.*JSONAdditional keys
$ (anyOf 3).error (anyOf 19).additional_data.* (anyOf 1)stringAlternative
$ (anyOf 3).error (anyOf 19).additional_data.* (anyOf 2)arrayAlternative
$ (anyOf 3).error (anyOf 19).additional_data.* (anyOf 2)[]stringEach item
$ (anyOf 3).error (anyOf 19).codestringRequired within parentMust equal: status_change_not_allowed
$ (anyOf 3).error (anyOf 19).messagestringRequired within parentMinimum length: 1
$ (anyOf 3).error (anyOf 19).objectstringRequired within parentMust equal: error
$ (anyOf 3).error (anyOf 19).statusJSONRequired within parent
$ (anyOf 3).error (anyOf 19).status (anyOf 1)integerAlternativeMust equal: 403
$ (anyOf 3).error (anyOf 19).status (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 3).error (anyOf 20)objectAlternativeAdditional keys: allowed
$ (anyOf 3).error (anyOf 20).additional_dataobjectOptionalAdditional keys: see wildcard field
$ (anyOf 3).error (anyOf 20).additional_data.*JSONAdditional keys
$ (anyOf 3).error (anyOf 20).additional_data.* (anyOf 1)stringAlternative
$ (anyOf 3).error (anyOf 20).additional_data.* (anyOf 2)arrayAlternative
$ (anyOf 3).error (anyOf 20).additional_data.* (anyOf 2)[]stringEach item
$ (anyOf 3).error (anyOf 20).codestringRequired within parentMust equal: agent_deleted
$ (anyOf 3).error (anyOf 20).messagestringRequired within parentMinimum length: 1
$ (anyOf 3).error (anyOf 20).objectstringRequired within parentMust equal: error
$ (anyOf 3).error (anyOf 20).statusJSONRequired within parent
$ (anyOf 3).error (anyOf 20).status (anyOf 1)integerAlternativeMust equal: 409
$ (anyOf 3).error (anyOf 20).status (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 3).error (anyOf 21)objectAlternativeAdditional keys: allowed
$ (anyOf 3).error (anyOf 21).additional_dataobjectOptionalAdditional keys: see wildcard field
$ (anyOf 3).error (anyOf 21).additional_data.*JSONAdditional keys
$ (anyOf 3).error (anyOf 21).additional_data.* (anyOf 1)stringAlternative
$ (anyOf 3).error (anyOf 21).additional_data.* (anyOf 2)arrayAlternative
$ (anyOf 3).error (anyOf 21).additional_data.* (anyOf 2)[]stringEach item
$ (anyOf 3).error (anyOf 21).codestringRequired within parentMust equal: invalid_credit_limit
$ (anyOf 3).error (anyOf 21).messagestringRequired within parentMinimum length: 1
$ (anyOf 3).error (anyOf 21).objectstringRequired within parentMust equal: error
$ (anyOf 3).error (anyOf 21).statusJSONRequired within parent
$ (anyOf 3).error (anyOf 21).status (anyOf 1)integerAlternativeMust equal: 400
$ (anyOf 3).error (anyOf 21).status (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 3).error (anyOf 22)objectAlternativeAdditional keys: allowed
$ (anyOf 3).error (anyOf 22).additional_dataobjectOptionalAdditional keys: see wildcard field
$ (anyOf 3).error (anyOf 22).additional_data.*JSONAdditional keys
$ (anyOf 3).error (anyOf 22).additional_data.* (anyOf 1)stringAlternative
$ (anyOf 3).error (anyOf 22).additional_data.* (anyOf 2)arrayAlternative
$ (anyOf 3).error (anyOf 22).additional_data.* (anyOf 2)[]stringEach item
$ (anyOf 3).error (anyOf 22).codestringRequired within parentMust equal: workspace_credits_exhausted
$ (anyOf 3).error (anyOf 22).messagestringRequired within parentMinimum length: 1
$ (anyOf 3).error (anyOf 22).objectstringRequired within parentMust equal: error
$ (anyOf 3).error (anyOf 22).statusJSONRequired within parent
$ (anyOf 3).error (anyOf 22).status (anyOf 1)integerAlternativeMust equal: 403
$ (anyOf 3).error (anyOf 22).status (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 3).error (anyOf 23)objectAlternativeAdditional keys: allowed
$ (anyOf 3).error (anyOf 23).additional_dataobjectOptionalAdditional keys: see wildcard field
$ (anyOf 3).error (anyOf 23).additional_data.*JSONAdditional keys
$ (anyOf 3).error (anyOf 23).additional_data.* (anyOf 1)stringAlternative
$ (anyOf 3).error (anyOf 23).additional_data.* (anyOf 2)arrayAlternative
$ (anyOf 3).error (anyOf 23).additional_data.* (anyOf 2)[]stringEach item
$ (anyOf 3).error (anyOf 23).codestringRequired within parentMust equal: agent_credit_limit_reached
$ (anyOf 3).error (anyOf 23).messagestringRequired within parentMinimum length: 1
$ (anyOf 3).error (anyOf 23).objectstringRequired within parentMust equal: error
$ (anyOf 3).error (anyOf 23).statusJSONRequired within parent
$ (anyOf 3).error (anyOf 23).status (anyOf 1)integerAlternativeMust equal: 403
$ (anyOf 3).error (anyOf 23).status (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 3).idstringRequired within parentMinimum length: 1
$ (anyOf 3).objectstringRequired within parentMust equal: async_task
$ (anyOf 3).operationobjectRequired within parentAdditional keys: allowed
$ (anyOf 3).operation.namestringRequired within parentMinimum length: 1
$ (anyOf 3).operation.surfacestringRequired within parentKnown values: rest, mcp
$ (anyOf 3).statusstringRequired within parentMust equal: failed
$ (anyOf 3).status_urlstringRequired within parentMinimum length: 1

Referenced models: Retrieve an async task — response body — object async task, status succeeded result value, Retrieve an async task — response body — object async_task, status: queued, running, retrying

Retrieve an async task — response body — object async task, status succeeded result value
FieldTypePresenceDescription and constraints
$JSONRoot
$ (anyOf 1)stringAlternative
$ (anyOf 2)JSONAlternative
$ (anyOf 2) (anyOf 1)numberAlternative
$ (anyOf 2) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (anyOf 3)booleanAlternative
$ (anyOf 4)nullAlternative
$ (anyOf 5)arrayAlternative
$ (anyOf 5)[]ModelEach itemExpand Retrieve an async task — response body — object async task, status succeeded result value
$ (anyOf 6)objectAlternativeAdditional keys: see wildcard field
$ (anyOf 6).*ModelAdditional keysExpand Retrieve an async task — response body — object async task, status succeeded result value

Referenced models: Retrieve an async task — response body — object async task, status succeeded result value

Retrieve an async task — response body — object async_task, status: queued, running, retrying
FieldTypePresenceDescription and constraints
$objectRootAdditional keys: allowed
created_timestringRequired within parentFormat: date-time
idstringRequired within parentMinimum length: 1
objectstringRequired within parentMust equal: async_task
operationobjectRequired within parentAdditional keys: allowed
operation.namestringRequired within parentMinimum length: 1
operation.surfacestringRequired within parentKnown values: rest, mcp
poll_after_secondsJSONRequired within parent
poll_after_seconds (anyOf 1)integerAlternativeMinimum: 0
poll_after_seconds (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
statusstringRequired within parentKnown values: queued, running, retrying
status_urlstringRequired within parentMinimum length: 1

SDK function policy ID: notion.retrieve_async_task. Catalog operation: retrieve_async_task. Rules can name either ID; function rules distinguish managed calls and conservatively cover raw calls sharing the route. Existing grant permissions and policy rules apply. wait() returns an immediate result or waits for a required approval; it never approves the request itself. Persist the approval ID to resume after a restart.

Provider errors retain their response; JSON decoding raises ProviderAPIError for provider failures. ManagedOperationError identifies contract/input/retention errors. See error handling and provider-specific behavior. Sensitive input may be refused before approval storage. A decoding error never resubmits a write.

Pinned headers: {"Notion-Version": "2026-03-11"}

Official provider source

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.