Delete Prompt
Prompts
Delete Prompt
DELETE
Delete Prompt
Deletes a prompt and all its version history. If a specific version number is provided, only that version snapshot is deleted.
Benefits:
Authentication
Requires JWT Bearer token (Cognito) with admin role.Path Parameters
string
required
Prompt UUID to deleteFormat: UUIDExample:
550e8400-e29b-41d4-a716-446655440000Query Parameters
number
If provided, deletes only this specific version snapshot rather than the entire promptExample:
2Useful for cleaning up old version history without removing the prompt itself.Response
Status:204 No Content
No response body is returned on successful deletion.
Example Request (Delete Entire Prompt)
Example Request (Delete Specific Version)
Error Responses
error
Missing or invalid Bearer token
error
Forbidden — admin role required
error
Prompt or version not found
Cascade Behavior
When deleting an entire prompt (noversion parameter):
- The prompt record is deleted from the
promptstable - All version snapshots in
prompt_versionsare deleted (CASCADE) - All comments in
prompt_commentsare deleted (CASCADE) - All change records in
prompt_changesare deleted (CASCADE)
version parameter):
- Only the specified version snapshot is removed from
prompt_versions - The prompt itself and other versions remain intact
- A change record is created with type
DELETE
Deletion Tracking
When a prompt is deleted:- A final change record is created in
prompt_changeswith:changeType: DELETEauthorId: User who deleted the promptcreatedAt: Deletion timestamp
- The change record persists even after the prompt is deleted (foreign key allows NULL)
Soft Delete Alternative
Consider using theisActive flag as a soft delete:
- Preserves full history and comments
- Can be reactivated later
- Allows filtering out inactive prompts in the UI
Source Code
Implementation:packages/api/src/prompts/prompts.controller.ts:179