Delete rows
curl --request POST \
--url https://api.airscale.io/v1/tables/{table_id}/rows/deleteconst url = 'https://api.airscale.io/v1/tables/{table_id}/rows/delete';
const options = {method: 'POST'};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));import requests
url = "https://api.airscale.io/v1/tables/{table_id}/rows/delete"
response = requests.post(url)
print(response.text)Delete rows
Delete up to 1,000 rows by ID. Rate limit: 10 write requests per minute per workspace, one write at a time per workspace, plus 60 requests per minute per API key. Rows count toward 5,000 rows per minute and 100,000 rows per UTC day per workspace.
POST
/
v1
/
tables
/
{table_id}
/
rows
/
delete
Delete rows
curl --request POST \
--url https://api.airscale.io/v1/tables/{table_id}/rows/deleteconst url = 'https://api.airscale.io/v1/tables/{table_id}/rows/delete';
const options = {method: 'POST'};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));import requests
url = "https://api.airscale.io/v1/tables/{table_id}/rows/delete"
response = requests.post(url)
print(response.text)Send the row
See limits, retries and error codes for shared behavior.
ids to delete. IDs that are unknown, already deleted or in another table are skipped; the response lists only the rows that were deleted.
Deleted rows disappear from the API and the app. Contact support to restore them. This endpoint uses POST so the list of IDs can be sent in the body.
Paid plans only. No credits are charged. Limits: 10 write requests per minute per workspace, one write at a time per workspace, plus 60 requests per minute per API key. Rows count toward 5,000 rows per minute and 100,000 rows per UTC day per workspace. See the Tables API overview for every limit.
Authentication
SendAuthorization: Bearer $AIRSCALE_API_KEY. The key determines the workspace. See Authentication.
Parameters
| Name | Location | Required | Description |
|---|---|---|---|
table_id | path | Yes | Table ID returned by Create table or List tables. |
Idempotency-Key | header | No | Reuse the same key and identical body when retrying this operation. A changed body with the same key returns 409 idempotency_conflict. |
JSON body
| Field | Type | Required | Description |
|---|---|---|---|
ids | array | Yes | 1–1000 items. |
Request example
Replace path variables with IDs returned by the API. Column UUIDs in the example body must belong to your table.curl --request POST "https://api.airscale.io/v1/tables/$TABLE_ID/rows/delete" \
--header "Authorization: Bearer $AIRSCALE_API_KEY" \
--header "Idempotency-Key: deleteTableRows-001" \
--header "Content-Type: application/json" \
--data '{
"ids": [
"4f9f5468-c311-4ee9-a85f-536e3e8b7a7b",
"00000000-0000-4000-8000-000000000000"
]
}'
Response
200
Rows were deleted.{
"deleted": 1,
"ids": [
"4f9f5468-c311-4ee9-a85f-536e3e8b7a7b"
]
}
Errors
| Status | Meaning |
|---|---|
| 400 | Invalid body or IDs. |
| 401 | Missing or invalid API key. |
| 403 | The workspace does not have an active paid plan. |
| 404 | Table not found in this workspace, or deleted. |
| 409 | A conflicting table operation is running. |
| 429 | A rate limit, the one-write-at-a-time rule or a daily limit was reached. Wait for Retry-After before retrying. |
| 502 | The service could not be reached. Retry with backoff. |
| 503 | The service is at capacity or temporarily unavailable. Retry after Retry-After. |
| 504 | The request timed out after 30 seconds. A write may still have been applied; check the result before retrying it. |