---
title: "Create Model"
method: POST
path: "/admin/models"
tags: ["admin"]
---

# Create Model

`POST /admin/models`

## Request

- Base URL: `https://api.agent4.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.agent4.io/admin/models`
- Auth: none declared

## Request body

- ModelBackendIn
  - `name` string, required
  - `kind` string
  - `base_url` string, required
  - `model` string, required
  - `api_key` string, nullable
  - `weight` integer
  - `enabled` boolean
  - `exclusive` boolean
  - `max_parallel` integer, nullable

## Response `201`

Successful Response

- ModelBackendOut
  - `id` string, required
  - `name` string, required
  - `kind` string, required
  - `base_url` string, required
  - `model` string, required
  - `weight` integer, required
  - `enabled` boolean, required
  - `exclusive` boolean
  - `supports_vision` boolean, nullable
  - `n_ctx` integer, nullable
  - `max_parallel` integer, nullable
  - `has_api_key` boolean, required
  - `status` string, required
  - `last_error` string, nullable
  - `last_checked_at` string, date-time, nullable
  - `assigned_sessions` integer
  - `total_tokens` integer
  - `prompt_tokens` integer
  - `completion_tokens` integer
  - `audio_ms` integer
  - `text_words` integer
  - `created_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/agent4/apis/chatagent-platform.md) · [All operations](https://skmtc.dev/agent4/apis/chatagent-platform/llms.txt) · [OpenAPI document](https://skmtc.dev/agent4/apis/chatagent-platform/revisions/18e58f082ce3?raw)