Revoke a hub subscription

Soft-deletes the tenant’s subscription. Idempotent: revoking an already-revoked subscription succeeds.

DELETE /v1/subscriptions/{id}

Revoke a hub subscription

cURL

curl --request DELETE \
  --url https://br-consignado-gw.sandbox.lerian.net/v1/subscriptions/{id} \
  --header 'Authorization: Bearer <token>'

default

{
  "code": "ERR-0001",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

Autorizaciones

Authorization · string · header · requerido

JWT bearer token issued by the identity provider.

Encabezados

Authorization · string

Bearer token, relayed to the streaming-hub as server-to-server auth.

X-Idempotency · string

Idempotency key, forwarded to the hub's idempotency middleware.

Parámetros de ruta

id · string · requerido

Subscription id.

Respuesta

204

No Content