---
id: asset-list
title: "List assets"
description: "Lists assets by `build_id`."
sidebar_label: "List assets"
hide_title: true
hide_table_of_contents: true
api: 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
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={"List assets"}
>
</Heading>

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



Lists assets by `build_id`.

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

<ParamsDetails
  parameters={[{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0},"description":"The starting point for pagination. Defaults to 0 if not provided.","example":0},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"},"description":"The maximum number of results to return per page\"","example":30},{"name":"build_id","in":"query","required":true,"schema":{"type":"integer"},"description":"The ID of the build to list assets by.","example":345},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["docker-image","lambda","bundle"]},"description":"The type of the asset.","example":"docker-image"},{"name":"platform","in":"query","required":false,"schema":{"type":"string","enum":["x86_64","arm_64"]},"description":"The platform of the asset.","example":"arm_64"}]}
>
  
</ParamsDetails>

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

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"A list of assets.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","required":["paging","results"],"properties":{"paging":{"type":"object","required":["offset","limit","total"],"properties":{"total":{"type":"integer","description":"The total number of results matching the query.","example":30},"offset":{"type":"integer","minimum":0,"description":"The starting point for pagination. Defaults to 0 if not provided.","example":0},"limit":{"type":"integer","maximum":200,"description":"The maximum number of results to return per page. The maximum allowed value is 200.","example":200}}},"results":{"type":"array","items":{"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"}}},"title":"assetListResponse"}}}}},"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>