---
title: "Create Agent"
method: POST
path: "/v1/agent"
tags: ["agent"]
---

# Create Agent

`POST /v1/agent`

Create an agent.

## Request body

- DeveloperAgentRequestModel — Request model for creating an agent.
  - `avatar_id` string, required — The ID of the avatar to use.
  - `system_prompt` string, required — The system prompt to use.
  - `name` string, nullable — The agent name.
  - `language` string, nullable — The language to use.
  - `greeting` string, nullable — What to say at the start of the session.
  - `max_session_length_minutes` integer, nullable — The maximum session length in minutes.
  - `capabilities` DeveloperAgentCapability[] — The agent capabilities.

## Response `201`

Successful Response

- DeveloperAgentResponseModel — Response model for the agent.
  - `avatar_id` string, required — The ID of the avatar to use.
  - `system_prompt` string, required — The system prompt to use.
  - `name` string, nullable — The agent name.
  - `language` string, nullable — The language to use.
  - `greeting` string, nullable — What to say at the start of the session.
  - `max_session_length_minutes` integer, nullable — The maximum session length in minutes.
  - `capabilities` DeveloperAgentCapability[] — The agent capabilities.
  - `id` string, required — The unique identifier (ID) of the agent.

## Other responses

- `422` — Validation Error

---

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