curl https://api.bottari.ai/v1/data_sources/exampleDb001 \
-H "Authorization: Bearer $BOTTARI_TOKEN" \
-H "Bottari-Version: 2026-03-11"
{
"object": "data_source",
"id": "exampleDb001",
"created_time": "2026-01-10T01:00: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": "11111111-1111-4111-8111-111111111111"
},
"in_trash": false,
"properties": {
"이름": {
"id": "title",
"name": "이름",
"description": null,
"type": "title",
"title": {}
},
"담당 팀": {
"id": "exampleFld01",
"name": "담당 팀",
"description": null,
"type": "select",
"select": {
"options": [
{
"id": "exampleOpt01",
"name": "운영",
"color": "blue",
"description": null
}
]
}
}
},
"parent": {
"type": "database_id",
"database_id": "exampleDb001"
},
"database_parent": {
"type": "workspace",
"workspace": true
},
"is_inline": false,
"database_type": null,
"title": [
{
"type": "text",
"text": {
"content": "주문",
"link": null
},
"annotations": {
"bold": false,
"italic": false,
"strikethrough": false,
"underline": false,
"code": false,
"color": "default"
},
"plain_text": "주문",
"href": null
}
],
"description": [],
"icon": null,
"cover": null,
"url": "https://app.bottari.ai/t/exampleTeam1/db/exampleDb001",
"public_url": null,
"request_id": "33333333-3333-4333-8333-333333333333"
}
데이터베이스와 데이터 소스
데이터 소스 읽기
데이터베이스의 속성 정의를 읽습니다.
GET
/
v1
/
data_sources
/
{id}
curl https://api.bottari.ai/v1/data_sources/exampleDb001 \
-H "Authorization: Bearer $BOTTARI_TOKEN" \
-H "Bottari-Version: 2026-03-11"
{
"object": "data_source",
"id": "exampleDb001",
"created_time": "2026-01-10T01:00: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": "11111111-1111-4111-8111-111111111111"
},
"in_trash": false,
"properties": {
"이름": {
"id": "title",
"name": "이름",
"description": null,
"type": "title",
"title": {}
},
"담당 팀": {
"id": "exampleFld01",
"name": "담당 팀",
"description": null,
"type": "select",
"select": {
"options": [
{
"id": "exampleOpt01",
"name": "운영",
"color": "blue",
"description": null
}
]
}
}
},
"parent": {
"type": "database_id",
"database_id": "exampleDb001"
},
"database_parent": {
"type": "workspace",
"workspace": true
},
"is_inline": false,
"database_type": null,
"title": [
{
"type": "text",
"text": {
"content": "주문",
"link": null
},
"annotations": {
"bold": false,
"italic": false,
"strikethrough": false,
"underline": false,
"code": false,
"color": "default"
},
"plain_text": "주문",
"href": null
}
],
"description": [],
"icon": null,
"cover": null,
"url": "https://app.bottari.ai/t/exampleTeam1/db/exampleDb001",
"public_url": null,
"request_id": "33333333-3333-4333-8333-333333333333"
}
속성 이름 · ID · 종류와 선택지를 읽습니다. 데이터 소스 ID는 데이터베이스 ID와 같습니다.
공통 오류는 공통 규칙에서 확인할 수 있습니다.
string
필수
Bearer <토큰> 형식입니다. 토큰 자세히 알아보기 →string
선택 항목입니다.
2026-03-11만 받습니다. 빼면 현재 버전을 사용하고, 다른 값을 보내면 400을 반환합니다.string
필수
데이터 소스 ID입니다. 데이터베이스 ID를 넣으세요.
object
속성 이름을 키로 한 속성 정의입니다. 각 값에
id · name · description · type과 종류별 설정이 있습니다.다음 속성은 빠집니다.- 세션 · 연결된 페이지 · PR 속성
- 연결하지 않은 데이터베이스를 가리키는 관계 속성과 그 관계를 쓰는 롤업 속성
object
{ "type": "database_id", "database_id": "..." }입니다.object
그 데이터베이스의 부모입니다.
object[]
이름입니다.
boolean
데이터베이스나 그 위의 문서가 휴지통에 있으면
true입니다.속성 정의
| 종류 | 설정 |
|---|---|
number | format |
select · multi_select | options: id · name · color · description |
status | options · default_option · groups |
unique_id | prefix |
formula | expression. 속성은 이름으로 나옵니다. 예: prop("메모") |
relation | database_id · data_source_id · limit · type(single_property 또는 dual_property) |
rollup | rollup_property_name · relation_property_name · rollup_property_id · relation_property_id · function |
오류
| 상태 | code | 원인 |
|---|---|---|
| 404 | object_not_found | 없거나 연결하지 않은 데이터베이스입니다. |
curl https://api.bottari.ai/v1/data_sources/exampleDb001 \
-H "Authorization: Bearer $BOTTARI_TOKEN" \
-H "Bottari-Version: 2026-03-11"
{
"object": "data_source",
"id": "exampleDb001",
"created_time": "2026-01-10T01:00: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": "11111111-1111-4111-8111-111111111111"
},
"in_trash": false,
"properties": {
"이름": {
"id": "title",
"name": "이름",
"description": null,
"type": "title",
"title": {}
},
"담당 팀": {
"id": "exampleFld01",
"name": "담당 팀",
"description": null,
"type": "select",
"select": {
"options": [
{
"id": "exampleOpt01",
"name": "운영",
"color": "blue",
"description": null
}
]
}
}
},
"parent": {
"type": "database_id",
"database_id": "exampleDb001"
},
"database_parent": {
"type": "workspace",
"workspace": true
},
"is_inline": false,
"database_type": null,
"title": [
{
"type": "text",
"text": {
"content": "주문",
"link": null
},
"annotations": {
"bold": false,
"italic": false,
"strikethrough": false,
"underline": false,
"code": false,
"color": "default"
},
"plain_text": "주문",
"href": null
}
],
"description": [],
"icon": null,
"cover": null,
"url": "https://app.bottari.ai/t/exampleTeam1/db/exampleDb001",
"public_url": null,
"request_id": "33333333-3333-4333-8333-333333333333"
}