API reference

API reference · Account

Delete stored files no film uses

POST/api/studio/storage/cleanSigned in session

The ids named (from the storage view's unused.ids) are judged again when the request comes: only a file still unused, in this account's own scope and ready is deleted, with its stored bytes once nothing else names them. An id a film took up since is kept and counted in kept. A 404 with code storage_off while the operator keeps no files for the studio. The signed in account; same origin for a write.

Request body

application/json, required

Request body fields
FieldTypeWhat it is
idsrequiredarray of string

Example

{
  "ids": [
    "string"
  ]
}

Answer 200

What was deleted and what was kept.

Fields of the 200 answer
FieldTypeWhat it is
object"studio.storage.cleaned"
deletedinteger
filesinteger
bytesinteger
keptinteger

Errors

  • 400OpenAI shaped error.
  • 401OpenAI shaped error.
  • 403OpenAI shaped error.
  • 404OpenAI shaped error.
  • 429OpenAI shaped error.

Every error answers in one shape, with its type, code and the field it names. The whole list is in the docs' Errors section.

Antimatter