Chutes API Reference

This section covers all endpoints related to chutes.

Share Chute

Share a chute with another user.

Endpoint: POST /chutes/share

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: POST /chutes/unshare

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.

---

List Boosted Chutes

Get a list of chutes that have a boost.

Endpoint: GET /chutes/boosted

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: GET /chutes/affine_available

Responses

Status Code	Description
200	Successful Response

---

List Chutes

List (and optionally filter/paginate) chutes.

Endpoint: GET /chutes/

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: POST /chutes/

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

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

---

List Rolling Updates

Endpoint: GET /chutes/rolling_updates

Responses

Status Code	Description
200	Successful Response

---

Get Gpu Count History

Endpoint: GET /chutes/gpu_count_history

Responses

Status Code	Description
200	Successful Response

---

Get Chute Miner Mean Index

Endpoint: GET /chutes/miner_means

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: GET /chutes/miner_means/{chute_id}.{ext}

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: GET /chutes/miner_means/{chute_id}

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: GET /chutes/code/{chute_id}

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: GET /chutes/warmup/{chute_id_or_name}

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: GET /chutes/utilization

Responses

Status Code	Description
200	Successful Response

---

Get Chute

Load a chute by ID or name.

Endpoint: GET /chutes/{chute_id_or_name}

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: PUT /chutes/{chute_id_or_name}

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

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

---

Delete Chute

Delete a chute by ID.

Endpoint: DELETE /chutes/{chute_id}

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: POST /chutes/vllm

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: POST /chutes/diffusion

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.

---

Get Bounty List

List available bounties, if any.

Endpoint: GET /bounties/

Responses

Status Code	Description
200	Successful Response

---