Mutation

updateWebhookSubscription

Partial-update a webhook subscription.

MCP: updateWebhookSubscription

Arguments

Object, input and enum types open in place — use + to reveal their fields. A type that is already open above the row stops at a ↻ circular marker, and anything nested past the depth limit links out to its own page instead.

id ID! required: UUID of the subscription to update.
input UpdateWebhookSubscriptionInput! required: Partial-update input. Only provided fields are updated.
eventTypes [String!]: Event types. When provided, replaces the existing list.
metadata JSON: Opaque metadata. When provided, replaces it (max 4KB serialized).
name String: Display name. When provided, replaces the existing name.
status WebhookSubscriptionStatus: Pause (DISABLED_BY_USER) or resume (ACTIVE) the subscription. DISABLED_BY_FAILURES is system-owned and rejected.
ACTIVE: The subscription is active and receives matching events.
DISABLED_BY_FAILURES: The subscription was disabled by the system after sustained delivery failures (a 410 Gone, 20 consecutive exhausted deliveries, or 3 days of continuous failure). Re-enable it with the enableWebhookSubscription mutation.
DISABLED_BY_USER: The subscription was paused by the workspace and delivers nothing until re-enabled.
url String: HTTPS endpoint. When provided, re-validated against SSRF ranges.
viewIds [ID!]: Content-view UUIDs. When provided, replaces the list (re-checked for ownership and the tier cap). Required while any subscribed event type is view-scoped (every v1 type); must be empty for non-view types. Changing eventTypes re-checks this against the resulting combination.

Returns

userErrors [UserError!]!: List of user-facing validation errors. Empty on success.
field [String!]: Path to the input field that caused the error.
message String!: The error message.
webhookSubscription WebhookSubscription: The updated subscription. Null on failure or when not found.
consecutiveFailures Int!: Consecutive failed deliveries since the last success. Resets to 0 on the next successful delivery.
createdAt DateTimeWithZone!: When the subscription was created.
disabledAt DateTimeWithZone: When the subscription was disabled by failures. Null while active/paused.
eventTypes [String!]!: Event types this subscription matches (e.g. content_view.item_added).
id ID!: Unique identifier of the subscription.
lastSuccessAt DateTimeWithZone: When the most recent successful delivery occurred. Null if none yet.
metadata JSON!: Opaque JSON object echoed back verbatim as subscription_metadata on every delivery envelope.
name String!: Display name of the subscription.
status WebhookSubscriptionStatus!: Current lifecycle status. ACTIVE delivers; DISABLED_BY_USER is a manual pause; DISABLED_BY_FAILURES is a system auto-disable triggered by a 410 Gone, 20 consecutive exhausted deliveries, or 3 days of continuous failure; re-enable with enableWebhookSubscription.
ACTIVE: The subscription is active and receives matching events.
DISABLED_BY_FAILURES: The subscription was disabled by the system after sustained delivery failures (a 410 Gone, 20 consecutive exhausted deliveries, or 3 days of continuous failure). Re-enable it with the enableWebhookSubscription mutation.
DISABLED_BY_USER: The subscription was paused by the workspace and delivers nothing until re-enabled.
updatedAt DateTimeWithZone!: When the subscription was last updated.
url String!: HTTPS endpoint deliveries are POSTed to.
viewIds [ID!]!: Content View (FilterPreset) UUIDs whose newly matching items trigger deliveries.

Open in explorer ↗

Values are sampled from a demo workspace — substitute your own token and workspace id.

Partial-update a subscription — only the fields you send change. Setting status to DISABLED_BY_USER is how you pause deliveries without deleting the subscription.

query.graphql

mutation UpdateWebhookSubscriptionDefault($id: ID!, $input: UpdateWebhookSubscriptionInput!) {
  updateWebhookSubscription(id: $id, input: $input) {
    webhookSubscription {
      id
      name
      url
      status
      metadata
    }
    userErrors {
      field
      message
    }
  }
}

variables.json

{
  "id": "eb418e28-bf9d-5350-b87b-446a6813bca4",
  "input": {
    "name": "Northwind Order Fulfilment (paused)",
    "status": "DISABLED_BY_USER"
  }
}

Headers

Authorization: Bearer docs_demo_token_0000000000000000000000
WORKSPACE-ID: 6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a

Request · cURL

curl https://app.archive.com/api/v2 \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer docs_demo_token_0000000000000000000000' \
  -H 'WORKSPACE-ID: 6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a' \
  -d '{
  "query": "mutation UpdateWebhookSubscriptionDefault($id: ID!, $input: UpdateWebhookSubscriptionInput!) {\n  updateWebhookSubscription(id: $id, input: $input) {\n    webhookSubscription {\n      id\n      name\n      url\n      status\n      metadata\n    }\n    userErrors {\n      field\n      message\n    }\n  }\n}",
  "variables": {
    "id": "eb418e28-bf9d-5350-b87b-446a6813bca4",
    "input": {
      "name": "Northwind Order Fulfilment (paused)",
      "status": "DISABLED_BY_USER"
    }
  }
}'

Request · Node.js

const response = await fetch("https://app.archive.com/api/v2", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer docs_demo_token_0000000000000000000000",
    "WORKSPACE-ID": "6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a"
  },
  body: JSON.stringify({
    query: `mutation UpdateWebhookSubscriptionDefault($id: ID!, $input: UpdateWebhookSubscriptionInput!) {
  updateWebhookSubscription(id: $id, input: $input) {
    webhookSubscription {
      id
      name
      url
      status
      metadata
    }
    userErrors {
      field
      message
    }
  }
}`,
    variables: {
      "id": "eb418e28-bf9d-5350-b87b-446a6813bca4",
      "input": {
        "name": "Northwind Order Fulfilment (paused)",
        "status": "DISABLED_BY_USER"
      }
    }
  })
})
console.log(JSON.stringify(await response.json(), null, 2))

Request · Ruby

require "json"
require "net/http"

query = <<~'GRAPHQL'
  mutation UpdateWebhookSubscriptionDefault($id: ID!, $input: UpdateWebhookSubscriptionInput!) {
    updateWebhookSubscription(id: $id, input: $input) {
      webhookSubscription {
        id
        name
        url
        status
        metadata
      }
      userErrors {
        field
        message
      }
    }
  }
GRAPHQL

response = Net::HTTP.post(
  URI("https://app.archive.com/api/v2"),
  { query: query, variables: { "id" => "eb418e28-bf9d-5350-b87b-446a6813bca4", "input" => { "name" => "Northwind Order Fulfilment (paused)", "status" => "DISABLED_BY_USER" } } }.to_json,
  "Content-Type" => "application/json",
  "Authorization" => "Bearer docs_demo_token_0000000000000000000000",
  "WORKSPACE-ID" => "6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a"
)
puts response.body

Request · Python

import json
import requests

query = """
mutation UpdateWebhookSubscriptionDefault($id: ID!, $input: UpdateWebhookSubscriptionInput!) {
  updateWebhookSubscription(id: $id, input: $input) {
    webhookSubscription {
      id
      name
      url
      status
      metadata
    }
    userErrors {
      field
      message
    }
  }
}
"""

response = requests.post(
    "https://app.archive.com/api/v2",
    json={"query": query, "variables": {"id": "eb418e28-bf9d-5350-b87b-446a6813bca4", "input": {"name": "Northwind Order Fulfilment (paused)", "status": "DISABLED_BY_USER"}}},
    headers={
        "Authorization": "Bearer docs_demo_token_0000000000000000000000",
        "WORKSPACE-ID": "6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a",
    },
)
print(json.dumps(response.json(), indent=2))

200 OK 16 lines

{
  "data": {
    "updateWebhookSubscription": {
      "webhookSubscription": {
        "id": "eb418e28-bf9d-5350-b87b-446a6813bca4",
        "name": "Northwind Order Fulfilment (paused)",
        "url": "https://hooks.northwind-botanicals.example/archive",
        "status": "DISABLED_BY_USER",
        "metadata": {
          "team": "growth"
        }
      },
      "userErrors": []
    }
  }
}