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

# Agent Setup

`POST /users/{user_id}/agent_setup`

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

- AgentSetupResponse
  - `user_id` string, required
  - `api_key` string, required
  - `hotkey_ss58address` string, required
  - `payment_address` string, required
  - `username` string, required
  - `config_ini` string, required
  - `setup_instructions` string, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-26** `8d909638091e` — 1 info
  - endpoint added
- **2026-08-22** `05d9af05d87e` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/chutes/apis/fastapi/changes/users/:user_id/agent_setup/post.md)

---

[API](https://skmtc.dev/chutes/apis/fastapi.md) · [All operations](https://skmtc.dev/chutes/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chutes/fastapi/revisions/7be1aa2fe1a0/schema)