GenerationsDelete generation

Generations

Delete generation API

Delete the output files of a finished generation right away. The record and its billing stay.

DELETEhttps://serastudio.app/api/v1/generations/{id}

Usage notes

  • The key needs the delete permission.
  • Deletes the MP4, the thumbnail and the working copies. The generation stays readable with output: null and output_deleted: true.
  • A queued or in-progress generation cannot be deleted (409 not_deletable); cancel it or wait for it to finish.
  • Without a delete, the files are removed 7 days after the generation finished.
  • Calling it again returns the current state with 200.

Quick start

curl -X DELETE https://serastudio.app/api/v1/generations/0b6e2c1a-7c1a-4f5e-9a51-2b3c4d5e6f70 \
  -H "Authorization: Bearer $SERA_API_KEY"

Response

{
  "id": "0b6e2c1a-7c1a-4f5e-9a51-2b3c4d5e6f70",
  "object": "generation",
  "model": "siren",
  "status": "succeeded",
  "created_at": "2026-11-09T05:11:02.000Z",
  "finished_at": "2026-11-09T05:14:40.000Z",
  "input": {
    "source": {
      "upload_id": "vid_3f2c7a9e-5d1b-4c8e-9f20-7a6b5c4d3e21"
    },
    "images": [
      {
        "upload_id": "img_9a0b8c7d-6e5f-4a3b-8c2d-1e0f9a8b7c6d"
      }
    ],
    "prompt": "Keep the motion.",
    "resolution": "720p",
    "source_duration_s": 9.4,
    "webhook_url": null
  },
  "progress": null,
  "output": null,
  "output_deleted": true,
  "error": null,
  "billing": {
    "currency": "usd",
    "resolution": "720p",
    "usd_per_second": 0.175,
    "discount_pct": 0,
    "held_usd": 3.5,
    "charged_usd": 3.5,
    "restored_usd": 0,
    "settled": true
  },
  "idempotency_key": "order-1182"
}

Errors

StatusCodeWhen it happensRetry
401api_key_missingNo Bearer key was sent in the Authorization header.No
401api_key_invalidThe key is malformed or unknown.No
401api_key_revokedThe key was deleted in the console.No
401api_key_disabledThe key is disabled in the console.No
401api_key_expiredThe key is past its expiration date.No
403insufficient_scopeThe key lacks the delete permission. Keys created in the console have it.No
403workspace_forbiddenThe account that owns the workspace is suspended or scheduled for deletion.No
404not_foundNo generation with that id exists in this workspace.No
409not_deletableThe generation is still queued or in progress.No
503temporarily_unavailableThe request could not be completed just now.Yes
500internal_errorSomething failed on our side. The request_id identifies the request.Yes
503api_unavailableThe API is turned off.No