Save model checkpoint

Required scope: models:manage

POST /api/v1/model/checkpoints

cURL

curl --request POST \
  --url 'https://api.nsr.stateset.com/api/v1/model/checkpoints' \
  --header "X-API-Key: $STATESET_NSR_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "description": "Two-person tent, green — replacement for damaged pole set.",
  "name": "Two-Person Tent",
  "tags": [
    "priority"
  ],
  "version": "2026-08-01"
}'

201

{
  "checkpoint": {
    "config": {
      "attention_heads": 1,
      "dropout": 1.5,
      "embedding_dim": 1,
      "features": [],
      "hidden_dims": [],
      "max_sequence_length": 1
    },
    "created_at": 1,
    "description": "Two-person tent, green — replacement for damaged pole set.",
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "metrics": {
      "accuracy": 1.5,
      "epochs": 1,
      "f1_score": 7.5,
      "train_loss": 1.5,
      "training_time_secs": 1,
      "val_loss": 1.5
    },
    "name": "Two-Person Tent",
    "tags": [
      "priority"
    ],
    "version": "2026-08-01"
  },
  "checkpoint_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

Required scope: models:manage

Request body

SaveCheckpointRequest

description · string

Optional description

name · string · required

Checkpoint name

tags · string[]

Tags for organization

version · string · required

Version string

Response

SaveCheckpointResponse

checkpoint · ModelCheckpoint · required

Show ModelCheckpoint

config · ModelConfig · required

Show ModelConfig

attention_heads · integer · required

Number of attention heads

dropout · number (float) · required

Dropout rate

embedding_dim · integer · required

Embedding dimension

features · string[] · required

Feature flags enabled

hidden_dims · integer[] · required

Hidden layer dimensions

max_sequence_length · integer · required

Maximum sequence length

created_at · integer (int64) · required

Creation timestamp (Unix ms)

description · string

Optional description

id · string · required

Unique checkpoint identifier

metrics · ModelMetrics · required

Show ModelMetrics

accuracy · number (double) · required

Accuracy on test set

epochs · integer · required

Training epochs completed

f1_score · number (double) · required

F1 score

train_loss · number (double) · required

Training loss

training_time_secs · integer (int64) · required

Total training time (seconds)

val_loss · number (double) · required

Validation loss

name · string · required

Human-readable name

tags · string[]

Tags for organization

version · string · required

Version string (semver)

checkpoint_id · string · required

Created checkpoint ID

Status codes

Code	Meaning
201	Checkpoint created
400	Invalid request
401	Unauthorized — missing or invalid credentials
403	Forbidden — the key/token lacks the required scope
429	Rate limited — see Retry-After / X-RateLimit-Reset

cURL

curl --request POST \
  --url 'https://api.nsr.stateset.com/api/v1/model/checkpoints' \
  --header "X-API-Key: $STATESET_NSR_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "description": "Two-person tent, green — replacement for damaged pole set.",
  "name": "Two-Person Tent",
  "tags": [
    "priority"
  ],
  "version": "2026-08-01"
}'

201

{
  "checkpoint": {
    "config": {
      "attention_heads": 1,
      "dropout": 1.5,
      "embedding_dim": 1,
      "features": [],
      "hidden_dims": [],
      "max_sequence_length": 1
    },
    "created_at": 1,
    "description": "Two-person tent, green — replacement for damaged pole set.",
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "metrics": {
      "accuracy": 1.5,
      "epochs": 1,
      "f1_score": 7.5,
      "train_loss": 1.5,
      "training_time_secs": 1,
      "val_loss": 1.5
    },
    "name": "Two-Person Tent",
    "tags": [
      "priority"
    ],
    "version": "2026-08-01"
  },
  "checkpoint_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}