> ## Documentation Index
> Fetch the complete documentation index at: https://developers.bottari.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve an async task

> Read the result of a write sent with allow_async.

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

* [Create a page](https://developers.bottari.ai/api-reference/pages/create.md) with `markdown`
* [Update content with Markdown](https://developers.bottari.ai/api-reference/pages/update-markdown.md)

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.

**Authorization** `string` *required*

`Bearer <token>`. See [Tokens](https://developers.bottari.ai/auth/tokens.md).

**Bottari-Version** `string`

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

**id** `string` *required*

The task ID from the 202 response.

**object** `string`

Always `async_task`.

**id** `string`

The task ID.

**status** `string`

`queued` in the 202 response, and `succeeded` here.

**status\_url** `string`

The address of this endpoint for this task.

**created\_time** `string`

When the task was created.

**poll\_after\_seconds** `number`

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

**operation** `object`

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

**result** `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](https://developers.bottari.ai/api-reference/overview.md#errors) for shared errors.

```bash curl theme={null}
curl https://api.bottari.ai/v1/async_tasks/task_exampleTask1 \
  -H "Authorization: Bearer $BOTTARI_TOKEN" \
  -H "Bottari-Version: 2026-03-11"
```

```json 200 theme={null}
{
  "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"
}
```

```json 202 theme={null}
{
  "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"
}
```

```json 404 theme={null}
{
  "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"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.