---
search:
  tags:
    - offline-sync
    - POST
seo:
  description: >-
    Enable or disable a matter subscription for the authenticated device.
    Reference for the POST /api/v1/sync/subscriptions endpoint in the Basenet
    Public API.
sidebar:
  label: Enable or disable a matter subscription for the authenticated device
  badge: POST
title: Enable or disable a matter subscription for the authenticated device
type: openapi-operation
---
Endpoint: `POST /api/v1/sync/subscriptions`

Authentication: `bearerAuth` (Scoped API token (bnx\_…). Required scopes are noted per operation.)

Request body (`application/json`):
- `matterId` (string, required)
- `enabled` (boolean, required)

Responses:
- `200`: Subscription state and selected contract version
- `400`: Invalid request
- `401`: Unauthenticated
- `403`: Forbidden (missing scope or permission)
- `429`: Rate limited

Response 200 body (`application/json`):
- `contractVersion` (one of `"v1"`, required)
- `matterId` (string, required)
- `enabled` (boolean, required)