---
title: "Deploy Function"
method: POST
path: "/v2/nvcf/deployments/functions/{functionId}/versions/{functionVersionId}"
tags: ["Function Deployment"]
---

# Deploy Function

`POST /v2/nvcf/deployments/functions/{functionId}/versions/{functionVersionId}`

Initiates deployment for the specified function version. Upon invocation of  this endpoint, the function's status transitions to 'DEPLOYING'. If the  specified function version is public, then Account Admin cannot perform this  operation. Access to this endpoint mandates a bearer token with 'deploy_function' scope in the  HTTP Authorization header.

## Path parameters

- `functionId` string, uuid, required
- `functionVersionId` string, uuid, required

## Request body

- FunctionDeploymentRequest — Request to deploy a function
  - `deploymentSpecifications` GpuSpecificationDto[], required — Deployment specs with Backend, GPU, instance-type, etc. details
    - `gpu` string, required — GPU name from the cluster
    - `backend` string — Backend/CSP where the GPU powered instance will be launched
    - `maxInstances` integer, required — Maximum number of spot instances for the deployment
    - `minInstances` integer, required — Minimum number of spot instances for the deployment
    - `instanceType` string, required — Instance type, based on GPU, assigned to a Worker
    - `availabilityZones` string[] — List of availability-zones(or clusters) in the cluster group
    - `maxRequestConcurrency` integer — Max request concurrency between 1 (default) and 1024.
    - `configuration` object
    - `clusters` string[] — Specific clusters within spot instance or worker node powered by the selected instance-type to deploy function.
    - `regions` string[] — List of regions allowed to deploy. The instance or worker node will be in one of the specified geographical regions.
    - `attributes` string[] — Specific attributes capabilities to deploy functions.
    - `preferredOrder` integer — Preferred order of deployment if there are several gpu specs.

## Response `200`

OK

- DeploymentResponse — Function Deployment Response
  - `deployment` FunctionDeploymentDto, required — Function deployment response
    - `functionId` string, uuid, required — Function id
    - `functionVersionId` string, uuid, required — Function version id
    - `functionName` string, required — Function name
    - `ncaId` string, required — NVIDIA Cloud Account Id
    - `functionStatus` 'ACTIVE' | 'DEPLOYING' | 'ERROR' | 'INACTIVE' | 'DELETED', required — Function status
    - `requestQueueUrl` string — Deprecated Request Queue URL
    - `healthInfo` DeploymentHealthDto[] — Health info for a deployment specification is included only if there are any issues/errors.
      - `sisRequestId` string, uuid — SIS Request ID
      - `gpu` string, required — GPU Type as per SDD
      - `backend` string, required — Backend/CSP where the GPU powered instance will be launched
      - `instanceType` string — Instance type
      - `error` string, required — Deployment error
    - `deploymentSpecifications` GpuSpecificationDto[], required — Function deployment details
      - `gpu` string, required — GPU name from the cluster
      - `backend` string — Backend/CSP where the GPU powered instance will be launched
      - `maxInstances` integer, required — Maximum number of spot instances for the deployment
      - `minInstances` integer, required — Minimum number of spot instances for the deployment
      - `instanceType` string, required — Instance type, based on GPU, assigned to a Worker
      - `availabilityZones` string[] — List of availability-zones(or clusters) in the cluster group
      - `maxRequestConcurrency` integer — Max request concurrency between 1 (default) and 1024.
      - `configuration` object
      - `clusters` string[] — Specific clusters within spot instance or worker node powered by the selected instance-type to deploy function.
      - `regions` string[] — List of regions allowed to deploy. The instance or worker node will be in one of the specified geographical regions.
      - `attributes` string[] — Specific attributes capabilities to deploy functions.
      - `preferredOrder` integer — Preferred order of deployment if there are several gpu specs.
    - `createdAt` string, date-time, required — Function deployment creation timestamp

---

[API](https://skmtc.dev/brevdev/apis/cloud-functions.md) · [All operations](https://skmtc.dev/brevdev/apis/cloud-functions/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/brevdev/cloud-functions/revisions/add37b001ffc/schema)