---
title: "Deploy model to Ray object store"
method: POST
path: "/v1/namespaces/{namespace_id}/models/{model_id}/deploy"
tags: ["Custom Models"]
---

# Deploy model to Ray object store

`POST /v1/namespaces/{namespace_id}/models/{model_id}/deploy`

Pre-load model weights into the Ray object store for fast access by plugins.

This operation:
1. Downloads the model archive from S3
2. Deserializes weights based on format (safetensors, pytorch, etc.)
3. Stores weights in Ray object store for zero-copy sharing

After deployment, plugins can load the model instantly using:
```python
from engine.models.loader import load_namespace_model
weights = load_namespace_model("model_id")
```

**Note:** This is optional - models are also loaded on-demand when plugins
first request them. Use this endpoint to pre-warm the cache.

## Path parameters

- `namespace_id` string, required
- `model_id` string, required

## Response `200`

Successful Response

- ModelDeployResponse — Response model for model deployment. Deploying a model pre-loads the weights into the Ray object store, making them available for zero-copy access by plugins.
  - `success` boolean, required — Whether deployment succeeded
  - `model_id` string, required — Model identifier
  - `namespace_id` string, required — Namespace ID
  - `deployment_status` string, required — Deployment status (deployed, failed)
  - `cached` boolean — Whether model is cached in object store
  - `message` string, required — Status message

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Model not found
- `422` — Validation Error
- `500` — Deployment failed

## Changes

- **2026-08-09** `5d4c905106b4` — 1 info
  - the endpoint scheme security `BearerAuth` was added to the API

[Change history](https://skmtc.dev/mixpeek/apis/mixpeek-api/changes/v1/namespaces/:namespace_id/models/:model_id/deploy/post.md)

---

[API](https://skmtc.dev/mixpeek/apis/mixpeek-api.md) · [All operations](https://skmtc.dev/mixpeek/apis/mixpeek-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mixpeek/mixpeek-api/revisions/daf60765b81d/schema)