Bulk-delete objects from a bucket

Soft-deletes up to 1000 objects from one bucket in a single call, then removes their stored bytes in one batched operation, so all freed bytes stop counting immediately.

Endpoint

POST https://api.dairo.app/v1/buckets/{bucketId}/objects/batch-delete

Soft-deletes up to 1000 objects from one bucket in a single call, then removes their stored bytes in one batched operation, so all freed bytes stop counting immediately. objectIds is required and must be non-empty; repeated ids are de-duplicated. Ownership is checked per id: an unknown, foreign, or already-deleted id is reported in the response's failed array with a reason and never aborts the call, while successfully removed ids are returned in deleted. Requires buckets:write.

Scope: buckets:write. Send the API key as a bearer token; Scopes lists what each one reaches.

Request

cURL

curl -X POST "https://api.dairo.app/v1/buckets/3fa85f64-5717-4562-b3fc-2c963f66afa6/objects/batch-delete" \
  -H "Authorization: Bearer $DAIRO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "objectIds": [
      "3fa85f64-5717-4562-b3fc-2c963f66afa6"
    ]
  }'

Path parameters

Name	Type	Required	Description
`bucketId`	string	yes	Bucket identifier (buk_*).

Body

Required, application/json: BatchDeleteBucketObjectsRequest.

Field	Type	Required	Description
`objectIds`	array of string (uuid)	yes	The storage object ids to delete (1-1000). (min items 1, max items 1000)

Response

200 Success. Body: application/json, BatchDeleteResult.

Field	Type	Required	Description
`object`	`"batch_delete_result"`	yes
`deleted`	array of string	yes	The ids that were successfully deleted.
`failed`	array of object	yes	Per-id failures; never aborts the rest of the batch.

200

{
  "object": "batch_delete_result",
  "deleted": [
    "string"
  ],
  "failed": [
    {
      "id": "string",
      "error": "string"
    }
  ]
}

Errors

Every error has the same body, {"error": {"type", "code", "message", "param"}}; branch on code. Errors lists every code.

Status	Meaning
`400`	The request is malformed or a value is invalid (`invalid_request`, `invalid_domain`, `idempotency_key_mismatch`).
`401`	The API key is missing or invalid.
`403`	The key lacks the scope this endpoint needs (`scope_missing`) or may not do this (`not_permitted`).
`404`	No such resource in this account (`resource_not_found`).
`422`	The request is well-formed but a field failed validation (`validation_failed`).
`429`	Rate limit, plan limit, budget or spend cap reached (`rate_limited`, `plan_limit_reached`, `budget_exceeded`, `spend_cap_reached`).
`500`	An unexpected error; retry with backoff, then contact support (`internal_error`).