Web API

Press shift + S to search API reference.

Collaborators

Delete workspace collaborator

deletehttps://api.airtable.com/v0/meta/workspaces/{workspaceId}/collaborators/{userOrGroupId}

Delete a workspace collaborator.

Requirements

AuthenticationPersonal access token, OAuth integration
ScopeworkspacesAndBases:write
User role

Workspace collaborators subject to sharing restrictions

Billing plansEnterprise (pre-2023.08 legacy plan), Enterprise Scale

Path parameters

workspaceId
string
userOrGroupId
string

Response format

This endpoint returns an empty response on success.

Error responses

Remove sole owner (403)
A workspace must have at least 1 owner who's responsible for the workspace's bill. Alternatively, [add another workspace owner](workspace-addWorkspaceCollaborators) before deleting the current owner.
{
"error": {
"message": "Sole owner of a workspace cannot be removed",
"type": "INVALID_PERMISSIONS"
}
}