---
title: "Update subscription by id"
method: PUT
path: "/subscriptions/{subscriptionId}"
tags: ["subscriptions"]
---

# Update subscription by id

`PUT /subscriptions/{subscriptionId}`

Updates an existing subscription.

You can modify:
- The technical contact email address
- The list of topics this subscription is listening for

Note that you cannot update the consumer URL after creation. If you need to change the URL, 
you must delete this subscription and create a new one.

## Path parameters

- `subscriptionId` string, uuid, required

## Request body

- SubscriptionBodyPut
  - `technicalContact` string, email — Updated email address for technical contact. - Used for notifications about subscription status changes - Used for troubleshooting communication - Should be monitored regularly
  - `topicNames` string[] — A collection of topic names to subscribe to. - Must contain at least one valid topic name - Each topic name must be a string matching an available topic - Use GET /topics to retrieve the list of available topics

## Response `204`

The resource was updated successfully.

## Other responses

- `400` — Bad Request - The server cannot process the request due to a client error. Common causes: - Invalid request format - Missing required fields - Validation errors in the request data
- `401` — Unauthorized - Authentication is required or has failed. Common causes: - Missing API key - Invalid API key - Expired or deactivated API key
- `404` — Not Found - The requested resource does not exist. Common causes: - Invalid subscription ID - Subscription has been deleted - URL path contains typos or incorrect values
- `412` — Precondition Failed - The request cannot be completed due to failed preconditions. Common causes: - Attempting to update a subscription with invalid topic names - Trying to create a subscription with an invalid URL - Validation errors specific to the operation

---

[API](https://skmtc.net/acculynx/apis/acculynx-api-v2.md) · [All operations](https://skmtc.net/acculynx/apis/acculynx-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/acculynx/acculynx-api-v2/versions/3a9e3886e400/schema)