Admiral
Components

Retrieve a revision

GET
/v1/components/{component_id}/revisions/{reference}

Scope: component: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

component_id*component_id

The component_id path parameter.

Formatuuid
reference*reference

A tag name (v1.2.0, latest) or a digest (sha256:<hex>). A digest is recognised by its prefix; everything else is looked up as a tag.

Match^(sha256:[0-9a-f]{64}|[A-Za-z0-9][A-Za-z0-9._+-]{0,127})$
Length1 <= length <= 128

Response Body

application/json

curl -X GET "https://example.com/v1/components/497f6eca-6276-4993-bfeb-53cbbbba6f08/revisions/string"
{  "revision": {    "id": "string",    "component_id": "string",    "digest": "string",    "kind": "COMPONENT_KIND_UNSPECIFIED",    "size_bytes": "string",    "contract": {      "inputs": [        {          "name": "string",          "type": "string",          "description": "string",          "required": true,          "default": null,          "sensitive": true,          "ephemeral": true        }      ],      "outputs": [        {          "name": "string",          "description": "string",          "sensitive": true        }      ]    },    "provenance": {      "kind": "PROVENANCE_KIND_UNSPECIFIED",      "uri": "string",      "ref": "string",      "commit": "string",      "path": "string",      "dirty": true,      "pins": [        {          "source": "string",          "constraint": "string",          "resolved": "string"        }      ],      "credentials": [        {          "id": "string",          "name": "string",          "hosts": [            "string"          ]        }      ]    },    "findings": [      {        "severity": "FINDING_SEVERITY_UNSPECIFIED",        "source": "string",        "code": "string",        "message": "string",        "path": "string"      }    ],    "status": "REVISION_STATUS_UNSPECIFIED",    "deprecated_at": "2023-01-15T01:30:15.01Z",    "deprecation_reason": "string",    "tags": [      "string"    ],    "created_by": {      "id": "string",      "display_name": "string",      "email": "string"    },    "created_at": "2023-01-15T01:30:15.01Z"  }}