---
title: "Create Endpoint"
method: POST
path: "/api/v2/inference/endpoints"
tags: ["Serverless (compat)"]
---

# Create Endpoint

`POST /api/v2/inference/endpoints`

## Request body

- ServerlessEndpointCreate
  - `name` string
  - `mode` string
  - `managed_engine` string
  - `model_name` string
  - `model_ref` string
  - `image_ref` string
  - `docker_image` string
  - `source_type` string
  - `source_ref` string
  - `source_ref_branch` string
  - `gpu_type` string
  - `gpu_tier` string
  - `gpu_count` integer
  - `region` string
  - `min_workers` integer
  - `max_workers` integer
  - `max_concurrency` integer
  - `idle_timeout_sec` integer
  - `scaledown_window_sec` integer, nullable
  - `scaling_policy_type` string
  - `scaling_policy_value` integer
  - `execution_mode` string
  - `queue_timeout_sec` integer
  - `startup_command` string
  - `http_port` integer
  - `health_check_path` string
  - `health_endpoint` string
  - `cuda_version` string
  - `request_timeout_sec` integer
  - `max_request_bytes` integer
  - `env` object
  - `lora_adapters` object[]

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

> 22 revisions in range; 1 could not be searched.

- **2026-08-02** `016014e16810` — 11 info
  - added the new optional request property `execution_mode`
  - added the new optional request property `lora_adapters`
  - added the new optional request property `managed_engine`
  - added the new optional request property `queue_timeout_sec`
  - …7 more
- **2026-06-08** `cbe3ad94235c` — 7 warning, 27 info
  - the `max_workers` request property's max was set to `32.00`
  - the `min_workers` request property's max was set to `32.00`
  - the `max_workers` request property's min was set to `1.00`
  - the `min_workers` request property's min was set to `0.00`
  - …30 more
- **2026-04-03** `74dc97653bc3` — 8 info
  - added the new optional request property `api_format`
  - added the new optional request property `docker_image`
  - added the new optional request property `gpu_type`
  - added the new optional request property `health_endpoint`
  - …4 more
- **2026-04-01** `526c3dd3d9d7` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/aabiro/apis/xcelsior/changes/api/v2/inference/endpoints/post.md)

---

[API](https://skmtc.dev/aabiro/apis/xcelsior.md) · [All operations](https://skmtc.dev/aabiro/apis/xcelsior/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/aabiro/xcelsior/revisions/32211b6f9d65/schema)