---
updatedAt: 2026-07-26T12:14:49.000Z
agentTools:
siteIndex: https://docs.jfrog.com/llms.txt
projectIndex: https://docs.jfrog.com/security/llms.txt
---
# List of images tags
# OpenAPI definition
```json
{
"openapi": "3.0.2",
"info": {
"title": "Runtime Security RESTful API",
"version": "1.0.0",
"description": "This document describes the Runtime Security RESTful API.
\nAt the moment these API Endpoints can only be used internally,
\nby the Runtime Frontend and other JPD services.\n"
},
"servers": [
{
"url": "http://localhost:9999/v1",
"description": "localhost"
},
{
"url": "http://demo-runtime.jfrog.net/v1",
"description": "demo"
}
],
"tags": [
{
"name": "Runtime Inventory",
"description": "Runtime inventory discovery for images, workloads, process groups, and live resources."
}
],
"paths": {
"/images/tags": {
"post": {
"tags": [
"Runtime Inventory"
],
"summary": "List of images tags",
"parameters": [
{
"$ref": "#/components/parameters/ProjectKey"
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PublicImagesTagsRequestEntity"
}
}
}
},
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PublicImagesTagsResponseEntity"
}
}
}
},
"400": {
"description": "Bad request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
}
}
}
}
},
"components": {
"schemas": {
"Error": {
"type": "object",
"properties": {
"message": {
"type": "string",
"description": "Error message."
}
},
"required": [
"message"
]
},
"ApplicabilityResult": {
"type": "string",
"enum": [
"applicable",
"not_applicable",
"undetermined",
"not_scanned",
"rescan_required",
"upgrade_required",
"not_covered",
""
],
"x-enum-varnames": [
"Applicable",
"NotApplicable",
"Undetermined",
"NotScanned",
"RescanRequired",
"UpgradeRequired",
"NotCovered",
"Empty"
]
},
"PublicComponent": {
"type": "object",
"required": [
"id",
"name",
"version"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"version": {
"type": "string"
}
}
},
"PublicMaliciousPackages": {
"type": "object",
"required": [
"xray_id",
"components"
],
"properties": {
"xray_id": {
"type": "string"
},
"components": {
"type": "array",
"items": {
"$ref": "#/components/schemas/PublicComponent"
}
}
}
},
"PublicVulnerabilityEntity": {
"type": "object",
"x-oapi-codegen-extra-tags": {
"gorm": "serializer:json"
},
"required": [
"xray_id",
"cve_id",
"applicability",
"severity",
"components",
"cvss_v2",
"cvss_v3"
],
"properties": {
"xray_id": {
"type": "string"
},
"cve_id": {
"type": "string"
},
"severity": {
"type": "string"
},
"cvss_v2": {
"type": "string"
},
"cvss_v3": {
"type": "string"
},
"applicability": {
"$ref": "#/components/schemas/ApplicabilityResult"
},
"components": {
"type": "array",
"items": {
"$ref": "#/components/schemas/PublicComponent"
}
}
}
},
"PublicWorkloadEntity": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
},
"namespace": {
"type": "string"
},
"cluster": {
"type": "string"
}
}
},
"Pagination": {
"type": "object",
"required": [
"limit"
],
"properties": {
"next_key": {
"type": "string"
},
"limit": {
"type": "integer"
}
}
},
"RuntimeStatus": {
"type": "string",
"enum": [
"running",
"stopped",
"unknown"
]
},
"ScanInfo": {
"type": "object",
"required": [
"sca"
],
"properties": {
"sca": {
"type": "boolean"
}
}
},
"PublicRiskKey": {
"type": "string",
"enum": [
"malicious",
"critical_applicable_cves",
"untrusted_registry",
"integrity_violation"
]
},
"PublicImageTag": {
"type": "object",
"required": [
"name",
"tag",
"repository_path",
"registry",
"risks",
"vulnerabilities",
"workloads",
"runtime_status",
"architecture",
"scan_info",
"malicious_packages",
"image_digest"
],
"properties": {
"name": {
"type": "string"
},
"tag": {
"type": "string"
},
"repository_path": {
"type": "string"
},
"registry": {
"type": "string"
},
"risks": {
"type": "array",
"items": {
"$ref": "#/components/schemas/PublicRiskKey"
}
},
"vulnerabilities": {
"type": "array",
"items": {
"$ref": "#/components/schemas/PublicVulnerabilityEntity"
}
},
"malicious_packages": {
"type": "array",
"items": {
"$ref": "#/components/schemas/PublicMaliciousPackages"
}
},
"workloads": {
"type": "array",
"items": {
"$ref": "#/components/schemas/PublicWorkloadEntity"
}
},
"scan_info": {
"$ref": "#/components/schemas/ScanInfo"
},
"runtime_status": {
"$ref": "#/components/schemas/RuntimeStatus"
},
"architecture": {
"type": "string"
},
"image_digest": {
"type": "string"
},
"k8s_labels": {
"type": "array",
"items": {
"$ref": "#/components/schemas/K8sLabel"
}
}
}
},
"PublicImagesTagsResponseEntity": {
"type": "object",
"required": [
"image_tags",
"pagination",
"total_count"
],
"properties": {
"total_count": {
"type": "integer"
},
"image_tags": {
"type": "array",
"items": {
"$ref": "#/components/schemas/PublicImageTag"
}
},
"pagination": {
"$ref": "#/components/schemas/Pagination"
}
}
},
"TimePeriodEnum": {
"type": "string",
"enum": [
"now",
"1 hour",
"24 hours",
"3 days",
"7 days",
"10 days",
"30 days"
]
},
"OrderDirectionEnum": {
"description": "Order direction",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"ComponentFilter": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
},
"version": {
"type": "string"
}
}
},
"PublicImagesTagsFilters": {
"type": "object",
"properties": {
"time_period": {
"$ref": "#/components/schemas/TimePeriodEnum"
},
"cve_id": {
"type": "array",
"items": {
"type": "string"
}
},
"severity": {
"type": "array",
"items": {
"type": "string"
}
},
"risk": {
"type": "array",
"items": {
"$ref": "#/components/schemas/PublicRiskKey"
}
},
"component": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ComponentFilter"
}
},
"applicability": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ApplicabilityResult"
}
},
"cluster": {
"type": "array",
"items": {
"type": "string"
}
},
"namespace": {
"type": "array",
"items": {
"type": "string"
}
},
"k8s_labels": {
"type": "array",
"items": {
"$ref": "#/components/schemas/K8sLabel"
}
}
}
},
"PublicImagesTagsRequestEntity": {
"type": "object",
"properties": {
"limit": {
"type": "integer"
},
"next_key": {
"type": "string"
},
"order_by": {
"type": "string",
"enum": [
"risks",
"name",
"registry",
"repository_path"
]
},
"direction": {
"$ref": "#/components/schemas/OrderDirectionEnum"
},
"filters": {
"$ref": "#/components/schemas/PublicImagesTagsFilters"
}
}
},
"K8sLabel": {
"type": "object",
"required": [
"key",
"value"
],
"properties": {
"key": {
"type": "string"
},
"value": {
"type": "string"
}
}
}
},
"parameters": {
"ProjectKey": {
"in": "query",
"name": "projectKey",
"required": false,
"description": "JFrog Project key to scope results",
"schema": {
"type": "string"
}
}
}
}
}
```