---
title: "Updates metadata such as tags of the specified function version."
method: PUT
path: "/v2/nvcf/metadata/functions/{functionId}/versions/{functionVersionId}"
tags: ["Function Management"]
---

# Updates metadata such as tags of the specified function version.

`PUT /v2/nvcf/metadata/functions/{functionId}/versions/{functionVersionId}`

Updates metadata, such as tags, of the specified function version within the authenticated NVIDIA Cloud Account. Values specified in the payload completely override the existing values. Requires a bearer token with 'update_function' scope in the HTTP Authorization header.

## Path parameters

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

## Request body

- UpdateFunctionMetadataRequest — Request payload to create tags.
  - `tags` string[] — Set of tags provided by user

## Response `200`

OK

- FunctionResponse — Response body with function details
  - `function` FunctionDto, required — Data Transfer Object (DTO) representing a function
    - `id` string, uuid, required — Unique function id
    - `ncaId` string, required — NVIDIA Cloud Account Id
    - `versionId` string, uuid, required — Unique function version id
    - `name` string, required — Function name
    - `status` 'ACTIVE' | 'DEPLOYING' | 'ERROR' | 'INACTIVE' | 'DELETED', required — Function status
    - `inferenceUrl` string, uri — Entrypoint for invoking the container to process requests
    - `ownedByDifferentAccount` boolean — Indicates whether the function is owned by another account. If the account that is being used to lookup functions happens to be authorized to invoke/list this function which is owned by a different account, then this field is set to true and ncaId will contain the id of the account that owns the function. Otherwise, this field is not set as it defaults to false.
    - `inferencePort` integer — Optional port number where the inference listener is running - defaults to 8000 for Triton
    - `containerArgs` string — Args used to launch the container
    - `containerEnvironment` ContainerEnvironmentEntryDto[] — Environment settings used to launch the container
      - `key` string, required — Container environment key
      - `value` string, required — Container environment value
    - `models` ArtifactDto[] — Optional set of models
      - `name` string, required — Artifact name
      - `version` string, required — Artifact version
      - `uri` string, uri, required — Artifact URI
    - `containerImage` string, uri — Optional custom container
    - `apiBodyFormat` 'PREDICT_V2' | 'CUSTOM' — Invocation request body format
    - `helmChart` string, uri — Optional Helm Chart
    - `helmChartServiceName` string — Helm Chart Service Name specified only when helmChart property is specified
    - `healthUri` string, uri, required — Health endpoint for the container or helmChart
    - `createdAt` string, date-time, required — Function creation timestamp
    - `activeInstances` InstanceDto[] — List of active instances for this function.
      - `instanceId` string — Unique id of the instance
      - `functionId` string, uuid — Function executing on the instance
      - `functionVersionId` string, uuid — Function version executing on the instance
      - `instanceType` string — GPU instance-type powering the instance
      - `instanceStatus` 'ACTIVE' | 'ERRORED' | 'PREEMPTED' | 'DELETED' — Instance status
      - `sisRequestId` string, uuid — SIS request-id used to launch this instance
      - `ncaId` string — NVIDIA Cloud Account Id that owns the function running on the instance
      - `gpu` string — GPU name powering the instance
      - `backend` string — Backend where the instance is running
      - `location` string — Location such as zone name or region where the instance is running
      - `instanceCreatedAt` string, date-time — Instance creation timestamp
      - `instanceUpdatedAt` string, date-time — Instance's last updated timestamp
    - `resources` ArtifactDto[] — Optional set of resources.
      - `name` string, required — Artifact name
      - `version` string, required — Artifact version
      - `uri` string, uri, required — Artifact URI
    - `tags` string[] — Optional set of tags. Maximum allowed number of tags per function is 64. Maximum length of each tag is 128 chars.
    - `description` string — Function/version description
    - `health` HealthDto — Data Transfer Object(DTO) representing a function ne
      - `protocol` 'HTTP' | 'gRPC', required — HTTP/gPRC protocol type for health endpoint
      - `uri` string, uri, required — Health endpoint for the container or the helmChart
      - `port` integer, required — Port number where the health listener is running
      - `timeout` string, PnDTnHnMn.nS, required — ISO 8601 duration string in PnDTnHnMn.nS format
      - `expectedStatusCode` integer, required — Expected return status code considered as successful.
    - `functionType` 'DEFAULT' | 'STREAMING', required — Used to indicate a STREAMING function. Defaults to DEFAULT.
    - `secrets` string[] — Optional secret names

---

[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)