Bulk Remove Workspace Members

DELETE

https://api.webflow.com/v2/workspaces/:workspace_id/members/bulk

DELETE

/v2/workspaces/:workspace_id/members/bulk

curl -X DELETE https://api.webflow.com/v2/workspaces/580e63e98c9a982ac9b8b741/members/bulk \
     -H "Authorization: Bearer <token>"

{
  "summary": {
    "removed": 2,
    "failed": 2
  },
  "results": [
    {
      "id": "62fa5e47f6b8256f4641c5bd",
      "type": "member",
      "outcome": "removed"
    },
    {
      "id": "63fa5e47f6b8256f4641c5bf",
      "type": "invite",
      "outcome": "removed"
    },
    {
      "id": "62fa5e47f6b8256f4641c5be",
      "type": "member",
      "outcome": "failed",
      "error": {
        "code": "workspace_member_managed_by_scim",
        "message": "This member is managed by your identity provider. Change their role there instead — a write here would be reverted by the next directory sync."
      }
    },
    {
      "id": "62fa5e47f6b8256f4641c5c0",
      "type": "member",
      "outcome": "failed",
      "error": {
        "code": "internal_error",
        "message": "This item may not have been removed. Check the workspace's members and invites before retrying."
      }
    }
  ]
}

Remove multiple members from a workspace and cancel multiple pending invites, in one request. This is the only endpoint that cancels an invite. Remove Workspace Member removes active members only.

Removing a member revokes their access to the whole workspace and frees their seat. Cancelling an invite stops it from being accepted. Both are broader than Revoke Site Access, which removes a person from one site and leaves their workspace membership in place.

This endpoint shares its path with Bulk Update Workspace Member Roles. POST changes roles. DELETE removes members and cancels invites.

Partial success

This endpoint answers 200 once it has processed the batch, even when some or all of the items failed. Individual ids can fail while others succeed, so read summary and results instead of relying on the status code. Match each result back to your input by id, not by position. Ids are deduplicated before processing, so results can be shorter than the request.

A 4xx response means the whole request was refused before anything was removed. It carries no per-item report.

A failed item is left unchanged, with one exception. If an item fails with internal_error, the member or invite may already have been removed. Check the list of workspace members before you retry it.

Enterprise Only

This endpoint requires an Enterprise workspace.

Required scope | workspace_members:write

Authentication

AuthorizationBearer

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

Path parameters

workspace_idstringRequiredformat: "objectid"

Unique identifier for a Workspace

Request

Requires at least one of memberIds or inviteIds. Their combined length is capped at 100. IDs must be lowercase; a mixed-case ID fails validation with a 400.

memberIdslist of stringsOptional

IDs of active Members to remove

inviteIdslist of stringsOptional

IDs of pending invites to cancel

Response

Request was processed. Check results for per-item outcomes.

summaryobject

Counts of removed and failed items

resultslist of objects

Result for each id. Match results to the request by id, not by position.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error