resources/skills/methods/create/index.md 2026-07-07 08:02 UTC to 2026-07-09 20:58 UTC

1## Create a new skill.

2 

3**post** `/skills`

4 

5Create a new skill.

6 

7### Body Parameters

8 

9- `files: optional array of string or string`

10 

11 Skill files to upload (directory upload) or a single zip file.

12 

13 - `array of string`

14 

15 Skill files to upload (directory upload) or a single zip file.

16 

17 - `string`

18 

19 Skill zip file to upload.

20 

21### Returns

22 

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

24 

25 - `id: string`

26 

27 Unique identifier for the skill.

28 

29 - `created_at: number`

30 

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

32 

33 - `default_version: string`

34 

35 Default version for the skill.

36 

37 - `description: string`

38 

39 Description of the skill.

40 

41 - `latest_version: string`

42 

43 Latest version for the skill.

44 

45 - `name: string`

46 

47 Name of the skill.

48 

49 - `object: "skill"`

50 

51 The object type, which is `skill`.

52 

53 - `"skill"`

54 

55### Example

56 

57```http

58curl https://api.openai.com/v1/skills \

59 -X POST \

60 -H "Authorization: Bearer $OPENAI_API_KEY"

61```

62 

63#### Response

64 

65```json

66{

67 "id": "id",

68 "created_at": 0,

69 "default_version": "default_version",

70 "description": "description",

71 "latest_version": "latest_version",

72 "name": "name",

73 "object": "skill"

74}

75```