Sign in
latestOpenAPI 3.1.02026-08-19270462702.4 KB

b92f75fd3b61

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: HTTPException: 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; 409 if the training job exists but is not deployable.

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