Chutes API Reference
This section covers all endpoints related to chutes.
Share Chute
Share a chute with another user.
Endpoint:
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| X-Chutes-Hotkey | string | null | No | |
| X-Chutes-Signature | string | null | No | |
| X-Chutes-Nonce | string | null | No | |
| Authorization | string | null | No |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| chute_id_or_name | string | Yes | |
| user_id_or_name | string | Yes |
Responses
| Status Code | Description |
|---|---|
| 200 | Successful Response |
| 422 | Validation Error |
Authentication
This endpoint requires authentication.
Unshare Chute
Unshare a chute with another user.
Endpoint:
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| X-Chutes-Hotkey | string | null | No | |
| X-Chutes-Signature | string | null | No | |
| X-Chutes-Nonce | string | null | No | |
| Authorization | string | null | No |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| chute_id_or_name | string | Yes | |
| user_id_or_name | string | Yes |
Responses
| Status Code | Description |
|---|---|
| 200 | Successful Response |
| 422 | Validation Error |
Authentication
This endpoint requires authentication.
Make Public
Promote subnet chutes to public visibility, owned by the calling subnet admin user.
Endpoint:
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| X-Chutes-Hotkey | string | null | No | |
| X-Chutes-Signature | string | null | No | |
| X-Chutes-Nonce | string | null | No | |
| Authorization | string | null | No |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| chutes | string[] | Yes |
Responses
| Status Code | Description |
|---|---|
| 200 | Successful Response |
| 422 | Validation Error |
Authentication
This endpoint requires authentication.
List Boosted Chutes
Get a list of chutes that have a boost.
Endpoint:
Responses
| Status Code | Description |
|---|---|
| 200 | Successful Response |
List Available Affine Chutes
Get a list of affine chutes where the creator/user has a non-zero balance.
Endpoint:
Responses
| Status Code | Description |
|---|---|
| 200 | Successful Response |
List Chutes
List (and optionally filter/paginate) chutes.
Endpoint:
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| include_public | boolean | null | No | |
| template | string | null | No | |
| name | string | null | No | |
| exclude | string | null | No | |
| image | string | null | No | |
| slug | string | null | No | |
| page | integer | No | |
| limit | integer | No | |
| offset | integer | No | |
| include_schemas | boolean | 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.
Deploy Chute
Standard deploy from the CDK.
Endpoint:
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| accept_fee | boolean | null | No | |
| X-Chutes-Hotkey | string | null | No | |
| X-Chutes-Signature | string | null | No | |
| X-Chutes-Nonce | string | null | No | |
| Authorization | string | null | No |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| name | string | Yes | |
| tagline | string | null | No | |
| readme | string | null | No | |
| tool_description | string | null | No | |
| logo_id | string | null | No | |
| image | string | Yes | |
| public | boolean | Yes | |
| code | string | Yes | |
| filename | string | Yes | |
| ref_str | string | Yes | |
| standard_template | string | null | No | |
| node_selector | NodeSelector | Yes | |
| cords | Cord[] | null | No | |
| jobs | Job[] | null | No | |
| concurrency | integer | null | No | |
| revision | string | null | No | |
| max_instances | integer | null | No | |
| scaling_threshold | number | null | No | |
| shutdown_after_seconds | integer | null | No | |
| allow_external_egress | boolean | null | No | |
| encrypted_fs | boolean | null | No | |
| tee | boolean | null | No | |
| lock_modules | boolean | null | No |
Responses
| Status Code | Description |
|---|---|
| 200 | Successful Response |
| 422 | Validation Error |
Authentication
This endpoint requires authentication.
List Rolling Updates
Endpoint:
Responses
| Status Code | Description |
|---|---|
| 200 | Successful Response |
Get Gpu Count History
Endpoint:
Responses
| Status Code | Description |
|---|---|
| 200 | Successful Response |
Get Chute Miner Mean Index
Endpoint:
Responses
| Status Code | Description |
|---|---|
| 200 | Successful Response |
Get Chute Miner Means
Load a chute's mean TPS and output token count by miner ID.
Endpoint:
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| chute_id | string | Yes | |
| ext | string | null | Yes |
Responses
| Status Code | Description |
|---|---|
| 200 | Successful Response |
| 422 | Validation Error |
Get Chute Miner Means
Load a chute's mean TPS and output token count by miner ID.
Endpoint:
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| chute_id | string | Yes | |
| ext | string | null | No |
Responses
| Status Code | Description |
|---|---|
| 200 | Successful Response |
| 422 | Validation Error |
Get Chute Code
Load a chute's code by ID or name.
Endpoint:
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| chute_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.
Get Chute Hf Info
Return Hugging Face repo_id and revision for a chute so miners can predownload the model. Miner-only; responses are cached by chute_id via aiocache.
Endpoint:
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| chute_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.
Warm Up Chute
Warm up a chute.
Endpoint:
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| chute_id_or_name | 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.
Get Chute Utilization
Get chute utilization data from the most recent capacity log.
Endpoint:
Responses
| Status Code | Description |
|---|---|
| 200 | Successful Response |
Get Tee Chute Evidence
Get TEE evidence for all instances of a chute (TDX quote, GPU evidence, certificate per instance).
Args: chute_id_or_name: Chute ID or name nonce: User-provided nonce (64 hex characters, 32 bytes)
Returns: TeeChuteEvidence with array of TEE instance evidence per instance
Raises: 404: Chute not found 400: Invalid nonce format or chute not TEE-enabled 403: User cannot access chute 429: Rate limit exceeded 500: Server attestation failures
Endpoint:
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| chute_id_or_name | 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.
Get Chute
Load a chute by ID or name.
Endpoint:
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| chute_id_or_name | 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.
Update Common Attributes
Update readme, tagline, etc. (but not code, image, etc.).
Endpoint:
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| chute_id_or_name | string | Yes | |
| X-Chutes-Hotkey | string | null | No | |
| X-Chutes-Signature | string | null | No | |
| X-Chutes-Nonce | string | null | No | |
| Authorization | string | null | No |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| tagline | string | null | No | |
| readme | string | null | No | |
| tool_description | string | null | No | |
| logo_id | string | null | No | |
| max_instances | integer | null | No | |
| scaling_threshold | number | null | No | |
| shutdown_after_seconds | integer | null | No | |
| disabled | boolean | null | No |
Responses
| Status Code | Description |
|---|---|
| 200 | Successful Response |
| 422 | Validation Error |
Authentication
This endpoint requires authentication.
Delete Chute
Delete a chute by ID.
Endpoint:
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| chute_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.
Easy Deploy Vllm Chute
Easy/templated vLLM deployment.
Endpoint:
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| X-Chutes-Hotkey | string | null | No | |
| X-Chutes-Signature | string | null | No | |
| X-Chutes-Nonce | string | null | No | |
| Authorization | string | null | No |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| model | string | Yes | |
| logo_id | string | null | No | |
| tagline | string | null | No | |
| tool_description | string | null | No | |
| readme | string | null | No | |
| public | boolean | null | No | |
| node_selector | NodeSelector | null | No | |
| engine_args | VLLMEngineArgs | null | No | |
| revision | string | null | No | |
| concurrency | integer | null | No |
Responses
| Status Code | Description |
|---|---|
| 200 | Successful Response |
| 422 | Validation Error |
Authentication
This endpoint requires authentication.
Easy Deploy Diffusion Chute
Easy/templated diffusion deployment.
Endpoint:
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| X-Chutes-Hotkey | string | null | No | |
| X-Chutes-Signature | string | null | No | |
| X-Chutes-Nonce | string | null | No | |
| Authorization | string | null | No |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| model | string | Yes | |
| name | string | Yes | |
| logo_id | string | null | No | |
| tagline | string | null | No | |
| tool_description | string | null | No | |
| readme | string | null | No | |
| public | boolean | null | No | |
| node_selector | NodeSelector | null | No | |
| concurrency | integer | null | No |
Responses
| Status Code | Description |
|---|---|
| 200 | Successful Response |
| 422 | Validation Error |
Authentication
This endpoint requires authentication.
Teeify Chute
Create a new TEE-enabled chute from an existing affine chute.
Endpoint:
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| chute_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.
Get Bounty List
List available bounties, if any.
Endpoint:
Responses
| Status Code | Description |
|---|---|
| 200 | Successful Response |
Increase Chute Bounty
Increase bounty value (creating if not exists).
Endpoint:
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| chute_id | string | Yes | |
| boost | number | 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.