PATCH
/
v1
/
indexer
/
subscriptions
/
{subscriptionId}
Update subscription
curl --request PATCH \
  --url https://api.withconvexity.com/v1/indexer/subscriptions/{subscriptionId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "webhookUrl": "https://api.merchant.example/webhooks/indexer-v2",
  "events": [
    "transfer"
  ],
  "status": "paused"
}
'
{
  "status": true,
  "message": "Indexer subscription updated",
  "data": {
    "id": "665f1a2b3c4d5e6f7a8b9c0d",
    "projectId": "proj_9f8e7d6c5b4a",
    "network": "BASE",
    "contractAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "webhookUrl": "https://api.merchant.example/webhooks/indexer-v2",
    "events": [
      "transfer"
    ],
    "status": "paused",
    "createdBy": "proj_9f8e7d6c5b4a",
    "createdAt": "2026-06-17T09:12:44.118Z",
    "updatedAt": "2026-06-17T11:30:09.882Z",
    "lastDeliveryAt": "2026-06-17T10:01:02.557Z",
    "deliveredCount": 42,
    "failedCount": 1
  }
}

Authorizations

Authorization
string
header
required

OAuth 2.0 access token from Auth-Edge.

Path Parameters

subscriptionId
string
required

Subscription id.

Body

application/json
webhookUrl
string<uri>

New HTTPS URL.

events
string[]

Replacement event keys (≥1).

status
enum<string>

Use Delete for removal.

Available options:
active,
paused

Response

OK

The response is of type object.