---
title: "Create Agent"
method: POST
path: "/agents"
---

# Create Agent

`POST /agents`

## Request

- Base URL: `https://app.wunel.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.wunel.com/agents`
- Auth: none declared

## Request body

- CreateAgentRequest
  - `name` string, required
  - `principal_user_id` string, nullable
  - `color` string, nullable

## Response `200`

Successful Response

- AgentOut
  - `id` string, required
  - `name` string, required
  - `principal_user_id` string, required
  - `principal_name` string, required
  - `color` string, required
  - `default_permission` string

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/wunel/apis/wunel-api.md) · [All operations](https://skmtc.dev/wunel/apis/wunel-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wunel/apis/wunel-api/revisions/872fe0687a60?raw)