Reload a model into a serving runtime

Use this endpoint to reload a model into its serving runtime. Because ariapin has no separate serving process, reloading is implemented by restarting the agent that executed the model’s training job. The agent already holds the weights, so a restart loads the latest checkpoint.

Method + Path

POST /v1/models/:id/reload

Authentication

Include your PIN API token or JWT in the Authorization header as a Bearer token.

Authorization: Bearer <token>

Path parameters

string

required

The model identifier (e.g., md_abc123def456).

Request body

No request body is required.

Request example

curl -s -X POST "https://api.ariacompute.com/v1/models/md_abc123def456/reload" \
  -H "Authorization: Bearer $PIN_API_TOKEN"

Response

Returns a standard PIN success envelope with the reload result.

integer

required

0 on success, nonzero on error.

object

required

Show properties

string

The model identifier.

string

The source training job identifier.

string

The restarted agent identifier.

boolean

Always true on success.

string

Always restart (current implementation).

string

Human-readable message (empty on success).

Example response

{
  "code": 0,
  "data": {
    "model_id": "md_abc123def456",
    "job_id": "jb_abc123def456",
    "agent_id": "ag_node01_001",
    "reloaded": true,
    "mode": "restart"
  },
  "message": ""
}

Reload requirements

A model can only be reloaded if all of the following are true:

The model was produced by an ariapin training job (job_id is set).
The source training job still exists in the database.
The source job is bound to an active agent (agent_id is not empty).

Stopped or resumed jobs release their agent, so reloading those models will fail with a 422 error.

Errors

Code	HTTP	Meaning
401	401	Missing or invalid Bearer token.
404	404	Model not found or does not belong to you.
422	422	Model has no source job, the job no longer exists, or the job is not bound to an agent.
500	500	Agent restart failed.

PIN API

ROUTER API

AGENT API

Reload a model into a serving runtime

Method + Path

Authentication

Path parameters

Request body

Request example

Response

Example response

Reload requirements

Errors

​Method + Path

​Authentication

​Path parameters

​Request body

​Request example

​Response

​Example response

​Reload requirements

​Errors

Method + Path

Authentication

Path parameters

Request body

Request example

Response

Example response

Reload requirements

Errors