--- title: "Changes to List agents by Workspace" method: GET path: "/v2/gen-ai/workspaces/{workspace_uuid}/agents" --- # Changes to List agents by Workspace `GET /v2/gen-ai/workspaces/{workspace_uuid}/agents` > Every recorded change to this endpoint, newest first. ## Timeline Changed in 6 of 8 revisions. - **2025-10-16** `cb3bf9b21459` — 2 info - **2025-08-04** `9aca3802735e` — 8 info - **2025-07-18** `f8e8c290636c` — 2 warning, 18 info - **2025-07-17** `5fc9af728e82` — 2 breaking, 11 warning, 10 info - **2025-07-17** `f8e8c290636c` — 2 warning, 18 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-08-04** `9aca3802735e` — 8 info - added the optional property `agents/items/knowledge_bases/items/last_indexing_job/total_items_failed` to the response with the `200` status - added the optional property `agents/items/knowledge_bases/items/last_indexing_job/total_items_indexed` to the response with the `200` status - added the optional property `agents/items/knowledge_bases/items/last_indexing_job/total_items_skipped` to the response with the `200` status - added the optional property `agents/items/logging_config/insights_enabled` to the response with the `200` status - added the optional property `agents/items/logging_config/insights_enabled_at` to the response with the `200` status - added the optional property `agents/items/template/knowledge_bases/items/last_indexing_job/total_items_failed` to the response with the `200` status - added the optional property `agents/items/template/knowledge_bases/items/last_indexing_job/total_items_indexed` to the response with the `200` status - added the optional property `agents/items/template/knowledge_bases/items/last_indexing_job/total_items_skipped` to the response with the `200` status - **2025-07-18** `f8e8c290636c` — 2 warning, 18 info - deleted the `query` request parameter `field_mask.paths` - added the new `METRIC_VALUE_TYPE_PERCENTAGE` enum value to the `agents/items/workspace/evaluation_test_cases/items/metrics/items/metric_value_type` response property for the response status `200` - api operation id `list_agents_by_workspace` removed and replaced with `genai_list_agents_by_workspace` - the endpoint scheme security `bearer_auth` was added to the API - api tag `GradientAI Platform` added - api tag `GenAIAPI` removed - for the `query` request parameter `page`, the format was generalized from `int64` to no format - for the `query` request parameter `per_page`, the format was generalized from `int64` to no format - 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 `agents/items/conversation_logs_enabled` to the response with the `200` status - added the optional property `agents/items/logging_config` to the response with the `200` status - added the optional property `agents/items/version_hash` to the response with the `200` status - added the optional property `agents/items/workspace/evaluation_test_cases/items/dataset` to the response with the `200` status - added the optional property `agents/items/workspace/evaluation_test_cases/items/metrics/items/inverted` to the response with the `200` status - added the optional property `agents/items/workspace/evaluation_test_cases/items/metrics/items/range_max` to the response with the `200` status - added the optional property `agents/items/workspace/evaluation_test_cases/items/metrics/items/range_min` to the response with the `200` status - added the optional property `agents/items/workspace/evaluation_test_cases/items/star_metric/success_threshold` to the response with the `200` status - **2025-07-17** `5fc9af728e82` — 2 breaking, 11 warning, 10 info - for the `query` request parameter `page`, the format changed from no format to `int64` - for the `query` request parameter `per_page`, the format changed from no format to `int64` - 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 `agents/items/conversation_logs_enabled` from the response with the `200` status - removed the optional property `agents/items/logging_config` from the response with the `200` status - removed the optional property `agents/items/version_hash` from the response with the `200` status - removed the optional property `agents/items/workspace/evaluation_test_cases/items/dataset` from the response with the `200` status - removed the optional property `agents/items/workspace/evaluation_test_cases/items/metrics/items/inverted` from the response with the `200` status - removed the optional property `agents/items/workspace/evaluation_test_cases/items/metrics/items/range_max` from the response with the `200` status - removed the optional property `agents/items/workspace/evaluation_test_cases/items/metrics/items/range_min` from the response with the `200` status - removed the optional property `agents/items/workspace/evaluation_test_cases/items/star_metric/success_threshold` from the response with the `200` status - api operation id `genai_list_agents_by_workspace` removed and replaced with `list_agents_by_workspace` - the endpoint scheme security `bearer_auth` was removed from the API - api tag `GenAIAPI` added - api tag `GradientAI Platform` removed - added the new optional `query` request parameter `field_mask.paths` - 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 `agents/items/workspace/evaluation_test_cases/items/metrics/items/metric_value_type` response property for the response status `200` - **2025-07-17** `f8e8c290636c` — 2 warning, 18 info - deleted the `query` request parameter `field_mask.paths` - added the new `METRIC_VALUE_TYPE_PERCENTAGE` enum value to the `agents/items/workspace/evaluation_test_cases/items/metrics/items/metric_value_type` response property for the response status `200` - api operation id `list_agents_by_workspace` removed and replaced with `genai_list_agents_by_workspace` - the endpoint scheme security `bearer_auth` was added to the API - api tag `GradientAI Platform` added - api tag `GenAIAPI` removed - for the `query` request parameter `page`, the format was generalized from `int64` to no format - for the `query` request parameter `per_page`, the format was generalized from `int64` to no format - 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 `agents/items/conversation_logs_enabled` to the response with the `200` status - added the optional property `agents/items/logging_config` to the response with the `200` status - added the optional property `agents/items/version_hash` to the response with the `200` status - added the optional property `agents/items/workspace/evaluation_test_cases/items/dataset` to the response with the `200` status - added the optional property `agents/items/workspace/evaluation_test_cases/items/metrics/items/inverted` to the response with the `200` status - added the optional property `agents/items/workspace/evaluation_test_cases/items/metrics/items/range_max` to the response with the `200` status - added the optional property `agents/items/workspace/evaluation_test_cases/items/metrics/items/range_min` to the response with the `200` status - added the optional property `agents/items/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/agents/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/agents/get)