---
title: "Changes to Get the state of a release target"
method: GET
path: "/v1/workspaces/{workspaceId}/release-targets/{releaseTargetKey}/state"
---

# Changes to Get the state of a release target

`GET /v1/workspaces/{workspaceId}/release-targets/{releaseTargetKey}/state`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 17 of 50 revisions.

- **2026-07-17** `e4a4bf1152c8`: 1 warning
- **2026-05-14** `f051c9ac1ba7`: 1 info
- **2026-04-16** `f90d884ae2a1`: 1 info
- **2026-04-08** `a0abdfdbb749`: 2 warning
- **2026-04-08** `bb21d09ab17e`: 1 info
- **2026-04-07** `e41df2952d9d`: 1 info
- **2026-03-30** `6f7ce65cbefe`: 1 breaking
- **2026-03-28** `eee17e2535c1`: 1 info
- **2026-03-12** `0628eca3b471`: 1 breaking
- **2026-03-06** `f3469b99b137`: 1 info
- **2026-03-03** `c5d75ce41764`: 3 info
- **2026-02-26** `6296ef382f73`: 1 info
- **2026-02-19** `88fe14c7b49e`: 1 info
- **2026-02-17** `dbed73823741`: 2 breaking
- **2026-02-14** `6fa97e4ccdc4`: 2 breaking, 2 info
- **2026-02-13** `fd9cb3e4b9c5`: 1 info
- **2026-02-11** `3924e3b154f6`: 5 breaking, 1 warning, 3 info

## Changes

- **2026-07-17** `e4a4bf1152c8`: 1 warning
  - added the new `queued` enum value to the `latestJob/job/status` response property for the response status `200`
- **2026-05-14** `f051c9ac1ba7`: 1 info
  - added the required property `latestJob/job/dispatchContext/workflow/slug` to the response with the `200` status
- **2026-04-16** `f90d884ae2a1`: 1 info
  - added the optional property `latestJob/job/dispatchContext/resource/variables` to the response with the `200` status
- **2026-04-08** `a0abdfdbb749`: 2 warning
  - removed the optional property `latestJob/job/dispatchContext/deployment/jobAgentId` from the response with the `200` status
  - removed the optional property `latestJob/job/dispatchContext/deployment/jobAgents` from the response with the `200` status
- **2026-04-08** `bb21d09ab17e`: 1 info
  - the response property `latestJob/job/dispatchContext/deployment/jobAgentSelector` became required for the status `200`
- **2026-04-07** `e41df2952d9d`: 1 info
  - added the optional property `latestJob/job/dispatchContext/deployment/jobAgentSelector` to the response with the `200` status
- **2026-03-30** `6f7ce65cbefe`: 1 breaking
  - removed the required property `latestJob/job/dispatchContext/workflow/jobs/items/id` from the response with the `200` status
- **2026-03-28** `eee17e2535c1`: 1 info
  - endpoint added
- **2026-03-12** `0628eca3b471`: 1 breaking
  - api path removed without deprecation
- **2026-03-06** `f3469b99b137`: 1 info
  - added the required property `latestJob/job/dispatchContext/environment/workspaceId` to the response with the `200` status
- **2026-03-03** `c5d75ce41764`: 3 info
  - added the required property `currentRelease/id` to the response with the `200` status
  - added the required property `desiredRelease/id` to the response with the `200` status
  - added the required property `latestJob/job/dispatchContext/release/id` to the response with the `200` status
- **2026-02-26** `6296ef382f73`: 1 info
  - added the required property `latestJob/job/dispatchContext/workflow/jobs/items/workflowId` to the response with the `200` status
- **2026-02-19** `88fe14c7b49e`: 1 info
  - added the optional property `latestJob/job/dispatchContext/deployment/jobAgents` to the response with the `200` status
- **2026-02-17** `dbed73823741`: 2 breaking
  - removed the required property `latestJob/job/dispatchContext/deployment/systemIds` from the response with the `200` status
  - removed the required property `latestJob/job/dispatchContext/environment/systemIds` from the response with the `200` status
- **2026-02-14** `6fa97e4ccdc4`: 2 breaking, 2 info
  - removed the required property `latestJob/job/dispatchContext/deployment/systemId` from the response with the `200` status
  - removed the required property `latestJob/job/dispatchContext/environment/systemId` from the response with the `200` status
  - added the required property `latestJob/job/dispatchContext/deployment/systemIds` to the response with the `200` status
  - added the required property `latestJob/job/dispatchContext/environment/systemIds` to the response with the `200` status
- **2026-02-13** `fd9cb3e4b9c5`: 1 info
  - added the optional property `latestJob/job/dispatchContext` to the response with the `200` status
- **2026-02-11** `3924e3b154f6`: 5 breaking, 1 warning, 3 info
  - the response property `latestJob/verifications/items/metrics/items/allOf[subschema #2]/measurements/items/data` became optional for the status `200`
  - removed the required property `currentRelease/id` from the response with the `200` status
  - removed the required property `desiredRelease/id` from the response with the `200` status
  - removed the required property `latestJob/verifications/items/metrics/items/allOf[subschema #2]/id` from the response with the `200` status
  - removed the required property `latestJob/verifications/items/status` from the response with the `200` status
  - removed the optional property `latestJob/job/dispatchContext` from the response with the `200` status
  - added the new optional `query` request parameter `bypassCache`
  - removed the non-success response with the status `400`
  - removed the `queued` enum value from the `latestJob/job/status` response property for the response status `200`

---

[Operation](https://skmtc.dev/ctrlplanedev/apis/workspace-engine-api/docs/v1/workspaces/:workspaceId/release-targets/:releaseTargetKey/state/get.md) - [API](https://skmtc.dev/ctrlplanedev/apis/workspace-engine-api.md) - [Page](https://skmtc.dev/ctrlplanedev/apis/workspace-engine-api/changes/v1/workspaces/:workspaceId/release-targets/:releaseTargetKey/state/get)