---
title: "Get Versions of a Resource Definition."
method: GET
path: "/orgs/{orgId}/resources/defs/{defId}/versions"
tags: ["public", "ResourceDefinitionVersion"]
---

# Get Versions of a Resource Definition.

`GET /orgs/{orgId}/resources/defs/{defId}/versions`

First 50 Versions are kept along with all the Versions referenced by an Active Resource.

 To obtain Versions of a deleted Resource Definition, the `deleted` parameter needs to be used.

## Path parameters

- `orgId` string, required
- `defId` string, required

## Query parameters

- `deleted` boolean
- `per_page` integer
- `page` string

## Response `200`

A list or Resource Definition Version.

- ResourceDefinitionVersion[]
  - `id` string, required — The Resource Definition Version ID.
  - `org_id` string, required — The Organization ID.
  - `def_id` string, required — The Resource Definition ID.
  - `name` string, required — The display name.
  - `type` string, required — The Resource Type.
  - `driver_type` string, required — The driver to be used to create the resource.
  - `driver_account` string, required — (Optional) Security account required by the driver.
  - `driver_inputs` ValuesSecretsRefsResponse, required — ValuesSecretsRefs stores data that should be passed around split by sensitivity.
    - `secret_refs` object — Secrets section of the data set. They can hold sensitive information that will be stored in the primary organization secret store and replaced with the secret store paths when sent outside, or secret references stored in a defined secret store. Can't be used together with `secrets`. They can hold a nested structure but leaf objects need to be of type SecretReference, where: - `store` is a Secret Store id. It can't be `humanitec`. It's mandatory if `ref` is defined and can't be used in request payloads if `value` is defined. - `ref` is the secret key in the format of the target store. It can't be used in request payloads if `value` is defined. - `version` is the version of the secret as defined in the target store. It can be defined only if `ref` is defined. - `value` is the value to store in the organizations primary secret store. It can't be used in request payloads if `ref` is defined.
    - `secrets` object — Secrets section of the data set. Sensitive information is stored in the primary organization secret store and replaced with the secret store paths when sent outside. Can't be used together with `secret_refs`.
    - `values` object — Values section of the data set. Passed around as-is.
  - `in_place_driver_change` boolean, required — If true, the Operator will not delete resources provisioned by the previous driver when driver_type changes on a later update; the new driver takes over the existing infrastructure in place. Applies to the Operator provisioning path only.
  - `provision` object, required — (Optional) A map where the keys are resType#resId (if resId is omitted, the same id of the current resource definition is used) of the resources that should be provisioned when the current resource is provisioned. This also specifies if the resources have a dependency on the current resource.
  - `action` string, required — The action that generated the Resource Definition Version. Might be one of `created`, `updated` or `deleted`.
  - `archived` boolean, required — Specifies if the version is archived (i.e. can't be used for a new resource).
  - `active` boolean, required — Specifies if the version is active (i.e. is being used if target version is not specified for a resource or a context).
  - `proposed` boolean, required — Specifies if the version is proposed (i.e. is newer than the active version).
  - `created_at` string, date-time, required — The timestamp of when this record has been created.
  - `created_by` string, required — The user who created this record.

## Other responses

- `400` — Bad Request.
- `404` — The Resource Definition is not found.

---

[API](https://skmtc.net/humanitec/apis/humanitec-api.md) · [All operations](https://skmtc.net/humanitec/apis/humanitec-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/humanitec/humanitec-api/revisions/e21ad140ec3c/schema)