Checkpoints

Permissions

List checkpoint permissions

get /fine_tuning/checkpoints/{fine_tuned_model_checkpoint}/permissions

List checkpoint permissions

Path Parameters

fine_tuned_model_checkpoint: string

Query Parameters

after: optional string

Identifier for the last permission ID from the previous pagination request.
limit: optional number

Number of permissions to retrieve.
order: optional "ascending" or "descending"

The order in which to retrieve permissions.
- "ascending"
- "descending"
project_id: optional string

The ID of the project to get permissions for.

Returns

data: array of object { id, created_at, object, project_id }
- id: string
  
  The permission identifier, which can be referenced in the API endpoints.
- created_at: number
  
  The Unix timestamp (in seconds) for when the permission was created.
- object: "checkpoint.permission"
  
  The object type, which is always "checkpoint.permission".
  - "checkpoint.permission"
- project_id: string
  
  The project identifier that the permission is for.
has_more: boolean
object: "list"
- "list"
first_id: optional string
last_id: optional string

Example

curl https://api.openai.com/v1/fine_tuning/checkpoints/$FINE_TUNED_MODEL_CHECKPOINT/permissions \
    -H "Authorization: Bearer $OPENAI_API_KEY"

Response

{
  "data": [
    {
      "id": "id",
      "created_at": 0,
      "object": "checkpoint.permission",
      "project_id": "project_id"
    }
  ],
  "has_more": true,
  "object": "list",
  "first_id": "first_id",
  "last_id": "last_id"
}

Example

curl https://api.openai.com/v1/fine_tuning/checkpoints/ft:gpt-4o-mini-2024-07-18:org:weather:B7R9VjQd/permissions \
  -H "Authorization: Bearer $OPENAI_API_KEY"

Response

{
  "object": "list",
  "data": [
    {
      "object": "checkpoint.permission",
      "id": "cp_zc4Q7MP6XxulcVzj4MZdwsAB",
      "created_at": 1721764867,
      "project_id": "proj_abGMw1llN8IrBb6SvvY5A1iH"
    },
    {
      "object": "checkpoint.permission",
      "id": "cp_enQCFmOTGj3syEpYVhBRLTSy",
      "created_at": 1721764800,
      "project_id": "proj_iqGMw1llN8IrBb6SvvY5A1oF"
    },
  ],
  "first_id": "cp_zc4Q7MP6XxulcVzj4MZdwsAB",
  "last_id": "cp_enQCFmOTGj3syEpYVhBRLTSy",
  "has_more": false
}

List checkpoint permissions

get /fine_tuning/checkpoints/{fine_tuned_model_checkpoint}/permissions

List checkpoint permissions

Path Parameters

fine_tuned_model_checkpoint: string

Query Parameters

after: optional string

Identifier for the last permission ID from the previous pagination request.
limit: optional number

Number of permissions to retrieve.
order: optional "ascending" or "descending"

The order in which to retrieve permissions.
- "ascending"
- "descending"
project_id: optional string

The ID of the project to get permissions for.

Returns

data: array of object { id, created_at, object, project_id }
- id: string
  
  The permission identifier, which can be referenced in the API endpoints.
- created_at: number
  
  The Unix timestamp (in seconds) for when the permission was created.
- object: "checkpoint.permission"
  
  The object type, which is always "checkpoint.permission".
  - "checkpoint.permission"
- project_id: string
  
  The project identifier that the permission is for.
has_more: boolean
object: "list"
- "list"
first_id: optional string
last_id: optional string

Example

curl https://api.openai.com/v1/fine_tuning/checkpoints/$FINE_TUNED_MODEL_CHECKPOINT/permissions \
    -H "Authorization: Bearer $OPENAI_API_KEY"

Response

{
  "data": [
    {
      "id": "id",
      "created_at": 0,
      "object": "checkpoint.permission",
      "project_id": "project_id"
    }
  ],
  "has_more": true,
  "object": "list",
  "first_id": "first_id",
  "last_id": "last_id"
}

Example

curl https://api.openai.com/v1/fine_tuning/checkpoints/ft:gpt-4o-mini-2024-07-18:org:weather:B7R9VjQd/permissions \
  -H "Authorization: Bearer $OPENAI_API_KEY"

Response

{
  "object": "list",
  "data": [
    {
      "object": "checkpoint.permission",
      "id": "cp_zc4Q7MP6XxulcVzj4MZdwsAB",
      "created_at": 1721764867,
      "project_id": "proj_abGMw1llN8IrBb6SvvY5A1iH"
    },
    {
      "object": "checkpoint.permission",
      "id": "cp_enQCFmOTGj3syEpYVhBRLTSy",
      "created_at": 1721764800,
      "project_id": "proj_iqGMw1llN8IrBb6SvvY5A1oF"
    },
  ],
  "first_id": "cp_zc4Q7MP6XxulcVzj4MZdwsAB",
  "last_id": "cp_enQCFmOTGj3syEpYVhBRLTSy",
  "has_more": false
}

Create checkpoint permissions

post /fine_tuning/checkpoints/{fine_tuned_model_checkpoint}/permissions

Create checkpoint permissions

Path Parameters

fine_tuned_model_checkpoint: string

Body Parameters

project_ids: array of string

The project identifiers to grant access to.

Returns

data: array of object { id, created_at, object, project_id }
- id: string
  
  The permission identifier, which can be referenced in the API endpoints.
- created_at: number
  
  The Unix timestamp (in seconds) for when the permission was created.
- object: "checkpoint.permission"
  
  The object type, which is always "checkpoint.permission".
  - "checkpoint.permission"
- project_id: string
  
  The project identifier that the permission is for.
has_more: boolean
object: "list"
- "list"
first_id: optional string
last_id: optional string

Example

curl https://api.openai.com/v1/fine_tuning/checkpoints/$FINE_TUNED_MODEL_CHECKPOINT/permissions \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $OPENAI_API_KEY" \
    -d '{
          "project_ids": [
            "string"
          ]
        }'

Response

{
  "data": [
    {
      "id": "id",
      "created_at": 0,
      "object": "checkpoint.permission",
      "project_id": "project_id"
    }
  ],
  "has_more": true,
  "object": "list",
  "first_id": "first_id",
  "last_id": "last_id"
}

Example

curl https://api.openai.com/v1/fine_tuning/checkpoints/ft:gpt-4o-mini-2024-07-18:org:weather:B7R9VjQd/permissions \
  -H "Authorization: Bearer $OPENAI_API_KEY"
  -d '{"project_ids": ["proj_abGMw1llN8IrBb6SvvY5A1iH"]}'

Response

{
  "object": "list",
  "data": [
    {
      "object": "checkpoint.permission",
      "id": "cp_zc4Q7MP6XxulcVzj4MZdwsAB",
      "created_at": 1721764867,
      "project_id": "proj_abGMw1llN8IrBb6SvvY5A1iH"
    }
  ],
  "first_id": "cp_zc4Q7MP6XxulcVzj4MZdwsAB",
  "last_id": "cp_zc4Q7MP6XxulcVzj4MZdwsAB",
  "has_more": false
}

Delete checkpoint permission

delete /fine_tuning/checkpoints/{fine_tuned_model_checkpoint}/permissions/{permission_id}

Delete checkpoint permission

Path Parameters

fine_tuned_model_checkpoint: string
permission_id: string

Returns

id: string

The ID of the fine-tuned model checkpoint permission that was deleted.
deleted: boolean

Whether the fine-tuned model checkpoint permission was successfully deleted.
object: "checkpoint.permission"

The object type, which is always "checkpoint.permission".
- "checkpoint.permission"

Example

curl https://api.openai.com/v1/fine_tuning/checkpoints/$FINE_TUNED_MODEL_CHECKPOINT/permissions/$PERMISSION_ID \
    -X DELETE \
    -H "Authorization: Bearer $OPENAI_API_KEY"

Response

{
  "id": "id",
  "deleted": true,
  "object": "checkpoint.permission"
}

Example

curl https://api.openai.com/v1/fine_tuning/checkpoints/ft:gpt-4o-mini-2024-07-18:org:weather:B7R9VjQd/permissions/cp_zc4Q7MP6XxulcVzj4MZdwsAB \
  -H "Authorization: Bearer $OPENAI_API_KEY"

Response

{
  "object": "checkpoint.permission",
  "id": "cp_zc4Q7MP6XxulcVzj4MZdwsAB",
  "deleted": true
}

Domain Types

Permission Retrieve Response

PermissionRetrieveResponse object { data, has_more, object, 2 more }
- data: array of object { id, created_at, object, project_id }
  - id: string
    
    The permission identifier, which can be referenced in the API endpoints.
  - created_at: number
    
    The Unix timestamp (in seconds) for when the permission was created.
  - object: "checkpoint.permission"
    
    The object type, which is always "checkpoint.permission".
    - "checkpoint.permission"
  - project_id: string
    
    The project identifier that the permission is for.
- has_more: boolean
- object: "list"
  - "list"
- first_id: optional string
- last_id: optional string

Permission List Response

PermissionListResponse object { id, created_at, object, project_id }

The checkpoint.permission object represents a permission for a fine-tuned model checkpoint.
- id: string
  
  The permission identifier, which can be referenced in the API endpoints.
- created_at: number
  
  The Unix timestamp (in seconds) for when the permission was created.
- object: "checkpoint.permission"
  
  The object type, which is always "checkpoint.permission".
  - "checkpoint.permission"
- project_id: string
  
  The project identifier that the permission is for.

Permission Create Response

PermissionCreateResponse object { id, created_at, object, project_id }

The checkpoint.permission object represents a permission for a fine-tuned model checkpoint.
- id: string
  
  The permission identifier, which can be referenced in the API endpoints.
- created_at: number
  
  The Unix timestamp (in seconds) for when the permission was created.
- object: "checkpoint.permission"
  
  The object type, which is always "checkpoint.permission".
  - "checkpoint.permission"
- project_id: string
  
  The project identifier that the permission is for.

Permission Delete Response

PermissionDeleteResponse object { id, deleted, object }
- id: string
  
  The ID of the fine-tuned model checkpoint permission that was deleted.
- deleted: boolean
  
  Whether the fine-tuned model checkpoint permission was successfully deleted.
- object: "checkpoint.permission"
  
  The object type, which is always "checkpoint.permission".
  - "checkpoint.permission"

resources/fine_tuning/subresources/checkpoints/index.md +519 −0 created

1# Checkpoints

3# Permissions

5## List checkpoint permissions

7**get** `/fine_tuning/checkpoints/{fine_tuned_model_checkpoint}/permissions`

9List checkpoint permissions

11### Path Parameters

13- `fine_tuned_model_checkpoint: string`

15### Query Parameters

17- `after: optional string`

19 Identifier for the last permission ID from the previous pagination request.

21- `limit: optional number`

23 Number of permissions to retrieve.

25- `order: optional "ascending" or "descending"`

27 The order in which to retrieve permissions.

29 - `"ascending"`

31 - `"descending"`

33- `project_id: optional string`

35 The ID of the project to get permissions for.

37### Returns

39- `data: array of object { id, created_at, object, project_id }`

41 - `id: string`

43 The permission identifier, which can be referenced in the API endpoints.

45 - `created_at: number`

47 The Unix timestamp (in seconds) for when the permission was created.

49 - `object: "checkpoint.permission"`

51 The object type, which is always "checkpoint.permission".

53 - `"checkpoint.permission"`

55 - `project_id: string`

57 The project identifier that the permission is for.

59- `has_more: boolean`

61- `object: "list"`

63 - `"list"`

65- `first_id: optional string`

67- `last_id: optional string`

69### Example

71```http

72curl https://api.openai.com/v1/fine_tuning/checkpoints/$FINE_TUNED_MODEL_CHECKPOINT/permissions \

73 -H "Authorization: Bearer $OPENAI_API_KEY"

74```

76#### Response

78```json

79{

80 "data": [

81 {

82 "id": "id",

83 "created_at": 0,

84 "object": "checkpoint.permission",

85 "project_id": "project_id"

86 }

87 ],

88 "has_more": true,

89 "object": "list",

90 "first_id": "first_id",

91 "last_id": "last_id"

92}

93```

95### Example

97```http

98curl https://api.openai.com/v1/fine_tuning/checkpoints/ft:gpt-4o-mini-2024-07-18:org:weather:B7R9VjQd/permissions \

99 -H "Authorization: Bearer $OPENAI_API_KEY"

100```

101

102#### Response

103

104```json

105{

106 "object": "list",

107 "data": [

108 {

109 "object": "checkpoint.permission",

110 "id": "cp_zc4Q7MP6XxulcVzj4MZdwsAB",

111 "created_at": 1721764867,

112 "project_id": "proj_abGMw1llN8IrBb6SvvY5A1iH"

113 },

114 {

115 "object": "checkpoint.permission",

116 "id": "cp_enQCFmOTGj3syEpYVhBRLTSy",

117 "created_at": 1721764800,

118 "project_id": "proj_iqGMw1llN8IrBb6SvvY5A1oF"

119 },

120 ],

121 "first_id": "cp_zc4Q7MP6XxulcVzj4MZdwsAB",

122 "last_id": "cp_enQCFmOTGj3syEpYVhBRLTSy",

123 "has_more": false

124}

125```

126

127## List checkpoint permissions

128

129**get** `/fine_tuning/checkpoints/{fine_tuned_model_checkpoint}/permissions`

130

131List checkpoint permissions

132

133### Path Parameters

134

135- `fine_tuned_model_checkpoint: string`

136

137### Query Parameters

138

139- `after: optional string`

140

141 Identifier for the last permission ID from the previous pagination request.

142

143- `limit: optional number`

144

145 Number of permissions to retrieve.

146

147- `order: optional "ascending" or "descending"`

148

149 The order in which to retrieve permissions.

150

151 - `"ascending"`

152

153 - `"descending"`

154

155- `project_id: optional string`

156

157 The ID of the project to get permissions for.

158

159### Returns

160

161- `data: array of object { id, created_at, object, project_id }`

162

163 - `id: string`

164

165 The permission identifier, which can be referenced in the API endpoints.

166

167 - `created_at: number`

168

169 The Unix timestamp (in seconds) for when the permission was created.

170

171 - `object: "checkpoint.permission"`

172

173 The object type, which is always "checkpoint.permission".

174

175 - `"checkpoint.permission"`

176

177 - `project_id: string`

178

179 The project identifier that the permission is for.

180

181- `has_more: boolean`

182

183- `object: "list"`

184

185 - `"list"`

186

187- `first_id: optional string`

188

189- `last_id: optional string`

190

191### Example

192

193```http

194curl https://api.openai.com/v1/fine_tuning/checkpoints/$FINE_TUNED_MODEL_CHECKPOINT/permissions \

195 -H "Authorization: Bearer $OPENAI_API_KEY"

196```

197

198#### Response

199

200```json

201{

202 "data": [

203 {

204 "id": "id",

205 "created_at": 0,

206 "object": "checkpoint.permission",

207 "project_id": "project_id"

208 }

209 ],

210 "has_more": true,

211 "object": "list",

212 "first_id": "first_id",

213 "last_id": "last_id"

214}

215```

216

217### Example

218

219```http

220curl https://api.openai.com/v1/fine_tuning/checkpoints/ft:gpt-4o-mini-2024-07-18:org:weather:B7R9VjQd/permissions \

221 -H "Authorization: Bearer $OPENAI_API_KEY"

222```

223

224#### Response

225

226```json

227{

228 "object": "list",

229 "data": [

230 {

231 "object": "checkpoint.permission",

232 "id": "cp_zc4Q7MP6XxulcVzj4MZdwsAB",

233 "created_at": 1721764867,

234 "project_id": "proj_abGMw1llN8IrBb6SvvY5A1iH"

235 },

236 {

237 "object": "checkpoint.permission",

238 "id": "cp_enQCFmOTGj3syEpYVhBRLTSy",

239 "created_at": 1721764800,

240 "project_id": "proj_iqGMw1llN8IrBb6SvvY5A1oF"

241 },

242 ],

243 "first_id": "cp_zc4Q7MP6XxulcVzj4MZdwsAB",

244 "last_id": "cp_enQCFmOTGj3syEpYVhBRLTSy",

245 "has_more": false

246}

247```

248

249## Create checkpoint permissions

250

251**post** `/fine_tuning/checkpoints/{fine_tuned_model_checkpoint}/permissions`

252

253Create checkpoint permissions

254

255### Path Parameters

256

257- `fine_tuned_model_checkpoint: string`

258

259### Body Parameters

260

261- `project_ids: array of string`

262

263 The project identifiers to grant access to.

264

265### Returns

266

267- `data: array of object { id, created_at, object, project_id }`

268

269 - `id: string`

270

271 The permission identifier, which can be referenced in the API endpoints.

272

273 - `created_at: number`

274

275 The Unix timestamp (in seconds) for when the permission was created.

276

277 - `object: "checkpoint.permission"`

278

279 The object type, which is always "checkpoint.permission".

280

281 - `"checkpoint.permission"`

282

283 - `project_id: string`

284

285 The project identifier that the permission is for.

286

287- `has_more: boolean`

288

289- `object: "list"`

290

291 - `"list"`

292

293- `first_id: optional string`

294

295- `last_id: optional string`

296

297### Example

298

299```http

300curl https://api.openai.com/v1/fine_tuning/checkpoints/$FINE_TUNED_MODEL_CHECKPOINT/permissions \

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

302 -H "Authorization: Bearer $OPENAI_API_KEY" \

303 -d '{

304 "project_ids": [

305 "string"

306 ]

307 }'

308```

309

310#### Response

311

312```json

313{

314 "data": [

315 {

316 "id": "id",

317 "created_at": 0,

318 "object": "checkpoint.permission",

319 "project_id": "project_id"

320 }

321 ],

322 "has_more": true,

323 "object": "list",

324 "first_id": "first_id",

325 "last_id": "last_id"

326}

327```

328

329### Example

330

331```http

332curl https://api.openai.com/v1/fine_tuning/checkpoints/ft:gpt-4o-mini-2024-07-18:org:weather:B7R9VjQd/permissions \

333 -H "Authorization: Bearer $OPENAI_API_KEY"

334 -d '{"project_ids": ["proj_abGMw1llN8IrBb6SvvY5A1iH"]}'

335```

336

337#### Response

338

339```json

340{

341 "object": "list",

342 "data": [

343 {

344 "object": "checkpoint.permission",

345 "id": "cp_zc4Q7MP6XxulcVzj4MZdwsAB",

346 "created_at": 1721764867,

347 "project_id": "proj_abGMw1llN8IrBb6SvvY5A1iH"

348 }

349 ],

350 "first_id": "cp_zc4Q7MP6XxulcVzj4MZdwsAB",

351 "last_id": "cp_zc4Q7MP6XxulcVzj4MZdwsAB",

352 "has_more": false

353}

354```

355

356## Delete checkpoint permission

357

358**delete** `/fine_tuning/checkpoints/{fine_tuned_model_checkpoint}/permissions/{permission_id}`

359

360Delete checkpoint permission

361

362### Path Parameters

363

364- `fine_tuned_model_checkpoint: string`

365

366- `permission_id: string`

367

368### Returns

369

370- `id: string`

371

372 The ID of the fine-tuned model checkpoint permission that was deleted.

373

374- `deleted: boolean`

375

376 Whether the fine-tuned model checkpoint permission was successfully deleted.

377

378- `object: "checkpoint.permission"`

379

380 The object type, which is always "checkpoint.permission".

381

382 - `"checkpoint.permission"`

383

384### Example

385

386```http

387curl https://api.openai.com/v1/fine_tuning/checkpoints/$FINE_TUNED_MODEL_CHECKPOINT/permissions/$PERMISSION_ID \

388 -X DELETE \

389 -H "Authorization: Bearer $OPENAI_API_KEY"

390```

391

392#### Response

393

394```json

395{

396 "id": "id",

397 "deleted": true,

398 "object": "checkpoint.permission"

399}

400```

401

402### Example

403

404```http

405curl https://api.openai.com/v1/fine_tuning/checkpoints/ft:gpt-4o-mini-2024-07-18:org:weather:B7R9VjQd/permissions/cp_zc4Q7MP6XxulcVzj4MZdwsAB \

406 -H "Authorization: Bearer $OPENAI_API_KEY"

407```

408

409#### Response

410

411```json

412{

413 "object": "checkpoint.permission",

414 "id": "cp_zc4Q7MP6XxulcVzj4MZdwsAB",

415 "deleted": true

416}

417```

418

419## Domain Types

420

421### Permission Retrieve Response

422

423- `PermissionRetrieveResponse object { data, has_more, object, 2 more }`

424

425 - `data: array of object { id, created_at, object, project_id }`

426

427 - `id: string`

428

429 The permission identifier, which can be referenced in the API endpoints.

430

431 - `created_at: number`

432

433 The Unix timestamp (in seconds) for when the permission was created.

434

435 - `object: "checkpoint.permission"`

436

437 The object type, which is always "checkpoint.permission".

438

439 - `"checkpoint.permission"`

440

441 - `project_id: string`

442

443 The project identifier that the permission is for.

444

445 - `has_more: boolean`

446

447 - `object: "list"`

448

449 - `"list"`

450

451 - `first_id: optional string`

452

453 - `last_id: optional string`

454

455### Permission List Response

456

457- `PermissionListResponse object { id, created_at, object, project_id }`

458

459 The `checkpoint.permission` object represents a permission for a fine-tuned model checkpoint.

460

461 - `id: string`

462

463 The permission identifier, which can be referenced in the API endpoints.

464

465 - `created_at: number`

466

467 The Unix timestamp (in seconds) for when the permission was created.

468

469 - `object: "checkpoint.permission"`

470

471 The object type, which is always "checkpoint.permission".

472

473 - `"checkpoint.permission"`

474

475 - `project_id: string`

476

477 The project identifier that the permission is for.

478

479### Permission Create Response

480

481- `PermissionCreateResponse object { id, created_at, object, project_id }`

482

483 The `checkpoint.permission` object represents a permission for a fine-tuned model checkpoint.

484

485 - `id: string`

486

487 The permission identifier, which can be referenced in the API endpoints.

488

489 - `created_at: number`

490

491 The Unix timestamp (in seconds) for when the permission was created.

492

493 - `object: "checkpoint.permission"`

494

495 The object type, which is always "checkpoint.permission".

496

497 - `"checkpoint.permission"`

498

499 - `project_id: string`

500

501 The project identifier that the permission is for.

502

503### Permission Delete Response

504

505- `PermissionDeleteResponse object { id, deleted, object }`

506

507 - `id: string`

508

509 The ID of the fine-tuned model checkpoint permission that was deleted.

510

511 - `deleted: boolean`

512

513 Whether the fine-tuned model checkpoint permission was successfully deleted.

514

515 - `object: "checkpoint.permission"`

516

517 The object type, which is always "checkpoint.permission".

518

519 - `"checkpoint.permission"`

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

Checkpoints

Permissions

List checkpoint permissions

Path Parameters

Query Parameters

Returns

Example

Response

Example

Response

List checkpoint permissions

Path Parameters

Query Parameters

Returns

Example

Response

Example

Response

Create checkpoint permissions

Path Parameters

Body Parameters

Returns

Example

Response

Example

Response

Delete checkpoint permission

Path Parameters

Returns

Example

Response

Example

Response

Domain Types

Permission Retrieve Response

Permission List Response

Permission Create Response

Permission Delete Response