Compliance API

Compliance API는 Claude Enterprise 고객에게 조직의 Activity Feed(활동 피드), 연결된 모든 조직의 사용자·역할·그룹 디렉터리, 그리고 claude.ai 조직의 경우 기본 채팅, 파일 및 프로젝트에 대한 프로그래밍 방식의 접근을 제공합니다. 보안, 법무 및 규정 준수 팀은 이를 사용하여 활동을 감사하고, 콘텐츠를 조회하거나 삭제하며, 이벤트를 다운스트림 도구로 전달합니다.

다음 호출은 조직에서 가장 최근의 활동 이벤트를 반환합니다. read:compliance_activities 스코프를 가진 모든 키가 이 호출을 수행할 수 있습니다. 키를 생성하고 해당 스코프를 부여하려면 Compliance API 접근 권한 얻기를 참조하세요.

curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/activities?limit=1" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"

성공적인 응답은 data(Activity 레코드 배열), has_more, first_id, last_id를 포함하는 JSON 객체를 반환합니다:

{
  "data": [
    {
      "id": "activity_01XyDMpzjS89pFZXqSFUBDr6",
      "created_at": "2026-04-10T08:09:10Z",
      "organization_id": "org_01Wv6QeBcDfGhJkLmNpQrSt8",
      "organization_uuid": "abcdef01-2345-6789-abcd-ef0123456789",
      "actor": {
        "type": "user_actor",
        "email_address": "[email protected]",
        "user_id": "user_01TuVwXyZaBcDeFgH2JkLmN4",
        "ip_address": "192.0.2.34",
        "user_agent": "Mozilla/5.0..."
      },
      "type": "claude_chat_created",
      "claude_chat_id": "claude_chat_01XyDMpzjS89pFZXqSFUBDr6",
      "claude_project_id": "claude_proj_01KGp4eZNug9ri4kE35RSppq"
    }
  ],
  "has_more": true,
  "first_id": "activity_01XyDMpzjS89pFZXqSFUBDr6",
  "last_id": "activity_01XyDMpzjS89pFZXqSFUBDr6"
}

Compliance API 작동 방식

모든 엔드포인트는 https://api.anthropic.com의 /v1/compliance/* 아래에 위치하며 x-api-key 헤더를 통해 인증합니다. 키를 프로비저닝하려면 Compliance API 접근 권한 얻기를 참조하세요.

Activity Feed(GET /v1/compliance/activities)는 read:compliance_activities 스코프를 가진 모든 키에서 사용할 수 있습니다. 필터, 페이지네이션 및 전체 Activity 객체에 대해서는 Activity Feed 쿼리하기를 참조하세요. 나머지 엔드포인트는 관련 스코프를 가진 Compliance Access Key가 필요합니다.

Claude Enterprise 테넌트는 하나의 상위 조직(ID를 중앙에서 관리하는 최상위 컨테이너)과 두 종류의 연결된 조직을 가집니다. 하나는 사용자가 채팅하고 콘텐츠를 저장하는 claude.ai 조직이고, 다른 하나는 사용자가 Claude API 워크로드를 관리하는 Claude Console 조직입니다. 디렉터리 엔드포인트(조직, 사용자, 역할 및 그룹)는 두 종류의 연결된 모든 조직에서 데이터를 반환합니다. 콘텐츠 엔드포인트(채팅, 파일, 프로젝트 및 프로젝트 첨부 파일)는 claude.ai 데이터만 제공합니다.

모든 /v1/compliance/* 엔드포인트는 상위 조직당 분당 600개 요청이라는 단일 속도 제한을 공유합니다. 응답 헤더 및 재시도 규약에 대해서는 429 Too Many Requests를 참조하세요.

Compliance API와 관련 기능 비교

두 가지 인접 기능이 Compliance API와 겹칩니다. 다음은 선택 방법입니다.

감사 로그 내보내기

감사 로그 내보내기는 claude.ai > Organization settings > Data and privacy에 있는 별도의 기능으로, 소유자 및 기본 소유자가 조직 이벤트의 CSV를 다운로드할 수 있게 합니다. 이 기능은 Compliance API보다 훨씬 제한적입니다. 조회 기간이 제한되어 있고, CSV 다운로드만 가능하며, 채팅, 파일 또는 프로젝트 콘텐츠에 접근할 수 없습니다. 지속적인 프로그래밍 방식의 사용을 위해서는 Compliance API를 표준으로 사용하세요.

Analytics API

Anthropic은 두 가지 분석 API를 제공합니다. Claude Enterprise Analytics API와 Claude Code Analytics API입니다. 두 API 모두 IT, FinOps 및 플랫폼 팀을 위한 집계된 사용량 및 비용 수치를 반환하는 반면, Compliance API는 보안, 법무 및 규정 준수 팀을 위한 이벤트별 레코드를 반환합니다. 두 API 제품군은 서로 다른 질문에 답하고, 서로 다른 키를 사용하며, 별도로 프로비저닝됩니다.

이 섹션의 내용