Docs
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.
GET/instances/reconciliation_csv
API
Code Examples
curl -X GET "https://api.chutes.ai/instances/reconciliation_csv"
-H "Content-Type: application/json"Request Configuration
Authorization
Endpoint:
Responses
| Status Code | Description |
|---|---|
| 200 | Successful Response |
Get Launch Config
GET/instances/launch_config
API
Code Examples
curl -X GET "https://api.chutes.ai/instances/launch_config"
-H "Content-Type: application/json"Request Configuration
Authorization
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
POST/instances/launch_config/{config_id}/attest
API
Code Examples
curl -X POST "https://api.chutes.ai/instances/launch_config/{config_id}/attest"
-H "Content-Type: application/json"
-d '{}'Request Configuration
Authorization
Request Body
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
POST/instances/launch_config/{config_id}
API
Code Examples
curl -X POST "https://api.chutes.ai/instances/launch_config/{config_id}"
-H "Content-Type: application/json"
-d '{}'Request Configuration
Authorization
Request Body
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
PUT/instances/launch_config/{config_id}
API
Code Examples
curl -X PUT "https://api.chutes.ai/instances/launch_config/{config_id}"
-H "Content-Type: application/json"Request Configuration
Authorization
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
GET/instances/launch_config/{config_id}/activate
API
Code Examples
curl -X GET "https://api.chutes.ai/instances/launch_config/{config_id}/activate"
-H "Content-Type: application/json"Request Configuration
Authorization
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
GET/instances/token_check
API
Code Examples
curl -X GET "https://api.chutes.ai/instances/token_check"
-H "Content-Type: application/json"Request Configuration
Authorization
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.
GET/instances/{instance_id}/logs
API
Code Examples
curl -X GET "https://api.chutes.ai/instances/{instance_id}/logs"
-H "Content-Type: application/json"Request Configuration
Authorization
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
DELETE/instances/{chute_id}/{instance_id}
API
Code Examples
curl -X DELETE "https://api.chutes.ai/instances/{chute_id}/{instance_id}"
-H "Content-Type: application/json"Request Configuration
Authorization
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.