EddytorDocs & API
Tables

Compact small files into larger ones to improve read performance

Rewrites many small Parquet files into fewer, larger ones. This is a non-destructive operation — the original files are replaced atomically via a Delta Lake commit. **Required scope:** `tables:modify`

POST
/v1/tables/{catalog}/{schema}/{table_name}/optimize

Authorization

BearerAuth
AuthorizationBearer <token>

Security scheme for OpenAPI endpoints. Validates both JWT tokens and API keys.

In: header

Path Parameters

catalog*string
schema*string
table_name*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Request body for the optimize table endpoint.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/tables/string/string/string/optimize" \  -H "Content-Type: application/json" \  -d '{}'
{  "filesAdded": 0,  "filesRemoved": 0}
Empty
Empty
{  "code": "string",  "message": "string",  "request_id": "string",  "details": [    {      "field": "string",      "message": "string"    }  ]}
{  "code": "string",  "message": "string",  "request_id": "string",  "details": [    {      "field": "string",      "message": "string"    }  ]}
{  "code": "string",  "message": "string",  "request_id": "string",  "details": [    {      "field": "string",      "message": "string"    }  ]}
{  "code": "string",  "message": "string",  "request_id": "string",  "details": [    {      "field": "string",      "message": "string"    }  ]}
{  "code": "string",  "message": "string",  "request_id": "string",  "details": [    {      "field": "string",      "message": "string"    }  ]}
{  "code": "string",  "message": "string",  "request_id": "string",  "details": [    {      "field": "string",      "message": "string"    }  ]}
{  "code": "string",  "message": "string",  "request_id": "string",  "details": [    {      "field": "string",      "message": "string"    }  ]}
{  "code": "string",  "message": "string",  "request_id": "string",  "details": [    {      "field": "string",      "message": "string"    }  ]}
{  "code": "string",  "message": "string",  "request_id": "string",  "details": [    {      "field": "string",      "message": "string"    }  ]}

Rename a table to a new path within the same storage configuration

Renames all Delta table files (parquet data + `_delta_log/`) from the current storage path to a new path in the same store. The table is deregistered from the old path and re-discovered at the new path. **Required scope:** `storage:write`

Delete unreferenced files older than the retention period

Removes Parquet files that are no longer referenced by any version of the Delta table and are older than the retention period. Use `dry_run: true` to preview which files would be deleted. **Required scope:** `tables:modify`