Chutes API Reference

This section covers all endpoints related to chutes.

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
image	string | null	No
slug	string | null	No
page	integer | null	No
limit	integer | null	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
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

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.

---

Get Chute Utilization

Get chute utilization data.

Endpoint: GET /chutes/utilization_legacy

Responses

Status Code	Description
200	Successful Response

---

Get Chute Utilization V2

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.

---

Delete Chute

Delete a chute by ID or name.

Endpoint: DELETE /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

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

---

Share Chute

Share a chute with another user.

Endpoint: POST /chutes/{chute_id}/share

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.

---

Easy Deploy Tei Chute

Easy/templated text-embeddings-inference deployment.

Endpoint: POST /chutes/tei

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
endpoints	string[]	Yes	List of supported endpoints for this chute
revision	string | null	No
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

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

---

List Bounties

List available bounties, if any.

Endpoint: GET /bounties/

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

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

---