resources/skills/methods/retrieve/index.md +0 −64 deleted
File Deleted View Diff
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```