---
title: "Retrieve Groups"
method: GET
path: "/filestorage/groups/{id}"
tags: ["filestorage/groups"]
---

# Retrieve Groups

`GET /filestorage/groups/{id}`

Retrieve Groups from any connected Filestorage software

## Path parameters

- `id` string, required

## Query parameters

- `remote_data` boolean

## Headers

- `x-connection-token` string, required

## Response `200`

- UnifiedFilestorageGroupOutput
  - `name` string, nullable, required — The name of the group
  - `users` union[], required — Uuids of users of the group
    - union
      - string
      - UnifiedFilestorageUserOutput
        - `name` string, nullable, required — The name of the user
        - `email` string, nullable, required — The email of the user
        - `is_me` boolean, nullable, required — Whether the user is the one who linked this account.
        - `field_mappings` object, nullable — The custom field mappings of the object between the remote 3rd party & Panora
        - `id` string, nullable — The UUID of the user
        - `remote_id` string, nullable — The id of the user in the context of the 3rd Party
        - `remote_data` object, nullable — The remote data of the user in the context of the 3rd Party
        - `created_at` string, date-time, nullable — The created date of the object
        - `modified_at` string, date-time, nullable — The modified date of the object
  - `remote_was_deleted` boolean, nullable, required — Indicates whether or not this object has been deleted in the third party platform.
  - `field_mappings` object, nullable — The custom field mappings of the object between the remote 3rd party & Panora
  - `id` string, nullable — The UUID of the group
  - `remote_id` string, nullable — The id of the group in the context of the 3rd Party
  - `remote_data` object, nullable — The remote data of the group in the context of the 3rd Party
  - `created_at` string, date-time, nullable — The created date of the object
  - `modified_at` string, date-time, nullable — The modified date of the object

## Changes

- **2024-08-06** `6502b0fa098c` — 2 breaking
  - added `#/components/schemas/UnifiedFilestorageUserOutput, subschema #1` to the `users/items/` response property `oneOf` list for the response status `200`
  - the `users/items/` response's property type/format changed from `string`/`` to ``/`` for status `200`
- **2024-08-05** `ca213ae36b7f` — 14 breaking, 1 info
  - the response property `created_at` became nullable for the status `200`
  - the response property `field_mappings` became nullable for the status `200`
  - the response property `id` became nullable for the status `200`
  - the response property `modified_at` became nullable for the status `200`
  - …11 more
- **2024-08-05** `167edd5346ec` — 2 breaking, 5 info
  - the `created_at` response's property type/format changed from `string`/`date-time` to `object`/`` for status `200`
  - the `modified_at` response's property type/format changed from `string`/`date-time` to `object`/`` for status `200`
  - the endpoint scheme security `bearer` was added to the API
  - the response property `created_at` became required for the status `200`
  - …3 more
- **2024-08-03** `9d25bd589fe9` — 14 breaking
  - the response property `created_at` became nullable for the status `200`
  - the response property `field_mappings` became nullable for the status `200`
  - the response property `id` became nullable for the status `200`
  - the response property `modified_at` became nullable for the status `200`
  - …10 more
- …earlier changes not shown

[Full history](https://skmtc.dev/panoratech/apis/panora-api-2/changes/filestorage/groups/:id/get.md)

---

[API](https://skmtc.dev/panoratech/apis/panora-api-2.md) · [All operations](https://skmtc.dev/panoratech/apis/panora-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/panoratech/panora-api-2/revisions/ef360d76c658/schema)
