---
title: "Agent Setup"
method: POST
path: "/users/{user_id}/agent_setup"
tags: ["Users"]
---

# Agent Setup

`POST /users/{user_id}/agent_setup`

## Request

- Base URL: `https://api.chutes.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.chutes.ai/users/{user_id}/agent_setup`
- Auth: none declared

One-time setup endpoint for agent-registered users.
Requires hotkey signature to prove ownership.
Returns API key and config.ini template.

## Path parameters

- `user_id` string, required

## Request body

- AgentSetupRequest
  - `hotkey` string, required
  - `signature` string, required

## Response `200`

Successful Response

- string

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-16** `23e8895b217d`: 8 breaking, 2 info
  - the response's body type changed from `object` to `string` for status `200`
  - removed the required property `api_key` from the response with the `200` status
  - removed the required property `config_ini` from the response with the `200` status
  - removed the required property `hotkey_ss58address` from the response with the `200` status
  - …6 more
- **2026-08-26** `8d909638091e`: 1 info
  - endpoint added
- **2026-08-22** `05d9af05d87e`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/chutes/apis/chutes-api/changes/users/:user_id/agent_setup/post.md)

---

[API](https://skmtc.dev/chutes/apis/chutes-api.md) - [All operations](https://skmtc.dev/chutes/apis/chutes-api/llms.txt) - [OpenAPI document](https://skmtc.dev/chutes/apis/chutes-api/revisions/8add5b0e22da?raw)