---
title: "create"
method: POST
path: "/api/agents"
tags: ["Agent"]
---

# create

`POST /api/agents`

## Request body

- object
  - `data` object, required
    - `type` string, required
    - `attributes` object, required
      - `name` string, required
      - `projectId` string, required
      - `modelType` string, required
      - `maxToolIterations` integer
      - `temperature` number, float
      - `variables` object[]
        - `name` string, required
        - `targetKnowledgeBaseId` string
        - `targetFunction` string, required
        - `toolTargetId` string, required
        - `toolTargetType` string, required
        - `functionArgumentsText` string
      - `reasoningEffort` 'NONE' | 'MINIMAL' | 'LOW' | 'MEDIUM' | 'HIGH' — Overall reasoning effort for the agent. For models whose name matches "gpt-oss-*", only "LOW", "MEDIUM", and "HIGH" are supported; "NONE" and "MINIMAL" are not valid for gpt-oss-* models.
      - `systemPrompt` string, nullable
      - `starterMessage` string, nullable
      - `outputs` object[]
        - `name` string, required
        - `functionName` string, required
        - `functionDescription` string
        - `jsonSchema` string, required
        - `artifactType` 'IMAGE_ID_OUTPUT' | 'MARKDOWN_TEXT_OUTPUT' | 'REACT_OUTPUT' | 'PRESENTATION'
        - `artifactContentType` 'IMAGE_ID_OUTPUT' | 'MARKDOWN_TEXT_OUTPUT' | 'REACT_OUTPUT' | 'PRESENTATION'
      - `tools` object[]
        - `toolTargetId` string, required
        - `toolTargetType` string, required
        - `targetFunction` string, required
        - `functionName` string, required
        - `functionDescription` string
        - `agentOutputMode` 'RETURN' | 'SHOW', nullable
        - `agentPromptSchema` string
        - `agentPromptTemplate` string
        - `inheritChatFiles` boolean

## Response `201`

Agent successfully created

## Other responses

- `400` — Bad request - invalid agent parameters provided
- `401` — Rejected by 401
- `403` — Forbidden - cannot reference agents from other users
- `422` — Validation error - temperature must be between 0 and 2

---

[API](https://skmtc.net/treasure/apis/llm-api.md) · [All operations](https://skmtc.net/treasure/apis/llm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/treasure/llm-api/revisions/56f275763358/schema)