---
title: "List versions of a resource plugin"
method: GET
path: "/orgs/{orgName}/resource-plugins/{pluginName}/versions"
tags: ["ResourcePlugins"]
---

# List versions of a resource plugin

`GET /orgs/{orgName}/resource-plugins/{pluginName}/versions`

## Request

- Base URL: `https://api.signadot.com/api/v2`
- URL: `https://api.signadot.com/api/v2/orgs/{orgName}/resource-plugins/{pluginName}/versions`
- Auth: API key in header `signadot-api-key`

List every published version of the named resource plugin.

## Path parameters

- `orgName` string, required
- `pluginName` string, required

## Response `200`

OK

- ResourcePlugin[]
  - `createdAt` string: The time at which the resource plugin was created
  - `name` string: Plugin identity of the form `bareName[@semver]`. The bare-name form (no `@`) means the default version (0.0.0); responses for plugins at the default version use this bare form for backward compatibility with pre-versioning clients.
  - `spec` ResourcepluginSpec
    - `create` ResourcepluginStep[]: Create refers to the `create` steps for spinning up the resource
      - `inputs` ResourcepluginStepInput[]: Inputs for the step
        - `as` ResourcepluginStepInputTo
          - `env` string: Inject the input as an env variable with name Env inside the main container
          - `path` string: Expose the input as a file at Path inside the main container
        - `name` string: Name for the input
        - `type` string: Type of input
        - `valueFromSandbox` boolean: ValueFromSandbox defines whether or not to source value from the sandbox spec
        - `valueFromStep` ResourcepluginValueFromStep
          - `name` string: Name of the step
          - `output` string: Name of the variable from the step
      - `name` string: Name for the step
      - `outputs` ResourcepluginStepOut[]: Outputs for the step
        - `description` string: Description for the output
        - `name` string: Name of the output variable
        - `type` string: Type of output
        - `valueFromPath` string: Path within the main container from where the output will be read
      - `script` string: Script to execute in the step
    - `delete` ResourcepluginStep[]: Delete refers to the `delete` steps for spinning up the resource
      - `inputs` ResourcepluginStepInput[]: Inputs for the step
        - `as` ResourcepluginStepInputTo
          - `env` string: Inject the input as an env variable with name Env inside the main container
          - `path` string: Expose the input as a file at Path inside the main container
        - `name` string: Name for the input
        - `type` string: Type of input
        - `valueFromSandbox` boolean: ValueFromSandbox defines whether or not to source value from the sandbox spec
        - `valueFromStep` ResourcepluginValueFromStep
          - `name` string: Name of the step
          - `output` string: Name of the variable from the step
      - `name` string: Name for the step
      - `outputs` ResourcepluginStepOut[]: Outputs for the step
        - `description` string: Description for the output
        - `name` string: Name of the output variable
        - `type` string: Type of output
        - `valueFromPath` string: Path within the main container from where the output will be read
      - `script` string: Script to execute in the step
    - `description` string: Description for the resource
    - `runner` ResourcepluginRunner
      - `image` string: Image for the runner instance
      - `namespace` string: Namespace to create this runner instance in
      - `podTemplateOverlay` string: Pod template overlay
  - `status` ResourcepluginStatus
    - `resources` ResourceInfo[]: Resources created using the resource plugin
      - `cluster` string: Cluster that the resource is created in
      - `name` string: Name of the created resource
      - `sandbox` string: Name of the sandbox containing the resource
  - `updatedAt` string: The time at which the resource plugin was last updated

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `502`: Bad Gateway

## Changes

- **2026-06-16** `ac9fc82a7732`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/signadot/apis/signadot-api/changes/orgs/:orgName/resource-plugins/:pluginName/versions/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)