Admiral
Components

List a component's revisions

GET
/v1/components/{component_id}/revisions

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

Query Parameters

filter?filter

Filter expression. Filterable fields:

  • kind: TERRAFORM, HELM, MANIFESTS.
  • status: PUBLISHED, DEPRECATED.

Example: field['status'] = 'PUBLISHED'

Lengthlength <= 1024
page_size?page_size

The page_size query parameter.

Formatint32
Range0 <= value <= 100
page_token?page_token

The page_token query parameter.

Response Body

application/json

curl -X GET "https://example.com/v1/components/497f6eca-6276-4993-bfeb-53cbbbba6f08/revisions"
{  "revisions": [    {      "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"    }  ],  "next_page_token": "string"}