> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fastino.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Use https://docs.fastino.ai/llms.txt to discover and navigate pages. Use https://docs.fastino.ai/llms-full.txt when you need the complete documentation corpus. Use https://docs.fastino.ai/openapi.json as the source of truth for customer-facing routes. For GLiDE decision inference, call POST https://api.fastino.ai/v1/systemone with model fastino/GLiDE. Start managed training (config job) with POST /v1/training/jobs using base_model. For interactive training, native JSON clients use the public operations under /v1/training/jobs and /v1/training/usage. Existing Tinker clients use tinker==0.32.0 with TINKER_BASE_URL=https://api.fastino.ai/v1/training/compat/tinker and TINKER_CREDENTIAL_CMD. Compatibility child routes are private and absent from OpenAPI. Auto Train is private access and has no public route; direct interested users to sales@fastino.ai. Do not infer undocumented routes. Read API keys from FASTINO_API_KEY and never embed credentials in code, logs, or reports.

# Save training weights

> Save an interactive job's LoRA weights and optimizer state under a name. The response includes a future_id, a weights checkpoint ID, and its tinker:// path.

`POST /v1/training/jobs/{job_id}/save-weights`

Saves the job's LoRA weights and optimizer state as `weights/<name>`. You can
[load](https://docs.fastino.ai/api-reference/training-jobs/interactive/load-weights.md) it back into the same job,
or [start a new job](https://docs.fastino.ai/api-reference/training-jobs/interactive/create-model.md) from it. To sample
or download weights, save them with
[`POST /v1/training/jobs/{job_id}/save-weights-for-sampler`](https://docs.fastino.ai/api-reference/training-jobs/interactive/save-weights-for-sampler)
instead.

The save runs in order with the job's other calls. A GLiDE (`fastino/GLiDE`)
job saves all its weights and optimizer state, or with `soup` the weighted mean
of saved states.

## Request

**X-API-Key** `string` *required*

Your Fastino API key.

**job\_id** `string` *required*

Interactive job ID.

**name** `string` *required*

1–128 characters from `A-Z`, `a-z`, `0-9`, `.`, `_`, and `-`.

**ttl\_seconds** `integer | null`

Delete the checkpoint automatically after this many seconds, from `3600`
(1 hour) to `315360000` (10 years). Omit it or send `null` to keep the checkpoint until you delete it. Live checkpoints count toward [storage usage](https://docs.fastino.ai/api-reference/training-jobs/interactive/storage-usage.md).

**overwrite** `boolean` (default: false)

Replace a state checkpoint with the same name.

**user\_metadata** `object`

String key-value metadata stored with the checkpoint.

**soup** `object[]`

GLiDE jobs only: save instead the weighted mean of `2` to `8` training states,
without optimizer state. Saving a soup doesn't change the job's weights: to evaluate or
serve it, first load it with
[`load-weights`](https://docs.fastino.ai/api-reference/training-jobs/interactive/load-weights) and
`"optimizer": false`.

**properties**

**path** `string` *required*

`base` for the base model, a state name saved by this job, or a
`tinker://<job_id>/weights/<name>` state of another of your team's GLiDE jobs.

**weight** `number` *required*

Greater than `0`. The weights must sum to `1`.

```bash cURL theme={null}
curl -X POST "https://api.fastino.ai/v1/training/jobs/$TRAINING_JOB_ID/save-weights" \
  -H "X-API-Key: $FASTINO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "step-000100"}'
```

## Response

**future\_id** `string`

The `save` future.

**checkpoint\_id** `string`

`weights/<name>`.

**path** `string`

Full checkpoint path. Pass it as `from_checkpoint` when you create a job.

```json Response theme={null}
{
  "future_id": "FUTURE_ID",
  "job_id": "SESSION_ID:train:0",
  "type": "save",
  "checkpoint_id": "weights/step-000100",
  "path": "tinker://SESSION_ID:train:0/weights/step-000100"
}
```

| Status | Meaning |
| - | - |
| `400` | The name has invalid characters or length, the TTL is out of range, the job was stopped, or a `soup` is sent by a decoder job, has weights that don't sum to `1`, or names a sampler checkpoint. |
| `404` | The job doesn't exist or belongs to another team. |
| `422` | The body is missing `name` or has an unknown field, or a `soup` has fewer than `2` or more than `8` states or a weight that isn't greater than `0`. |
| `429` | The job already has `512` operations queued. Wait for its existing futures to finish before retrying. See [Interactive-job lifecycle](https://docs.fastino.ai/training.md#interactive-job-lifecycle). |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.