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

# 권한

> 연동이 할 수 있는 일을 정하는 다섯 가지 권한과 기본값을 정리합니다.

권한은 연동 상세의 `권한`에서 지정합니다. 팀 소유자만 바꿀 수 있습니다. 바꾸면 바로 저장되고 다음 요청부터 적용됩니다.

| 화면 이름 | 값 | 새 연동 기본값 | 허용하는 작업 |
| - | - | - | - |
| `내용 읽기` | `read_content` | 켜짐(끌 수 없음) | 검색 · 데이터베이스 · 데이터 소스 · 쿼리 · 페이지 · 속성 · 마크다운 · 블록 읽기 |
| `내용 수정` | `update_content` | 꺼짐 | `PATCH /v1/pages/{id}`: 속성 고치기 · 휴지통 · 되살리기 · 보관 · 잠금 · 아이콘 · 표지 |
| `내용 추가` | `insert_content` | 꺼짐 | `POST /v1/pages`: 행 만들기 |
| `댓글 읽기` | `read_comments` | 꺼짐 | `GET /v1/comments` · `GET /v1/comments/{id}` · `comment.*` 웹훅 이벤트 |
| `사용자 정보` | `user_info` | `이메일 없이`(`no_email`) | 사람 정보를 어디까지 담을지 정합니다. 자세한 내용은 아래를 확인하세요. |

필요한 권한이 꺼져 있으면 403을 반환합니다.

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

`GET /v1/users/me`는 권한과 상관없이 응답합니다.

## 쓰기 권한의 범위

* `내용 수정`과 `내용 추가`는 따로 켭니다. `내용 추가`만 켠 연동은 행을 만들 수 있지만 고칠 수 없습니다.
* `select`와 `multi_select` 값에 새 이름을 쓰면 그 쓰기에 필요한 권한만으로 선택지가 만들어집니다.
* 쓸 수 있는 행은 읽을 수 있는 행과 같습니다. [연결 범위 자세히 알아보기 →](https://developers.bottari.ai/ko/auth/connections.md)
* 행이나 데이터베이스가 잠겨 있어도 연동은 쓸 수 있습니다.
* 작업 에이전트가 붙은 데이터베이스에는 쓸 수 없습니다. 403을 반환합니다.
* 연동의 쓰기도 데이터베이스 자동화를 실행합니다. 자동화는 만든 사람의 권한으로 실행됩니다.

## 사용자 정보

| 값 | 화면 이름 | 사용자 객체 | `GET /v1/users` · `/v1/users/{id}` |
| - | - | - | - |
| `none` | `없음` | `object`와 `id`만 포함 | 403 |
| `no_email` | `이메일 없이` | 이름과 아바타까지 포함 | 200 |
| `email` | `이메일 포함` | `person.email`과 `person.email_verified`까지 포함 | 200 |

이 값은 다음 동작에도 영향을 줍니다.

| 위치 | `none` | `no_email` | `email` |
| - | - | - | - |
| 사람 멘션의 `plain_text` | `@Anonymous` | `@이름` | `@이름` |
| 수식 `name()` | 빈 텍스트 | 이름 | 이름 |
| 수식 `email()` | 빈 텍스트 | **이메일** | 이메일 |
| 사람 속성에 사람 쓰기 | 404 | 200 | 200 |
| 사람 필터 `people.contains` | 동작함 | 동작함 | 동작함 |

> [!WARNING]
>
> `이메일 없이`여도 수식의 `email()`은 이메일을 반환합니다. 사용자 객체에는 이메일이 없어도, 이 수식 속성이 있는 데이터베이스에서는 이메일을 읽을 수 있습니다.

봇은 이 값과 상관없이 이름이 표시됩니다. 봇 객체는 `{ "object": "user", "id": "...", "name": "...", "avatar_url": null, "type": "bot", "bot": {} }`입니다.

`none`이면 사람 속성에는 봇과 빈 값만 쓸 수 있습니다. 이미 들어 있는 사람을 다시 보내도 404를 반환합니다.

`none`이면 사람 목록을 텍스트로 바꾸는 수식의 값은 이름이 비어 있고, 수식의 `map`에서 그 사람이 빠지지 않습니다.


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