Get Workspace Audit Logs

GET

Get audit logs for a workspace.

Enterprise & workspace API token only

This endpoint requires an Enterprise workspace and a workspace token with the workspace_activity:read scope. Create a workspace token from your workspace dashboard integrations page to use this endpoint.

Required scope | workspace_activity:read

Path parameters

workspace_id_or_slugstringRequired

Unique identifier or slug for a Workspace

Query parameters

limitdoubleOptional

Maximum number of records to be returned (max limit: 100)

offsetdoubleOptional

Offset used for pagination if the results have more than limit records

sortOrderenumOptional

Sorts the results by asc or desc

Allowed values: ascdesc

eventTypeenumOptional

The event type to filter by

Allowed values: user_accesscustom_roleworkspace_membershipsite_membershipworkspace_invitation

fromdatetimeOptional

The start date to filter by

todatetimeOptional

The end date to filter by

Response

A list of workspace audit logs

itemslist of objectsOptional

paginationobjectOptional

Pagination object

Errors

GET

1 curl -G https://api.webflow.com/v2/workspaces/hitchhikers-workspace/audit_logs \
2      -H "Authorization: Bearer <token>" \
3      --data-urlencode from=2024-04-22T16:00:31Z \
4      --data-urlencode to=2024-04-22T16:00:31Z

200Retrieved

1 {
2   "items": [
3     {
4       "eventType": "user_access",
5       "actor": {
6         "id": "6661ccb359b561c69f29d554",
7         "email": "someone@email.com"
8       },
9       "eventSubType": "login",
10       "payload": {
11         "method": "dashboard",
12         "location": "Ashburn US",
13         "ipAddress": "54.165.18.93"
14       },
15       "timestamp": "2025-04-29T20:30:06Z",
16       "workspace": {
17         "id": "6621ccb459b561c69f29d57c",
18         "slug": "hitchhikers-workspace"
19       }
20     },
21     {
22       "eventType": "workspace_membership",
23       "actor": {
24         "id": "60492e55bbddce079561cd7a",
25         "email": "someone@webflow.com"
26       },
27       "eventSubType": "user_added",
28       "payload": {
29         "targetUser": {
30           "id": "60492e55bbddce079561cd7a",
31           "email": "someone@webflow.com"
32         },
33         "method": "sso",
34         "userType": "member",
35         "roleName": "member"
36       },
37       "timestamp": "2025-04-30T20:30:06Z",
38       "workspace": {
39         "id": "6621ccb459b561c69f29d57c",
40         "slug": "hitchhikers-workspace"
41       }
42     },
43     {
44       "eventType": "site_membership",
45       "actor": {
46         "id": "671fe00d185fc8c1ad409d37",
47         "email": "someone@webflow.com"
48       },
49       "eventSubType": "user_added",
50       "payload": {
51         "site": {
52           "id": "67dc519889286123da057175",
53           "slug": "hitchhikers-site"
54         },
55         "targetUser": {
56           "id": "672946bf5d384ea895bb95e2",
57           "email": "someone@webflow.com"
58         },
59         "method": "dashboard",
60         "userType": "member",
61         "roleName": "Edit - Cannot publish"
62       },
63       "timestamp": "2025-04-30T00:33:31Z",
64       "workspace": {
65         "id": "6621ccb459b561c69f29d57c",
66         "slug": "hitchhikers-workspace"
67       }
68     }
69   ],
70   "pagination": {
71     "limit": 10,
72     "offset": 0,
73     "total": 3
74   }
75 }

Event Types and Payload Schemas

Up Next

Built with

1	curl -G https://api.webflow.com/v2/workspaces/hitchhikers-workspace/audit_logs \
2	-H "Authorization: Bearer <token>" \
3	--data-urlencode from=2024-04-22T16:00:31Z \
4	--data-urlencode to=2024-04-22T16:00:31Z

1	{
2	"items": [
3	{
4	"eventType": "user_access",
5	"actor": {
6	"id": "6661ccb359b561c69f29d554",
7	"email": "someone@email.com"
8	},
9	"eventSubType": "login",
10	"payload": {
11	"method": "dashboard",
12	"location": "Ashburn US",
13	"ipAddress": "54.165.18.93"
14	},
15	"timestamp": "2025-04-29T20:30:06Z",
16	"workspace": {
17	"id": "6621ccb459b561c69f29d57c",
18	"slug": "hitchhikers-workspace"
19	}
20	},
21	{
22	"eventType": "workspace_membership",
23	"actor": {
24	"id": "60492e55bbddce079561cd7a",
25	"email": "someone@webflow.com"
26	},
27	"eventSubType": "user_added",
28	"payload": {
29	"targetUser": {
30	"id": "60492e55bbddce079561cd7a",
31	"email": "someone@webflow.com"
32	},
33	"method": "sso",
34	"userType": "member",
35	"roleName": "member"
36	},
37	"timestamp": "2025-04-30T20:30:06Z",
38	"workspace": {
39	"id": "6621ccb459b561c69f29d57c",
40	"slug": "hitchhikers-workspace"
41	}
42	},
43	{
44	"eventType": "site_membership",
45	"actor": {
46	"id": "671fe00d185fc8c1ad409d37",
47	"email": "someone@webflow.com"
48	},
49	"eventSubType": "user_added",
50	"payload": {
51	"site": {
52	"id": "67dc519889286123da057175",
53	"slug": "hitchhikers-site"
54	},
55	"targetUser": {
56	"id": "672946bf5d384ea895bb95e2",
57	"email": "someone@webflow.com"
58	},
59	"method": "dashboard",
60	"userType": "member",
61	"roleName": "Edit - Cannot publish"
62	},
63	"timestamp": "2025-04-30T00:33:31Z",
64	"workspace": {
65	"id": "6621ccb459b561c69f29d57c",
66	"slug": "hitchhikers-workspace"
67	}
68	}
69	],
70	"pagination": {
71	"limit": 10,
72	"offset": 0,
73	"total": 3
74	}
75	}