Documentation

API reference

Delete a managed file

DELETE/v1/files/{file_id}

Historical files for the same account and key. Valid keys with exhausted quota are allowed; revoked/expired keys are still rejected. Downloads require ready; deletion while referenced returns 409. retry only retries saving the original result, not generation. Ordinary APIs use day-based retention, persistent tasks protect references, and expires_at=0 means no fixed expiration.

Authentication and permissions

Use your current GloopAPI key. Available models, capabilities and permissions depend on its catalog and the endpoint documentation.

Authorization: Bearer $GLOOP_API_KEY

Authentication schemes: BearerAuth

Request

Path parameters

  • file_idstringRequired

    Public ID of a managed file belonging to the same key.

Responses and errors

HTTP 204

Managed file deleted successfully

No response body.

HTTP 400

Invalid request fields or parameters.

application/json

Type
object
Required fields
error

HTTP 401

The key is missing, invalid, expired, or revoked.

application/json

Type
object
Required fields
error

HTTP 403

Insufficient IP, account, model, or tool permissions.

application/json

Type
object
Required fields
error

HTTP 404

Object/capability unavailable, or feature switch disabled.

application/json

Type
object
Required fields
error

HTTP 409

Idempotency/quote conflict, object not ready, or still referenced.

application/json

Type
object
Required fields
error

HTTP 429

Request/queue rate limit.

application/json

Type
object
Required fields
error

HTTP 500

Internal authentication or data storage failure.

application/json

Type
object
Required fields
error

HTTP 503

Service, pricing, or storage unavailable.

application/json

Type
object
Required fields
error