---
title: "List workspace children"
method: GET
path: "/workspaces/{workspaceId}/children"
tags: ["workspaces"]
---

# List workspace children

`GET /workspaces/{workspaceId}/children`

Retrieves a paginated list of immediate child resources within a specified workspace.

**Key Characteristics**

- **Shallow representation:** It returns metadata for the direct children only, rather than the full content or nested sub-structures.
- **Filtered by type:** The results are restricted to the resource types defined in the `childrenResourceTypes` query parameter.
- **Paginated:** The response provides a page of results, implying that for large workspaces, multiple requests may be necessary to view all children.

> **Note:** For pagination guidance, refer to [Token-based pagination](/api/smartsheet/guides/basics/pagination#token-based-pagination).

## Query parameters

- `childrenResourceTypes` 'sheets' | 'reports' | 'sights' | 'folders' | 'templates'
- `include` 'source' | 'ownerInfo'
- `numericDates` boolean
- `accessApiLevel` number
- `lastKey` string
- `maxItems` integer

## Response `200`

An array of asset references with a pagination token if there are more results.

- PaginatedChildrenResponse — Paginated response object containing an array of asset references. Call again with the `lastKey` query parameter to retrieve the next page of results.
  - `data` union[], required — Array of assets of the requested type in this folder.
    - union
      - PaginatedChildrenListItem
        - `id` integer, required — Resource ID.
        - `name` string, required — Resource name.
        - `permalink` string, uri, required — URL to the resource in Smartsheet.
        - `createdAt` union, required
          - string, date-time
          - integer
        - `modifiedAt` union, required
          - string, date-time
          - integer
        - `accessLevel` 'ADMIN' | 'COMMENTER' | 'EDITOR' | 'EDITOR_SHARE' | 'OWNER' | 'VIEWER', required
        - `resourceType` 'sheet' | 'report' | 'sight' | 'template', required — The type of the child resource
      - PaginatedFolderListItem
        - `id` integer, required — Resource ID.
        - `name` string, required — Resource name.
        - `permalink` string, uri, required — URL to the resource in Smartsheet.
        - `createdAt` union, required
          - string, date-time
          - integer
        - `modifiedAt` union, required
          - string, date-time
          - integer
        - `resourceType` 'folder', required — The type of the resource
  - `lastKey` string — A token that is used to retrieve the next page of results when passed as the `lastKey` query parameter. This value will be absent when there are no further pages.

## Other responses

- `400` — Bad Request. See Smartsheet Error Code and Message for details.
- `404` — Not Found. See Smartsheet Error Code and Message for details.
- `500` — Internal Server Error. See Smartsheet Error Code and Message for details.
- `503` — Service Unavailable. See Smartsheet Error Code and Message for details.

---

[API](https://skmtc.net/smartsheet/apis/smartsheet-openapi-reference.md) · [All operations](https://skmtc.net/smartsheet/apis/smartsheet-openapi-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartsheet/smartsheet-openapi-reference/versions/b4afda95fb51/schema)