Web API

Press shift + S to search API reference.

SCIM

Delete user

deletehttps://airtable.com/scim/v2/Users/{userId}

Delete a single SCIM user.

The endpoint cannot be used to delete the admin that owns the authentication token used to make the request.
The endpoint cannot be used to delete the sole owner of a workspace that has multiple collaborators.

See SCIM specification for more.

Requirements

AuthenticationPersonal access token, OAuth integration
Scopeenterprise.scim.usersAndGroups:manage
User role

Enterprise admin

Admins of multiple enterprises should use a service account's token when calling this route.
Billing plansBusiness, Enterprise (pre-2023.08 legacy plan), Enterprise Scale

Path parameters

userId
string

Response format

This endpoint returns an empty response on success.

Error responses

Unknown user ID (404)
With an unknown User ID
{
"detail": "user not found",
"schemas": [
"urn:ietf:params:scim:api:messages:2.0:Error"
],
"status": 404
}
Against own id (422)
Delete called against own ID
{
"detail": "Cannot perform deletion operation on own account",
"schemas": [
"urn:ietf:params:scim:api:messages:2.0:Error"
],
"status": 422
}
Against sole owner of workspace with multiple collaborators (422)
Delete called against sole owner of workspace with multiple collaborators
{
"detail": "Cannot delete the sole owner of a workspace containing multiple collaborators",
"schemas": [
"urn:ietf:params:scim:api:messages:2.0:Error"
],
"status": 422
}