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

# 행 수정하기

> 행의 속성과 휴지통 · 보관 · 잠금 · 아이콘 · 표지를 바꿉니다. 내용 수정 권한이 필요합니다.

행이나 하위 문서를 고칩니다. `내용 수정` 권한이 필요합니다. 연동이 읽을 수 있는 행만 고칠 수 있습니다. 최종 편집자는 연동 봇이 됩니다.

보낸 키만 바뀝니다. 빈 본문은 아무것도 바꾸지 않고 200을 반환합니다. 행이나 데이터베이스가 잠겨 있어도 고칠 수 있습니다.

**Authorization** `string` *required*

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

**Bottari-Version** `string`

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

**id** `string` *required*

행이나 하위 문서의 ID입니다.

**properties** `object`

속성 이름이나 ID를 키로 한 값입니다. 하위 문서는 `title`만 받습니다. [속성 값 자세히 알아보기 →](https://developers.bottari.ai/ko/api-reference/property-values.md)

**in\_trash** `boolean`

`true`면 휴지통에 넣고, `false`면 되살립니다. 행과 그 아래 하위 문서가 함께 움직입니다. 하위 항목 관계로 묶인 다른 행은 따라가지 않습니다.

**is\_archived** `boolean`

행을 보관하거나 보관을 해제합니다. 보관한 행은 기본 쿼리에서 빠집니다.

**is\_locked** `boolean`

행을 잠그거나 잠금을 해제합니다.

**icon** `object | null`

`emoji` · `custom_emoji` · `icon` · `file`(현재 아이콘과 같은 그림만) · `null`을 받습니다. 아이콘 이름은 26자까지이고 그 밖에는 검사하지 않습니다. `external`은 400입니다.

**cover** `object | null`

`external`(http(s) 주소) · `file`(현재 표지와 같은 그림만) · `null`을 받습니다.

## 휴지통 규칙

* 휴지통에 있는 행은 `in_trash: false`로만 고칠 수 있습니다. 다른 쓰기는 400 `Can't edit block that is archived. You must unarchive the block before editing.`입니다.
* 휴지통에 있는 데이터베이스의 행은 고칠 수 없습니다. 같은 400입니다.
* 연동이 읽지 못하는 하위 문서나 인라인 데이터베이스 행이 있는 행은 휴지통에 넣거나 되살릴 수 없습니다. 403입니다.
* 부모가 휴지통에 있는 하위 문서는 되살릴 수 없습니다. 400입니다.

> [!WARNING]
>
> 되살리기 · 속성 쓰기 · 휴지통 넣기는 차례로 저장합니다. 값은 먼저 검증하지만, 드문 저장 오류가 나면 앞 단계만 남을 수 있습니다.

## 응답

고친 뒤의 `page` 객체입니다. 속성을 모두 포함합니다.

## 오류

| 상태 | `code` | 원인 |
| - | - | - |
| 400 | `validation_error` | 값이나 본문 키가 틀렸거나, 휴지통에 있는 대상이거나, 값이 768,000바이트를 넘었습니다. |
| 400 | `invalid_request` | 하위 문서를 부모 본문에 되돌리지 못했습니다. |
| 403 | `restricted_resource` | `내용 수정`이 꺼져 있거나, 작업 에이전트가 붙은 데이터베이스이거나, 연동이 읽지 못하는 내용이 있는 행입니다. |
| 404 | `object_not_found` | 연동이 읽을 수 없는 행입니다. 사람 · 관계 값의 ID를 찾지 못해도 404입니다. |

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

```bash curl theme={null}
curl https://api.bottari.ai/v1/pages/exampleRow01 \
  -X PATCH \
  -H "Authorization: Bearer $BOTTARI_TOKEN" \
  -H "Bottari-Version: 2026-03-11" \
  -H "Content-Type: application/json" \
  -d '{
    "properties": {
      "완료": {
        "checkbox": true
      },
      "담당 팀": {
        "select": {
          "name": "운영"
        }
      }
    }
  }'
```

```json 200 theme={null}
{
  "object": "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": "11111111-1111-4111-8111-111111111111"
  },
  "last_edited_by": {
    "object": "user",
    "id": "22222222-2222-4222-8222-222222222222"
  },
  "in_trash": false,
  "cover": null,
  "icon": null,
  "parent": {
    "type": "data_source_id",
    "data_source_id": "exampleDb001",
    "database_id": "exampleDb001"
  },
  "is_archived": false,
  "is_locked": false,
  "properties": {
    "이름": {
      "id": "title",
      "type": "title",
      "title": [
        {
          "type": "text",
          "text": {
            "content": "1월 주문 확인",
            "link": null
          },
          "annotations": {
            "bold": false,
            "italic": false,
            "strikethrough": false,
            "underline": false,
            "code": false,
            "color": "default"
          },
          "plain_text": "1월 주문 확인",
          "href": null
        }
      ]
    },
    "완료": {
      "id": "exampleFld03",
      "type": "checkbox",
      "checkbox": true
    },
    "담당 팀": {
      "id": "exampleFld01",
      "type": "select",
      "select": {
        "id": "exampleOpt01",
        "name": "운영",
        "color": "blue"
      }
    }
  },
  "url": "https://app.bottari.ai/t/exampleTeam1/p/exampleRow01",
  "public_url": null,
  "request_id": "33333333-3333-4333-8333-333333333333"
}
```

```json 400 theme={null}
{
  "object": "error",
  "status": 400,
  "code": "validation_error",
  "message": "body failed validation: body.properties.Notes.rich_text[0].text.content.length should be ≤ `2000`, instead was `2001`.",
  "request_id": "33333333-3333-4333-8333-333333333333"
}
```

```json 403 theme={null}
{
  "object": "error",
  "status": 403,
  "code": "restricted_resource",
  "message": "Insufficient permissions for this endpoint.",
  "request_id": "33333333-3333-4333-8333-333333333333"
}
```


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