POST/bases/rows/delete-many

Delete rows from a base

Deletes multiple rows from a base in one request. Supply the base page ID in pageId and between 1 and 500 row IDs in rowIds. A 200 response confirms that the rows were deleted.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

2 body fields

Base and row identifiers for the rows to delete. pageId and rowIds are required.

pageIdstringrequired
Id of the base. A base *is* a page, so this is the base's page id - the same id you would pass to the page endpoints.
rowIdsarray<string>required
The UUIDs of the rows to delete. Include between 1 and 500 row IDs.

4 status codes
200Returns a success response confirming that the rows were deleted.
dataunknownoptional
Response payload
statusintegeroptional
successbooleanoptional
400Returned when the request fails validation, such as when `pageId` or `rowIds` is missing or `rowIds` contains fewer than 1 or more than 500 items.
errorstringoptional
Reason phrase, for example `Bad Request`.
messagestringoptional
statusCodeintegeroptional
403Returned when the request is forbidden or bases are not included in the current licence.
errorstringoptional
Reason phrase, for example `Bad Request`.
messagestringoptional
statusCodeintegeroptional
404Returned when the base is not found.
errorstringoptional
Reason phrase, for example `Bad Request`.
messagestringoptional
statusCodeintegeroptional

Error handling

pageId and rowIds are required, and rowIds must contain between 1 and 500 UUIDs; invalid input returns a 400. A 403 is returned when the authenticated user is forbidden from deleting rows or bases are not included in the current licence. A 404 is returned when the base does not exist.