API Reference

Skills

Versions

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Delete a skill version.

client.skills.versions.delete(stringversion, VersionDeleteParams { skill_id } params, RequestOptionsoptions?): DeletedSkillVersion { id, deleted, object, version }

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

Delete a skill version.

ParametersExpand Collapse

version: string

The skill version number.

params: VersionDeleteParams { skill_id }

skill_id: string

The identifier of the skill.

ReturnsExpand Collapse

DeletedSkillVersion { id, deleted, object, version }

id: string

deleted: boolean

object: "skill.version.deleted"

version: string

The deleted skill version.

Delete a skill version.

TypeScript

HTTP

TypeScript

Python

Java

Go

Ruby

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env['OPENAI_API_KEY'], // This is the default and can be omitted
});

const deletedSkillVersion = await client.skills.versions.delete('version', {
  skill_id: 'skill_123',
});

console.log(deletedSkillVersion.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"
}