---
title: "Load a training state into an interactive training job"
method: POST
path: "/v1/training/jobs/{job_id}/load-weights"
tags: ["training"]
---

# Load a training state into an interactive training job

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

## Request

- Base URL: `https://api.fastino.ai`
- URL: `https://api.fastino.ai/v1/training/jobs/{job_id}/load-weights`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Restore one of the job's saved training states, and optionally its optimizer state (Tinker's `load_state`). Read the result at GET /v1/training/jobs/{job_id}/futures/{future_id}.

## Path parameters

- `job_id` string, required

## Headers

- `Idempotency-Key` string, nullable: Client-generated key (a UUID is ideal; it must be URL-safe to look it up) that makes the call safe to send again after a lost response. A repeat with the same key and body from the same caller returns the first call's answer (the same job and future) without running or billing it again, or a 409 while the first call still runs; the same key with another route, job, body or caller is a 422. Look a key up with GET /v1/training/operations/{idempotency_key}.

## Request body

- LoadWeightsBody: ``POST .../load-weights``: restore one of the job's saved training states.
  - `optimizer` boolean: Also restore the optimizer state.
  - `path` string, required: The state's name, or its `tinker://<job_id>/weights/<name>` path (this job's own).

## Response `200`

Successful Response

- FutureAccepted: A queued call: read its result at ``GET /v1/training/jobs/{job_id}/futures/{future_id}``.
  - `future_id` string, required
  - `job_id` string, required
  - `type` string, required: The call: create, load, forward, forward_backward, optim_step, save, sample.

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-17** `81465e18c1d2`: 1 info
  - added the new optional `header` request parameter `Idempotency-Key`
- **2026-10-15** `eef86c1497c1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fastino-ai/apis/pioneer-inference-api/changes/v1/training/jobs/:job_id/load-weights/post.md)

---

[API](https://skmtc.dev/fastino-ai/apis/pioneer-inference-api.md) - [All operations](https://skmtc.dev/fastino-ai/apis/pioneer-inference-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fastino-ai/apis/pioneer-inference-api/revisions/81465e18c1d2?raw)