Zur Navigation springen

delete generation

Delete a generation. Generations are organization-scoped, so any member — or an API key for the organization — can delete one. Only generations in a terminal state can be deleted; deleting one that is still processing returns 409 (errorCode generation_not_deletable_while_processing). Returns the deleted generation in its stored shape (modelName, inputs, outputMediaUrl, deletedAt), not the Get Generation shape.

Authentifizierung

x-api-keystring
API-Key-Authentifizierung via Header

Pfadparameter

idstringErforderlich
A unique identifier for the generation.

Antwort

The deleted generation, in the stored-generation shape.

idstring
A unique identifier for the generation.
organizationIdstring
userIdstring or null
apiKeyIdstring or null
createdAtdatetime
updatedAtdatetime
startedAtdatetime or null
finishedAtdatetime or null
statusenum
The status of the generation. COMPLETED, FAILED and REJECTED are terminal. For FAILED or REJECTED, inspect errorCode and errorMessage before retrying.
Erlaubte Werte:
modelobject
modelNamestring
inputslist of objects
webhookUrlstring or null
thumbnailUrlstring or null
frameCountdouble or null
optionsmap from strings to any

Persisted generation options, including server-owned fields. This is not a create-request options contract.

outputMediaUrlstring or null
segmentOutputMediaUrlstring or null
segmentOutputBucketPathstring or null
outputMediaLengthdouble or null
potentialErrorobject or null
isPublicboolean or null
deletedAtdatetime or null
projectIdstring or null
A unique identifier for a project.
segmentslist of objects or nullOptional
playbackMediaUrlstring or nullOptional
Browser playback URL, using a preview when available. Use outputMediaUrl or the download endpoint for the original output. Returned on project responses.
creatorNamestring or nullOptional
outputFileNamestring or nullOptional
outputExtensionstring or nullOptional
generationEstimateobject or nullOptional

A completion-time estimate produced when a generation is accepted.

Fehler

401
Unauthorized Error
404
Not Found Error
409
Conflict Error
500
Internal Server Error