Get Workspace Audit Logs | Webflow Developer Documentation

import requests
url = "https://api.webflow.com/beta/workspaces/hitchhikers-workspace/audit_logs"
querystring = {"limit":"100","offset":"0","eventType":"user_access","from":"2025-06-22T16:00:31Z","to":"2025-07-22T16:00:31Z"}
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

{
  "items": [
    {
      "eventType": "user_access",
      "eventSubType": "login",
      "payload": {
        "method": "dashboard",
        "location": "Ashburn US",
        "ipAddress": "54.165.18.93"
      },
      "timestamp": "2025-04-29T20:30:06.622Z",
      "actor": {
        "id": "6661ccb359b561c69f29d554",
        "email": "someone@email.com"
      },
      "workspace": {
        "id": "6621ccb459b561c69f29d57c",
        "slug": "hitchhikers-workspace"
      }
    },
    {
      "eventType": "workspace_membership",
      "eventSubType": "user_added",
      "payload": {
        "targetUser": {
          "id": "60492e55bbddce079561cd7a",
          "email": "someone@webflow.com"
        },
        "method": "sso",
        "userType": "member",
        "roleName": "member"
      },
      "timestamp": "2025-04-30T20:30:06.622Z",
      "actor": {
        "id": "60492e55bbddce079561cd7a",
        "email": "someone@webflow.com"
      },
      "workspace": {
        "id": "6621ccb459b561c69f29d57c",
        "slug": "hitchhikers-workspace"
      }
    },
    {
      "eventType": "site_membership",
      "eventSubType": "user_added",
      "payload": {
        "site": {
          "id": "67dc519889286123da057175",
          "slug": "hitchhikers-site"
        },
        "targetUser": {
          "id": "672946bf5d384ea895bb95e2",
          "email": "someone@webflow.com"
        },
        "method": "dashboard",
        "userType": "member",
        "roleName": "Edit - Cannot publish",
        "granularAccess": {
          "id": "67dc519889286123da057175",
          "name": "Blogs",
          "type": "cms",
          "restricted": false
        }
      },
      "timestamp": "2025-04-30T00:33:31.793Z",
      "actor": {
        "id": "671fe00d185fc8c1ad409d37",
        "email": "someone@webflow.com"
      },
      "workspace": {
        "id": "6621ccb459b561c69f29d57c",
        "slug": "hitchhikers-workspace"
      }
    }
  ],
  "pagination": {
    "limit": 10,
    "offset": 0,
    "total": 3
  }
}

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

Get audit logs for a workspace. <Warning title="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.</Warning> Required scope | `workspace_activity:read`

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

workspace_id_or_slugstringRequiredformat: "objectid"

Unique identifier or slug for a Workspace

Query parameters

limitintegerOptional

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

offsetintegerOptional

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

sortOrderenumOptional

Sorts the results by asc or desc

Allowed values:

eventTypeenumOptional

The event type to filter by

fromstringOptionalformat: "date-time"

The start date to filter by

tostringOptionalformat: "date-time"

The end date to filter by

Response

A list of workspace audit logs

itemslist of objects

paginationobject

Pagination object

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error