Skip to main content
PUT
Create a Model Distillation project

Authorizations

Authorization
string
header
required

A wandb API key or wandb JWT. Browser sessions are exchanged by the Model Distillation web app backend; job capabilities are internal only.

Headers

Forge-Entity
string

Accessible personal or team entity. Omit to list all accessible entities on GET /projects and GET /projects/summaries. Other endpoints use the authenticated user's default entity.

Path Parameters

alias
string
required
Pattern: ^[a-z0-9-]{1,64}$

Body

application/json
project
string
required

The one Forge project owned by this Model Distillation project.

Required string length: 1 - 128
project_mode
enum<string>
required

Create a new Forge project or import an existing accessible Forge project.

Available options:
create,
import
targets
object[]
required

The initial routing configuration. A new project must route traffic to at least one model.

Minimum array length: 1
proxy_backend
enum<string>
default:cloudflare
Available options:
cloudflare,
local
trace_sampling_rate
number
default:1
Required range: 0 <= x <= 1

Response

Created Model Distillation project.

id
string<uuid>
required
entity
string
required
project
string
required
alias
string
required
proxy_backend
enum<string>
required
Available options:
cloudflare,
local
created_at
string<date-time>
required
updated_at
string<date-time>
required
versions
object[]
required
Last modified on October 6, 2026