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

1## Get a skill by its ID.

2 

3**get** `/skills/{skill_id}`

4 

5Get a skill by its ID.

6 

7### Path Parameters

8 

9- `skill_id: string`

10 

11### Returns

12 

13- `Skill object { id, created_at, default_version, 4 more }`

14 

15 - `id: string`

16 

17 Unique identifier for the skill.

18 

19 - `created_at: number`

20 

21 Unix timestamp (seconds) for when the skill was created.

22 

23 - `default_version: string`

24 

25 Default version for the skill.

26 

27 - `description: string`

28 

29 Description of the skill.

30 

31 - `latest_version: string`

32 

33 Latest version for the skill.

34 

35 - `name: string`

36 

37 Name of the skill.

38 

39 - `object: "skill"`

40 

41 The object type, which is `skill`.

42 

43 - `"skill"`

44 

45### Example

46 

47```http

48curl https://api.openai.com/v1/skills/$SKILL_ID \

49 -H "Authorization: Bearer $OPENAI_API_KEY"

50```

51 

52#### Response

53 

54```json

55{

56 "id": "id",

57 "created_at": 0,

58 "default_version": "default_version",

59 "description": "description",

60 "latest_version": "latest_version",

61 "name": "name",

62 "object": "skill"

63}

64```