Skip to main content

Delete Prompts and Prompt Version Tags via REST API#

March 30, 2026

Available in arize-phoenix 13.20.0+

Two new REST endpoints let you delete prompts and remove tags from prompt versions programmatically.

DELETE /v1/prompts/{prompt_identifier} deletes a prompt and all of its versions, tags, and labels in one operation. The prompt_identifier can be the prompt name or its numeric ID.

DELETE /v1/prompt_versions/{prompt_version_id}/tags/{tag_name} removes a single named tag from a specific prompt version. The tag is resolved within the scope of the prompt linked to that version.

  • DELETE /v1/prompts/{prompt_identifier} — permanently deletes the prompt and every version, tag, and label associated with it
  • DELETE /v1/prompt_versions/{prompt_version_id}/tags/{tag_name} — removes a tag from a prompt version without affecting other tags or the version itself
  • Both endpoints return 204 No Content on success; attempting to delete a non-existent tag returns 404 Not Found