data.registry.image-version.list

List registry image versions (tags) for an organization (UUID-only public surface)

List RegistryImageVersion rows for an organization with image/repo/tag/digest filters.

Inputs:

• organization_uuid: Organization UUID (required)
• registry_image_uuid: Restrict to versions of one image digest (optional)
• registry_repository_uuid: Restrict to versions in one repository (optional)
• tag: Exact tag match (optional)
• tag_contains: Substring match on tag (optional)
• digest: Exact digest match (optional)
• is_mutable: Filter by mutability (optional)
• limit: Page size — clamped by the engine (default 50)
• offset: Pagination offset (default 0)

Outputs (terminal state_data):

• items: list of registry-image-version public dicts (UUID-only)
• count: number of items returned
• total: total rows matching the filter
• limit: effective limit after clamping
• offset: offset used
• error: str | None (only on failure)

Overview

Property	Value
Workflow type	Atomic
Library	App-registry
Version	1.0

Input Schema

Field	Type	Required	Default	Description
organization_uuid	uuid	Yes	—	Organization UUID for tenant isolation
registry_image_uuid	uuid	No	—	Restrict to versions of one RegistryImage
registry_repository_uuid	uuid	No	—	Restrict to versions in one RegistryRepository
tag	string	No	—	Exact tag match
tag_contains	string	No	—	Substring match on tag
digest	string	No	—	Exact digest match
is_mutable	boolean	No	—	Filter by mutability
limit	integer	No	50	Page size — hard-capped by the engine
offset	integer	No	0	Pagination offset

Output Schema

Field	Type	Required	Default	Description
organization_uuid	uuid	Yes	—	Organization UUID for tenant isolation
registry_image_uuid	uuid	No	—	Restrict to versions of one RegistryImage
registry_repository_uuid	uuid	No	—	Restrict to versions in one RegistryRepository
tag	string	No	—	Exact tag match
tag_contains	string	No	—	Substring match on tag
digest	string	No	—	Exact digest match
is_mutable	boolean	No	—	Filter by mutability
limit	integer	No	50	Page size — hard-capped by the engine
offset	integer	No	0	Pagination offset
items	list	Yes	—	List of registry-image-version public dicts (UUID-only)
count	integer	Yes	—	Number of items returned in this page
total	integer	Yes	—	Total rows matching the filter across all pages
error	string	No	—	Set when query() raised; only present on failure
failure_reason	string	No	—	Engine failure reason, present only on failed terminal state
failure_type	string	No	—	Engine failure type classification (ADR-015 E2)
failed_action	string	No	—	Action name that caused the failure (ADR-015 E2)
failed_at_state	string	No	—	State name where the failure occurred
failed_step	string	No	—	Failed DAG step name when reported by the engine
failed_layer	integer	No	—	1-based failed DAG layer number emitted by the engine
error_type	string	No	—	Unexpected error class or type

States

State	Initial	Terminal	Success	Auto-advance	Description
done	Yes	Yes	Yes	—	—

API Usage

POST /api/workflows/start
Content-Type: application/json

{
  "workflow_type": "data.registry.image-version.list",
  "initial_data": {
    "organization_uuid": "value"
  }
}