---
id: asset-update
title: "Update an asset"
description: "Updates an asset."
sidebar_label: "Update an asset"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "patch api-method"
info_path: docs/api/asset
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Update an asset"}
>
</Heading>

<MethodEndpoint
  method={"patch"}
  path={"/asset/{id}"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Updates an asset.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"The ID of the asset to update.","example":123}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"metadata":{"type":"object","description":"The metadata loaded via the metadata catalog API.","example":{"key":"value"},"properties":{"key":{"type":"string","description":"The key of the metadata.","example":"key"},"value":{"type":"string","description":"The value of the metadata.","example":null},"additional_properties":{"type":"object","description":"Additional metadata properties, including schemas and tags.","properties":{"schemas":{"type":"array","description":"The JSON schemas of the metadata.","items":{"type":"object"}},"tags":{"type":"array","description":"Tags associated with the metadata.","items":{"type":"object","properties":{"key":{"type":"string","example":"key"},"value":{"type":"string","example":"value"}}}}}}},"title":"MetadataComponent"}},"title":"assetUpdate"}}}}}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The asset was updated","content":{"application/json":{"schema":{"type":"object","required":["id","build_id","type","url"],"properties":{"id":{"type":"integer","description":"The ID of the asset.","example":123},"name":{"type":"string","description":"The name of the asset.","example":"My Asset"},"build_id":{"type":"integer","description":"The ID of the build that the asset belongs to.","example":345},"type":{"type":"string","description":"The type of the asset.","enum":["docker-image","lambda","bundle"],"example":"docker-image"},"platform":{"type":"string","description":"The platform of the asset.","enum":["x86_64","arm_64"],"example":"arm_64"},"url":{"type":"string","format":"uri","description":"The url of the asset.\n\n> •For docker-image assets, this should be the local tagged image or image name.\n> \n> •For lambda assets, this should be the file path of the lambda package.\n","example":"https://example.com/my-asset.jpg"},"nrn":{"type":"string","description":"The resource name (NRN) uniquely identifying the asset.","example":"organization=1:account=2:namespace=4:application=4:build=345:asset=123"},"branch":{"type":"string","description":"The branch that the asset was built from.","example":"main"},"commit":{"type":"object","properties":{"id":{"type":"integer","description":"The ID of the commit that the asset was built from.","example":234},"permalink":{"type":"string","description":"The permalink to the commit that the asset was built from.","example":"https://example.com/1234"}}}},"title":"assetResponse"}}}},"4XX":{"description":"Client error responses due to invalid input or missing parameters.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific client error (e.g., 400, 401, 403, 404).","example":400},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"bad_request"},"error":{"type":"string","description":"A brief, human-readable description of the error type (e.g., \"Bad Request\", \"Unauthorized\").","example":"Bad Request"},"message":{"type":"string","description":"Additional details about the error.","example":"The request was malformed or contained invalid parameters."}}}}}},"5XX":{"description":"Server error responses indicating an issue on the API side.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific server error (e.g., 500, 502, 503).","example":500},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"internal_server_error"},"error":{"type":"string","description":"A brief, human-readable description of the error type (e.g., \"Internal Server Error\", \"Service Unavailable\").","example":"Internal Server Error"},"message":{"type":"string","description":"Additional details about the error.","example":"An unexpected error occurred. Please try again later."}}}}}}}}
>
  
</StatusCodes>