Updates the permission level of a collaborator on a base.
Collaborators
Update collaborator base permission
patch
https://api.airtable.com/v0/meta/bases/{baseId}/collaborators/{userOrGroupId}
Authentication | Personal access token, OAuth integration |
Scope | workspacesAndBases:write |
User role | Base collaborators subject to sharing restrictions |
Billing plans | Enterprise (pre-2023.08 legacy plan), Enterprise Scale |
Response format
This endpoint returns an empty response on success.
Error responses
Not base collaborator (403)
This route can only be used for users who are already collaborators on the base. To add a new collaborator, use the [add base collaborator](base-addBaseCollaborators) route.
{"error": {"message": "Invalid permissions","type": "INVALID_PERMISSIONS"}}
Request (example)
Copy
$curl -X PATCH "https://api.airtable.com/v0/meta/bases/{baseId}/collaborators/{userOrGroupId}" \-H "Authorization: Bearer YOUR_TOKEN" \-H "Content-Type: application/json" \--data '{"permissionLevel": "read"}'