Passer à la navigation

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.

Authentification

x-api-keystring
Authentification par clé API via en-tête

Paramètres de chemin

idstringRequis
A unique identifier for the generation.

Réponse

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.
Valeurs autorisées:
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 nullOptionnel
playbackMediaUrlstring or nullOptionnel
Browser playback URL, using a preview when available. Use outputMediaUrl or the download endpoint for the original output. Returned on project responses.
creatorNamestring or nullOptionnel
outputFileNamestring or nullOptionnel
outputExtensionstring or nullOptionnel
generationEstimateobject or nullOptionnel

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

Erreurs

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