Tables
Delete a record
Deletes one record from a table.
DEL
https://app.getera.io/api/v1/tables/{tableId}/records/{recordId}API key
Deletes the record. The same rules apply as deleting on screen: if a link blocks deletion (a parent record that still has children), the request is refused.
Authentication
An API key in the x-api-key header; the permission Tables needs to delete. See Authentication.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
tableId | UUID | Yes | The table's id. |
recordId | UUID | Yes | The record's id. |
Example
curl -X DELETE https://app.getera.io/api/v1/tables/3f2a9c1e-0000-4000-8000-000000000001/records/8b1d0c4e-0000-4000-8000-000000000010 \
-H "x-api-key: ERA_API_KEY"Response
{ "id": "8b1d0c4e-0000-4000-8000-000000000010" }Errors
| Status | When |
|---|---|
401 | Missing or invalid key. |
403 | No permission, or the key's owner is not in the workspace. |
404 | Record or table not found. |
409 | A rule refused it. Example code values: row_not_found, row_policy_denies, referenced_by_relation. |
429 | Rate limit. |