resources/skills/subresources/versions/methods/delete/index.md 2026-05-02 05:57 UTC to 2026-05-05 23:00 UTC

1## Delete a skill version.

2 

3**delete** `/skills/{skill_id}/versions/{version}`

4 

5Delete a skill version.

6 

7### Path Parameters

8 

9- `skill_id: string`

10 

11- `version: string`

12 

13 The skill version number.

14 

15### Returns

16 

17- `DeletedSkillVersion object { id, deleted, object, version }`

18 

19 - `id: string`

20 

21 - `deleted: boolean`

22 

23 - `object: "skill.version.deleted"`

24 

25 - `"skill.version.deleted"`

26 

27 - `version: string`

28 

29 The deleted skill version.

30 

31### Example

32 

33```http

34curl https://api.openai.com/v1/skills/$SKILL_ID/versions/$VERSION \

35 -X DELETE \

36 -H "Authorization: Bearer $OPENAI_API_KEY"

37```

38 

39#### Response

40 

41```json

42{

43 "id": "id",

44 "deleted": true,

45 "object": "skill.version.deleted",

46 "version": "version"

47}

48```