Get Workspace Audit Logs

GET

https://api.webflow.com/v2/workspaces/:workspace_id_or_slug/audit_logs

GET

/v2/workspaces/:workspace_id_or_slug/audit_logs

curl -G https://api.webflow.com/v2/workspaces/hitchhikers-workspace/audit_logs \
     -H "Authorization: Bearer <token>" \
     -d limit=100 \
     -d offset=0 \
     -d eventType=user_access \
     --data-urlencode from=2025-06-22T16:00:31Z \
     --data-urlencode to=2025-07-22T16:00:31Z

{
  "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": {
        "type": "person",
        "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": {
        "type": "person",
        "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": {
        "type": "person",
        "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

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 objectsOptional

paginationobjectOptional

Pagination object

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error