Resolve a catalog item

This operation fetches from the external system in real time and may take several seconds depending on the source type and size.

Scope: catalog:read

Authorization

bearerAuth

AuthorizationBearer <token>

Personal Access Token (PAT) or Service Access Token (SAT). Pass the token in the Authorization header: Bearer admp_...

In: header

Path Parameters

catalog_item_id*catalog_item_id

Unique identifier of the catalog item to resolve (UUID).

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

catalog_item_id*catalog_item_id

Unique identifier of the catalog item to resolve (UUID).

Formatuuid

ref_override?ref_override

Optional ref override. When set, this ref is used instead of the item's default ref. Useful for previewing a different version without modifying the catalog item definition.

Lengthlength <= 256

Response Body

`application/json`

curl -X POST "https://api.admiral.io/api/v1/catalog-items/497f6eca-6276-4993-bfeb-53cbbbba6f08/resolve" \  -H "Content-Type: application/json" \  -d '{    "catalog_item_id": "ab09154e-32b9-4c7b-baeb-072fb240b8d2"  }'

{  "revision": "string",  "digest": "string",  "catalog_item": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "name": "string",    "description": "string",    "type": "CATALOG_ITEM_TYPE_UNSPECIFIED",    "source_id": "ae50a35c-df42-4eff-ba26-f8bc28d2af81",    "ref": "string",    "root": "string",    "path": "string",    "labels": {      "property1": "string",      "property2": "string"    },    "source_name": "string",    "created_by": {      "id": "string",      "display_name": "string",      "email": "string"    },    "created_at": "2023-01-15T01:30:15.01Z",    "updated_at": "2023-01-15T01:30:15.01Z"  }}