> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tiro.ooo/llms.txt
> Use this file to discover all available pages before exploring further.

# 조직 단위로 연동하기

> 조직 API 키는 조직 소속 워크스페이스 전체의 노트에 닿아요. 접근 범위와 호출할 수 있는 엔드포인트를 정리했어요.

조직 API 키는 **조직 소속 워크스페이스 전체의 노트**에 닿는 서버-투-서버 연동용 키예요. 인증과 웹훅이 동작하는 방식은 일반 API 키와 똑같고, 다른 점은 **접근 범위**뿐이에요.

* 인증 방식과 키 종류 비교: [인증](/ko/developers/fundamentals/authentication)
* 조직 단위 웹훅으로 이벤트를 받는 방법: [Webhook 개요](/ko/developers/webhooks/webhooks-overview)

<Note>
  조직 API 키와 조직 웹훅은 조직 **관리자**만 발급·등록할 수 있어요.
</Note>

## 조직 API 키는 어디까지 닿나요?

조직 API 키는 조직에 소속된 워크스페이스에 들어 있는 노트에 닿아요. 조직 밖 개인 워크스페이스의 노트에는 닿지 않아요.

## 조직 API 키로 호출할 수 있는 엔드포인트

조직 API 키는 아래 엔드포인트로 조직과 워크스페이스, 노트를 조회해요.

| 엔드포인트                                     | 용도                                                                         |
| ----------------------------------------- | -------------------------------------------------------------------------- |
| `GET /v1/external/organizations/me`       | 키가 연결된 조직 확인                                                               |
| `GET /v1/external/workspaces`             | 조직 소속 워크스페이스 목록 (조직 키면 전체 반환)                                              |
| `GET /v1/external/organizations/me/notes` | 조직 소속 워크스페이스의 종료된 노트 목록 (`endedAfter`·`endedBefore`로 기간 한정, cursor 페이지네이션) |
| `GET /v1/external/notes/{noteGuid}`       | 개별 노트 메타데이터 조회                                                             |

<Warning>
  조직 키는 구성원 전체의 노트에 접근할 수 있으므로 보관과 접근 통제에 유의하세요. 유출이 의심되면 즉시 조직 콘솔에서 회수하고 재발급하세요. 키의 secret은 발급 시점에만 표시돼요.
</Warning>

## Next steps

<CardGroup cols={2}>
  <Card title="인증" icon="key" href="/ko/developers/fundamentals/authentication">
    API 키 종류별 접근 범위와 발급 방법
  </Card>

  <Card title="Webhook 개요" icon="webhook" href="/ko/developers/webhooks/webhooks-overview">
    이벤트 구조, 재시도 정책, 검증 방법
  </Card>
</CardGroup>