---
title: "Changes to Retrieve an Existing Workspace"
method: GET
path: "/v2/gen-ai/workspaces/{workspace_uuid}"
---

# Changes to Retrieve an Existing Workspace

`GET /v2/gen-ai/workspaces/{workspace_uuid}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 5 of 8 revisions.

- **2025-10-16** `cb3bf9b21459` — 2 info
- **2025-07-18** `f8e8c290636c` — 1 warning, 13 info
- **2025-07-17** `5fc9af728e82` — 8 warning, 9 info
- **2025-07-17** `f8e8c290636c` — 1 warning, 13 info
- **2025-06-25** `e8b3cbc80e18` — 1 info

## Changes

- **2025-10-16** `cb3bf9b21459` — 2 info
  - api tag `DigitalOcean-public.v2-new_GradientAI Platform` added
  - api tag `GradientAI Platform` removed
- **2025-07-18** `f8e8c290636c` — 1 warning, 13 info
  - added the new `METRIC_VALUE_TYPE_PERCENTAGE` enum value to the `workspace/evaluation_test_cases/items/metrics/items/metric_value_type` response property for the response status `200`
  - api operation id `get_workspace` removed and replaced with `genai_get_workspace`
  - the endpoint scheme security `bearer_auth` was added to the API
  - api tag `GradientAI Platform` added
  - api tag `GenAIAPI` removed
  - added the non-success response with the status `401`
  - added the non-success response with the status `404`
  - added the non-success response with the status `429`
  - added the non-success response with the status `500`
  - added the optional property `workspace/evaluation_test_cases/items/dataset` to the response with the `200` status
  - added the optional property `workspace/evaluation_test_cases/items/metrics/items/inverted` to the response with the `200` status
  - added the optional property `workspace/evaluation_test_cases/items/metrics/items/range_max` to the response with the `200` status
  - added the optional property `workspace/evaluation_test_cases/items/metrics/items/range_min` to the response with the `200` status
  - added the optional property `workspace/evaluation_test_cases/items/star_metric/success_threshold` to the response with the `200` status
- **2025-07-17** `5fc9af728e82` — 8 warning, 9 info
  - the optional response header `ratelimit-limit` removed for the status `200`
  - the optional response header `ratelimit-remaining` removed for the status `200`
  - the optional response header `ratelimit-reset` removed for the status `200`
  - removed the optional property `workspace/evaluation_test_cases/items/dataset` from the response with the `200` status
  - removed the optional property `workspace/evaluation_test_cases/items/metrics/items/inverted` from the response with the `200` status
  - removed the optional property `workspace/evaluation_test_cases/items/metrics/items/range_max` from the response with the `200` status
  - removed the optional property `workspace/evaluation_test_cases/items/metrics/items/range_min` from the response with the `200` status
  - removed the optional property `workspace/evaluation_test_cases/items/star_metric/success_threshold` from the response with the `200` status
  - api operation id `genai_get_workspace` removed and replaced with `get_workspace`
  - the endpoint scheme security `bearer_auth` was removed from the API
  - api tag `GenAIAPI` added
  - api tag `GradientAI Platform` removed
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `404`
  - removed the non-success response with the status `429`
  - removed the non-success response with the status `500`
  - removed the `METRIC_VALUE_TYPE_PERCENTAGE` enum value from the `workspace/evaluation_test_cases/items/metrics/items/metric_value_type` response property for the response status `200`
- **2025-07-17** `f8e8c290636c` — 1 warning, 13 info
  - added the new `METRIC_VALUE_TYPE_PERCENTAGE` enum value to the `workspace/evaluation_test_cases/items/metrics/items/metric_value_type` response property for the response status `200`
  - api operation id `get_workspace` removed and replaced with `genai_get_workspace`
  - the endpoint scheme security `bearer_auth` was added to the API
  - api tag `GradientAI Platform` added
  - api tag `GenAIAPI` removed
  - added the non-success response with the status `401`
  - added the non-success response with the status `404`
  - added the non-success response with the status `429`
  - added the non-success response with the status `500`
  - added the optional property `workspace/evaluation_test_cases/items/dataset` to the response with the `200` status
  - added the optional property `workspace/evaluation_test_cases/items/metrics/items/inverted` to the response with the `200` status
  - added the optional property `workspace/evaluation_test_cases/items/metrics/items/range_max` to the response with the `200` status
  - added the optional property `workspace/evaluation_test_cases/items/metrics/items/range_min` to the response with the `200` status
  - added the optional property `workspace/evaluation_test_cases/items/star_metric/success_threshold` to the response with the `200` status
- **2025-06-25** `e8b3cbc80e18` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/digitalocean/apis/digitalocean-api/docs/v2/gen-ai/workspaces/:workspace_uuid/get.md) · [API](https://skmtc.dev/digitalocean/apis/digitalocean-api.md) · [Page](https://skmtc.dev/digitalocean/apis/digitalocean-api/changes/v2/gen-ai/workspaces/:workspace_uuid/get)