python/resources/skills/methods/delete/index.md 2026-05-18 22:01 UTC to 2026-05-19 06:34 UTC

1## Delete a skill by its ID.

2 

3`skills.delete(strskill_id) -> DeletedSkill`

4 

5**delete** `/skills/{skill_id}`

6 

7Delete a skill by its ID.

8 

9### Parameters

10 

11- `skill_id: str`

12 

13### Returns

14 

15- `class DeletedSkill: …`

16 

17 - `id: str`

18 

19 - `deleted: bool`

20 

21 - `object: Literal["skill.deleted"]`

22 

23 - `"skill.deleted"`

24 

25### Example

26 

27```python

28import os

29from openai import OpenAI

30 

31client = OpenAI(

32 api_key=os.environ.get("OPENAI_API_KEY"), # This is the default and can be omitted

33)

34deleted_skill = client.skills.delete(

35 "skill_123",

36)

37print(deleted_skill.id)

38```

39 

40#### Response

41 

42```json

43{

44 "id": "id",

45 "deleted": true,

46 "object": "skill.deleted"

47}

48```