Move a base between two workspaces owned by the enterprise.
Workspaces
Move base
post
https://api.airtable.com/v0/meta/workspaces/{workspaceId}/moveBase
Authentication | Personal access token, OAuth integration |
Scope | workspacesAndBases:manage |
User role | Enterprise admin Admins of multiple enterprises
should use an enterprise-scoped token or a service account's token when calling this route. |
Billing plans | Enterprise (pre-2023.08 legacy plan), Enterprise Scale |
string ID of the base to be moved | |
string ID of the target workspace of the move. I.e. the workspace that the base will belong to once the move is complete. The target workspace must be in the same enterprise account as the source workspace. | |
optional< number > The desired index for the base in the target workspace's base order (optional). If provided, targetIndex must be a number between 0 (beginning of the list) and the number of bases in the target workspace (end of the list). If targetIndex is not provided, the base will be moved to the end of the list of bases in the target workspace. |
Response format
This endpoint returns an empty response on success.
Error responses
Not admin (403)
Only an admin can perform this action.
{"error": {"message": "You are not permitted to perform this operation","type": "INVALID_PERMISSIONS"}}
Request (example)
Copy
$curl -X POST "https://api.airtable.com/v0/meta/workspaces/{workspaceId}/moveBase" \-H "Authorization: Bearer YOUR_TOKEN" \-H "Content-Type: application/json" \--data '{"baseId": "appLkNDICXNqxSDhG","targetIndex": 0,"targetWorkspaceId": "wspmhESAta6clCCwF"}'