---
title: "Upload And Register LoRA Weights"
method: POST
path: "/v1/adapters/upload"
tags: ["public_api", "external", "model-adapters"]
---

# Upload And Register LoRA Weights

`POST /v1/adapters/upload`

## Request

- Base URL: `https://api.hydracept.com`
- URL: `https://api.hydracept.com/v1/adapters/upload`
- Auth: HTTP bearer

Upload immutable safetensors weights and register them as one adapter.

The upload is streamed to disk, structurally validated, then committed using
the project's ordinary storage disposition. No generation or paid provider
call occurs here.

## Query parameters

- `projectId` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `401`: Structured public error envelope (`code`, `message`, `requestId`, …)
- `403`: Structured public error envelope (`code`, `message`, `requestId`, …)
- `422`: Validation failure: public envelope plus Pydantic `detail` / `validationErrors`
- `429`: Structured public error envelope (`code`, `message`, `requestId`, …)
- `500`: Structured public error envelope (`code`, `message`, `requestId`, …)
- `502`: Structured public error envelope (`code`, `message`, `requestId`, …)
- `503`: Structured public error envelope (`code`, `message`, `requestId`, …)

---

[API](https://skmtc.dev/hydracept/apis/hydracept-public-api.md) · [All operations](https://skmtc.dev/hydracept/apis/hydracept-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hydracept/apis/hydracept-public-api/revisions/2d41a8069ede?raw)