---
title: "Update File Subscription"
method: PUT
path: "/fileSubscription/{subscriptionKey}"
tags: ["File Subscriptions"]
---

# Update File Subscription

`PUT /fileSubscription/{subscriptionKey}`

## Request

- Base URL: `https://eu-west-1.api.silverflow.com/v1`
- URL: `https://eu-west-1.api.silverflow.com/v1/fileSubscription/{subscriptionKey}`
- Auth: one of:
  - HTTP basic
  - HTTP bearer
- TypeScript: <https://skmtc.dev/silverflow/apis/silverflow-api/docs/fileSubscription/:subscriptionKey/put.ts> (a function with typed inputs; its response is checked against the schema)

Updates an existing subscription.

Note: Distributions configured for email deliveries are not supported.

Requires the `fileSubscription:Update` permission.

## Path parameters

- `subscriptionKey` string, required: The key of a subscription.

## Request body

- UpdateFileSubscriptionRequest
  - `acquirerReferences` string[], required: Network-specific references for file routing. The type of reference required depends on the card network: | Card Network | Required Value | BIN Object Field | |-------------------|----------------|----------------------| | American Express | Submitter ID | acquirerIdCode | | Visa | Acquirer BIN | acquirerBin | | Mastercard | Acquirer BIN | acquirerBin | | Discover | Acquirer BIN | acquirerBin | These references are used to match incoming card network files to subscriptions.
  - `distributionKey` string, required: Key of the distribution where files will be sent.
  - `fileTypes` string[], required: List of card network file types to subscribe to. Each file type represents a specific format of raw data files from different card networks.

## Response `200`

The updated file subscription

- FileSubscription
  - `subscriptionKey` string, required: The key of a subscription.
  - `agentKey` string, required: The key of an agent.
  - `acquirerReferences` string[], required: Network-specific references for file routing. The type of reference required depends on the card network: | Card Network | Required Value | BIN Object Field | |-------------------|----------------|----------------------| | American Express | Submitter ID | acquirerIdCode | | Visa | Acquirer BIN | acquirerBin | | Mastercard | Acquirer BIN | acquirerBin | | Discover | Acquirer BIN | acquirerBin | These references are used to match incoming card network files to subscriptions.
  - `distributionKey` string, required: Key of the distribution where files will be sent.
  - `fileTypes` string[], required: List of card network file types to subscribe to. Each file type represents a specific format of raw data files from different card networks.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `500`: Internal Server Error

---

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