Sign in

v2

latestOpenAPI 3.1.02026-08-05267431678.1 KB
deployments

Deploy a model to a project

Activate a model as the project's active model and record the swap.

Exactly one of training_job_id (a fine-tuned checkpoint) or base_model (a stock HuggingFace base model) must be supplied in the request body; this is enforced by the DeploymentCreate schema.

Args: project_id: ID of the project to update. request: Deployment target (training job or base model) and optional reason. auth: Authenticated user.

Returns: DeploymentResponse with the new history record.

Raises: 400: If the supplied base model is not in the catalog. 403: If the user does not have access to the project. 404: If the project or training job is not found.

post/projects/{project_id}/deployments

Path parameters

project_idstring uuid required

Request body

training_job_idstring nullable

UUID of the training job to deploy

base_modelstring nullable

HuggingFace base model ID to deploy (e.g. 'fastino/gliner2-base-v1'). Mutually exclusive with training_job_id.

reasonstring nullable

Optional reason for this deployment

project_idstring nullable

[Deprecated] Project ID. Provide in the URL path (/projects/{project_id}/deployments) instead.

Response

Successful Response

idstring required
project_idstring required
training_job_idstring nullable
base_modelstring nullable
deployed_bystring required
reasonstring nullable required
deployed_atstring date-time required