Web API

Press shift + S to search API reference.

Records

Delete multiple records

deletehttps://api.airtable.com/v0/{baseId}/{tableIdOrName}

Deletes records given an array of record ids

Requirements

AuthenticationPersonal access token, OAuth integration
Scopedata.records:write
User role

Base editor

Billing plansAll plans

Path parameters

baseId
string
tableIdOrName
string

Query parameters

records
optional<array of strings>

The recordIds of each record to be deleted. Up to 10 recordIds can be provided.

Response format

records
array of the below object
id
string

Record ID

deleted
true
Request (example)
Copy
$
curl -X DELETE "https://api.airtable.com/v0/{baseId}/{tableIdOrName}\
?records[]=rec560UJdUtocSouk&records[]=rec3lbPRG4aVqkeOQ" \
-H "Authorization: Bearer YOUR_TOKEN"
200 – Response (example)
{
"records": [
{
"deleted": true,
"id": "rec560UJdUtocSouk"
},
{
"deleted": true,
"id": "rec3lbPRG4aVqkeOQ"
}
]
}