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:
Responses
| Status Code | Description |
|---|
| 200 | Successful Response |
Get Launch Config
Endpoint:
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.
Validate Tee Launch Config Instance
Endpoint:
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 | |
| netnanny_hash | string | null | No | |
| run_path | string | null | No | |
| py_dirs | string[] | null | No | |
| gpu_evidence | object[] | Yes | |
| inspecto | string | null | No | |
Responses
| Status Code | Description |
|---|
| 200 | Successful Response |
| 422 | Validation Error |
Claim Launch Config
Endpoint:
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 | |
| netnanny_hash | string | null | No | |
| run_path | string | null | No | |
| py_dirs | 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:
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:
Parameters
| Parameter | Type | Required | Description |
|---|
| config_id | string | Yes | |
| Authorization | string | No | |
Responses
| Status Code | Description |
|---|
| 200 | Successful Response |
| 422 | Validation Error |
Get Token
Endpoint:
Parameters
| Parameter | Type | Required | Description |
|---|
| salt | string | No | |
Responses
| Status Code | Description |
|---|
| 200 | Successful Response |
| 422 | Validation Error |
Stream Logs
Fetch the raw kubernetes pod logs, but only if the chute is private.
These are application-level logs, which for example would not include
any prompts/responses/etc. by default for any sglang/vllm container.
The caveat is that affine admins can view any affine chute pod logs.
Endpoint:
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.
Delete Instance
Endpoint:
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.