---
id: asset-read
title: "Read an asset"
description: "Reads an asset by ID."
sidebar_label: "Read an asset"
hide_title: true
hide_table_of_contents: true
api: eJzdV21vGzcM/iuCPrXA1XFipxgOyICsL1sGrAjSFCuQBAEt0XdqdNJVL1lc44D9lv20/ZKB0tmxY6d19wrsy/mso8hHJB9SnPMAleflBT/2HgO/KrhEL5xqg7KGl/wMQXoGhgF9Z5MZO3k54AW3LTogmRPJS54+lg5B8oJ7FNGpMOPlxZxPEBy64xhqXl5cdVcFb8FBgwGdTwIGGuQlV7RTkcUWQs0L7vBjVA4lL4OLWHAvamyAl3MeZm3aYQJW6Hj3EPJ5jezkJbNTFmrscQfLCB0hxztoWo283D8YER6HvrXGoyfdB8Mh/WwqXJ6X/QKe+SgEej+NmjQKawKaQBuhbbUSSXDvg6fd803kdvIBRVg740V2wCQqLa/Ta5IteHSagtI6AhBURqnkFj/s4IaN4xe9+5fKfHDKVFt1keTj2vhPM5ZTqFs5xteiTBtZqCGsxG6C2prKs2DXLI7Gh13vpp3wk8QmfhMb8r604gbdM9VARV7X0EwkpIAYqZEicH/SNdmu4K2GMLWu2Q3GQvpRKHffPL9+PuYFB9fQy5rtfq3LibHFIKmGwEsendpqPzq9bvrSXJpv2e+//vbaOrZ6tvzdFyzUyjNf26glm2Daqq0AzQJUFUqWpa3rXyhRBqRzRW926Oc0TpVGRtxfoOu3tCBuoCKFa+lWh9D6cm+vXxkI2+w1s2f5SB/ailxknNktJg69jU70Of7kzdmbpywa9TGinjEl0QQ1nSlTPZb71lVg1KdE+6P9EoSw0YSjg5L0+RYEHo3LldJwNC5Tph+Nxodl0ne0fzBKzHFgRL0b6iz7kC1Unkh5YFNnm3WcDShDVoRtGhW2VaS/XGey6q8AdTAaE4fQNaCVudmRRAtxKux/yuzWBNo/GI1513VUV1TIhCNFZ32L6L+N37/fbBIvtEITGDpnHVv2FCYjEkZlbkEryZRpYyCqNMp7yqj7bvi3dRIfIET/wkqqZAkPL3iD3lO92uglK9JfjvUP5+enLO9gwkpiTuvQE0F6dvgWhZoqwcSqP57goBoUbDwc0mOfHiN6jJ+uBWU8HKbslDuU9GPWgKiVwWfU2GGisbeVcKVEEBCwsk59Qp+xobtFx6agdHS4ng4TkNfkRPSpg2W37QBi4hROC1bHBsw9khWpBTEyuNSEem9c8u9AsrNs9JLTwjsDMdQJsrzk685ZlSaIi4h+GaSUil5BM4kBlPYMJjaGe1jrdnJFTHYSgxrQ1FVQsuRdE0AZqvp9Sq9mcNdlhhxuY8jb7P6HDFFGpjw3FV0zlfcRmTUJ3PHpCfNK4v+MGn7VEX0yHBI1DocH9BitB/7wv2MFHdYZ0NdZ6Dq77F/jx0lvnvWp84pkMlNoRQlk7wzcgtKkdYMwW7f/o9Q5NiwavGtRBJT9kawQ0TmUA3aqETyy4GYMKlCGaQjoFqxJuEJtaZ6qMDVjmoRKvpd60N5cyS5NV3SWPDulO+Cyk0GrBiZqvbhhUkvjNOEsBrK3xJGc2qtj2dIJpIj3k1aqiUmIbsHp5fXiavnjz+ec4CoztbSd8GR/7Q+GgyG/757LiaC1PjSQmNoPfDRYLufKh46f39P90Qm0Bx3wLuy1ur/Z9Lfi7LkLvlBeKkn0rq0PtDyfT8DjO6e7jpY/RnQ0rV4V/BacolxK7pXK07vk5RS0x89gfHLWF5mn7AvT51bU/SKYGScIOtI/XvAbnOXRuLvqCl4jSHQJWf5wLAS2YWXLRmGk6C+T6vtX5zRVrMf8QYyT9q1w5vMscW5v0HTdEl2g/wSw6/4AATiWGg==
sidebar_class_name: "get 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={"Read an asset"}
>
</Heading>

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



Reads an asset by ID.

<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 read.","example":123}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={undefined}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The operation was successful.","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>