# 자기 정책 읽기 API

> GET /v1/agents/{agentId}/policy로 에이전트가 자기 발신·수신 모드와 목록, 한도를 읽습니다. 바꾸는 API는 없습니다.

```http
GET /v1/agents/{agentId}/policy
```

**자기 정보**(`agent:read_self`) 권한이 필요합니다. MCP의 `get_my_policy`와 같은 내용이고, MCP 쪽에는 기본 발신 주소(`from_address`)가 더해집니다.

| 필드 | 뜻 |
|---|---|
| `policy_version` | 지금 정책 버전. 소유자가 바꿀 때마다 올라갑니다. |
| `outbound.mode` | 발신 모드: `all`, `allowlist`, `blocklist`, `none`. 예전 모드면 `legacy` |
| `outbound.allow` | 발신 허용 목록 |
| `outbound.block_count` | 발신 차단 목록 개수(내용은 보이지 않습니다) |
| `inbound.mode` · `inbound.allow` · `inbound.block_count` | 수신 쪽 같은 값 |
| `limits` | 실제로 걸리는 한도: `per_minute`, `per_hour`, `per_day`, `recipients_per_message`, `org_daily_recipients` |
| `plan` | 조직의 요금제 |
| `how_to_change` | 정책을 바꾸는 방법 안내(소유자가 콘솔에서) |

정책이 바뀌는 중이면 `409 policy_changing`입니다. 잠시 뒤 다시 읽습니다.

정책은 에이전트가 바꿀 수 없습니다. 보내야 할 상대가 막혀 있으면 소유자에게 허용 목록에 넣어 달라고 요청합니다.

---

원문: https://docs.atmark.ai/api/policy · 마지막 수정 2026-09-27