---
title: "Update a persistant subscription"
method: POST
path: "/subscriptions/{stream}/{subscription}"
tags: ["Subscriptions"]
---

# Update a persistant subscription

`POST /subscriptions/{stream}/{subscription}`

You can edit the settings of an existing subscription while it is running. This will drop the current subscribers and will reset the subscription internally.

## Path parameters

- `stream` string, required
- `subscription` string, required

## Request body

- SubscriptionItem
  - `ResolveLinkTos` boolean — Whether to resolve link events.
  - `startFrom` integer — Which event position in the stream the subscription should start from.
  - `extraStatistics` boolean — Whether to track latency statistics on this subscription.
  - `checkPointAfterMilliseconds` integer — The amount of time to try to checkpoint after.
  - `liveBufferSize` integer — The size of the buffer (in-memory) listening to live messages as they happen before paging occurs.
  - `readBatchSize` integer — The number of events to read per batch when reading the history.
  - `bufferSize` integer — The number of events to cache when paging through history.
  - `maxCheckPointCount` integer — The maximum number of messages not checkpointed before forcing a checkpoint.
  - `maxRetryCount` integer — The maximum number of retries (due to timeout) before a message is considered to be parked.
  - `maxSubscriberCount` integer — The maximum number of TCP subscribers allowed.
  - `messageTimeoutMilliseconds` integer — The amount of time after which to consider a message as timedout and retried.
  - `minCheckPointCount` integer — The minimum number of messages to write to a checkpoint.
  - `namedConsumerStrategy` 'RoundRobin' | 'DispatchToSingle' | 'Pinned' — The strategy to use for distributing events to client consumers.

## Response `200`

Subscription updated

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found

---

[API](https://skmtc.net/kurrent-io/apis/http-api.md) · [All operations](https://skmtc.net/kurrent-io/apis/http-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kurrent-io/http-api/revisions/b7fd712e809c/schema)