cli/resources/skills/methods/retrieve/index.md +0 −67 deleted
File Deleted View Diff
1## Get a skill by its ID.
2
3`$ openai skills retrieve`
4
5**get** `/skills/{skill_id}`
6
7Get a skill by its ID.
8
9### Parameters
10
11- `--skill-id: string`
12
13 The identifier of the skill to retrieve.
14
15### Returns
16
17- `skill: object { id, created_at, default_version, 4 more }`
18
19 - `id: string`
20
21 Unique identifier for the skill.
22
23 - `created_at: number`
24
25 Unix timestamp (seconds) for when the skill was created.
26
27 - `default_version: string`
28
29 Default version for the skill.
30
31 - `description: string`
32
33 Description of the skill.
34
35 - `latest_version: string`
36
37 Latest version for the skill.
38
39 - `name: string`
40
41 Name of the skill.
42
43 - `object: "skill"`
44
45 The object type, which is `skill`.
46
47### Example
48
49```cli
50openai skills retrieve \
51 --api-key 'My API Key' \
52 --skill-id skill_123
53```
54
55#### Response
56
57```json
58{
59 "id": "id",
60 "created_at": 0,
61 "default_version": "default_version",
62 "description": "description",
63 "latest_version": "latest_version",
64 "name": "name",
65 "object": "skill"
66}
67```