Skip to main content
DELETE
Deletes one prompt draft version for an agent. The route only deletes versions with status: "DRAFT"; published prompt versions and archived versions are not deleted by this endpoint. Use this route to discard a staged prompt change that should not be reviewed or published.
Deleting a draft removes it from normal prompt history reads. It does not change the agent’s active prompt configuration.

Headers

string
required
Bearer token containing your Fini workspace API key. Format: Bearer fini_... The key needs write scope.

Path parameters

string
required
Agent ID that owns the draft.
string
required
Exact draft version ID to delete.

Response

Returns 204 No Content when the delete succeeds. The response body is empty.

Errors

The API key is missing, malformed, revoked, or invalid.
The API key does not include write scope.
The version does not exist for this agent or is not a draft.
The agent belongs to a different workspace.