> ## Documentation Index
> Fetch the complete documentation index at: https://api.csboard.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PUT /v1/account/sources_off — выключить поставщиков

> Заменить список номеров поставщиков, выключенных для вашего аккаунта.

Заменяет список поставщиков, выключенных для вашего аккаунта. Каждый раз отправляйте список целиком: присланные номера выключены, все остальные включены. Пустой массив включает всех обратно.

Изменение действует со следующего запроса. Оно применяется к листингам, глубине, ценам, обоим снапшотам и потоку. Номера берите из [`GET /v1/sources`](https://api.csboard.com/ru/api-reference/get-sources).

> [!NOTE]
>
> Это фильтр того, что вам показывают, а не запрет покупки. Id листинга, отправленный в `POST /v1/orders`, покупается независимо от поставщика.

**Требуется аутентификация.** Передавайте ключ как `Authorization: Bearer csb_pub_...`.

## Тело запроса

**sources\_off** `integer[]` *required*

Номера поставщиков, которых нужно выключить. Номер, которого нет в использовании, отклоняется, чтобы опечатка не выключила «ничего» незаметно.

## После изменения

* **Поток.** Соединение живёт со списком, с которым было открыто. Переподключитесь, чтобы применить новый, и удалите из своей копии листинги выключенных поставщиков: их `gone` не придёт.
* **Снапшоты.** Снапшот листингов собирается под каждый список. Список, которым ещё никто не пользовался, отвечает `202 snapshot_building`, пока файл не готов.

## Пример запроса

```bash theme={null}
curl -X PUT "https://csboard.com/v1/account/sources_off" \
  -H "Authorization: Bearer csb_pub_..." \
  -H "Content-Type: application/json" \
  -d '{ "sources_off": [107, 113] }'
```

## Пример ответа

```json theme={null}
{
  "data": {
    "sources_off": [107, 113]
  }
}
```

## Коды ошибок

| HTTP-статус | Код | Значение |
| - | - | - |
| 400 | `invalid_request` | `sources_off` отсутствует, не является массивом целых чисел или содержит номер, которого нет в использовании. |
| 401 | `missing_api_key`, `invalid_api_key` | Ключ отсутствует или недействителен. |


## OpenAPI

````yaml PUT /account/sources_off
openapi: 3.1.0
info:
  title: CSBoard API
  version: 1.0.0
  description: >-
    Market data over the CSBoard marketplace — live listings, floats, stickers,
    minAsk prices, FX rates — plus opt-in buying straight from your balance.
    Free to read, key-gated, built for automation.
  contact:
    name: CSBoard
    url: https://csboard.com/docs
servers:
  - url: https://csboard.com/v1
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Status
    description: Liveness and freshness probes.
  - name: Market data
    description: Read the live catalog, prices, and FX rates.
  - name: Trading
    description: Buy listings from your CSBoard balance. Opt-in, key-gated.
  - name: Instant Sell
    description: >-
      Sell CS2, Dota 2 and Rust items from any Steam inventory to the CSBoard
      network and get paid to your balance. Invite-only.
  - name: P2P
    description: >-
      List your own CS2 skins on the CSBoard P2P market. Free — any valid key,
      no balance requirement.
  - name: Merchant lots
    description: >-
      List items that sit in your own Steam accounts, take an order call when
      one sells, report the trade yourself. Off until we switch it on for your
      account. See the Merchant Lots guide.
  - name: Account
    description: Your balance, settled funds, and trading status.
  - name: Webhooks
    description: Register an endpoint and receive signed order updates instead of polling.
paths:
  /account/sources_off:
    put:
      tags:
        - Account
      summary: Replace the list of suppliers switched off
      description: >-
        Replaces the list: the numbers you send are off, everything else is on;
        an empty array switches every supplier back on. Takes effect on your
        next request. A filter on what you are shown, not a block on buying: a
        listing id sent to `POST /orders` is bought whatever its supplier. An
        open stream connection keeps the list it was opened with.
      operationId: putAccountSourcesOff
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - sources_off
              properties:
                sources_off:
                  type: array
                  items:
                    type: integer
                  description: >-
                    Supplier numbers to switch off, from `GET /sources`. A
                    number that is not in use is refused.
            example:
              sources_off:
                - 107
                - 113
      responses:
        '200':
          description: Saved.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    required:
                      - sources_off
                    properties:
                      sources_off:
                        type: array
                        items:
                          type: integer
                        description: >-
                          Supplier numbers switched off for this account,
                          ascending. Empty = every supplier is on.
              example:
                data:
                  sources_off:
                    - 107
                    - 113
        '400':
          description: >-
            `invalid_request`: `sources_off` is missing, is not an array of
            integers, or names a number that is not in use.
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/RateLimited'
components:
  responses:
    Unauthorized:
      description: Missing or invalid API key (`missing_api_key` or `invalid_api_key`).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            code: missing_api_key
            detail: >-
              Provide your API key via `Authorization: Bearer csb_pub_…`.
              Generate one at https://csboard.com/profile?tab=api
    RateLimited:
      description: >-
        A per-key limit is spent. The key's own buckets answer
        `rate_limit_exceeded` with `bucket` (`read`, `trading` or `buy_orders`),
        `limit_per_min` and `retry_after_sec`. `Retry-After` is the seconds left
        until the one-minute window restarts (1–60), not a flat 60.
        Endpoint-specific limits (`snapshot_rate_limited` on the price snapshot,
        `rate_limited` on Instant Sell) send only `code` and `detail`.
      headers:
        Retry-After:
          description: >-
            Seconds until the one-minute window restarts (1–60). Waiting that
            long is always enough.
          schema:
            type: integer
        X-RateLimit-Limit:
          $ref: '#/components/headers/X-RateLimit-Limit'
        X-RateLimit-Remaining:
          $ref: '#/components/headers/X-RateLimit-Remaining'
        X-RateLimit-Reset:
          $ref: '#/components/headers/X-RateLimit-Reset'
        X-RateLimit-Bucket:
          $ref: '#/components/headers/X-RateLimit-Bucket'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/RateLimitError'
          example:
            code: rate_limit_exceeded
            detail: >-
              Read rate limit of 100 requests/min exceeded. The counter restarts
              in 23 s. For new listings use GET /v1/listings/stream instead of
              polling.
            bucket: read
            limit_per_min: 100
            retry_after_sec: 23
  schemas:
    Error:
      type: object
      description: >-
        All errors return { code, detail }. Some carry extra fields (e.g.
        price_moved adds current_total_usd, insufficient_balance adds
        required_usd/current_usd, item_unavailable adds unavailable_ids and, on
        CS2 buys, unknown_ids).
      properties:
        code:
          type: string
          description: >-
            Machine-readable error code, e.g. rate_limit_exceeded,
            trading_not_enabled, price_moved.
        detail:
          type: string
          description: Human-readable explanation.
      required:
        - code
    RateLimitError:
      type: object
      description: >-
        The `429` body of a per-key bucket. Endpoint-specific limits send only
        `code` and `detail`.
      properties:
        code:
          type: string
          description: >-
            `rate_limit_exceeded` for the key's buckets. Endpoint-specific
            limits use their own code (`snapshot_rate_limited`, `rate_limited`).
        detail:
          type: string
          description: Human-readable explanation.
        bucket:
          type: string
          enum:
            - read
            - trading
            - buy_orders
          description: Which bucket is spent.
        limit_per_min:
          type: integer
          description: That bucket's ceiling per minute.
        retry_after_sec:
          type: integer
          minimum: 1
          maximum: 60
          description: >-
            Seconds until the window restarts — the same number as
            `Retry-After`.
      required:
        - code
  headers:
    X-RateLimit-Limit:
      description: >-
        The ceiling per minute of the bucket this call spent (named in
        `X-RateLimit-Bucket`).
      schema:
        type: integer
      example: 3000
    X-RateLimit-Remaining:
      description: Calls left on that bucket in the current one-minute window.
      schema:
        type: integer
        minimum: 0
      example: 2987
    X-RateLimit-Reset:
      description: >-
        Seconds until the one-minute window restarts and the counter starts
        again.
      schema:
        type: integer
        minimum: 1
        maximum: 60
      example: 41
    X-RateLimit-Bucket:
      description: >-
        The bucket this call spent: `read` (reads and every other keyed call) or
        `trading` (buys, order reads, claims, cancels, balance). A `429` from
        the buy-order limit says `buy_orders`.
      schema:
        type: string
        enum:
          - read
          - trading
          - buy_orders
      example: trading
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Send your key as a Bearer token on every request: `Authorization: Bearer
        csb_pub_...`. Generate keys in your CSBoard profile. Calls made with a
        key are metered only by that key's own limits — there is no per-IP limit
        on top — and every answer carries `X-RateLimit-Limit`,
        `X-RateLimit-Remaining`, `X-RateLimit-Reset` and `X-RateLimit-Bucket`
        for the bucket the call spent. See [Rate limits](/rate-limits).

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.