Manage dataset files (delete, restore, tag, archive restore)

PUT 
/datasets/:id/files

Performs bulk file operations. Operation values include delete, restore, permanent_delete, restore_from_archive, grant, revoke, update_tags. Caller must be owner or editor. Iceberg/Hudi/DeltaLake and many external targets block these ops (GE-1106 / DS-*). For grant/revoke set query action=tag_files. TruncateDataset is only valid with permanent_delete. Some ops are async (SF); Message indicates the accepted action.

Request

Responses

200

File operation accepted or completed. Message varies by Operation.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

400

Validation/auth failure. Codes include AUTH-1010, DS-1038 (invalid Operation), DS-1039 (TruncateDataset misuse), GE-1106 (unsupported dataset type), DS-1040/1073 and related file/lifecycle codes. GE-1034 is returned when the dataset is busy: either its DatasetStatus is not active (a reload, framework data load or an earlier truncate still holds it) or one or more files are still processing. Both are transient - retry once the current operation completes. The busy-dataset case previously returned DS-1002 ("Inactive DatasetId") as a 500.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

500

Backend/generic failure.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers