---
title: "List synced folders"
method: GET
path: "/v1/media-sync"
tags: ["media-sync"]
---

# List synced folders

`GET /v1/media-sync`

## Request

- Base URL: `https://api.brixsignage.com`
- URL: `https://api.brixsignage.com/v1/media-sync`
- Auth: HTTP bearer

Return the workspace's synced folders, including the remote path, the destination folder in Brix, the connected account, sync status, the last error, the last check time, and the number of files synced. Only folders connected at locations where the caller holds the integration view permission are returned.

## Response `200`

Success.

- object
  - `data` object[], required
    - `id` string, required
    - `provider` string, required: `onedrive` or `sharepoint`.
    - `remotePath` string, required
    - `folderId` string, required: The library folder the files land in.
    - `folderName` string, nullable, required
    - `accountLabel` string, nullable, required
    - `accountConnected` boolean, required: False when the connected account was removed: syncing stops until it is connected again.
    - `status` 'ok' | 'error' | 'paused', required
    - `lastError` string, nullable, required
    - `lastSyncAt` string, nullable, required: ISO-8601 timestamp (UTC).
    - `itemsSynced` integer, required
    - `createdAt` string, required: ISO-8601 timestamp (UTC).
    - `updatedAt` string, required: ISO-8601 timestamp (UTC).

## Other responses

- `401`: Missing, expired or revoked bearer token.
- `403`: The token lacks the permission this operation needs (see `x-brix-permission`).
- `5XX`: Server error. The body carries a `requestId` to quote to support.

---

[API](https://skmtc.dev/brixsignage/apis/brix-api.md) · [All operations](https://skmtc.dev/brixsignage/apis/brix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/brixsignage/apis/brix-api/revisions/7c2741bcdb16?raw)