블록 지우기

curl https://api.bottari.ai/v1/blocks/exampleRow01.exampleBlk01 \
  -X DELETE \
  -H "Authorization: Bearer $BOTTARI_TOKEN" \
  -H "Bottari-Version: 2026-03-11"

{
  "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"
}

{
  "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"
}

DELETE

blocks

{id}

curl https://api.bottari.ai/v1/blocks/exampleRow01.exampleBlk01 \
  -X DELETE \
  -H "Authorization: Bearer $BOTTARI_TOKEN" \
  -H "Bottari-Version: 2026-03-11"

{
  "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"
}

{
  "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"
}

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

string

필수

Bearer <토큰> 형식입니다. 토큰 자세히 알아보기 →

string

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

string

필수

블록 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인 블록 객체입니다. 블록 읽기 자세히 알아보기 →

오류

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

공통 오류는 공통 규칙에서 확인할 수 있습니다.

curl https://api.bottari.ai/v1/blocks/exampleRow01.exampleBlk01 \
  -X DELETE \
  -H "Authorization: Bearer $BOTTARI_TOKEN" \
  -H "Bottari-Version: 2026-03-11"

{
  "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"
}

{
  "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"
}

공통

사용자

검색

데이터베이스와 데이터 소스

페이지

블록

비동기 작업

댓글

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

지운 블록 읽기

되살리기

응답

오류

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

​지운 블록 읽기

​되살리기

​응답

​오류

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

지운 블록 읽기

되살리기

응답

오류