---
title: "What this portal can synchronise"
method: GET
path: "/disk.sync.capabilities.get"
tags: ["disk"]
---

# What this portal can synchronise

`GET /disk.sync.capabilities.get`

The first call a client makes, and the one every later call is planned against.

Nothing here depends on who is asking: the answer describes the portal, not the caller, and
the method reads nothing the caller owns. What it publishes is the schema version, the
vocabulary of entities and of changes, the page ceilings, how long the journal of changes
keeps a record, how long an interaction keeps an object in sight, and the three polling
steps - the shortest one allowed, the recommended one and the longest one still accepted.

`interactionWindowDays` is the one number that is about the memory of the portal rather than
about the journal. An object a user only ever touched - opened through a link, or reached
through an attachment of another module - is theirs to see while the window lasts, and is
announced as a tombstone once it runs out. Nothing happened to such an object; the portal
stopped counting the interaction as a reason to show it.

The numbers are not constants of the product. A portal may shorten the life of its journal,
and the polling bounds move with it, so a client that stores them once and never asks again
will eventually plan against bounds the portal no longer honours. Ask on every start of a
synchronisation cycle.

`cardSections` names every section the schema declares and says, for each, whether this
portal fills it. A section published as `false` is refused when it is asked for rather than
answered empty: an empty section would be indistinguishable from "nothing is there".

## Response `200`

The answer of the method.

- object
  - `result` object
    - `item` BitrixDiskCapabilitiesdto
      - `schemaVersion` integer
      - `entityTypes` unknown[]
        - unknown
      - `changeTypes` unknown[]
        - unknown
      - `pageSizeMax` integer
      - `pageSizeMaxHeavy` integer
      - `journalRetentionDays` integer
      - `interactionWindowDays` integer
      - `safeWindowSeconds` integer
      - `pollIntervalMinSeconds` integer
      - `pollIntervalRecommendedSeconds` integer
      - `pollIntervalMaxSeconds` integer
      - `cardSections` unknown[]
        - unknown
      - `changeNotificationSupported` boolean

## Other responses

- `400` — FEATURE_NOT_SUPPORTED, BITRIX_REST_V3_EXCEPTION_VALIDATION_REQUESTVALIDATIONEXCEPTION
- `429` — BITRIX_REST_V3_EXCEPTION_RATELIMITEXCEPTION

## Changes

- **2026-09-29** `f6be0a558c33` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/bitrix24/apis/bitrix24-rest-v3-api/changes/disk.sync.capabilities.get/get.md)

---

[API](https://skmtc.dev/bitrix24/apis/bitrix24-rest-v3-api.md) · [All operations](https://skmtc.dev/bitrix24/apis/bitrix24-rest-v3-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bitrix24/apis/bitrix24-rest-v3-api/revisions/f6be0a558c33?raw)