EddytorDocs & API
Storages

Delete a storage configuration

Soft-deletes the storage configuration from the database and notifies the engine to clean up DataFusion registrations. All tables associated with this configuration will become inaccessible. This action cannot be undone. **Required scope:** `storage:configure` (+ `storage_configs:share` for workspace-shared configs)

DELETE
/v1/storages/configs/{config_id}

Authorization

BearerAuth
AuthorizationBearer <token>

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

In: header

Path Parameters

config_id*string
Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/v1/storages/configs/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "configId": "46ff6d11-d8b2-40d8-9197-dfa33c61cd6c",  "configName": "string",  "message": "string"}
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"    }  ]}

Update a storage configuration

Updates the discovery settings and/or name of an existing storage configuration. After updating, the engine is notified to clear caches and re-run discovery so that the changes take effect immediately. **Required scope:** `storage:configure` (+ `storage_configs:share` for workspace-shared configs)

Attach a storage configuration to a workspace

Two cases (ED-544): - **Personal config the caller owns** → promoted to workspace ownership. The promoter can undo within a short window (see the undo endpoint). - **Workspace-owned config** → re-attached to the target workspace. Requires Admin/Builder access to BOTH the current and the target workspace, and extinguishes any pending promote-undo window. The config id is stable in both cases, so its `cfg_{id}` catalog schema and every registered table keep resolving. Gaining access is additive — new members pick the config up on their next discovery refresh. *Losing* it is not: a re-attach drops the source workspace members' engine sessions so the config stops resolving for them immediately. Attaching to the default workspace is a deliberate org-wide share. **Required scope:** `storage_configs:share` (plus Admin or Builder access to the workspace(s) involved)