---
title: "Capabilities of an agentic sync, and which your consumers are offered"
method: GET
path: "/syncs/{syncid}/capabilities"
tags: ["Syncs"]
---

# Capabilities of an agentic sync, and which your consumers are offered

`GET /syncs/{syncid}/capabilities`

## Request

- Base URL: `https://api.chift.eu`
- URL: `https://api.chift.eu/syncs/{syncid}/capabilities`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/chift/apis/chift-api/docs/syncs/:syncid/capabilities/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists what the sync can do and whether your account offers it to its consumers. Whether a capability is available depends on each consumer's connections, so it is not reported here: read it from the consumer's capabilities.

## Path parameters

- `syncid` string, uuid, required

## Query parameters

- `language` string, nullable: ISO 639-1 code of the language of the texts (en, fr, nl, de, es; any case), falling back to English. Without it, translation keys.

## Response `200`

Successful Response

- SyncCapabilities: What the account offers its consumers. Whether a capability is available depends on each consumer's connections.
  - `capabilities` SyncCapabilityItem[], required: Every capability of the sync, offered or not.
    - `key` string, required: Stable key, e.g. 'spend_to_accounting.SupplierInvoices'. Send it back as is.
    - `id` string, uuid, required: The stable uuid derived from the key, as the legacy sync routes identify the same item.
    - `title` string, required: Name to show, in the requested language; its translation key without one.
    - `description` string, required: What it does, the tooltip: in the requested language, its translation key without one.
    - `kind` 'main' | 'supporting', required: 'main': the consumer chooses it. 'supporting': shown as a tooltip, turned on by what needs it.
    - `offered` boolean, required: Whether your consumers can use it. A capability not offered is absent for them.
    - `default_mode` string, nullable, required: The mode preselected on a consumer's screen when it can choose between several; the consumer still chooses it. Null when none is set.
    - `modes` SyncCapabilityMode[], required: The alternative ways of doing it. Empty when there is only one.
      - `key` string, required: Key of the mode.
      - `title` string, required: Name to show, in the requested language; its translation key without one.
      - `description` string, required: What it does, the tooltip: in the requested language, its translation key without one.
  - `cron` string, nullable, required: When the sync runs for each consumer that enabled it, as a cron expression. Null: it runs only when started by hand.

## Other responses

- `404`: Not Found
- `422`: Validation Error

## Changes

- **2026-11-03** `020884969534`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/chift/apis/chift-api/changes/syncs/:syncid/capabilities/get.md)

---

[API](https://skmtc.dev/chift/apis/chift-api.md) - [All operations](https://skmtc.dev/chift/apis/chift-api/llms.txt) - [OpenAPI document](https://skmtc.dev/chift/apis/chift-api/revisions/020884969534?raw)