Skip to main content
DELETE
/
v1
/
tables
/
{table_id}
/
rows
Delete Table Rows
curl --request DELETE \
  --url https://api.extruct.ai/v1/tables/{table_id}/rows \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "rows": [
    "11111111-1111-1111-1111-111111111111",
    "22222222-2222-2222-2222-222222222222"
  ]
}
'
[
  "<string>"
]

​
Overview

This endpoint permanently removes one or more rows from a table. Deletion is bulk and row-ID based. Send the row IDs you want to remove in rows. Use it when you want to clean up bad inputs, remove duplicates, or drop rows you no longer want to run or keep.

​
Example request

export EXTRUCT_API_TOKEN="YOUR_API_TOKEN"
export TABLE_ID="YOUR_TABLE_ID"

curl -X DELETE "https://api.extruct.ai/v1/tables/${TABLE_ID}/rows" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${EXTRUCT_API_TOKEN}" \
  -d '{
    "rows": [
      "11111111-1111-1111-1111-111111111111",
      "22222222-2222-2222-2222-222222222222"
    ]
  }'

​
Key parameters

  • table_id (required): target table identifier.
  • rows (required): array of row IDs to delete.

​
Success signal

A successful response returns the deleted row IDs.

​
Common errors

​
401 Unauthorized

Check that your header is Authorization: Bearer ${EXTRUCT_API_TOKEN}.

​
404 Not Found

The table ID is invalid or unavailable in your workspace.

​
422 Unprocessable Entity

Most often caused by missing rows, malformed JSON, or invalid row ID values.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
table_id
string
required

Body

application/json
​
rows
string<uuid>[]
required

List of row IDs to delete.

Response

Successful Response