API Reference

Skills

Versions

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Delete Skill Version

skills.versions.delete(strversion, VersionDeleteParams**kwargs) -> DeletedSkillVersion

DELETE/skills/{skill_id}/versions/{version}

Delete a skill version.

ParametersExpand Collapse

skill_id: str

version: str

The skill version number.

ReturnsExpand Collapse

class DeletedSkillVersion: …

id: str

deleted: bool

object: Literal["skill.version.deleted"]

version: str

The deleted skill version.

Delete Skill Version

Python

HTTP

Python

TypeScript

Go

Ruby

Java

CLI Tool

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("OPENAI_API_KEY"),  # This is the default and can be omitted
)
deleted_skill_version = client.skills.versions.delete(
    version="version",
    skill_id="skill_123",
)
print(deleted_skill_version.id)

200 example

{
  "id": "id",
  "deleted": true,
  "object": "skill.version.deleted",
  "version": "version"
}

Returns Examples

200 example

{
  "id": "id",
  "deleted": true,
  "object": "skill.version.deleted",
  "version": "version"
}