---
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","description":"The number of results returned per page. Defaults to 30.","example":30}}},"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>