### Get Usage Configuration Source: https://chutes.ai/docs/api-reference/invocations Configuration for the GET /invocations/usage endpoint. ```json {"endpoint":"/invocations/usage","method":"GET","parameters":[],"requestBody":null} ``` -------------------------------- ### GET /pricing Source: https://chutes.ai/docs/api-reference/pricing Get the current compute unit pricing. ```APIDOC ## GET /pricing ### Description Get the current compute unit pricing. ### Method GET ### Endpoint /pricing ### Responses #### Success Response (200) - **Response Body** (object) - Successful Response ``` -------------------------------- ### Get Launch Config Source: https://chutes.ai/docs/api-reference/instances Retrieves the launch configuration for instances. ```APIDOC ## GET /instances/launch_config ### Description Retrieves the launch configuration for instances. ### Method GET ### Endpoint /instances/launch_config ### Parameters #### Query Parameters - **chute_id** (string) - Required - - **server_id** (string | null) - Optional - - **job_id** (string | null) - Optional - #### Header Parameters - **X-Chutes-Hotkey** (string | null) - Optional - - **X-Chutes-Signature** (string | null) - Optional - - **X-Chutes-Nonce** (string | null) - Optional - - **Authorization** (string | null) - Optional - ### Responses #### Success Response (200) - **Success** - Successful Response #### Error Response (422) - **Error** - Validation Error ``` -------------------------------- ### Get Export Configuration Source: https://chutes.ai/docs/api-reference/invocations Configuration for the GET /invocations/exports/{year}/{month}/{day}/{hour_format} endpoint requiring path parameters. ```json {"endpoint":"/invocations/exports/{year}/{month}/{day}/{hour_format}","method":"GET","parameters":[{"name":"year","type":"integer","required":true,"description":"","in":"path"},{"name":"month","type":"integer","required":true,"description":"","in":"path"},{"name":"day","type":"integer","required":true,"description":"","in":"path"},{"name":"hour_format","type":"string","required":true,"description":"","in":"path"}],"requestBody":null} ``` -------------------------------- ### GET /fmv Source: https://chutes.ai/docs/api-reference/pricing Get the current FMV for tao. ```APIDOC ## GET /fmv ### Description Get the current FMV for tao. ### Method GET ### Endpoint /fmv ### Responses #### Success Response (200) - **Response Body** (object) - Successful Response ``` -------------------------------- ### GET /instances/token_check Source: https://chutes.ai/docs/api-reference/instances Retrieves a token for instance verification. ```APIDOC ## GET /instances/token_check ### Description Retrieves a token for instance verification purposes. ### Method GET ### Endpoint /instances/token_check ### Parameters #### Query Parameters - **salt** (string) - Optional ### Response #### Success Response (200) - Successful Response #### Error Response (422) - Validation Error ``` -------------------------------- ### GET /instances/launch_config/{config_id}/activate Source: https://chutes.ai/docs/api-reference/instances Activates a specific launch configuration instance. ```APIDOC ## GET /instances/launch_config/{config_id}/activate ### Description Activates a launch configuration instance using the provided configuration ID. ### Method GET ### Endpoint /instances/launch_config/{config_id}/activate ### Parameters #### Path Parameters - **config_id** (string) - Required #### Header Parameters - **Authorization** (string) - Optional ### Response #### Success Response (200) - Successful Response #### Error Response (422) - Validation Error ``` -------------------------------- ### GET /daily_revenue_summary Source: https://chutes.ai/docs/api-reference/pricing Get the summary of daily revenue including paygo, invoiced users, subscriptions and pending private instances. ```APIDOC ## GET /daily_revenue_summary ### Description Get the summary of daily revenue including paygo, invoiced users, subscriptions and pending private instances. ### Method GET ### Endpoint /daily_revenue_summary ### Parameters #### Query Parameters - **days** (integer | null) - Optional - ### Responses #### Success Response (200) - **Response Body** (object) - Successful Response #### Error Response (422) - **Response Body** (object) - Validation Error ``` -------------------------------- ### GET /bounties/ Source: https://chutes.ai/docs/api-reference/chutes List available bounties, if any. ```APIDOC ## GET /bounties/ ### Description List available bounties, if any. ### Method GET ### Endpoint /bounties/ ### Response #### Success Response (200) - Successful Response ``` -------------------------------- ### GET /invocations/exports/{year}/{month}/{day}/{hour_format} Source: https://chutes.ai/docs/api-reference/invocations Get invocation exports (and reports) for a particular hour. ```APIDOC ## GET /invocations/exports/{year}/{month}/{day}/{hour_format} ### Description Get invocation exports (and reports) for a particular hour. ### Method GET ### Endpoint /invocations/exports/{year}/{month}/{day}/{hour_format} ### Parameters #### Path Parameters - **year** (integer) - Required - - **month** (integer) - Required - - **day** (integer) - Required - - **hour_format** (string) - Required - ### Responses #### Success Response (200) - Successful Response #### Error Response (422) - Validation Error #### Response Example { "example": "response body" } ``` -------------------------------- ### GET /instances/nonce Source: https://chutes.ai/docs/api-reference/instances Generates a nonce for TEE instance verification. ```APIDOC ## GET /instances/nonce ### Description Generates a nonce for TEE instance verification. This endpoint is called by chute instances during TEE verification (Phase 1) to bind attestation evidence to the request. ### Method GET ### Endpoint /instances/nonce ### Response #### Success Response (200) - Successful Response ``` -------------------------------- ### Get Recent Export Configuration Source: https://chutes.ai/docs/api-reference/invocations Configuration for the GET /invocations/exports/recent endpoint with optional hotkey and limit parameters. ```json {"endpoint":"/invocations/exports/recent","method":"GET","parameters":[{"name":"hotkey","type":"string \\| null","required":false,"description":"","in":"query"},{"name":"limit","type":"integer \\| null","required":false,"description":"","in":"query"}],"requestBody":null} ``` -------------------------------- ### GET /invocations/usage Source: https://chutes.ai/docs/api-reference/invocations Get aggregated usage data, which is the amount of revenue we would be receiving if no usage was free. ```APIDOC ## GET /invocations/usage ### Description Get aggregated usage data, which is the amount of revenue we would be receiving if no usage was free. ### Method GET ### Endpoint /invocations/usage ### Responses #### Success Response (200) - Successful Response #### Response Example { "example": "response body" } ``` -------------------------------- ### GET /idp/userinfo Source: https://chutes.ai/docs/api-reference/identity-provider OpenID Connect UserInfo Endpoint. ```APIDOC ## GET /idp/userinfo ### Description OpenID Connect UserInfo Endpoint. ### Method GET ### Endpoint /idp/userinfo ### Response #### Success Response (200) - Successful Response ``` -------------------------------- ### GET /payments Source: https://chutes.ai/docs/api-reference/pricing List all payments. ```APIDOC ## GET /payments ### Description List all payments. ### Method GET ### Endpoint /payments ### Parameters #### Query Parameters - **page** (integer | null) - Optional - - **limit** (integer | null) - Optional - ### Responses #### Success Response (200) - **Response Body** (object) - Successful Response #### Error Response (422) - **Response Body** (object) - Validation Error ``` -------------------------------- ### GET /users/me/discounts Source: https://chutes.ai/docs/api-reference/users Loads discounts for the current user. Requires authentication. ```APIDOC ## GET /users/me/discounts ### Description Loads discounts for the current user. ### Method GET ### Endpoint /users/me/discounts ### Parameters #### Header Parameters - **X-Chutes-Hotkey** (string | null) - Optional - - **X-Chutes-Signature** (string | null) - Optional - - **X-Chutes-Nonce** (string | null) - Optional - - **Authorization** (string | null) - Optional - ### Responses #### Success Response (200) - **Description**: Successful Response #### Error Response (422) - **Description**: Validation Error ### Authentication This endpoint requires authentication. ``` -------------------------------- ### GET /payments/summary/tao Source: https://chutes.ai/docs/api-reference/pricing Get the amount (as USD equivalent) of payments made by tao for today, the current month, and total. ```APIDOC ## GET /payments/summary/tao ### Description Get the amount (as USD equivalent) of payments made by tao for today, the current month, and total. ### Method GET ### Endpoint /payments/summary/tao ### Responses #### Success Response (200) - **Response Body** (object) - Successful Response ``` -------------------------------- ### GET /miner/servers/ Source: https://chutes.ai/docs/api-reference/miner Lists all servers for the authenticated miner, including nested GPU information. ```APIDOC ## GET /miner/servers/ ### Description List all servers for the authenticated miner, with nested GPU info. Provides full visibility into server inventory. ### Method GET ### Endpoint /miner/servers/ ### Parameters #### Header Parameters - **X-Chutes-Hotkey** (string | null) - Optional - **X-Chutes-Signature** (string | null) - Optional - **X-Chutes-Nonce** (string | null) - Optional - **Authorization** (string | null) - Optional ``` -------------------------------- ### GET /users/set_logo Source: https://chutes.ai/docs/api-reference/users Sets the logo for the current user. ```APIDOC ## GET /users/set_logo ### Description Get a detailed response for the current user. ### Method GET ### Endpoint /users/set_logo ### Parameters #### Query Parameters - **logo_id** (string) - Required #### Header Parameters - **X-Chutes-Hotkey** (string | null) - Optional - **X-Chutes-Signature** (string | null) - Optional - **X-Chutes-Nonce** (string | null) - Optional - **Authorization** (string | null) - Optional ### Response #### Success Response (200) - Successful Response #### Error Response (422) - Validation Error ``` -------------------------------- ### GET /misc/hf_repo_info Source: https://chutes.ai/docs/api-reference/miscellaneous Retrieves file information for a Hugging Face repository. ```APIDOC ## GET /misc/hf_repo_info ### Description Proxy endpoint for retrieving Hugging Face repository file information. ### Method GET ### Endpoint /misc/hf_repo_info ### Parameters #### Query Parameters - **repo_id** (string) - Required - The ID of the repository. - **repo_type** (string) - Optional - The type of the repository. - **revision** (string) - Optional - The specific revision to fetch. - **hf_token** (string | null) - Optional - Authentication token for Hugging Face. ### Response #### Success Response (200) - Successful Response #### Error Response (422) - Validation Error ``` -------------------------------- ### GET /miner/images/ Source: https://chutes.ai/docs/api-reference/miner Retrieves a list of images for the authenticated miner. ```APIDOC ## GET /miner/images/ ### Description Retrieves a list of images for the authenticated miner. ### Method GET ### Endpoint /miner/images/ ### Parameters #### Header Parameters - **X-Chutes-Hotkey** (string | null) - Optional - **X-Chutes-Signature** (string | null) - Optional - **X-Chutes-Nonce** (string | null) - Optional - **Authorization** (string | null) - Optional ### Response #### Success Response (200) - Successful Response #### Error Response (422) - Validation Error ``` -------------------------------- ### GET /idp/authorizations Source: https://chutes.ai/docs/api-reference/identity-provider List apps the current user has authorized. ```APIDOC ## GET /idp/authorizations ### Description List apps the current user has authorized. ### Method GET ### Endpoint /idp/authorizations ### Parameters #### Query Parameters - **page** (integer | null) - Optional - **limit** (integer | null) - Optional #### Header Parameters - **X-Chutes-Hotkey** (string | null) - Optional - **X-Chutes-Signature** (string | null) - Optional - **X-Chutes-Nonce** (string | null) - Optional - **Authorization** (string | null) - Optional ### Response #### Success Response (200) - Successful Response #### Error Response (422) - Validation Error ``` -------------------------------- ### GET /guess/vllm_config Source: https://chutes.ai/docs/api-reference/configguesser Analyzes a model from Hugging Face to estimate the required GPU count and VRAM configuration. ```APIDOC ## GET /guess/vllm_config ### Description Attempt to guess required GPU count and VRAM for a model on huggingface, assuming safetensors format. ### Method GET ### Endpoint /guess/vllm_config ### Parameters #### Query Parameters - **model** (string) - Required - The identifier of the model on Hugging Face. ### Response #### Success Response (200) - Successful Response #### Error Response (422) - Validation Error ``` -------------------------------- ### GET /idp/authorize/consent Source: https://chutes.ai/docs/api-reference/identity-provider Show authorization consent page. ```APIDOC ## GET /idp/authorize/consent ### Description Show authorization consent page. ### Method GET ### Endpoint /idp/authorize/consent ### Parameters #### Query Parameters - **session_id** (string) - Required ### Response #### Success Response (200) - Successful Response #### Error Response (422) - Validation Error ``` -------------------------------- ### GET /secrets/ Source: https://chutes.ai/docs/api-reference/secret List all secrets associated with the authenticated account. ```APIDOC ## GET /secrets/ ### Description List secrets. ### Method GET ### Endpoint /secrets/ ### Parameters #### Query Parameters - **page** (integer | null) - Optional - **limit** (integer | null) - Optional #### Header Parameters - **X-Chutes-Hotkey** (string | null) - Optional - **X-Chutes-Signature** (string | null) - Optional - **X-Chutes-Nonce** (string | null) - Optional - **Authorization** (string | null) - Optional ### Response #### Success Response (200) - Successful Response #### Error Response (422) - Validation Error ``` -------------------------------- ### GET /users/me/price_overrides Source: https://chutes.ai/docs/api-reference/users Loads price overrides for the current user. Requires authentication. ```APIDOC ## GET /users/me/price_overrides ### Description Loads price overrides for the current user. ### Method GET ### Endpoint /users/me/price_overrides ### Parameters #### Header Parameters - **X-Chutes-Hotkey** (string | null) - Optional - - **X-Chutes-Signature** (string | null) - Optional - - **X-Chutes-Nonce** (string | null) - Optional - - **Authorization** (string | null) - Optional - ### Responses #### Success Response (200) - **Description**: Successful Response #### Error Response (422) - **Description**: Validation Error ### Authentication This endpoint requires authentication. ``` -------------------------------- ### GET /users/agent_registration/{hotkey} Source: https://chutes.ai/docs/api-reference/users Check the status of an agent registration by hotkey, including pending, completed, or expired states. ```APIDOC ## GET /users/agent_registration/{hotkey} ### Description Check the status of an agent registration by hotkey. Handles all states: pending payment, completed (converted to user), or expired. ### Method GET ### Endpoint /users/agent_registration/{hotkey} ### Parameters #### Path Parameters - **hotkey** (string) - Required - The unique hotkey associated with the agent registration. ### Response #### Success Response (200) - **status** (string) - The current status of the registration. #### Error Response (422) - **detail** (string) - Validation error details. ``` -------------------------------- ### GET /images/{image_id_or_name} Source: https://chutes.ai/docs/api-reference/images Load a single image by ID or name. ```APIDOC ## GET /images/{image_id_or_name} ### Description Load a single image by ID or name. ### Method GET ### Endpoint /images/{image_id_or_name} ### Parameters #### Path Parameters - **image_id_or_name** (string) - Required - The ID or name of the image to retrieve. #### Header Parameters - **X-Chutes-Hotkey** (string | null) - Optional - Chutes hotkey for authentication. - **X-Chutes-Signature** (string | null) - Optional - Chutes signature for authentication. - **X-Chutes-Nonce** (string | null) - Optional - Chutes nonce for authentication. - **Authorization** (string | null) - Optional - Bearer token for authentication. ### Responses #### Success Response (200) - **Successful Response** - Description of the successful response. #### Error Response (422) - **Validation Error** - Description of the validation error response. ### Authentication This endpoint requires authentication. ``` -------------------------------- ### GET /instances/{instance_id}/evidence Source: https://chutes.ai/docs/api-reference/instances Retrieves TEE evidence for a specific instance. ```APIDOC ## GET /instances/{instance_id}/evidence ### Description Get TEE evidence for a specific instance, including TDX quote, GPU evidence, and certificate. ### Method GET ### Endpoint /instances/{instance_id}/evidence ### Parameters #### Path Parameters - **instance_id** (string) - Required #### Query Parameters - **nonce** (string) - Required #### Header Parameters - **X-Chutes-Hotkey** (string | null) - Optional - **X-Chutes-Signature** (string | null) - Optional - **X-Chutes-Nonce** (string | null) - Optional - **Authorization** (string | null) - Optional ### Response #### Success Response (200) - Successful Response #### Error Response (422) - Validation Error ``` -------------------------------- ### GET /users/registration_token Source: https://chutes.ai/docs/api-reference/users Initiates the registration process by providing a form with Cloudflare and hCaptcha for generating a registration token. ```APIDOC ## GET /users/registration_token ### Description Initial form with cloudflare + hcaptcha to generate a registration token. ### Method GET ### Endpoint /users/registration_token ### Response #### Success Response (200) - **token** (string) - A registration token #### Response Example ```json { "token": "generated_registration_token" } ``` ``` -------------------------------- ### GET /users/login/nonce Source: https://chutes.ai/docs/api-reference/users Retrieves a nonce for hotkey signature login. The nonce is a UUID4 string valid for 5 minutes. ```APIDOC ## GET /users/login/nonce ### Description 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. ### Method GET ### Endpoint /users/login/nonce ### Response #### Success Response (200) - **nonce** (string) - A UUID4 string representing the nonce. ``` -------------------------------- ### GET /images/ Source: https://chutes.ai/docs/api-reference/images Retrieves a list of images, supporting filtering by name or tag, and pagination. ```APIDOC ## GET /images/ ### Description List, filter, and paginate images. ### Method GET ### Endpoint /images/ ### Parameters #### Query Parameters - **include_public** (boolean | null) - Optional - **name** (string | null) - Optional - **tag** (string | null) - Optional - **page** (integer | null) - Optional - **limit** (integer | null) - Optional #### Header Parameters - **X-Chutes-Hotkey** (string | null) - Optional - **X-Chutes-Signature** (string | null) - Optional - **X-Chutes-Nonce** (string | null) - Optional - **Authorization** (string | null) - Optional ### Response #### Success Response (200) - Successful Response #### Error Response (422) - Validation Error ``` -------------------------------- ### GET /users/{user_id}/discounts Source: https://chutes.ai/docs/api-reference/users Retrieves a list of discounts for a specific user. Requires authentication. ```APIDOC ## GET /users/{user_id}/discounts ### Description Retrieves a list of discounts for a specific user. ### Method GET ### Endpoint /users/{user_id}/discounts ### Parameters #### Path Parameters - **user_id** (string) - Required #### Header Parameters - **X-Chutes-Hotkey** (string | null) - Optional - **X-Chutes-Signature** (string | null) - Optional - **X-Chutes-Nonce** (string | null) - Optional - **Authorization** (string | null) - Optional ### Response #### Success Response (200) - Successful Response #### Error Response (422) - Validation Error ``` -------------------------------- ### GET /servers/{server_id}/nonce Source: https://chutes.ai/docs/api-reference/servers Generates a nonce for runtime attestation for a specific server. ```APIDOC ## GET /servers/{server_id}/nonce ### Description Generate a nonce for runtime attestation. ### Method GET ### Endpoint /servers/{server_id}/nonce ### Parameters #### Path Parameters - **server_id** (string) - Required - The ID of the server for which to generate a nonce. #### Header Parameters - **X-Chutes-Hotkey** (string | null) - Optional - The miner's hotkey for authentication. - **X-Chutes-Signature** (string | null) - Optional - The signature for authentication. - **X-Chutes-Nonce** (string | null) - Optional - The nonce for authentication. - **Authorization** (string | null) - Optional - The authorization token. ### Responses #### Success Response (200) - **Nonce** (string) - The generated nonce for runtime attestation. #### Error Response (422) - **Error** (object) - Validation error details. ``` -------------------------------- ### POST /users/{user_id}/agent_setup Source: https://chutes.ai/docs/api-reference/users Perform a one-time setup for agent-registered users, requiring a hotkey signature to verify ownership. ```APIDOC ## POST /users/{user_id}/agent_setup ### Description One-time setup endpoint for agent-registered users. Requires hotkey signature to prove ownership. Returns API key and config.ini template. ### Method POST ### Endpoint /users/{user_id}/agent_setup ### Parameters #### Path Parameters - **user_id** (string) - Required - The ID of the user performing the setup. #### Request Body - **hotkey** (string) - Required - The hotkey associated with the agent. - **signature** (string) - Required - The cryptographic signature proving ownership. ### Response #### Success Response (200) - **api_key** (string) - The generated API key. - **config_template** (string) - The config.ini template. #### Error Response (422) - **detail** (string) - Validation error details. ``` -------------------------------- ### Get Rint Nonce Source: https://chutes.ai/docs/api-reference/instances Retrieves the runtime integrity nonce for a launch config. ```APIDOC ## GET /instances/launch_config/{config_id}/nonce ### Description Get runtime integrity nonce for a launch config. This endpoint consumes the nonce from Redis (one-time use). Only available for chutes_version >= 0.4.9. ### Method GET ### Endpoint /instances/launch_config/{config_id}/nonce ### Parameters #### Path Parameters - **config_id** (string) - Required - #### Header Parameters - **Authorization** (string) - Optional - ### Responses #### Success Response (200) - **Success** - Successful Response #### Error Response (422) - **Error** - Validation Error ``` -------------------------------- ### POST /instances/launch_config/{config_id} Source: https://chutes.ai/docs/api-reference/instances Claims a specific launch configuration for an instance by providing necessary hardware and environment settings. ```APIDOC ## POST /instances/launch_config/{config_id} ### Description Claims a launch configuration for an instance. ### Method POST ### Endpoint /instances/launch_config/{config_id} ### Parameters #### Path Parameters - **config_id** (string) - Required #### Request Body - **gpus** (object[]) - Required - **host** (string) - Required - **port_mappings** (PortMap[]) - Required - **fsv** (string | null) - Optional - **egress** (boolean | null) - Optional - **lock_modules** (boolean | null) - Optional - **netnanny_hash** (string | null) - Optional - **run_path** (string | null) - Optional - **py_dirs** (string[] | null) - Optional - **rint_commitment** (string | null) - Optional - **rint_nonce** (string | null) - Optional - **rint_pubkey** (string | null) - Optional - **tls_cert** (string | null) - Optional - **tls_cert_sig** (string | null) - Optional - **tls_ca_cert** (string | null) - Optional - **tls_client_cert** (string | null) - Optional - **tls_client_key** (string | null) - Optional - **tls_client_key_password** (string | null) - Optional - **e2e_pubkey** (string | null) - Optional - **cllmv_session_init** (string | null) - Optional - **env** (string) - Required - **code** (string | null) - Optional - **run_code** (string | null) - Optional - **inspecto** (string | null) - Optional ### Response #### Success Response (200) - Successful Response ``` -------------------------------- ### POST /servers/ Source: https://chutes.ai/docs/api-reference/servers Register a new server. This is called via CLI after the server has booted and decrypted its disk. Links the server to any existing boot attestation history via server ip. ```APIDOC ## POST /servers/ ### Description Register a new server. This is called via CLI after the server has booted and decrypted its disk. Links the server to any existing boot attestation history via server ip. ### Method POST ### Endpoint /servers/ ### Parameters #### Header Parameters - **X-Chutes-Hotkey** (string | null) - Optional - - **X-Chutes-Signature** (string | null) - Optional - - **X-Chutes-Nonce** (string | null) - Optional - - **Authorization** (string | null) - Optional - #### Request Body - **host** (string) - Required - Public IP address or DNS Name of the server - **id** (string) - Required - Server ID (e.g. k8s node uid) - **name** (string | null) - Optional - Server name (defaults to server id if omitted) - **gpus** (NodeArgs[]) - Required - GPU info for this server ### Request Example { "host": "string", "id": "string", "name": "string | null", "gpus": [ { "gpu_model": "string", "gpu_memory_mib": 0 } ] } ### Response #### Success Response (201) - **message** (string) - Description #### Response Example { "message": "string" } ``` -------------------------------- ### GET /audit/download Source: https://chutes.ai/docs/api-reference/audit Downloads report data based on the provided file path. ```APIDOC ## GET /audit/download ### Description Download report data. ### Method GET ### Endpoint /audit/download ### Parameters #### Query Parameters - **path** (string) - Required ### Response #### Success Response (200) - Successful Response #### Error Response (422) - Validation Error ``` -------------------------------- ### Get Diffusion Stats Configuration Source: https://chutes.ai/docs/api-reference/invocations Configuration for the GET /invocations/stats/diffusion endpoint. ```json {"endpoint":"/invocations/stats/diffusion","method":"GET","parameters":[],"requestBody":null} ``` -------------------------------- ### PUT /instances/launch_config/{config_id} Source: https://chutes.ai/docs/api-reference/instances Verifies an existing launch configuration instance. ```APIDOC ## PUT /instances/launch_config/{config_id} ### Description Verifies a launch configuration instance. ### Method PUT ### Endpoint /instances/launch_config/{config_id} ### Parameters #### Path Parameters - **config_id** (string) - Required ### Response #### Success Response (200) - Successful Response ``` -------------------------------- ### GET /invocations/exports/recent Source: https://chutes.ai/docs/api-reference/invocations Get an export for recent data, which may not yet be in S3. ```APIDOC ## GET /invocations/exports/recent ### Description Get an export for recent data, which may not yet be in S3. ### Method GET ### Endpoint /invocations/exports/recent ### Parameters #### Query Parameters - **hotkey** (string | null) - Optional - - **limit** (integer | null) - Optional - ### Responses #### Success Response (200) - Successful Response #### Error Response (422) - Validation Error #### Response Example { "example": "response body" } ``` -------------------------------- ### POST /instances/launch_config/{config_id}/tee Source: https://chutes.ai/docs/api-reference/instances Claims a TEE launch config, verifies attestation, and returns a symmetric key. ```APIDOC ## POST /instances/launch_config/{config_id}/tee ### Description Claims a TEE launch config, verifies attestation, and receives a symmetric key. ### Method POST ### Endpoint /instances/launch_config/{config_id}/tee ### Parameters #### Path Parameters - **config_id** (string) - Required #### Header Parameters - **Authorization** (string) - Optional - **X-Chutes-Nonce** (string | null) - Optional #### Request Body - **gpus** (object[]) - Required - **host** (string) - Required - **port_mappings** (PortMap[]) - Required - **fsv** (string | null) - Optional - **egress** (boolean | null) - Optional - **lock_modules** (boolean | null) - Optional - **netnanny_hash** (string | null) - Optional - **run_path** (string | null) - Optional - **py_dirs** (string[] | null) - Optional - **rint_commitment** (string | null) - Optional - **rint_nonce** (string | null) - Optional - **rint_pubkey** (string | null) - Optional - **tls_cert** (string | null) - Optional - **tls_cert_sig** (string | null) - Optional - **tls_ca_cert** (string | null) - Optional - **tls_client_cert** (string | null) - Optional - **tls_client_key** (string | null) - Optional - **tls_client_key_password** (string | null) - Optional - **e2e_pubkey** (string | null) - Optional - **cllmv_session_init** (string | null) - Optional - **env** (string) - Required - **code** (string | null) - Optional - **run_code** (string | null) - Optional - **inspecto** (string | null) - Optional - **deployment_id** (string) - Required ### Response #### Success Response (200) - Successful Response #### Error Response (422) - Validation Error ``` -------------------------------- ### GET /idp/apps/{app_id} - Get App Source: https://chutes.ai/docs/api-reference/identity-provider Retrieves details of a specific OAuth application. Requires authentication. ```APIDOC ## GET /idp/apps/{app_id} ### Description Get details of an OAuth application. ### Method GET ### Endpoint /idp/apps/{app_id} ### Parameters #### Path Parameters - **app_id** (string) - Required - The unique identifier of the application. #### Header Parameters - **X-Chutes-Hotkey** (string | null) - Optional - - **X-Chutes-Signature** (string | null) - Optional - - **X-Chutes-Nonce** (string | null) - Optional - - **Authorization** (string | null) - Optional - ### Response #### Success Response (200) - **id** (string) - The unique identifier for the application. - **name** (string) - The name of the application. - **description** (string | null) - The description of the application. - **redirect_uris** (string[]) - The list of redirect URIs. - **homepage_url** (string | null) - The homepage URL of the application. - **logo_url** (string | null) - The logo URL of the application. - **public** (boolean) - Indicates if the application is public. - **refresh_token_lifetime_days** (integer) - The lifetime of the refresh token in days. - **allowed_scopes** (string[]) - The list of allowed scopes. - **created_at** (string) - The timestamp when the app was created. - **updated_at** (string) - The timestamp when the app was last updated. #### Response Example ```json { "id": "app_12345", "name": "example_app", "description": "My awesome application", "redirect_uris": ["https://example.com/callback"], "homepage_url": "https://example.com", "logo_url": "https://example.com/logo.png", "public": true, "refresh_token_lifetime_days": 90, "allowed_scopes": ["read", "write"], "created_at": "2023-10-27T10:00:00Z", "updated_at": "2023-10-27T10:00:00Z" } ``` #### Error Response (422) - **message** (string) - Error message describing the validation failure. - **errors** (object) - Object containing field-specific validation errors. #### Response Example (422) ```json { "message": "App not found", "errors": {} } ``` ### Authentication This endpoint requires authentication. ``` -------------------------------- ### POST /servers/{vm_name}/luks Source: https://chutes.ai/docs/api-reference/servers Sync LUKS passphrases: VM sends volume list; API returns keys for existing volumes, creates keys for new volumes, rekeys volumes in rekey list, and prunes stored keys for volumes not in the list. Boot token is consumed after successful POST. ```APIDOC ## POST /servers/{vm_name}/luks ### Description Sync LUKS passphrases: VM sends volume list; API returns keys for existing volumes, creates keys for new volumes, rekeys volumes in rekey list, and prunes stored keys for volumes not in the list. Boot token is consumed after successful POST. ### Method POST ### Endpoint /servers/{vm_name}/luks #### Path Parameters - **vm_name** (string) - Required - Description not provided #### Header Parameters - **X-Chutes-Hotkey** (string | null) - Optional - Description not provided - **X-Boot-Token** (string | null) - Optional - Description not provided #### Request Body - **volumes** (array of strings) - Required - Volume names the VM is managing (defines full set) - **rekey** (array of strings | null) - Optional - Volume names that must receive new passphrases (no reuse); must be subset of volumes ### Request Example ```json { "volumes": [ "string" ], "rekey": [ "string" ] } ``` ### Responses #### Success Response (200) - **Successful Response** (object) - Successful Response ``` -------------------------------- ### GET /images/{image_id}/logs Source: https://chutes.ai/docs/api-reference/images Streams the build logs for a specific image identified by its ID. ```APIDOC ## GET /images/{image_id}/logs ### Description Streams the build logs for a specific image. ### Method GET ### Endpoint /images/{image_id}/logs ### Parameters #### Path Parameters - **image_id** (string) - Required #### Query Parameters - **offset** (string | null) - Optional #### Header Parameters - **X-Chutes-Hotkey** (string | null) - Optional - **X-Chutes-Signature** (string | null) - Optional - **X-Chutes-Nonce** (string | null) - Optional - **Authorization** (string | null) - Optional ### Response #### Success Response (200) - Successful Response #### Error Response (422) - Validation Error ``` -------------------------------- ### Create Nodes Source: https://chutes.ai/docs/api-reference/nodes Add nodes/GPUs to inventory. ```APIDOC ## POST /nodes/ ### Description Add nodes/GPUs to inventory. ### Method POST ### Endpoint /nodes/ #### Request Body - **server_id** (string) - Required - - **server_name** (string | null) - Optional - - **nodes** (NodeArgs[]) - Required - ### Request Example { "server_id": "string", "server_name": "string | null", "nodes": [ { "gpu_model": "string", "gpu_count": 0, "ram_gb": 0, "storage_gb": 0 } ] } #### Responses ##### Success Response (202) - **(No fields specified)** ##### Error Response (422) - **(No fields specified)** ### Authentication This endpoint requires authentication. ``` -------------------------------- ### Get LLM Stats Configuration Source: https://chutes.ai/docs/api-reference/invocations Configuration for the GET /invocations/stats/llm endpoint with optional date and chute ID filters. ```json {"endpoint":"/invocations/stats/llm","method":"GET","parameters":[{"name":"start_date","type":"string","required":false,"description":"","in":"query"},{"name":"end_date","type":"string","required":false,"description":"","in":"query"},{"name":"chute_id","type":"string","required":false,"description":"","in":"query"}],"requestBody":null} ``` -------------------------------- ### POST /instances/launch_config/{config_id}/attest Source: https://chutes.ai/docs/api-reference/instances Validates a TEE (Trusted Execution Environment) launch configuration instance. ```APIDOC ## POST /instances/launch_config/{config_id}/attest ### Description Validates a TEE launch configuration instance using the provided configuration ID. ### Method POST ### Endpoint /instances/launch_config/{config_id}/attest ### Parameters #### Path Parameters - **config_id** (string) - Required #### Header Parameters - **Authorization** (string) - Optional - **X-Chutes-Nonce** (string | null) - Optional #### Request Body - **gpus** (object[]) - Required - **host** (string) - Required - **port_mappings** (PortMap[]) - Required - **fsv** (string | null) - Optional - **egress** (boolean | null) - Optional - **lock_modules** (boolean | null) - Optional - **netnanny_hash** (string | null) - Optional - **run_path** (string | null) - Optional - **py_dirs** (string[] | null) - Optional - **rint_commitment** (string | null) - Optional - **rint_nonce** (string | null) - Optional - **rint_pubkey** (string | null) - Optional - **tls_cert** (string | null) - Optional - **tls_cert_sig** (string | null) - Optional - **tls_ca_cert** (string | null) - Optional - **tls_client_cert** (string | null) - Optional - **tls_client_key** (string | null) - Optional - **tls_client_key_password** (string | null) - Optional - **e2e_pubkey** (string | null) - Optional - **cllmv_session_init** (string | null) - Optional - **env** (string) - Required - **code** (string | null) - Optional - **run_code** (string | null) - Optional - **inspecto** (string | null) - Optional - **gpu_evidence** (object[]) - Required ### Response #### Success Response (200) - Successful Response #### Error Response (422) - Validation Error ``` -------------------------------- ### List Supported GPUs Source: https://chutes.ai/docs/api-reference/nodes Show all currently supported GPUs. ```APIDOC ## GET /nodes/supported ### Description Show all currently supported GPUs. ### Method GET ### Endpoint /nodes/supported #### Responses ##### Success Response (200) - **(No fields specified)** ``` -------------------------------- ### POST /servers/boot/attestation Source: https://chutes.ai/docs/api-reference/servers Verify boot attestation and return LUKS passphrase. This endpoint verifies the TDX quote against expected boot measurements and returns the LUKS passphrase for disk decryption if valid. ```APIDOC ## POST /servers/boot/attestation ### Description Verify boot attestation and return LUKS passphrase. This endpoint verifies the TDX quote against expected boot measurements and returns the LUKS passphrase for disk decryption if valid. ### Method POST ### Endpoint /servers/boot/attestation #### Header Parameters - **X-Chutes-Nonce** (string | null) - Optional - Description not provided #### Request Body - **quote** (string) - Required - Base64 encoded TDX quote - **miner_hotkey** (string) - Required - Miner hotkey that owns this VM - **vm_name** (string) - Required - VM name/identifier ### Request Example ```json { "quote": "string", "miner_hotkey": "string", "vm_name": "string" } ``` ### Responses #### Success Response (200) - **Successful Response** (object) - Successful Response #### Error Response (422) - **Validation Error** (object) - Validation Error ``` -------------------------------- ### PUT /instances/launch_config/{config_id}/graval Source: https://chutes.ai/docs/api-reference/instances Verify Graval launch config instance by validating PoVW proof and symmetric key usage. ```APIDOC ## PUT /instances/launch_config/{config_id}/graval ### Description Verify Graval launch config instance by validating PoVW proof and symmetric key usage. ### Method PUT ### Endpoint /instances/launch_config/{config_id}/graval ### Parameters #### Path Parameters - **config_id** (string) - Required #### Header Parameters - **Authorization** (string) - Optional ``` -------------------------------- ### PUT /instances/launch_config/{config_id}/tee Source: https://chutes.ai/docs/api-reference/instances Verifies a TEE launch config instance by validating symmetric key usage via dummy ports. ```APIDOC ## PUT /instances/launch_config/{config_id}/tee ### Description Verify TEE launch config instance by validating symmetric key usage via dummy ports. ### Method PUT ### Endpoint /instances/launch_config/{config_id}/tee ### Parameters #### Path Parameters - **config_id** (string) - Required #### Header Parameters - **Authorization** (string) - Optional ``` -------------------------------- ### GET /servers/nonce Source: https://chutes.ai/docs/api-reference/servers Generate a nonce for boot attestation. This endpoint is called by VMs during boot before any registration. No authentication required as the VM doesn't exist in the system yet. ```APIDOC ## GET /servers/nonce ### Description Generate a nonce for boot attestation. This endpoint is called by VMs during boot before any registration. No authentication required as the VM doesn't exist in the system yet. ### Method GET ### Endpoint /servers/nonce ### Responses #### Success Response (200) - **Successful Response** (object) - Successful Response ``` -------------------------------- ### POST /instances/launch_config/{config_id}/graval Source: https://chutes.ai/docs/api-reference/instances Claim a Graval launch config and receive a PoVW challenge. ```APIDOC ## POST /instances/launch_config/{config_id}/graval ### Description Claim a Graval launch config and receive PoVW challenge. ### Method POST ### Endpoint /instances/launch_config/{config_id}/graval ### Parameters #### Path Parameters - **config_id** (string) - Required #### Header Parameters - **Authorization** (string) - Optional #### Request Body - **gpus** (object[]) - Required - **host** (string) - Required - **port_mappings** (PortMap[]) - Required - **fsv** (string | null) - Optional - **egress** (boolean | null) - Optional - **lock_modules** (boolean | null) - Optional - **netnanny_hash** (string | null) - Optional - **run_path** (string | null) - Optional - **py_dirs** (string[] | null) - Optional - **rint_commitment** (string | null) - Optional - **rint_nonce** (string | null) - Optional - **rint_pubkey** (string | null) - Optional - **tls_cert** (string | null) - Optional - **tls_cert_sig** (string | null) - Optional - **tls_ca_cert** (string | null) - Optional - **tls_client_cert** (string | null) - Optional - **tls_client_key** (string | null) - Optional - **tls_client_key_password** (string | null) - Optional - **e2e_pubkey** (string | null) - Optional - **cllmv_session_init** (string | null) - Optional - **env** (string) - Required - **code** (string | null) - Optional - **run_code** (string | null) - Optional - **inspecto** (string | null) - Optional ### Response #### Success Response (200) - Successful Response #### Error Response (422) - Validation Error ``` -------------------------------- ### Get Stats API Source: https://chutes.ai/docs/api-reference/miner Get miner stats over different intervals based on instance data (matching actual scoring). Returns instance-based metrics (total_instances, compute_seconds, compute_units, bounty_count) which align with how miners are actually scored for validator weights. ```APIDOC ## GET /miner/stats ### Description Get miner stats over different intervals based on instance data (matching actual scoring). Returns instance-based metrics (total_instances, compute_seconds, compute_units, bounty_count) which align with how miners are actually scored for validator weights. ### Method GET ### Endpoint /miner/stats ### Parameters #### Query Parameters - **miner_hotkey** (string | null) - Optional - Description: - **per_chute** (boolean | null) - Optional - Description: ### Responses #### Success Response (200) Successful Response #### Error Response (422) Validation Error ```