---
title: "Launch SuperAgent"
method: POST
path: "/v1/superagents"
tags: ["SuperAgents"]
---

# Launch SuperAgent

`POST /v1/superagents`

Launch a new always-on SuperAgent. Each agent runs in its own cloud container with persistent memory and optional Telegram bot.

## Request body

- LaunchSuperagentRequest
  - `name` string, required — Display name for the agent
  - `soul_md` string — Custom soul.md content — the agent's identity and instructions
  - `description` string — Short description of what the agent does
  - `model` string, required — Model ID from the selected provider
  - `model_provider` 'openai' | 'anthropic' | 'xai' | 'openrouter' | 'venice', required — Provider for the model
  - `telegram_bot_token` string — Telegram bot token (from @BotFather) for Telegram interface

## Response `200`

Agent launched

- LaunchSuperagentResponse
  - `agent_id` string
  - `name` string
  - `bot_username` string, nullable — Telegram bot username (if token was provided)
  - `wallet_address` string, nullable
  - `status` string

## Other responses

- `400` — Validation error (e.g. name is required)
- `401` — Invalid or revoked API key
- `429` — Rate limit exceeded (60 requests per minute)

---

[API](https://skmtc.net/gigabraingg/apis/gigabrain-api.md) · [All operations](https://skmtc.net/gigabraingg/apis/gigabrain-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gigabraingg/gigabrain-api/versions/bb4070b30d92/schema)