---
title: "Get assets workspaces"
method: GET
path: "/rest/servicedeskapi/assets/workspace"
tags: ["Assets"]
---

# Get assets workspaces

`GET /rest/servicedeskapi/assets/workspace`

## Request

- Base URL: `https://your-domain.atlassian.net`
- URL: `https://your-domain.atlassian.net/rest/servicedeskapi/assets/workspace`
- Auth: OAuth 2
  - Authorization code: `https://auth.atlassian.com/authorize`
  - Token URL: `https://auth.atlassian.com/oauth/token` scopes: `read:servicedesk-request`

Returns a list of Assets workspace IDs. Include a workspace ID in the path to access the [Assets REST APIs](https://developer.atlassian.com/cloud/assets/rest).

**[Permissions](#permissions) required**: Any

## Query parameters

- `start` integer
- `limit` integer

## Response `200`

Returned if the request is successful.

- PagedDTOAssetsWorkspaceDTO
  - `_expands` string[]
  - `_links` PagedLinkDTO
    - `base` string, uri: Base URL for the REST API calls.
    - `context` string
    - `next` string, uri: REST API URL for the next page, if there is one.
    - `prev` string, uri: REST API URL for the previous page, if there is one.
    - `self` string, uri: REST API URL for the current page.
  - `isLastPage` boolean: Indicates if this is the last page of records (true) or not (false).
  - `limit` integer: Number of items to be returned per page, up to the maximum set for these objects in the current implementation.
  - `size` integer: Number of items returned in the page.
  - `start` integer: Index of the first item returned in the page.
  - `values` AssetsWorkspaceDTO[]: Details of the items included in the page.
    - `workspaceId` string: The workspace ID used as the identifier to access the Assets REST API.

## Other responses

- `401`: Returned if the authentication credentials are incorrect or missing.
- `403`: Returned if the user does not have the necessary permission.
- `500`: Internal Server Error.

## Changes

> 20 revisions in range; 3 not diffed.

- **2024-02-08** `7c79c3ffe305`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/atlassian/apis/service-management-public-rest-api/changes/rest/servicedeskapi/assets/workspace/get.md)

---

[API](https://skmtc.dev/atlassian/apis/service-management-public-rest-api.md) - [All operations](https://skmtc.dev/atlassian/apis/service-management-public-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/atlassian/apis/service-management-public-rest-api/revisions/fe02b1260fc7?raw)