> ## 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.

# 블록 지우기

> 블록을 휴지통에 넣습니다. 30일 동안 되살릴 수 있습니다. 내용 수정 권한이 필요합니다.

블록과 그 자식을 휴지통에 넣습니다. `내용 수정` 권한이 필요합니다. 30일 동안 되살릴 수 있습니다.

**Authorization** `string` *required*

`Bearer <토큰>` 형식입니다. [토큰 자세히 알아보기 →](https://developers.bottari.ai/ko/auth/tokens.md)

**Bottari-Version** `string`

선택 항목입니다. `2026-03-11`만 받습니다. 빼면 현재 버전을 사용하고, 다른 값을 보내면 400을 반환합니다.

**id** `string` *required*

블록 ID입니다. 하위 문서 · 행 · 데이터베이스 ID를 넣으면 그 하위 문서 · 행 · 데이터베이스를 휴지통에 넣습니다.

## 함께 휴지통에 들어가는 대상

* 블록 안의 하위 문서와 인라인 데이터베이스도 휴지통에 들어갑니다. 블록을 되살리면 함께 돌아옵니다.
* 이 블록보다 먼저 지운 하위 문서나 인라인 데이터베이스는 지운 상태로 남습니다.
* 블록 안에 연동이 쓸 수 없는 하위 문서나 데이터베이스가 있으면 요청 전체가 403이고 아무것도 바뀌지 않습니다.

## 지운 블록 읽기

| 요청 | 응답 |
| - | - |
| `GET /v1/blocks/{id}` | 200, `in_trash: true`. 그 안의 블록도 200입니다. |
| `GET /v1/blocks/{id}/children` | 404 |
| 그 블록에 `PATCH` · `DELETE` | 400 `Can't edit block that is archived. You must unarchive the block before editing.` |
| 그 안의 블록에 `PATCH` · `DELETE` | 400 `Can't edit page on block with an archived ancestor. You must unarchive the ancestor before editing page.` |

이 규칙은 이 API · `in_trash: true` · 마크다운 편집 · `erase_content`로 지운 블록에 적용됩니다. 사람이 앱에서 지운 블록은 404를 반환하고 API로 되살릴 수 없습니다.

## 되살리기

| 지운 대상 | 되살리는 방법 |
| - | - |
| 블록 | `PATCH /v1/blocks/{id}`에 `{ "in_trash": false }` |
| 하위 문서 · 행 | `PATCH /v1/pages/{id}`에 `{ "in_trash": false }` |
| 데이터베이스 | `PATCH /v1/blocks/{id}`에 `{ "in_trash": false }` |

* 되살린 블록은 부모의 끝에 들어갑니다. 부모가 더 이상 없으면 문서의 끝에 들어갑니다.
* 부모도 지워진 블록은 따로 되살릴 수 없습니다. 400입니다.
* 지운 블록 안의 하위 문서나 데이터베이스도 따로 되살릴 수 없습니다. 블록을 되살리세요.
* 열 하나를 지워 열이 하나만 남았다면 그 `column_list`는 사라진 상태입니다. 지운 열을 되살리면 그 블록은 문서 끝에 들어가고, 응답은 그중 첫 블록입니다.

## 응답

`in_trash: true`인 블록 객체입니다. [블록 읽기 자세히 알아보기 →](https://developers.bottari.ai/ko/api-reference/blocks/retrieve.md)

## 오류

| 상태 | `code` | 원인 |
| - | - | - |
| 400 | `validation_error` | 이미 지운 블록이거나, 지운 블록 아래의 블록이거나, 병합한 칸이 있는 표의 행입니다. |
| 403 | `restricted_resource` | `내용 수정`이 꺼져 있거나, 작업 에이전트가 붙은 데이터베이스이거나, 연동이 쓸 수 없는 내용이 있는 블록이거나, 앱이 자동으로 만드는 데이터베이스입니다. |
| 404 | `object_not_found` | 없거나 연동이 읽을 수 없는 블록입니다. |

공통 오류는 [공통 규칙](https://developers.bottari.ai/ko/api-reference/overview.md#오류)에서 확인할 수 있습니다.

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

```json 200 theme={null}
{
  "object": "block",
  "id": "exampleRow01.exampleBlk01",
  "parent": {
    "type": "page_id",
    "page_id": "exampleRow01"
  },
  "created_time": "2026-01-15T02:30:00.000Z",
  "last_edited_time": "2026-01-15T03:10:00.000Z",
  "created_by": {
    "object": "user",
    "id": "22222222-2222-4222-8222-222222222222"
  },
  "last_edited_by": {
    "object": "user",
    "id": "22222222-2222-4222-8222-222222222222"
  },
  "has_children": false,
  "in_trash": true,
  "type": "divider",
  "divider": {},
  "request_id": "33333333-3333-4333-8333-333333333333"
}
```

```json 400 theme={null}
{
  "object": "error",
  "status": 400,
  "code": "validation_error",
  "message": "Can't edit block that is archived. You must unarchive the block before editing.",
  "request_id": "33333333-3333-4333-8333-333333333333"
}
```


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