Skills

Create a new skill.

post /skills

Create a new skill.

Body Parameters

files: optional array of string or string

Skill files to upload (directory upload) or a single zip file.
- array of string
  
  Skill files to upload (directory upload) or a single zip file.
- string
  
  Skill zip file to upload.

Returns

Skill object { id, created_at, default_version, 4 more }
- id: string
  
  Unique identifier for the skill.
- created_at: number
  
  Unix timestamp (seconds) for when the skill was created.
- default_version: string
  
  Default version for the skill.
- description: string
  
  Description of the skill.
- latest_version: string
  
  Latest version for the skill.
- name: string
  
  Name of the skill.
- object: "skill"
  
  The object type, which is skill.
  - "skill"

Example

curl https://api.openai.com/v1/skills \
    -X POST \
    -H "Authorization: Bearer $OPENAI_API_KEY"

Response

{
  "id": "id",
  "created_at": 0,
  "default_version": "default_version",
  "description": "description",
  "latest_version": "latest_version",
  "name": "name",
  "object": "skill"
}

List all skills for the current project.

get /skills

List all skills for the current project.

Query Parameters

after: optional string

Identifier for the last item from the previous pagination request
limit: optional number

Number of items to retrieve
order: optional "asc" or "desc"

Sort order of results by timestamp. Use asc for ascending order or desc for descending order.
- "asc"
- "desc"

Returns

SkillList object { data, first_id, has_more, 2 more }
- data: array of Skill
  
  A list of items
  - id: string
    
    Unique identifier for the skill.
  - created_at: number
    
    Unix timestamp (seconds) for when the skill was created.
  - default_version: string
    
    Default version for the skill.
  - description: string
    
    Description of the skill.
  - latest_version: string
    
    Latest version for the skill.
  - name: string
    
    Name of the skill.
  - object: "skill"
    
    The object type, which is skill.
    - "skill"
- first_id: string
  
  The ID of the first item in the list.
- has_more: boolean
  
  Whether there are more items available.
- last_id: string
  
  The ID of the last item in the list.
- object: "list"
  
  The type of object returned, must be list.
  - "list"

Example

curl https://api.openai.com/v1/skills \
    -H "Authorization: Bearer $OPENAI_API_KEY"

Response

{
  "data": [
    {
      "id": "id",
      "created_at": 0,
      "default_version": "default_version",
      "description": "description",
      "latest_version": "latest_version",
      "name": "name",
      "object": "skill"
    }
  ],
  "first_id": "first_id",
  "has_more": true,
  "last_id": "last_id",
  "object": "list"
}

Get a skill by its ID.

get /skills/{skill_id}

Get a skill by its ID.

Path Parameters

skill_id: string

Returns

Skill object { id, created_at, default_version, 4 more }
- id: string
  
  Unique identifier for the skill.
- created_at: number
  
  Unix timestamp (seconds) for when the skill was created.
- default_version: string
  
  Default version for the skill.
- description: string
  
  Description of the skill.
- latest_version: string
  
  Latest version for the skill.
- name: string
  
  Name of the skill.
- object: "skill"
  
  The object type, which is skill.
  - "skill"

Example

curl https://api.openai.com/v1/skills/$SKILL_ID \
    -H "Authorization: Bearer $OPENAI_API_KEY"

Response

{
  "id": "id",
  "created_at": 0,
  "default_version": "default_version",
  "description": "description",
  "latest_version": "latest_version",
  "name": "name",
  "object": "skill"
}

Update the default version pointer for a skill.

post /skills/{skill_id}

Update the default version pointer for a skill.

Path Parameters

skill_id: string

Body Parameters

default_version: string

The skill version number to set as default.

Returns

Skill object { id, created_at, default_version, 4 more }
- id: string
  
  Unique identifier for the skill.
- created_at: number
  
  Unix timestamp (seconds) for when the skill was created.
- default_version: string
  
  Default version for the skill.
- description: string
  
  Description of the skill.
- latest_version: string
  
  Latest version for the skill.
- name: string
  
  Name of the skill.
- object: "skill"
  
  The object type, which is skill.
  - "skill"

Example

curl https://api.openai.com/v1/skills/$SKILL_ID \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $OPENAI_API_KEY" \
    -d '{
          "default_version": "default_version"
        }'

Response

{
  "id": "id",
  "created_at": 0,
  "default_version": "default_version",
  "description": "description",
  "latest_version": "latest_version",
  "name": "name",
  "object": "skill"
}

Delete a skill by its ID.

delete /skills/{skill_id}

Delete a skill by its ID.

Path Parameters

skill_id: string

Returns

DeletedSkill object { id, deleted, object }
- id: string
- deleted: boolean
- object: "skill.deleted"
  - "skill.deleted"

Example

curl https://api.openai.com/v1/skills/$SKILL_ID \
    -X DELETE \
    -H "Authorization: Bearer $OPENAI_API_KEY"

Response

{
  "id": "id",
  "deleted": true,
  "object": "skill.deleted"
}

Domain Types

Deleted Skill

DeletedSkill object { id, deleted, object }
- id: string
- deleted: boolean
- object: "skill.deleted"
  - "skill.deleted"

Skill

Skill object { id, created_at, default_version, 4 more }
- id: string
  
  Unique identifier for the skill.
- created_at: number
  
  Unix timestamp (seconds) for when the skill was created.
- default_version: string
  
  Default version for the skill.
- description: string
  
  Description of the skill.
- latest_version: string
  
  Latest version for the skill.
- name: string
  
  Name of the skill.
- object: "skill"
  
  The object type, which is skill.
  - "skill"

Skill List

SkillList object { data, first_id, has_more, 2 more }
- data: array of Skill
  
  A list of items
  - id: string
    
    Unique identifier for the skill.
  - created_at: number
    
    Unix timestamp (seconds) for when the skill was created.
  - default_version: string
    
    Default version for the skill.
  - description: string
    
    Description of the skill.
  - latest_version: string
    
    Latest version for the skill.
  - name: string
    
    Name of the skill.
  - object: "skill"
    
    The object type, which is skill.
    - "skill"
- first_id: string
  
  The ID of the first item in the list.
- has_more: boolean
  
  Whether there are more items available.
- last_id: string
  
  The ID of the last item in the list.
- object: "list"
  
  The type of object returned, must be list.
  - "list"

Content

Download a skill zip bundle by its ID.

get /skills/{skill_id}/content

Download a skill zip bundle by its ID.

Path Parameters

skill_id: string

Example

curl https://api.openai.com/v1/skills/$SKILL_ID/content \
    -H "Authorization: Bearer $OPENAI_API_KEY"

Versions

Create a new immutable skill version.

post /skills/{skill_id}/versions

Create a new immutable skill version.

Path Parameters

skill_id: string

Body Parameters

default: optional boolean

Whether to set this version as the default.
files: optional array of string or string

Skill files to upload (directory upload) or a single zip file.
- array of string
  
  Skill files to upload (directory upload) or a single zip file.
- string
  
  Skill zip file to upload.

Returns

SkillVersion object { id, created_at, description, 4 more }
- id: string
  
  Unique identifier for the skill version.
- created_at: number
  
  Unix timestamp (seconds) for when the version was created.
- description: string
  
  Description of the skill version.
- name: string
  
  Name of the skill version.
- object: "skill.version"
  
  The object type, which is skill.version.
  - "skill.version"
- skill_id: string
  
  Identifier of the skill for this version.
- version: string
  
  Version number for this skill.

Example

curl https://api.openai.com/v1/skills/$SKILL_ID/versions \
    -X POST \
    -H "Authorization: Bearer $OPENAI_API_KEY"

Response

{
  "id": "id",
  "created_at": 0,
  "description": "description",
  "name": "name",
  "object": "skill.version",
  "skill_id": "skill_id",
  "version": "version"
}

List skill versions for a skill.

get /skills/{skill_id}/versions

List skill versions for a skill.

Path Parameters

skill_id: string

Query Parameters

after: optional string

The skill version ID to start after.
limit: optional number

Number of versions to retrieve.
order: optional "asc" or "desc"

Sort order of results by version number.
- "asc"
- "desc"

Returns

SkillVersionList object { data, first_id, has_more, 2 more }
- data: array of SkillVersion
  
  A list of items
  - id: string
    
    Unique identifier for the skill version.
  - created_at: number
    
    Unix timestamp (seconds) for when the version was created.
  - description: string
    
    Description of the skill version.
  - name: string
    
    Name of the skill version.
  - object: "skill.version"
    
    The object type, which is skill.version.
    - "skill.version"
  - skill_id: string
    
    Identifier of the skill for this version.
  - version: string
    
    Version number for this skill.
- first_id: string
  
  The ID of the first item in the list.
- has_more: boolean
  
  Whether there are more items available.
- last_id: string
  
  The ID of the last item in the list.
- object: "list"
  
  The type of object returned, must be list.
  - "list"

Example

curl https://api.openai.com/v1/skills/$SKILL_ID/versions \
    -H "Authorization: Bearer $OPENAI_API_KEY"

Response

{
  "data": [
    {
      "id": "id",
      "created_at": 0,
      "description": "description",
      "name": "name",
      "object": "skill.version",
      "skill_id": "skill_id",
      "version": "version"
    }
  ],
  "first_id": "first_id",
  "has_more": true,
  "last_id": "last_id",
  "object": "list"
}

Get a specific skill version.

get /skills/{skill_id}/versions/{version}

Get a specific skill version.

Path Parameters

skill_id: string
version: string

The version number to retrieve.

Returns

SkillVersion object { id, created_at, description, 4 more }
- id: string
  
  Unique identifier for the skill version.
- created_at: number
  
  Unix timestamp (seconds) for when the version was created.
- description: string
  
  Description of the skill version.
- name: string
  
  Name of the skill version.
- object: "skill.version"
  
  The object type, which is skill.version.
  - "skill.version"
- skill_id: string
  
  Identifier of the skill for this version.
- version: string
  
  Version number for this skill.

Example

curl https://api.openai.com/v1/skills/$SKILL_ID/versions/$VERSION \
    -H "Authorization: Bearer $OPENAI_API_KEY"

Response

{
  "id": "id",
  "created_at": 0,
  "description": "description",
  "name": "name",
  "object": "skill.version",
  "skill_id": "skill_id",
  "version": "version"
}

Delete a skill version.

delete /skills/{skill_id}/versions/{version}

Delete a skill version.

Path Parameters

skill_id: string
version: string

The skill version number.

Returns

DeletedSkillVersion object { id, deleted, object, version }
- id: string
- deleted: boolean
- object: "skill.version.deleted"
  - "skill.version.deleted"
- version: string
  
  The deleted skill version.

Example

curl https://api.openai.com/v1/skills/$SKILL_ID/versions/$VERSION \
    -X DELETE \
    -H "Authorization: Bearer $OPENAI_API_KEY"

Response

{
  "id": "id",
  "deleted": true,
  "object": "skill.version.deleted",
  "version": "version"
}

Domain Types

Deleted Skill Version

DeletedSkillVersion object { id, deleted, object, version }
- id: string
- deleted: boolean
- object: "skill.version.deleted"
  - "skill.version.deleted"
- version: string
  
  The deleted skill version.

Skill Version

SkillVersion object { id, created_at, description, 4 more }
- id: string
  
  Unique identifier for the skill version.
- created_at: number
  
  Unix timestamp (seconds) for when the version was created.
- description: string
  
  Description of the skill version.
- name: string
  
  Name of the skill version.
- object: "skill.version"
  
  The object type, which is skill.version.
  - "skill.version"
- skill_id: string
  
  Identifier of the skill for this version.
- version: string
  
  Version number for this skill.

Skill Version List

SkillVersionList object { data, first_id, has_more, 2 more }
- data: array of SkillVersion
  
  A list of items
  - id: string
    
    Unique identifier for the skill version.
  - created_at: number
    
    Unix timestamp (seconds) for when the version was created.
  - description: string
    
    Description of the skill version.
  - name: string
    
    Name of the skill version.
  - object: "skill.version"
    
    The object type, which is skill.version.
    - "skill.version"
  - skill_id: string
    
    Identifier of the skill for this version.
  - version: string
    
    Version number for this skill.
- first_id: string
  
  The ID of the first item in the list.
- has_more: boolean
  
  Whether there are more items available.
- last_id: string
  
  The ID of the last item in the list.
- object: "list"
  
  The type of object returned, must be list.
  - "list"

Content

Download a skill version zip bundle.

get /skills/{skill_id}/versions/{version}/content

Download a skill version zip bundle.

Path Parameters

skill_id: string
version: string

The skill version number.

Example

curl https://api.openai.com/v1/skills/$SKILL_ID/versions/$VERSION/content \
    -H "Authorization: Bearer $OPENAI_API_KEY"

resources/skills/index.md +937 −0 created

1# Skills

3## Create a new skill.

5**post** `/skills`

7Create a new skill.

9### Body Parameters

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

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

15 - `array of string`

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

19 - `string`

21 Skill zip file to upload.

23### Returns

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

27 - `id: string`

29 Unique identifier for the skill.

31 - `created_at: number`

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

35 - `default_version: string`

37 Default version for the skill.

39 - `description: string`

41 Description of the skill.

43 - `latest_version: string`

45 Latest version for the skill.

47 - `name: string`

49 Name of the skill.

51 - `object: "skill"`

53 The object type, which is `skill`.

55 - `"skill"`

57### Example

59```http

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

61 -X POST \

62 -H "Authorization: Bearer $OPENAI_API_KEY"

63```

65#### Response

67```json

68{

69 "id": "id",

70 "created_at": 0,

71 "default_version": "default_version",

72 "description": "description",

73 "latest_version": "latest_version",

74 "name": "name",

75 "object": "skill"

76}

77```

79## List all skills for the current project.

81**get** `/skills`

83List all skills for the current project.

85### Query Parameters

87- `after: optional string`

89 Identifier for the last item from the previous pagination request

91- `limit: optional number`

93 Number of items to retrieve

95- `order: optional "asc" or "desc"`

97 Sort order of results by timestamp. Use `asc` for ascending order or `desc` for descending order.

99 - `"asc"`

100

101 - `"desc"`

102

103### Returns

104

105- `SkillList object { data, first_id, has_more, 2 more }`

106

107 - `data: array of Skill`

108

109 A list of items

110

111 - `id: string`

112

113 Unique identifier for the skill.

114

115 - `created_at: number`

116

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

118

119 - `default_version: string`

120

121 Default version for the skill.

122

123 - `description: string`

124

125 Description of the skill.

126

127 - `latest_version: string`

128

129 Latest version for the skill.

130

131 - `name: string`

132

133 Name of the skill.

134

135 - `object: "skill"`

136

137 The object type, which is `skill`.

138

139 - `"skill"`

140

141 - `first_id: string`

142

143 The ID of the first item in the list.

144

145 - `has_more: boolean`

146

147 Whether there are more items available.

148

149 - `last_id: string`

150

151 The ID of the last item in the list.

152

153 - `object: "list"`

154

155 The type of object returned, must be `list`.

156

157 - `"list"`

158

159### Example

160

161```http

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

163 -H "Authorization: Bearer $OPENAI_API_KEY"

164```

165

166#### Response

167

168```json

169{

170 "data": [

171 {

172 "id": "id",

173 "created_at": 0,

174 "default_version": "default_version",

175 "description": "description",

176 "latest_version": "latest_version",

177 "name": "name",

178 "object": "skill"

179 }

180 ],

181 "first_id": "first_id",

182 "has_more": true,

183 "last_id": "last_id",

184 "object": "list"

185}

186```

187

188## Get a skill by its ID.

189

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

191

192Get a skill by its ID.

193

194### Path Parameters

195

196- `skill_id: string`

197

198### Returns

199

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

201

202 - `id: string`

203

204 Unique identifier for the skill.

205

206 - `created_at: number`

207

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

209

210 - `default_version: string`

211

212 Default version for the skill.

213

214 - `description: string`

215

216 Description of the skill.

217

218 - `latest_version: string`

219

220 Latest version for the skill.

221

222 - `name: string`

223

224 Name of the skill.

225

226 - `object: "skill"`

227

228 The object type, which is `skill`.

229

230 - `"skill"`

231

232### Example

233

234```http

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

236 -H "Authorization: Bearer $OPENAI_API_KEY"

237```

238

239#### Response

240

241```json

242{

243 "id": "id",

244 "created_at": 0,

245 "default_version": "default_version",

246 "description": "description",

247 "latest_version": "latest_version",

248 "name": "name",

249 "object": "skill"

250}

251```

252

253## Update the default version pointer for a skill.

254

255**post** `/skills/{skill_id}`

256

257Update the default version pointer for a skill.

258

259### Path Parameters

260

261- `skill_id: string`

262

263### Body Parameters

264

265- `default_version: string`

266

267 The skill version number to set as default.

268

269### Returns

270

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

272

273 - `id: string`

274

275 Unique identifier for the skill.

276

277 - `created_at: number`

278

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

280

281 - `default_version: string`

282

283 Default version for the skill.

284

285 - `description: string`

286

287 Description of the skill.

288

289 - `latest_version: string`

290

291 Latest version for the skill.

292

293 - `name: string`

294

295 Name of the skill.

296

297 - `object: "skill"`

298

299 The object type, which is `skill`.

300

301 - `"skill"`

302

303### Example

304

305```http

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

307 -H 'Content-Type: application/json' \

308 -H "Authorization: Bearer $OPENAI_API_KEY" \

309 -d '{

310 "default_version": "default_version"

311 }'

312```

313

314#### Response

315

316```json

317{

318 "id": "id",

319 "created_at": 0,

320 "default_version": "default_version",

321 "description": "description",

322 "latest_version": "latest_version",

323 "name": "name",

324 "object": "skill"

325}

326```

327

328## Delete a skill by its ID.

329

330**delete** `/skills/{skill_id}`

331

332Delete a skill by its ID.

333

334### Path Parameters

335

336- `skill_id: string`

337

338### Returns

339

340- `DeletedSkill object { id, deleted, object }`

341

342 - `id: string`

343

344 - `deleted: boolean`

345

346 - `object: "skill.deleted"`

347

348 - `"skill.deleted"`

349

350### Example

351

352```http

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

354 -X DELETE \

355 -H "Authorization: Bearer $OPENAI_API_KEY"

356```

357

358#### Response

359

360```json

361{

362 "id": "id",

363 "deleted": true,

364 "object": "skill.deleted"

365}

366```

367

368## Domain Types

369

370### Deleted Skill

371

372- `DeletedSkill object { id, deleted, object }`

373

374 - `id: string`

375

376 - `deleted: boolean`

377

378 - `object: "skill.deleted"`

379

380 - `"skill.deleted"`

381

382### Skill

383

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

385

386 - `id: string`

387

388 Unique identifier for the skill.

389

390 - `created_at: number`

391

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

393

394 - `default_version: string`

395

396 Default version for the skill.

397

398 - `description: string`

399

400 Description of the skill.

401

402 - `latest_version: string`

403

404 Latest version for the skill.

405

406 - `name: string`

407

408 Name of the skill.

409

410 - `object: "skill"`

411

412 The object type, which is `skill`.

413

414 - `"skill"`

415

416### Skill List

417

418- `SkillList object { data, first_id, has_more, 2 more }`

419

420 - `data: array of Skill`

421

422 A list of items

423

424 - `id: string`

425

426 Unique identifier for the skill.

427

428 - `created_at: number`

429

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

431

432 - `default_version: string`

433

434 Default version for the skill.

435

436 - `description: string`

437

438 Description of the skill.

439

440 - `latest_version: string`

441

442 Latest version for the skill.

443

444 - `name: string`

445

446 Name of the skill.

447

448 - `object: "skill"`

449

450 The object type, which is `skill`.

451

452 - `"skill"`

453

454 - `first_id: string`

455

456 The ID of the first item in the list.

457

458 - `has_more: boolean`

459

460 Whether there are more items available.

461

462 - `last_id: string`

463

464 The ID of the last item in the list.

465

466 - `object: "list"`

467

468 The type of object returned, must be `list`.

469

470 - `"list"`

471

472# Content

473

474## Download a skill zip bundle by its ID.

475

476**get** `/skills/{skill_id}/content`

477

478Download a skill zip bundle by its ID.

479

480### Path Parameters

481

482- `skill_id: string`

483

484### Example

485

486```http

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

488 -H "Authorization: Bearer $OPENAI_API_KEY"

489```

490

491# Versions

492

493## Create a new immutable skill version.

494

495**post** `/skills/{skill_id}/versions`

496

497Create a new immutable skill version.

498

499### Path Parameters

500

501- `skill_id: string`

502

503### Body Parameters

504

505- `default: optional boolean`

506

507 Whether to set this version as the default.

508

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

510

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

512

513 - `array of string`

514

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

516

517 - `string`

518

519 Skill zip file to upload.

520

521### Returns

522

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

524

525 - `id: string`

526

527 Unique identifier for the skill version.

528

529 - `created_at: number`

530

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

532

533 - `description: string`

534

535 Description of the skill version.

536

537 - `name: string`

538

539 Name of the skill version.

540

541 - `object: "skill.version"`

542

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

544

545 - `"skill.version"`

546

547 - `skill_id: string`

548

549 Identifier of the skill for this version.

550

551 - `version: string`

552

553 Version number for this skill.

554

555### Example

556

557```http

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

559 -X POST \

560 -H "Authorization: Bearer $OPENAI_API_KEY"

561```

562

563#### Response

564

565```json

566{

567 "id": "id",

568 "created_at": 0,

569 "description": "description",

570 "name": "name",

571 "object": "skill.version",

572 "skill_id": "skill_id",

573 "version": "version"

574}

575```

576

577## List skill versions for a skill.

578

579**get** `/skills/{skill_id}/versions`

580

581List skill versions for a skill.

582

583### Path Parameters

584

585- `skill_id: string`

586

587### Query Parameters

588

589- `after: optional string`

590

591 The skill version ID to start after.

592

593- `limit: optional number`

594

595 Number of versions to retrieve.

596

597- `order: optional "asc" or "desc"`

598

599 Sort order of results by version number.

600

601 - `"asc"`

602

603 - `"desc"`

604

605### Returns

606

607- `SkillVersionList object { data, first_id, has_more, 2 more }`

608

609 - `data: array of SkillVersion`

610

611 A list of items

612

613 - `id: string`

614

615 Unique identifier for the skill version.

616

617 - `created_at: number`

618

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

620

621 - `description: string`

622

623 Description of the skill version.

624

625 - `name: string`

626

627 Name of the skill version.

628

629 - `object: "skill.version"`

630

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

632

633 - `"skill.version"`

634

635 - `skill_id: string`

636

637 Identifier of the skill for this version.

638

639 - `version: string`

640

641 Version number for this skill.

642

643 - `first_id: string`

644

645 The ID of the first item in the list.

646

647 - `has_more: boolean`

648

649 Whether there are more items available.

650

651 - `last_id: string`

652

653 The ID of the last item in the list.

654

655 - `object: "list"`

656

657 The type of object returned, must be `list`.

658

659 - `"list"`

660

661### Example

662

663```http

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

665 -H "Authorization: Bearer $OPENAI_API_KEY"

666```

667

668#### Response

669

670```json

671{

672 "data": [

673 {

674 "id": "id",

675 "created_at": 0,

676 "description": "description",

677 "name": "name",

678 "object": "skill.version",

679 "skill_id": "skill_id",

680 "version": "version"

681 }

682 ],

683 "first_id": "first_id",

684 "has_more": true,

685 "last_id": "last_id",

686 "object": "list"

687}

688```

689

690## Get a specific skill version.

691

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

693

694Get a specific skill version.

695

696### Path Parameters

697

698- `skill_id: string`

699

700- `version: string`

701

702 The version number to retrieve.

703

704### Returns

705

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

707

708 - `id: string`

709

710 Unique identifier for the skill version.

711

712 - `created_at: number`

713

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

715

716 - `description: string`

717

718 Description of the skill version.

719

720 - `name: string`

721

722 Name of the skill version.

723

724 - `object: "skill.version"`

725

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

727

728 - `"skill.version"`

729

730 - `skill_id: string`

731

732 Identifier of the skill for this version.

733

734 - `version: string`

735

736 Version number for this skill.

737

738### Example

739

740```http

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

742 -H "Authorization: Bearer $OPENAI_API_KEY"

743```

744

745#### Response

746

747```json

748{

749 "id": "id",

750 "created_at": 0,

751 "description": "description",

752 "name": "name",

753 "object": "skill.version",

754 "skill_id": "skill_id",

755 "version": "version"

756}

757```

758

759## Delete a skill version.

760

761**delete** `/skills/{skill_id}/versions/{version}`

762

763Delete a skill version.

764

765### Path Parameters

766

767- `skill_id: string`

768

769- `version: string`

770

771 The skill version number.

772

773### Returns

774

775- `DeletedSkillVersion object { id, deleted, object, version }`

776

777 - `id: string`

778

779 - `deleted: boolean`

780

781 - `object: "skill.version.deleted"`

782

783 - `"skill.version.deleted"`

784

785 - `version: string`

786

787 The deleted skill version.

788

789### Example

790

791```http

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

793 -X DELETE \

794 -H "Authorization: Bearer $OPENAI_API_KEY"

795```

796

797#### Response

798

799```json

800{

801 "id": "id",

802 "deleted": true,

803 "object": "skill.version.deleted",

804 "version": "version"

805}

806```

807

808## Domain Types

809

810### Deleted Skill Version

811

812- `DeletedSkillVersion object { id, deleted, object, version }`

813

814 - `id: string`

815

816 - `deleted: boolean`

817

818 - `object: "skill.version.deleted"`

819

820 - `"skill.version.deleted"`

821

822 - `version: string`

823

824 The deleted skill version.

825

826### Skill Version

827

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

829

830 - `id: string`

831

832 Unique identifier for the skill version.

833

834 - `created_at: number`

835

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

837

838 - `description: string`

839

840 Description of the skill version.

841

842 - `name: string`

843

844 Name of the skill version.

845

846 - `object: "skill.version"`

847

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

849

850 - `"skill.version"`

851

852 - `skill_id: string`

853

854 Identifier of the skill for this version.

855

856 - `version: string`

857

858 Version number for this skill.

859

860### Skill Version List

861

862- `SkillVersionList object { data, first_id, has_more, 2 more }`

863

864 - `data: array of SkillVersion`

865

866 A list of items

867

868 - `id: string`

869

870 Unique identifier for the skill version.

871

872 - `created_at: number`

873

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

875

876 - `description: string`

877

878 Description of the skill version.

879

880 - `name: string`

881

882 Name of the skill version.

883

884 - `object: "skill.version"`

885

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

887

888 - `"skill.version"`

889

890 - `skill_id: string`

891

892 Identifier of the skill for this version.

893

894 - `version: string`

895

896 Version number for this skill.

897

898 - `first_id: string`

899

900 The ID of the first item in the list.

901

902 - `has_more: boolean`

903

904 Whether there are more items available.

905

906 - `last_id: string`

907

908 The ID of the last item in the list.

909

910 - `object: "list"`

911

912 The type of object returned, must be `list`.

913

914 - `"list"`

915

916# Content

917

918## Download a skill version zip bundle.

919

920**get** `/skills/{skill_id}/versions/{version}/content`

921

922Download a skill version zip bundle.

923

924### Path Parameters

925

926- `skill_id: string`

927

928- `version: string`

929

930 The skill version number.

931

932### Example

933

934```http

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

936 -H "Authorization: Bearer $OPENAI_API_KEY"

937```

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

Skills

Create a new skill.

Body Parameters

Returns

Example

Response

List all skills for the current project.

Query Parameters

Returns

Example

Response

Get a skill by its ID.

Path Parameters

Returns

Example

Response

Update the default version pointer for a skill.

Path Parameters

Body Parameters

Returns

Example

Response

Delete a skill by its ID.

Path Parameters

Returns

Example

Response

Domain Types

Deleted Skill

Skill

Skill List

Content

Download a skill zip bundle by its ID.

Path Parameters

Example

Versions

Create a new immutable skill version.

Path Parameters

Body Parameters

Returns

Example

Response

List skill versions for a skill.

Path Parameters

Query Parameters

Returns

Example

Response

Get a specific skill version.

Path Parameters

Returns

Example

Response

Delete a skill version.

Path Parameters

Returns

Example

Response

Domain Types

Deleted Skill Version

Skill Version

Skill Version List

Content

Download a skill version zip bundle.

Path Parameters

Example