---
title: 'Update a subscription (blockchain or snag)'
description: 'This endpoint allows you to update a stratus subscription. Every field is optional and only the ones you send are changed — its name, website and organization, associated function IDs, callback URL, active window, and the blockchain or snag subscriptions it watches.'
openapi: POST /api/stratus/subscriptions/{id}
---

> **For AI agents:** the complete documentation index is at [llms.txt](https://docs.snagsolutions.io/llms.txt). Append `.md` to any page URL for its markdown version.

`POST /api/stratus/subscriptions/{id}` — path parameters: `id`

`POST https://admin.snagsolutions.io/api/stratus/subscriptions/{id}`

This endpoint allows you to update a stratus subscription. Every field is optional and only the ones you send are changed — its name, website and organization, associated function IDs, callback URL, active window, and the blockchain or snag subscriptions it watches.

## Authentication

- `apiKeyAuth` — apiKey in header: `X-API-KEY`

## Path parameters

- `id` (string, required)

## Request body

- Content type: `application/json`
  - request body (object)
    - `name` (string)
    - `websiteId` (string)
    - `organizationId` (string)
    - `functionIds` (array)
      - `items` (string)
    - `callbackUrl` (string, uri)
    - `startsAt` (string)
    - `endsAt` (string)
    - `blockchainSubscriptions` (array)
      - `items` (object)
        - `triggerId` (string)
        - `chainId` (number, required)
        - `contractAddress` (string, required)
        - `blockchainSubscriptionType` (string, required, one of: EVENT, FUNCTION)
        - `eventAbi` (string)
        - `functionAbi` (string)
        - `fromBlock` (string)
    - `snagSubscriptions` (array)
      - `items` (object)
        - `triggerId` (string)
        - `tableNames` (array, required)
          - `items` (string)
        - `mainLoyaltyAccountIds` (array)
          - `items` (string)

## Response 200

200
  - response (object)
    - `name` (string, required)
    - `websiteId` (string, required)
    - `organizationId` (string, required)
    - `functionIds` (array)
      - `items` (string)
    - `callbackUrl` (string, required)
    - `startsAt` (string)
    - `endsAt` (string)
    - `id` (string, required)
    - `version` (string, one of: v1, v2)
    - `signingKey` (string, required)
    - `createdAt` (string, date-time, required)
    - `updatedAt` (string, date-time, required)
    - `deletedAt` (string, date-time, required)
    - `disabled` (boolean)
    - `disabledAt` (string, date-time)
    - `disabledReason` (string)
    - `consecutiveFailures` (number)
    - `blockchainSubscriptions` (array)
      - `items` (object)
        - `id` (string, required)
        - `chainId` (number, required)
        - `contractAddress` (string, required)
        - `blockchainSubscriptionType` (string, required, one of: EVENT, FUNCTION)
        - `eventSelector` (string, required)
        - `eventAbi` (string, required)
        - `functionAbi` (string, required)
        - `fromBlock` (string, required)
        - `createdAtBlock` (string, required)
        - `createdAt` (string, date-time, required)
        - `updatedAt` (string, date-time, required)
        - `deletedAt` (string, date-time, required)
    - `snagSubscriptions` (array)
      - `items` (object)
        - `id` (string, required)
        - `table` (string, required)
        - `createdAt` (string, date-time, required)
        - `updatedAt` (string, date-time, required)
        - `deletedAt` (string, date-time, required)

## Response 400

400
  - response (object)
    - `error` (string, required)

## Response 404

404
  - response (object)
    - `error` (string, required)

## Response 500

500
  - response (object)
    - `error` (string, required)


---

📦 **OpenAPI specs:** Every OpenAPI specification referenced by this documentation is available as a single download — https://docs.snagsolutions.io/api-specs.zip