Instances API Reference

This section covers all endpoints related to instances.

Get Instance Reconciliation Csv

Get all instance audit instance_id, deleted_at records to help reconcile audit data.

Endpoint: GET /instances/reconciliation_csv

Responses

Status Code	Description
200	Successful Response

---

Get Instance Compute History Csv

Get instance_compute_history records for the scoring period (last 7 days + buffer). Used by the auditor to reconcile compute history data on startup.

Endpoint: GET /instances/compute_history_csv

Responses

Status Code	Description
200	Successful Response

---

Get Launch Config

Endpoint: GET /instances/launch_config

Parameters

Parameter	Type	Required	Description
chute_id	string	Yes
server_id	string | null	No
job_id	string | null	No
X-Chutes-Hotkey	string | null	No
X-Chutes-Signature	string | null	No
X-Chutes-Nonce	string | null	No
Authorization	string | null	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

---

Get Rint Nonce

Get runtime integrity nonce for a launch config.

This endpoint consumes the nonce from Redis (one-time use). Only available for chutes_version >= 0.4.9.

Endpoint: GET /instances/launch_config/{config_id}/nonce

Parameters

Parameter	Type	Required	Description
config_id	string	Yes
Authorization	string	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

---

Claim Tee Launch Config

Claim a TEE launch config, verify attestation, and receive symmetric key.

Endpoint: POST /instances/launch_config/{config_id}/tee

Parameters

Parameter	Type	Required	Description
config_id	string	Yes
Authorization	string	No
X-Chutes-Nonce	string | null	No

Request Body

Field	Type	Required	Description
gpus	object[]	Yes
host	string	Yes
port_mappings	PortMap[]	Yes
fsv	string | null	No
egress	boolean | null	No
lock_modules	boolean | null	No
netnanny_hash	string | null	No
run_path	string | null	No
py_dirs	string[] | null	No
rint_commitment	string | null	No
rint_nonce	string | null	No
rint_pubkey	string | null	No
tls_cert	string | null	No
tls_cert_sig	string | null	No
tls_ca_cert	string | null	No
tls_client_cert	string | null	No
tls_client_key	string | null	No
tls_client_key_password	string | null	No
e2e_pubkey	string | null	No
cllmv_session_init	string | null	No
env	string	Yes
code	string | null	No
run_code	string | null	No
inspecto	string | null	No
deployment_id	string	Yes

Responses

Status Code	Description
200	Successful Response
422	Validation Error

---

Verify Tee Launch Config Instance

Verify TEE launch config instance by validating symmetric key usage via dummy ports.

Endpoint: PUT /instances/launch_config/{config_id}/tee

Parameters

Parameter	Type	Required	Description
config_id	string	Yes
Authorization	string	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

---

Validate Tee Launch Config Instance

Endpoint: POST /instances/launch_config/{config_id}/attest

Parameters

Parameter	Type	Required	Description
config_id	string	Yes
Authorization	string	No
X-Chutes-Nonce	string | null	No

Request Body

Field	Type	Required	Description
gpus	object[]	Yes
host	string	Yes
port_mappings	PortMap[]	Yes
fsv	string | null	No
egress	boolean | null	No
lock_modules	boolean | null	No
netnanny_hash	string | null	No
run_path	string | null	No
py_dirs	string[] | null	No
rint_commitment	string | null	No
rint_nonce	string | null	No
rint_pubkey	string | null	No
tls_cert	string | null	No
tls_cert_sig	string | null	No
tls_ca_cert	string | null	No
tls_client_cert	string | null	No
tls_client_key	string | null	No
tls_client_key_password	string | null	No
e2e_pubkey	string | null	No
cllmv_session_init	string | null	No
env	string	Yes
code	string | null	No
run_code	string | null	No
inspecto	string | null	No
gpu_evidence	object[]	Yes

Responses

Status Code	Description
200	Successful Response
422	Validation Error

---

Claim Launch Config

Endpoint: POST /instances/launch_config/{config_id}

Parameters

Parameter	Type	Required	Description
config_id	string	Yes
Authorization	string	No

Request Body

Field	Type	Required	Description
gpus	object[]	Yes
host	string	Yes
port_mappings	PortMap[]	Yes
fsv	string | null	No
egress	boolean | null	No
lock_modules	boolean | null	No
netnanny_hash	string | null	No
run_path	string | null	No
py_dirs	string[] | null	No
rint_commitment	string | null	No
rint_nonce	string | null	No
rint_pubkey	string | null	No
tls_cert	string | null	No
tls_cert_sig	string | null	No
tls_ca_cert	string | null	No
tls_client_cert	string | null	No
tls_client_key	string | null	No
tls_client_key_password	string | null	No
e2e_pubkey	string | null	No
cllmv_session_init	string | null	No
env	string	Yes
code	string | null	No
run_code	string | null	No
inspecto	string | null	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

---

Verify Launch Config Instance

Endpoint: PUT /instances/launch_config/{config_id}

Parameters

Parameter	Type	Required	Description
config_id	string	Yes
Authorization	string	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

---

Claim Graval Launch Config

Claim a Graval launch config and receive PoVW challenge.

Endpoint: POST /instances/launch_config/{config_id}/graval

Parameters

Parameter	Type	Required	Description
config_id	string	Yes
Authorization	string	No

Request Body

Field	Type	Required	Description
gpus	object[]	Yes
host	string	Yes
port_mappings	PortMap[]	Yes
fsv	string | null	No
egress	boolean | null	No
lock_modules	boolean | null	No
netnanny_hash	string | null	No
run_path	string | null	No
py_dirs	string[] | null	No
rint_commitment	string | null	No
rint_nonce	string | null	No
rint_pubkey	string | null	No
tls_cert	string | null	No
tls_cert_sig	string | null	No
tls_ca_cert	string | null	No
tls_client_cert	string | null	No
tls_client_key	string | null	No
tls_client_key_password	string | null	No
e2e_pubkey	string | null	No
cllmv_session_init	string | null	No
env	string	Yes
code	string | null	No
run_code	string | null	No
inspecto	string | null	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

---

Verify Graval Launch Config Instance

Verify Graval launch config instance by validating PoVW proof and symmetric key usage.

Endpoint: PUT /instances/launch_config/{config_id}/graval

Parameters

Parameter	Type	Required	Description
config_id	string	Yes
Authorization	string	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

---

Activate Launch Config Instance

Endpoint: GET /instances/launch_config/{config_id}/activate

Parameters

Parameter	Type	Required	Description
config_id	string	Yes
Authorization	string	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

---

Get Instance Nonce

Generate a nonce for TEE instance verification.

This endpoint is called by chute instances during TEE verification (Phase 1). The nonce is used to bind the attestation evidence to this specific verification request.

Endpoint: GET /instances/nonce

Responses

Status Code	Description
200	Successful Response

---

Get Token

Endpoint: GET /instances/token_check

Parameters

Parameter	Type	Required	Description
salt	string	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

---

Get Tee Instance Evidence

Get TEE evidence for a specific instance (TDX quote, GPU evidence, certificate).

Args: instance_id: Instance ID nonce: User-provided nonce (64 hex characters, 32 bytes)

Returns: TeeInstanceEvidence with quote, gpu_evidence, and certificate

Raises: 404: Instance not found 400: Invalid nonce format or instance not TEE-enabled 403: User cannot access instance 429: Rate limit exceeded 500: Server attestation failures

Endpoint: GET /instances/{instance_id}/evidence

Parameters

Parameter	Type	Required	Description
instance_id	string	Yes
nonce	string	Yes
X-Chutes-Hotkey	string | null	No
X-Chutes-Signature	string | null	No
X-Chutes-Nonce	string | null	No
Authorization	string | null	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

---

Stream Logs

Fetch raw kubernetes pod logs.

NOTE: These are pod logs, not request data/etc., so it will never include prompts, responses, etc. Used for troubleshooting and checking status of warmup, etc.

Endpoint: GET /instances/{instance_id}/logs

Parameters

Parameter	Type	Required	Description
instance_id	string	Yes
backfill	integer | null	No
X-Chutes-Hotkey	string | null	No
X-Chutes-Signature	string | null	No
X-Chutes-Nonce	string | null	No
Authorization	string | null	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

---

Disable Instance Endpoint

Endpoint: POST /instances/{chute_id}/{instance_id}/disable

Parameters

Parameter	Type	Required	Description
chute_id	string	Yes
instance_id	string	Yes
X-Chutes-Hotkey	string | null	No
X-Chutes-Signature	string | null	No
X-Chutes-Nonce	string | null	No
Authorization	string | null	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

---

Delete Instance

Endpoint: DELETE /instances/{chute_id}/{instance_id}

Parameters

Parameter	Type	Required	Description
chute_id	string	Yes
instance_id	string	Yes
X-Chutes-Hotkey	string | null	No
X-Chutes-Signature	string | null	No
X-Chutes-Nonce	string | null	No
Authorization	string | null	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

---