---
title: "Desired image set for a plan runner group"
method: GET
path: "/orgs/{orgName}/plan-runnergroups/{planRunnerGroupName}/desired-images"
tags: ["PlanRunnerGroups"]
---

# Desired image set for a plan runner group

`GET /orgs/{orgName}/plan-runnergroups/{planRunnerGroupName}/desired-images`

## Request

- Base URL: `https://api.signadot.com/api/v2`
- URL: `https://api.signadot.com/api/v2/orgs/{orgName}/plan-runnergroups/{planRunnerGroupName}/desired-images`
- Auth: API key in header `signadot-api-key`

Returns the set of literal \image refs declared by

## Path parameters

- `orgName` string, required
- `planRunnerGroupName` string, required

## Response `200`

OK

- PlanDesiredImagesResponse
  - `images` PlanImageSpec[]
    - `lastReferencedAt` string: LastReferencedAt is the most recent timestamp at which a plan execution or visible action referenced this ref, computed at the apiserver. Zero when neither source supplies a timestamp.
    - `ref` string: Ref is the canonicalized image reference, e.g. "index.docker.io/library/alpine:3.19".
    - `referenceCount` integer: ReferenceCount is the number of distinct plan executions and actions that referenced this ref over the apiserver's window. Zero when neither source supplies a count.

## Other responses

- `304`: Not Modified — desired set unchanged since the client's ETag
- `404`: Not Found

## Changes

- **2026-05-07** `942b3992433f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/signadot/apis/signadot-api/changes/orgs/:orgName/plan-runnergroups/:planRunnerGroupName/desired-images/get.md)

---

[API](https://skmtc.dev/signadot/apis/signadot-api.md) - [All operations](https://skmtc.dev/signadot/apis/signadot-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signadot/apis/signadot-api/revisions/5e80b0f9c718?raw)