---
title: "Upload a custom model or adapter"
method: POST
path: "/models"
tags: ["Models"]
---

# Upload a custom model or adapter

`POST /models`

Upload a custom model or adapter from Hugging Face or S3

## Request body

- ModelUploadRequest
  - `model_name` string, required — The name to give to your uploaded model
  - `model_source` string, required — The source location of the model (Hugging Face repo or S3 path)
  - `model_type` 'model' | 'adapter' — Whether the model is a full model or an adapter
  - `hf_token` string — Hugging Face token (if uploading from Hugging Face)
  - `description` string — A description of your model
  - `base_model` string — The base model to use for an adapter if setting it to run against a serverless pool. Only used for model_type `adapter`.
  - `lora_model` string — The lora pool to use for an adapter if setting it to run against, say, a dedicated pool. Only used for model_type `adapter`.

## Response `200`

Model / adapter upload job created successfully

- ModelUploadSuccessResponse
  - `data` object, required
    - `job_id` string, required
    - `model_name` string, required
    - `model_id` string, required
    - `model_source` string, required
  - `message` string, required

---

[API](https://skmtc.net/together/apis/together-apis.md) · [All operations](https://skmtc.net/together/apis/together-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/together/together-apis/revisions/468edbdc879c/schema)