Docs

Users API Reference

This section covers all endpoints related to users.

Get User Growth

GET/users/growth

API

Code Examples

curl -X GET "https://api.chutes.ai/users/growth"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Responses

Status Code	Description
200	Successful Response

List Chute Shares

GET/users/{user_id}/shares

API

Code Examples

curl -X GET "https://api.chutes.ai/users/{user_id}/shares"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Parameters

Parameter	Type	Required
user_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.

Admin User Id Lookup

GET/users/user_id_lookup

API

Code Examples

curl -X GET "https://api.chutes.ai/users/user_id_lookup"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Parameters

Parameter	Type	Required
username	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.

Admin Balance Lookup

GET/users/{user_id_or_username}/balance

API

Code Examples

curl -X GET "https://api.chutes.ai/users/{user_id_or_username}/balance"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Parameters

Parameter	Type	Required
user_id_or_username	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.

Admin Invoiced User List

GET/users/invoiced_user_list

API

Code Examples

curl -X GET "https://api.chutes.ai/users/invoiced_user_list"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Parameters

Parameter	Type	Required
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.

Admin Batch User Lookup

POST/users/batch_user_lookup

API

Code Examples

curl -X POST "https://api.chutes.ai/users/batch_user_lookup"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Parameters

Parameter	Type	Required
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.

Admin Balance Change

POST/users/admin_balance_change

API

Code Examples

curl -X POST "https://api.chutes.ai/users/admin_balance_change"
  -H "Content-Type: application/json"
  -d '{}'

Request Configuration

Authorization

API Key or Bearer Token

Request Body

user_id*string

amount*number

reason*string

Endpoint:

Parameters

Parameter	Type	Required
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
user_id	string	Yes
amount	number	Yes
reason	string	Yes

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

Grant Subnet Role

POST/users/grant_subnet_role

API

Code Examples

curl -X POST "https://api.chutes.ai/users/grant_subnet_role"
  -H "Content-Type: application/json"
  -d '{}'

Request Configuration

Authorization

API Key or Bearer Token

Request Body

user*string

netuid*integer

admin*boolean

Endpoint:

Parameters

Parameter	Type	Required
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
user	string	Yes
netuid	integer	Yes
admin	boolean	Yes

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

Revoke Subnet Role

POST/users/revoke_subnet_role

API

Code Examples

curl -X POST "https://api.chutes.ai/users/revoke_subnet_role"
  -H "Content-Type: application/json"
  -d '{}'

Request Configuration

Authorization

API Key or Bearer Token

Request Body

user*string

netuid*integer

Endpoint:

Parameters

Parameter	Type	Required
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
user	string	Yes
netuid	integer	Yes

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

Admin Quotas Change

POST/users/{user_id}/quotas

API

Code Examples

curl -X POST "https://api.chutes.ai/users/{user_id}/quotas"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Parameters

Parameter	Type	Required
user_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.

Admin Get User Quotas

Load quotas for a user.

GET/users/{user_id}/quotas

API

Code Examples

curl -X GET "https://api.chutes.ai/users/{user_id}/quotas"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Parameters

Parameter	Type	Required
user_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.

Admin Discounts Change

POST/users/{user_id}/discounts

API

Code Examples

curl -X POST "https://api.chutes.ai/users/{user_id}/discounts"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Parameters

Parameter	Type	Required
user_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.

Admin List Discounts

GET/users/{user_id}/discounts

API

Code Examples

curl -X GET "https://api.chutes.ai/users/{user_id}/discounts"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Parameters

Parameter	Type	Required
user_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.

Admin Enable Invoicing

POST/users/{user_id}/enable_invoicing

API

Code Examples

curl -X POST "https://api.chutes.ai/users/{user_id}/enable_invoicing"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Parameters

Parameter	Type	Required
user_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.

My Quotas

Load quotas for the current user.

GET/users/me/quotas

API

Code Examples

curl -X GET "https://api.chutes.ai/users/me/quotas"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Parameters

Parameter	Type	Required
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.

My Discounts

Load discounts for the current user.

GET/users/me/discounts

API

Code Examples

curl -X GET "https://api.chutes.ai/users/me/discounts"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Parameters

Parameter	Type	Required
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.

My Price Overrides

Load price overrides for the current user.

GET/users/me/price_overrides

API

Code Examples

curl -X GET "https://api.chutes.ai/users/me/price_overrides"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Parameters

Parameter	Type	Required
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.

Chute Quota Usage

Check the current quota usage for a chute.

GET/users/me/quota_usage/{chute_id}

API

Code Examples

curl -X GET "https://api.chutes.ai/users/me/quota_usage/{chute_id}"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Parameters

Parameter	Type	Required
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.

Delete My User

Delete account.

DELETE/users/me

API

Code Examples

curl -X DELETE "https://api.chutes.ai/users/me"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Parameters

Parameter	Type	Required	Description
Authorization	string	Yes	Authorization header

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Set Logo

Get a detailed response for the current user.

GET/users/set_logo

API

Code Examples

curl -X GET "https://api.chutes.ai/users/set_logo"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Parameters

Parameter	Type	Required
logo_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.

Check Username

Check if a username is valid and available.

GET/users/name_check

API

Code Examples

curl -X GET "https://api.chutes.ai/users/name_check"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Parameters

Parameter	Type	Required	Description
username	string	Yes
readonly	boolean \| null	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Register

POST/users/register

API

Code Examples

curl -X POST "https://api.chutes.ai/users/register"
  -H "Content-Type: application/json"
  -d '{}'

Request Configuration

Authorization

API Key or Bearer Token

Request Body

username*string

coldkey*string

logo_idstring | null

Endpoint:

Parameters

Parameter	Type	Required	Description
token	string \| null	No
X-Chutes-Hotkey	string	Yes	The hotkey of the user
X-Chutes-Signature	string \| null	No
X-Chutes-Nonce	string \| null	No
Authorization	string \| null	No

Request Body

Field	Type	Required
username	string	Yes
coldkey	string	Yes
logo_id	string \| null	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

Get Registration Token

Initial form with cloudflare + hcaptcha to generate a registration token.

GET/users/registration_token

API

Code Examples

curl -X GET "https://api.chutes.ai/users/registration_token"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Responses

Status Code	Description
200	Successful Response

Post Rtok

Verify hCaptcha and get a short-lived registration token.

POST/users/registration_token

API

Code Examples

curl -X POST "https://api.chutes.ai/users/registration_token"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Responses

Status Code	Description
200	Successful Response

Admin Create User

Create a new user manually from an admin account, no bittensor stuff necessary.

POST/users/create_user

API

Code Examples

curl -X POST "https://api.chutes.ai/users/create_user"
  -H "Content-Type: application/json"
  -d '{}'

Request Configuration

Authorization

API Key or Bearer Token

Request Body

username*string

coldkeystring | null

hotkeystring | null

logo_idstring | null

Endpoint:

Parameters

Parameter	Type	Required
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
username	string	Yes
coldkey	string \| null	No
hotkey	string \| null	No
logo_id	string \| null	No

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Authentication

This endpoint requires authentication.

Change Fingerprint

Reset a user's fingerprint using either the hotkey or coldkey.

POST/users/change_fingerprint

API

Code Examples

curl -X POST "https://api.chutes.ai/users/change_fingerprint"
  -H "Content-Type: application/json"
  -d '{}'

Request Configuration

Authorization

API Key or Bearer Token

Request Body

fingerprint*string

Endpoint:

Parameters

Parameter	Type	Required	Description
Authorization	string \| null	No
X-Chutes-Hotkey	string \| null	No
X-Chutes-Coldkey	string \| null	No
X-Chutes-Nonce	string	No	Nonce
X-Chutes-Signature	string	No	Hotkey signature

Request Body

Field	Type	Required	Description
fingerprint	string	Yes

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Get a nonce for hotkey signature login. The nonce is a UUID4 string that must be signed by the user's hotkey. Valid for 5 minutes.

GET/users/login/nonce

API

Code Examples

curl -X GET "https://api.chutes.ai/users/login/nonce"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Responses

Status Code	Description
200	Successful Response

Exchange credentials for a JWT.

Supports two authentication methods:

Fingerprint: {"fingerprint": "your-fingerprint"}
Hotkey signature: {"hotkey": "5...", "signature": "hex...", "nonce": "uuid"}

For hotkey auth, first call GET /users/login/nonce to get a nonce, sign it with your hotkey (e.g., ), then submit the hotkey, signature, and nonce.

POST/users/login

API

Code Examples

curl -X POST "https://api.chutes.ai/users/login"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Responses

Status Code	Description
200	Successful Response

Change Bt Auth

Change the bittensor hotkey/coldkey associated with an account via fingerprint auth.

POST/users/change_bt_auth

API

Code Examples

curl -X POST "https://api.chutes.ai/users/change_bt_auth"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Parameters

Parameter	Type	Required	Description
Authorization	string	Yes

Responses

Status Code	Description
200	Successful Response
422	Validation Error

Update Squad Access

Enable squad access.

PUT/users/squad_access

API

Code Examples

curl -X PUT "https://api.chutes.ai/users/squad_access"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Parameters

Parameter	Type	Required
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.

List Usage

List usage summary data.

GET/users/{user_id}/usage

API

Code Examples

curl -X GET "https://api.chutes.ai/users/{user_id}/usage"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Parameters

Parameter	Type	Required
user_id	string	Yes
page	integer \| null	No
limit	integer \| null	No
per_chute	boolean \| null	No
chute_id	string \| null	No
start_date	string \| null	No
end_date	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.

Get User Info

Get user info.

GET/users/{user_id}

API

Code Examples

curl -X GET "https://api.chutes.ai/users/{user_id}"
  -H "Content-Type: application/json"

Request Configuration

Authorization

API Key or Bearer Token

Endpoint:

Parameters

Parameter	Type	Required
user_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.

Users API Reference

Get User Growth

Authorization

Responses

List Chute Shares

Authorization

Parameters (5)

Parameters

Responses

Authentication

Admin User Id Lookup

Authorization

Parameters (5)

Parameters

Responses

Authentication

Admin Balance Lookup

Authorization

Parameters (5)

Parameters

Responses

Authentication

Admin Invoiced User List

Authorization

Parameters (4)

Parameters

Responses

Authentication

Admin Batch User Lookup

Authorization

Parameters (4)

Parameters

Responses

Authentication

Admin Balance Change

Authorization

Parameters (4)

Request Body

Parameters

Request Body

Responses

Authentication

Grant Subnet Role

Authorization

Parameters (4)

Request Body

Parameters

Request Body

Responses

Authentication

Revoke Subnet Role

Authorization

Parameters (4)

Request Body

Parameters

Request Body

Responses

Authentication

Admin Quotas Change

Authorization

Parameters (5)

Parameters

Responses

Authentication

Admin Get User Quotas

Authorization

Parameters (5)

Parameters

Responses

Authentication

Admin Discounts Change

Authorization

Parameters (5)

Parameters

Responses

Authentication

Admin List Discounts

Authorization

Parameters (5)

Parameters