Documentation

API reference

Query managed files

GET/v1/files

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

Query parameters

  • afterintegerOptional

    Use next_cursor from the original response; the service fixes the page size at 50 items.

    Default value
    0
    Minimum
    0

Responses and errors

HTTP 200

Managed files queried successfully

application/json

Type
object
Required fields
datanext_cursor
  • dataarrayRequired
    data child fields (1)
    • []objectOptional
      [] child fields (13)
      • idstringRequired

        Public identifier of this object, used for its corresponding detail path.

      • source_kindstringRequired

        File source category; determines lifecycle and reference protection rules.

      • source_indexintegerRequired

        Source result item index.

      • modelstringRequired

        Public model ID from the current key's catalog.

      • statusstringRequired

        Background storage stages such as waiting/pending/archiving/ready/failed/deleting; download URLs are only available after ready.

      • mime_typestringRequired

        Verified file MIME type.

      • file_namestringRequired

        Public download filename.

      • sha256stringOptional

        SHA-256 of archived content, returned if determined.

      • size_bytesintegerRequired

        File size in bytes.

      • error_codestringOptional

        Public error code usable for branching logic.

      • created_atintegerRequired

        Creation time in Unix seconds.

      • updated_atintegerRequired

        Last update time in Unix seconds.

      • expires_atintegerRequired

        Unix seconds; 0 means long-term retention. Ordinary APIs follow the deployment's day-based retention policy. Persistent images/videos protect results with references, and deletion still retains billing and idempotency records.

  • next_cursorintegerRequired

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