Skip to content
Primary navigation

List checkpoint permissions

Deprecated
fine_tuning.checkpoints.permissions.retrieve(fine_tuned_model_checkpoint, **kwargs) -> PermissionRetrieveResponse { data, has_more, object, 2 more }
GET/fine_tuning/checkpoints/{fine_tuned_model_checkpoint}/permissions

NOTE: This endpoint requires an admin API key.

Organization owners can use this endpoint to view all permissions for a fine-tuned model checkpoint.

ParametersExpand Collapse
fine_tuned_model_checkpoint: String
after: String

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

limit: Integer

Number of permissions to retrieve.

order: :ascending | :descending

The order in which to retrieve permissions.

Accepts one of the following:
:ascending
:descending
project_id: String

The ID of the project to get permissions for.

ReturnsExpand Collapse
class PermissionRetrieveResponse { data, has_more, object, 2 more }
data: Array[{ id, created_at, object, project_id}]
id: String

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

created_at: Integer

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

object: :"checkpoint.permission"

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

project_id: String

The project identifier that the permission is for.

has_more: bool
object: :list
first_id: String
last_id: String

List checkpoint permissions

require "openai"

openai = OpenAI::Client.new(api_key: "My API Key")

permission = openai.fine_tuning.checkpoints.permissions.retrieve("ft-AF1WoRqd3aJAHsqc9NY7iL8F")

puts(permission)
{
  "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
}
Returns Examples
{
  "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
}