---
id: artifact-read
title: "Read a platform artifact"
description: "Read one artifact: its identity meta, visibility, revision count and latest revision id."
sidebar_label: "Read a platform artifact"
hide_title: true
hide_table_of_contents: true
api: eJztV21v2zYQ/ivEfVlbSI7sOGkirAO67qUb0KBIMrRYGrgn8WRxkUiVpOK4hv77cJTj16QdMPTLsC+JJVLH55577oULkORyqxqvjIYUzgmlMJoEWq8KzH0qlHdCSdJe+bmoyWMkbpVTmaqUn0fCEj8ZLXLTai9QS1GhJ+fXK0oOIALTkEU+5jcJKazsW0IJEXicOkiv4OXyPVxH0KDFmjxZXlmAYoAN+hIi0FgTpKD4U0ufWmVJQuptSxG4vKQaIV2Anze8y3mr9BQiKIyt0UMKbaskdNGO85fl2u8laLrDuqnYyFF+LJ/TSRGfYpLF43wo4xMaFfEhjrP7NeiuI3CUt1b5ecCcEVqyL1tfQnp1zcuWXGO0I8cAR0nC/x6HwRhyoz1pzxuxaSqVBxYP/nK8e7Hvrsn+otzDF70jfUuVaShdh7apWreOWWbMzQ1Ro/SUMTSWw+dVD9uSM63NaaLk12n+BixHyyP3jybd1iwjk6uJqnFKLDyLbnJ/IkQwVX5iqTFOeWPnEEFWmYz19gWcfE4kZqXKSyEpV5Kc8CUJV2JDwhTi4z2PE06RjyEPTCHolux8xep3TnwMy9tOr8F2EWirH3JsH5uZaaWn4uz8bMeanaJWn4NIXgxTzENivhix8S2QD0kGpVT8IVZvNyLe59U+hJV2XJs58uwwk8LGBZOaCktT5bydBz7WpEeitVUkjBWV6eUcCUkNackuGR343nKLRdebghSGo8Px0fHzk9NkOBrIGzug3A5aFxM6Hw8HWONno3HmBrmpQ4FYBTuFeh4bOz2o57HLTUPQdRGEelbRxJsNTtBaZHUoT7XbD8le9Tg7P3MCq8rMSApvRG60a2sST7jC9XVR6ZunwpfKrfNbXLRNY6x3wltUldLTeKYqmaOVIgB04klhrFgSEYkPjwX42Qd4Go7hEEwrk2ElVqZ2vnr2AQbiJyqwrfhkI6601dcD8cZIVSwLjBPO41xM0ZMMIdnRXMfE9rqeBAQbHCntaUoWIqiVVjXnZLLL12szEzXqdXb0GbVKuRLdlgIOuwj6zjJZnfvP6o9uqwoztvGYkDXNNjtWUCZ/JWYl6T1YQhu9rU4YZYf5WB5RfFw8x3icneTxqUwoHhYjPMzG+ZE8DtmdW2I+J+i/CFyip9irmvYy/90eoBk6USgb4HOGkKWdojpKRsdxchoPx5fDUZokaZIMkiT5M2jfK1/RRkOGruPX4/fv9zvTq0qR9oKsNVasGpmQLbGGlL7FSkmhdNP6SNTKORbLuoszq0q7tihUHgw1ZMMuo92/anTb3cl59K17ZSQ9qMgdFV5evhX9FyI3cjus4yThmG1beqQkv8G8VJpiznYW25KlPZuQoZzwyELOsyLCtq+bvyiNvWeeh59tmz+iFOdrmzU5x+3kq1ZftzXqDch3TYU6sL5tnyv6QKopJ0nd8h/0ecndb3R0nH5/PI5LuvthS08B6vlSI0tRHT0kqguyt2R3RfW/Hv7zegjAfGn4OjClEDce7lM4uK9F7mChZAc8U7NG+mtAaytIofS+cenBATZqwJW6qdBz+Qwtf3MMv2CV9ELYHMZXTLAhWF4aQjjCJp4Kw49f7kvy7+8ugz9KF2FKYDw9acNBMkhg7enqCtNF0BjnawxyXV5Zwg0LxT1esTGYbsVisZb/t7yVLVnwdOcPmgqVZtSB4sUyHFer1uAgglRJHpVL4zwvLRYZOvrDVl3Hrz+1xEPW1XUEt2hV33SvFiCV498S0gIrt9uCN119cr68zT0VD1wUHkR7P69pntZusWr5CSK4oXl/ReyuuwhKQkk2oOkXXuY5NX7jk70awzJaKfTXny95Pt4Wz45YgvUH4SwW/Y5Lc0O661boPD8zwK77G0+3XMU=
sidebar_class_name: "get api-method"
info_path: docs/api/artifact
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 a platform artifact"}
>
</Heading>

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



Read one artifact: its identity meta, visibility, revision count and latest revision id.

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

<ParamsDetails
  parameters={[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uuid"},"description":"The artifact id.","example":"5c6d7e8f-9a0b-4c1d-8e2f-3a4b5c6d7e8f"}]}
>
  
</ParamsDetails>

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

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The artifact.","content":{"application/json":{"schema":{"type":"object","description":"The artifact envelope: identity plus revision bookkeeping.","properties":{"resource_id":{"type":"string","format":"uuid","description":"The artifact id.","example":"5c6d7e8f-9a0b-4c1d-8e2f-3a4b5c6d7e8f"},"type":{"type":"string","enum":["oci_image","oras_artifact","git_repository","blob"],"description":"The artifact type, which decides the shape of `identity_meta` and of every revision's `meta`.","example":"oci_image"},"nrn":{"type":"string","description":"The owning NRN.","example":"organization=1:account=2"},"identity_meta":{"type":"object","additionalProperties":true,"description":"The identity subset of the meta blob: registry and repository, url, or location, depending on type.","example":{"registry":"123456789012.dkr.ecr.us-east-1.amazonaws.com","repository":"my-org/my-scope"}},"visible_to":{"type":"array","items":{"type":"string"},"description":"NRNs allowed to consume (read and link) this artifact. Supports trailing-wildcard scopes (for example, \"organization=1:account=*\") and the global wildcard \"organization=*\". Defaults to [nrn]. Modifications stay gated on the owning NRN."},"revision_count":{"type":"integer","minimum":0,"description":"How many revisions the artifact has.","example":3},"latest_revision_id":{"type":"string","format":"uuid","nullable":true,"description":"The newest revision, or null when the artifact has none.","example":"2b3c4d5e-6f7a-4b8c-9d0e-1f2a3b4c5d6e"},"created_at":{"type":"string","format":"date-time","description":"When the artifact was first registered.","example":"2026-09-14T12:00:00.000Z"}},"title":"artifact"}}}},"4XX":{"description":"Client error responses due to invalid input, missing parameters or insufficient permissions.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"integer","description":"HTTP status code.","example":400},"code":{"type":"string","description":"Machine-readable error code.","example":"bad_request"},"error":{"type":"string","description":"Short error name.","example":"Bad Request"},"message":{"type":"string","description":"Human-readable explanation.","example":"meta.digest must match sha256:<64-hex>"}},"title":"errorResponse"}}}},"5XX":{"description":"Server error responses.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"integer","description":"HTTP status code.","example":400},"code":{"type":"string","description":"Machine-readable error code.","example":"bad_request"},"error":{"type":"string","description":"Short error name.","example":"Bad Request"},"message":{"type":"string","description":"Human-readable explanation.","example":"meta.digest must match sha256:<64-hex>"}},"title":"errorResponse"}}}}}}
>
  
</StatusCodes>