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

# Create Model

`POST /admin/models`

## Request

- Base URL: `https://api.oxlo.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.oxlo.ai/admin/models`
- Auth: HTTP bearer

## Request body

- ModelCreate
  - `name` string, nullable
  - `original_filename` string, required
  - `storage_path` string, required
  - `size_bytes` integer, required
  - `model_type` 'chat' | 'embedding', required
  - `format` 'gguf' | 'safetensors', required
  - `context_length` integer, nullable
  - `id` string, nullable
  - `status` 'uploaded' | 'validating' | 'ready' | 'error'

## Response `201`

Successful Response

- ModelResponse
  - `name` string, nullable
  - `original_filename` string, required
  - `storage_path` string, required
  - `size_bytes` integer, required
  - `model_type` 'chat' | 'embedding', required
  - `format` 'gguf' | 'safetensors', required
  - `context_length` integer, nullable
  - `id` string, required
  - `user_id` string, required
  - `status` 'uploaded' | 'validating' | 'ready' | 'error', required
  - `error_message` string, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/oxlo/apis/oxlo-backend.md) - [All operations](https://skmtc.dev/oxlo/apis/oxlo-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/oxlo/apis/oxlo-backend/revisions/bc2ecdc94f31?raw)