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

1## Get a specific skill version.

2 

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

4 

5Get a specific skill version.

6 

7### Path Parameters

8 

9- `skill_id: string`

10 

11- `version: string`

12 

13 The version number to retrieve.

14 

15### Returns

16 

17- `SkillVersion object { id, created_at, description, 4 more }`

18 

19 - `id: string`

20 

21 Unique identifier for the skill version.

22 

23 - `created_at: number`

24 

25 Unix timestamp (seconds) for when the version was created.

26 

27 - `description: string`

28 

29 Description of the skill version.

30 

31 - `name: string`

32 

33 Name of the skill version.

34 

35 - `object: "skill.version"`

36 

37 The object type, which is `skill.version`.

38 

39 - `"skill.version"`

40 

41 - `skill_id: string`

42 

43 Identifier of the skill for this version.

44 

45 - `version: string`

46 

47 Version number for this skill.

48 

49### Example

50 

51```http

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

53 -H "Authorization: Bearer $OPENAI_API_KEY"

54```

55 

56#### Response

57 

58```json

59{

60 "id": "id",

61 "created_at": 0,

62 "description": "description",

63 "name": "name",

64 "object": "skill.version",

65 "skill_id": "skill_id",

66 "version": "version"

67}

68```