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

# Create Agent

`POST /v1/agents`

Create a new agent.

## Headers

- `authorization` string, nullable

## Request body

- AgentCreate — Schema for creating a new agent.
  - `name` string, required — Agent name
  - `description` string, nullable — Agent description
  - `model` string — LLM model to use
  - `systemPrompt` string, nullable — System prompt for the agent
  - `temperature` number, nullable — Temperature for generation
  - `maxContextChunks` integer, nullable — Maximum number of context chunks
  - `status` string, nullable — Agent status
  - `useContext` boolean — Whether to use knowledge base context
  - `knowledge` string, nullable — Knowledge base slug to use
  - `metadata` object, nullable — Additional metadata
  - `deepresearch` boolean, nullable — Whether deep research is enabled

## Response `201`

Successful Response

- AgentResponse — Schema for single agent response (wrapped in { agent: {...} }).
  - `agent` AgentDetail, required — Schema for agent detail (unwrapped).
    - `name` string, required — Agent name
    - `description` string, nullable — Agent description
    - `model` string — LLM model to use
    - `systemPrompt` string, nullable — System prompt for the agent
    - `temperature` number, nullable — Temperature for generation
    - `maxContextChunks` integer, nullable — Maximum number of context chunks
    - `status` string, nullable — Agent status
    - `useContext` boolean — Whether to use knowledge base context
    - `knowledge` string, nullable — Knowledge base slug to use
    - `metadata` object, nullable — Additional metadata
    - `deepresearch` boolean, nullable — Whether deep research is enabled
    - `id` string, required — Agent ID
    - `slug` string, required — Agent slug
    - `organizationSlug` string, required — Organization slug
    - `createdAt` string, date-time, required — Creation timestamp
    - `updatedAt` string, date-time, nullable — Last update timestamp

## Other responses

- `422` — Validation Error

---

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