감사 이벤트 나열

얻다 /api/v1/organizations/{id}/audit-events

베어러 인증

조직 활동 피드 (조직의 프로젝트 전체에서 수행된 조치)를 최신 항목부터 반환합니다. 페이지가 매겨진 키 세트/ 커서 .

경로 매개변수

id 문자열 필수 사항

감사 피드를 읽을 조직

쿼리 매개변수

PROJECT_ID 문자열

프로젝트 별 필터링
limit integer

페이지당 최대 이벤트 수(기본값 50, 최대 200)
cursor 문자열

다음 페이지를 위한 불투명한 키 세트 커서
조치 문자열

조치 별 필터링(예: 에이전트. 배포)
카테고리 문자열

카테고리별 필터링: 액세스 또는 변형
Actor_email 문자열

행위자 이메일 로 필터링
결과 문자열

결과별 필터링: 성공 또는 실패
start_time 문자열

시간 범위 시작(RFC3339)
end_time 문자열

시간 범위 종료(RFC3339)
show_admin_events 부울

관리자 이벤트(연산자 작업 및 GSA 런타임 이벤트)를 포함합니다. 기본값 false 숨김

응답

406

application/json

application/json 애플리케이션/vnd.agent-engine-2026-09-20-preview+json

지원되지 않거나 잘못된 API 버전, 선택한 게시된 계약에서 사용할 수 없는 작업 또는 허용되지 않는 표현(지원되지 않는 미디어 유형 매개변수 또는 제외된 SSE 포함). 기존 인증, 권한 부여 및 속도 제한 실패가 우선적으로 적용됩니다.
응답 속성 숨기기 응답 속성 표시 객체
- badRequestDetail 객체
  
  표준 오류 스키마 에 정의된 선택적 유효성 검사 세부 정보입니다. API 협상 오류는 이 필드 내보내지 않습니다.
  
  badRequestDetail 속성 숨기기 badRequestDetail 속성 표시 객체
  
  필드 배열[객체]
  
  유효성 검사 에 실패한 필드입니다.
  
  필드 속성 숨기기 필드 속성 표시 객체
  
  필드 및 해당 유효성 검사 실패.
  
  description 문자열 필수 사항
  
  사람이 읽을 수 있는 유효성 검사 실패.
  
  필드 문자열 필수 사항
  
  잘못된 요청 필드 의 이름 또는 경로입니다.
- 세부 정보 문자열 필수 사항
  
  사람이 읽을 수 있는 오류 세부 정보.
- 오류 integer 필수 사항
  
  HTTP status code.
- 오류 코드 문자열 필수 사항
  
  기계가 읽을 수 있는 오류 코드입니다.
- 매개변수 array[string]
  
  오류와 관련된 요청 매개변수 이름입니다. 적용 않는 경우 생략됩니다.
- 이유 문자열 필수 사항
  
  HTTP 상태 이유 구문입니다.
응답 속성 숨기기 응답 속성 표시 객체
- badRequestDetail 객체
  
  표준 오류 스키마 에 정의된 선택적 유효성 검사 세부 정보입니다. API 협상 오류는 이 필드 내보내지 않습니다.
  
  badRequestDetail 속성 숨기기 badRequestDetail 속성 표시 객체
  
  필드 배열[객체]
  
  유효성 검사 에 실패한 필드입니다.
  
  필드 속성 숨기기 필드 속성 표시 객체
  
  필드 및 해당 유효성 검사 실패.
  
  description 문자열 필수 사항
  
  사람이 읽을 수 있는 유효성 검사 실패.
  
  필드 문자열 필수 사항
  
  잘못된 요청 필드 의 이름 또는 경로입니다.
- 세부 정보 문자열 필수 사항
  
  사람이 읽을 수 있는 오류 세부 정보.
- 오류 integer 필수 사항
  
  HTTP status code.
- 오류 코드 문자열 필수 사항
  
  기계가 읽을 수 있는 오류 코드입니다.
- 매개변수 array[string]
  
  오류와 관련된 요청 매개변수 이름입니다. 적용 않는 경우 생략됩니다.
- 이유 문자열 필수 사항
  
  HTTP 상태 이유 구문입니다.
200

애플리케이션/vnd.agent-engine-2026-09-20-preview+json

애플리케이션/vnd.agent-engine-2026-09-20-preview+json application/json

확인
응답 속성 숨기기 응답 속성 표시 객체
- audit_events 배열[객체]
  
  audit_events 속성 숨기기 audit_events 속성 표시 객체
  
  조치 문자열
  
  값은 agent.deploy, agent.rollback, agent.promote, secret.set, secret.delete, workspace_logs.view, data_viewer_access.grant, data_viewer_access.revoke, support_access.grant, support_access.revoke, service_account.create, service_account.rotate_secret, service_account.revoke, service_account.reactivate, service_account.replace_roles, service_account.token_mint, service_account.token_use, service_account.authz_denied, service_account.ip_access_list.update, oe_profile.capture, oe_profile.download, workspace.delete, project.delete, workspace.deletion_delivered, workspace.restoration_delivered, app_secrets.reclaim, project_secrets.reclaim, api_key_secrets.reclaim, ecr_repository.delete, namespace.delete, atlas_service_account.retire, workspace_records.purge, project_records.purge, project.reclaim, project_platform_target.select, project_staged_rollout.start, project_staged_rollout.resume, app_platform_update.accept, project_operation.force_cancel, project_operation.request_cancel, app_operation.request_cancel, project_operation.resume, runtime_config.set, runtime_config.clear, trace.view, application_secret.migrate, egress_allow_all.migrate, egress.save, guardrail.create, guardrail.update, guardrail.delete, policy.create, policy.update, policy.delete, credential_provider.create, credential_provider.update 또는 credential_provider.delete.
  
  배우 객체
  
  행위자 속성 숨기기 행위자 속성 표시 객체
  
  client_id 문자열
  
  ClientID는 Type이 ActorTypeServiceAccount인 경우 글로벌 서비스 계정 클라이언트 ID입니다.
  
  이메일 문자열
  
  roles array[string]
  
  역할은 조치 시점에 기록된 행위자의 역할 (있는 경우)입니다. 선택 사항.
  
  유형 문자열
  
  유형에 따라 행위자 종류가 구분됩니다. 비어 있음 또는 ActorTypeUser는 UserID/Email로 식별되는 사람을 의미합니다. ActorTypeServiceAccount는 ClientID로 식별되는 GSA를 의미합니다(UserID/Email이 비어 있을 수 있음).
  
  user_id 문자열
  
  카테고리 문자열
  
  값은 access 또는 mutation입니다.
  
  Failure_reason 문자열
  
  id 문자열
  
  metadata 객체
  
  추가 속성이 허용됩니다.
  
  결과 문자열
  
  값은 success 또는 failure입니다.
  
  범위 객체
  
  범위 속성 숨기기 범위 속성 표시 객체
  
  org_id 문자열
  
  PROJECT_ID 문자열
  
  Workspace_id 문자열
  
  source_ip 문자열
  
  대상 객체
  
  대상 속성 숨기기 대상 속성 표시 객체
  
  id 문자열
  
  이름 문자열
  
  유형 문자열
  
  유형은 리소스 종류입니다(예: 'workspace_logs', 'deployment', 'secret').
  
  timestamp 문자열
- has_more 부울
- Next_cursor 문자열
응답 속성 숨기기 응답 속성 표시 객체
- audit_events 배열[객체]
  
  audit_events 속성 숨기기 audit_events 속성 표시 객체
  
  조치 문자열
  
  값은 agent.deploy, agent.rollback, agent.promote, secret.set, secret.delete, workspace_logs.view, data_viewer_access.grant, data_viewer_access.revoke, support_access.grant, support_access.revoke, service_account.create, service_account.rotate_secret, service_account.revoke, service_account.reactivate, service_account.replace_roles, service_account.token_mint, service_account.token_use, service_account.authz_denied, service_account.ip_access_list.update, oe_profile.capture, oe_profile.download, workspace.delete, project.delete, workspace.deletion_delivered, workspace.restoration_delivered, app_secrets.reclaim, project_secrets.reclaim, api_key_secrets.reclaim, ecr_repository.delete, namespace.delete, atlas_service_account.retire, workspace_records.purge, project_records.purge, project.reclaim, project_platform_target.select, project_staged_rollout.start, project_staged_rollout.resume, app_platform_update.accept, project_operation.force_cancel, project_operation.request_cancel, app_operation.request_cancel, project_operation.resume, runtime_config.set, runtime_config.clear, trace.view, application_secret.migrate, egress_allow_all.migrate, egress.save, guardrail.create, guardrail.update, guardrail.delete, policy.create, policy.update, policy.delete, credential_provider.create, credential_provider.update 또는 credential_provider.delete.
  
  배우 객체
  
  행위자 속성 숨기기 행위자 속성 표시 객체
  
  client_id 문자열
  
  ClientID는 Type이 ActorTypeServiceAccount인 경우 글로벌 서비스 계정 클라이언트 ID입니다.
  
  이메일 문자열
  
  roles array[string]
  
  역할은 조치 시점에 기록된 행위자의 역할 (있는 경우)입니다. 선택 사항.
  
  유형 문자열
  
  유형에 따라 행위자 종류가 구분됩니다. 비어 있음 또는 ActorTypeUser는 UserID/Email로 식별되는 사람을 의미합니다. ActorTypeServiceAccount는 ClientID로 식별되는 GSA를 의미합니다(UserID/Email이 비어 있을 수 있음).
  
  user_id 문자열
  
  카테고리 문자열
  
  값은 access 또는 mutation입니다.
  
  Failure_reason 문자열
  
  id 문자열
  
  metadata 객체
  
  추가 속성이 허용됩니다.
  
  결과 문자열
  
  값은 success 또는 failure입니다.
  
  범위 객체
  
  범위 속성 숨기기 범위 속성 표시 객체
  
  org_id 문자열
  
  PROJECT_ID 문자열
  
  Workspace_id 문자열
  
  source_ip 문자열
  
  대상 객체
  
  대상 속성 숨기기 대상 속성 표시 객체
  
  id 문자열
  
  이름 문자열
  
  유형 문자열
  
  유형은 리소스 종류입니다(예: 'workspace_logs', 'deployment', 'secret').
  
  timestamp 문자열
- has_more 부울
- Next_cursor 문자열
400

application/json

application/json 애플리케이션/vnd.agent-engine-2026-09-20-preview+json

잘못된 요청
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
401

application/json

application/json 애플리케이션/vnd.agent-engine-2026-09-20-preview+json

승인되지 않음
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
403

application/json

application/json 애플리케이션/vnd.agent-engine-2026-09-20-preview+json

Forbidden
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
500

application/json

application/json 애플리케이션/vnd.agent-engine-2026-09-20-preview+json

내부 서버 오류
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울

GET /api/v1/organizations/{id}/audit-events

curl \
 --request GET 'https://agentengine.mongodb.com/api/v1/organizations/{id}/audit-events' \
 --header "Authorization: $API_KEY"

응답 예시(406)

{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}

{
  "detail": "This operation supports text/event-stream, which the Accept header excludes. Remove unsupported media-type parameters or accept this type with a positive q value.",
  "error": 406,
  "errorCode": "UNACCEPTABLE_MEDIA_TYPE",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}

{
  "detail": "The requested API version is not supported. Supported versions: 2026-09-20-preview.",
  "error": 406,
  "errorCode": "UNSUPPORTED_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}

응답 예시(406)

{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}

응답 예시(200)

{
  "audit_events": [
    {
      "action": "agent.deploy",
      "actor": {
        "client_id": "string",
        "email": "string",
        "roles": [
          "string"
        ],
        "type": "string",
        "user_id": "string"
      },
      "category": "access",
      "failure_reason": "string",
      "id": "string",
      "metadata": {},
      "outcome": "success",
      "scope": {
        "org_id": "string",
        "project_id": "string",
        "workspace_id": "string"
      },
      "source_ip": "string",
      "target": {
        "id": "string",
        "name": "string",
        "type": "string"
      },
      "timestamp": "string"
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}

응답 예시(200)

{
  "audit_events": [
    {
      "action": "agent.deploy",
      "actor": {
        "client_id": "string",
        "email": "string",
        "roles": [
          "string"
        ],
        "type": "string",
        "user_id": "string"
      },
      "category": "access",
      "failure_reason": "string",
      "id": "string",
      "metadata": {},
      "outcome": "success",
      "scope": {
        "org_id": "string",
        "project_id": "string",
        "workspace_id": "string"
      },
      "source_ip": "string",
      "target": {
        "id": "string",
        "name": "string",
        "type": "string"
      },
      "timestamp": "string"
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}

응답 예시(400)

{
  "code": "string",
  "error": "string",
  "success": true
}

응답 예시(400)

{
  "code": "string",
  "error": "string",
  "success": true
}

응답 예시(401)

{
  "code": "string",
  "error": "string",
  "success": true
}

응답 예시(401)

{
  "code": "string",
  "error": "string",
  "success": true
}

응답 예시(403)

{
  "code": "string",
  "error": "string",
  "success": true
}

응답 예시(403)

{
  "code": "string",
  "error": "string",
  "success": true
}

응답 예시(500)

{
  "code": "string",
  "error": "string",
  "success": true
}

응답 예시(500)

{
  "code": "string",
  "error": "string",
  "success": true
}