Retrieve an async task

curl https://api.bottari.ai/v1/async_tasks/task_exampleTask1 \
  -H "Authorization: Bearer $BOTTARI_TOKEN" \
  -H "Bottari-Version: 2026-03-11"

{
  "object": "async_task",
  "id": "task_exampleTask1",
  "status": "succeeded",
  "status_url": "https://api.bottari.ai/v1/async_tasks/task_exampleTask1",
  "created_time": "2026-01-15T03:10:12.345Z",
  "operation": {
    "surface": "rest",
    "name": "PATCH /v1/pages/:page_id/markdown"
  },
  "result": {
    "object": "page_markdown",
    "id": "exampleRow01",
    "markdown": "Added with allow_async.",
    "truncated": false,
    "unknown_block_ids": []
  },
  "request_id": "33333333-3333-4333-8333-333333333333"
}

{
  "object": "async_task",
  "id": "task_exampleTask1",
  "status": "queued",
  "status_url": "https://api.bottari.ai/v1/async_tasks/task_exampleTask1",
  "created_time": "2026-01-15T03:10:12.345Z",
  "poll_after_seconds": 2,
  "operation": {
    "surface": "rest",
    "name": "PATCH /v1/pages/:page_id/markdown"
  },
  "request_id": "33333333-3333-4333-8333-333333333333"
}

{
  "object": "error",
  "status": 404,
  "code": "object_not_found",
  "message": "Could not find async_task with ID: task_exampleTask1. Make sure the relevant pages and databases are shared with your integration \"Order sync\".",
  "request_id": "33333333-3333-4333-8333-333333333333"
}

GET

async_tasks

{id}

curl https://api.bottari.ai/v1/async_tasks/task_exampleTask1 \
  -H "Authorization: Bearer $BOTTARI_TOKEN" \
  -H "Bottari-Version: 2026-03-11"

{
  "object": "async_task",
  "id": "task_exampleTask1",
  "status": "succeeded",
  "status_url": "https://api.bottari.ai/v1/async_tasks/task_exampleTask1",
  "created_time": "2026-01-15T03:10:12.345Z",
  "operation": {
    "surface": "rest",
    "name": "PATCH /v1/pages/:page_id/markdown"
  },
  "result": {
    "object": "page_markdown",
    "id": "exampleRow01",
    "markdown": "Added with allow_async.",
    "truncated": false,
    "unknown_block_ids": []
  },
  "request_id": "33333333-3333-4333-8333-333333333333"
}

{
  "object": "async_task",
  "id": "task_exampleTask1",
  "status": "queued",
  "status_url": "https://api.bottari.ai/v1/async_tasks/task_exampleTask1",
  "created_time": "2026-01-15T03:10:12.345Z",
  "poll_after_seconds": 2,
  "operation": {
    "surface": "rest",
    "name": "PATCH /v1/pages/:page_id/markdown"
  },
  "request_id": "33333333-3333-4333-8333-333333333333"
}

{
  "object": "error",
  "status": 404,
  "code": "object_not_found",
  "message": "Could not find async_task with ID: task_exampleTask1. Make sure the relevant pages and databases are shared with your integration \"Order sync\".",
  "request_id": "33333333-3333-4333-8333-333333333333"
}

Reads the result of a write sent with allow_async: true. Two endpoints take that option, both only with Markdown:

Create a page with markdown
Update content with Markdown

These requests return 202 with a task once they’re accepted. A request that fails returns the error right away, the same as without allow_async, and there’s no task.

string

required

Bearer <token>. See Tokens.

string

Optional. Only 2026-03-11 is accepted. Without it, the current version is used. A different value returns 400.

string

required

The task ID from the 202 response.

string

Always async_task.

string

The task ID.

string

queued in the 202 response, and succeeded here.

string

The address of this endpoint for this task.

string

When the task was created.

number

In the 202 response only. How long to wait before reading.

object

surface is rest, and name is the request, such as POST /v1/pages.

object

A page object for POST /v1/pages, or a page_markdown object for Markdown updates. It’s read when you call this endpoint, so it shows the current state.

Errors

Status	`code`	Cause
404	`object_not_found`	The task ID is wrong, or the integration can no longer read the document.

See Common rules for shared errors.

curl https://api.bottari.ai/v1/async_tasks/task_exampleTask1 \
  -H "Authorization: Bearer $BOTTARI_TOKEN" \
  -H "Bottari-Version: 2026-03-11"

{
  "object": "async_task",
  "id": "task_exampleTask1",
  "status": "succeeded",
  "status_url": "https://api.bottari.ai/v1/async_tasks/task_exampleTask1",
  "created_time": "2026-01-15T03:10:12.345Z",
  "operation": {
    "surface": "rest",
    "name": "PATCH /v1/pages/:page_id/markdown"
  },
  "result": {
    "object": "page_markdown",
    "id": "exampleRow01",
    "markdown": "Added with allow_async.",
    "truncated": false,
    "unknown_block_ids": []
  },
  "request_id": "33333333-3333-4333-8333-333333333333"
}

{
  "object": "async_task",
  "id": "task_exampleTask1",
  "status": "queued",
  "status_url": "https://api.bottari.ai/v1/async_tasks/task_exampleTask1",
  "created_time": "2026-01-15T03:10:12.345Z",
  "poll_after_seconds": 2,
  "operation": {
    "surface": "rest",
    "name": "PATCH /v1/pages/:page_id/markdown"
  },
  "request_id": "33333333-3333-4333-8333-333333333333"
}

{
  "object": "error",
  "status": 404,
  "code": "object_not_found",
  "message": "Could not find async_task with ID: task_exampleTask1. Make sure the relevant pages and databases are shared with your integration \"Order sync\".",
  "request_id": "33333333-3333-4333-8333-333333333333"
}

Common

Users

Search

Databases and data sources

Pages

Blocks

Async tasks

Comments

Errors

​Errors

Errors