Skip to main content
PUT
cURL

Authorizations

Authorization
string
header
required

Send Authorization: Bearer <api_key>. The legacy Authorization: Api-Key <api_key> scheme is also accepted.

Path Parameters

checkpoint_id
string
required

Body

application/json
ttl_seconds
integer | null
required

Seconds from now until the checkpoint expires and is deleted, from 3600 (1 hour) to 315360000 (10 years). Null removes the TTL, so the checkpoint is kept until you delete it.

Required range: 3600 <= x <= 315360000

Response

200 - application/json

A checkpoint saved by a Loops run.

checkpoint_id
string
required

The ID of the checkpoint.

created_at
string<date-time>
required

The timestamp of the checkpoint in ISO 8601 format.

checkpoint_type
string
required

The type of checkpoint.

base_model
string | null
required

The base model of the checkpoint.

lora_adapter_config
Lora Adapter Config · object | null
required

The adapter config of the checkpoint.

size_bytes
integer
required

The size of the checkpoint in bytes.

id
string
required

The checkpoint ID.

lora_config
LoopsLoRAConfigV1 · object | null
required

The immutable LoRA config used to save this checkpoint. Null means the checkpoint is unsupported and cannot be loaded.

run_id
string
required

The ID of the run that produced the checkpoint.

target
enum<string>
required

Whether this checkpoint is loadable by the sampler or by the run.

Available options:
sampler,
trainer
expires_at
string<date-time> | null
required

When the checkpoint expires and is deleted, set from the TTL it was saved with. Null means it's kept until you delete it. A checkpoint that's still in use when it expires, for example deployed, is deleted once it's released.

sync_status
string | null

Sync state of the checkpoint: SYNCING or COMPLETE.