Blockchain Notifications
Delete a Subscription

Delete a subscription

Stops delivery for a subscription.

DELETE
https://api-prod.useknit.io/api/v1/blockchain-notifications/subscriptions/{id}
Scopeblockchain-notifications:writeAuthBearer token

The subscription record is retained with isActive: false rather than being erased, so it still appears in List subscriptions. If you may want to resume later, prefer setting isActive to false — that is reversible.

Path parameters

idstringrequired

The subscription's id.

Request

cURL
curl -X DELETE "https://api-prod.useknit.io/api/v1/blockchain-notifications/subscriptions/3f6f9d1a-64b2-4c7f-9a1e-7a2f0c8c7e11" \
  -H "Authorization: Bearer $KNIT_ACCESS_TOKEN" \
  -H "Accept: application/json"

Response

200 OK
{
  "statusCode": 200,
  "message": "Address notification subscription deleted",
  "data": null,
  "success": true
}

Errors

StatusCause
401Missing or invalid token, IP not allow-listed, or missing blockchain-notifications:write
404No subscription with that ID belongs to your business