행 고치기

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": "운영"
        }
      }
    }
  }'

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

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

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

PATCH

pages

{id}

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": "운영"
        }
      }
    }
  }'

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

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

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

행이나 하위 문서를 고칩니다. 내용 수정 권한이 필요합니다. 연동이 읽을 수 있는 행만 고칠 수 있습니다. 최종 편집자는 연동 봇이 됩니다. 보낸 키만 바뀝니다. 빈 본문은 아무것도 바꾸지 않고 200을 반환합니다. 행이나 데이터베이스가 잠겨 있어도 고칠 수 있습니다.

string

필수

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

string

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

string

필수

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

object

속성 이름이나 ID를 키로 한 값입니다. 하위 문서는 title만 받습니다. 속성 값 자세히 알아보기 →

boolean

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

boolean

보관하거나 풉니다. 보관한 행은 기본 쿼리에서 빠집니다.

boolean

잠그거나 풉니다.

object | null

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

object | null

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

object

{ "mode": "default" } 또는 { "mode": "silent" }입니다. 형식만 확인하고 동작에는 영향이 없습니다.

object

형식만 확인하고 옮기지 않습니다.

휴지통 규칙

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

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

받지 않는 키

children · content · markdown · markdown_version · allow_async · template · position · erase_content는 400입니다. 본문은 쓸 수 없습니다.

응답

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

오류

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

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

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": "운영"
        }
      }
    }
  }'

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

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

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

공통

사용자

검색

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

페이지

블록

댓글

휴지통 규칙

받지 않는 키

응답

오류

​휴지통 규칙

​받지 않는 키

​응답

​오류

휴지통 규칙

받지 않는 키

응답

오류