Skip to content

Commit 0a6ba2c

Browse files
authored
[Audit Logs] Document Audit Logs v2 organization-level support (#30231)
1 parent 65e6a66 commit 0a6ba2c

2 files changed

Lines changed: 37 additions & 0 deletions

File tree

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
---
2+
title: Audit Logs v2 — Organization-level support
3+
description: Audit Logs v2 now supports organization-level audit logs.
4+
products:
5+
- audit-logs
6+
date: 2026-04-23
7+
---
8+
9+
Audit Logs v2 now supports organization-level audit logs. Org Admins can retrieve audit events for actions performed at the organization level via the Audit Logs v2 API.
10+
11+
To retrieve organization-level audit logs, use the following endpoint:
12+
13+
```bash
14+
GET https://api.cloudflare.com/client/v4/organizations/{organization_id}/logs/audit
15+
```
16+
17+
This release covers user-initiated actions performed through organization-level APIs. Audit logs for system-initiated actions, a dashboard UI, and Logpush support for organizations will be added in future releases.
18+
19+
:::note
20+
Organization-level audit logs are separate from account-level audit logs. Actions performed within a specific account continue to be available via the account-level Audit Logs UI, Audit Logs v2 API, and Logpush.
21+
:::
22+
23+
For more information, refer to the [Audit Logs documentation](/fundamentals/account/account-security/audit-logs/).

src/content/docs/fundamentals/account/account-security/audit-logs.mdx

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -159,6 +159,20 @@ Reflect actions associated with a user's login (email) across multiple accounts.
159159

160160
The `GET /memberships` endpoint supports cross-account access. To query memberships, use the parameter `resource_scope=memberships`.
161161

162+
#### Organization Activity Logs
163+
164+
Contain events scoped to specific Cloudflare organizations. These logs capture user-initiated actions performed by Org Admins through organization-level APIs and are retrievable via the Audit Logs v2 API.
165+
166+
```bash
167+
GET https://api.cloudflare.com/client/v4/organizations/{organization_id}/logs/audit
168+
```
169+
170+
:::note
171+
Organization-level audit logs are separate from account-level audit logs. Actions performed within a specific account continue to be available via the account-level Audit Logs UI, Audit Logs v2 API, and Logpush.
172+
173+
This initial release covers user-initiated actions only. Support for system-initiated actions, a dashboard UI, and Logpush for organizations will be added in future releases.
174+
:::
175+
162176
## Example how to query Audit Logs
163177

164178
Use the following example to get a list of audit logs for a user account.

0 commit comments

Comments
 (0)