Mutation

redeliverWebhookDelivery

Manually replay a terminal failed delivery (one-shot).

MCP: redeliverWebhookDelivery

Arguments

deliveryId ID! required: UUID of the failed delivery to replay.

Returns

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.

userErrors [UserError!]!: List of user-facing errors. Empty on success.
field [String!]: Path to the input field that caused the error.
message String!: The error message.
webhookDelivery WebhookDelivery: The re-enqueued delivery. Null on failure.
attemptCount Int!: Lifetime number of attempts made (also the backoff-ladder index). The ladder is 8 attempts total: one immediate try plus backoffs at 1m/5m/30m/2h/6h/12h/24h (±20% jitter), spanning about 44.6h nominal (up to about 53.5h with max jitter).
createdAt DateTimeWithZone!: When the delivery was created.
eventId ID!: ID of the webhook event being delivered.
id ID!: Unique identifier of the delivery.
lastAttemptAt DateTimeWithZone: When the most recent attempt was made. Null before the first attempt.
lastError String: Error message from the most recent failed attempt. Null on success.
lastResponseStatus Int: HTTP status of the most recent attempt. Null for transport-level failures.
nextAttemptAt DateTimeWithZone: When the next attempt is scheduled. Null when terminal (exhausted or dropped, no retry queued). Pushed to the cooldown while the endpoint host circuit breaker is open (deferred, not failed).
responseTimeMs Int: Round-trip time of the most recent attempt in milliseconds.
status WebhookDeliveryStatus!: Current status of this delivery attempt. FAILED is retried on the backoff ladder until terminal (then redeliverable); DROPPED is backpressure/rate-limit and is never retried (recover via webhookEvents).
DELIVERING: Currently being delivered (claimed for one attempt).
DROPPED: Dropped without delivery by backpressure (backlog cap reached) or rate-limiting (per-subscription events/sec bucket exhausted). Not retried; the business event remains in the outbox (webhookEvents). Never used for auto-disable.
FAILED: The attempt failed. Terminal failures are redeliverable.
PENDING: Queued or scheduled for a (re)attempt.
SUCCEEDED: Delivered successfully (endpoint returned a 2xx).
subscriptionId ID!: ID of the subscription this delivery belongs to.
updatedAt DateTimeWithZone!: When the delivery was last updated.

Open in explorer ↗

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

Replay one terminal failed delivery (nextAttemptAt null). One-shot: a replayed delivery is no longer failed. Resolve the deliveryId from webhookDeliveries filtered to FAILED.

query.graphql

mutation RedeliverWebhookDeliveryDefault($deliveryId: ID!) {
  redeliverWebhookDelivery(deliveryId: $deliveryId) {
    webhookDelivery {
      id
      subscriptionId
      eventId
      status
      attemptCount
      lastResponseStatus
      responseTimeMs
    }
    userErrors {
      field
      message
    }
  }
}

variables.json

{
  "deliveryId": "dbe6be29-b520-5cdc-81a3-b7a0d5d8f62e"
}

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 RedeliverWebhookDeliveryDefault($deliveryId: ID!) {\n  redeliverWebhookDelivery(deliveryId: $deliveryId) {\n    webhookDelivery {\n      id\n      subscriptionId\n      eventId\n      status\n      attemptCount\n      lastResponseStatus\n      responseTimeMs\n    }\n    userErrors {\n      field\n      message\n    }\n  }\n}",
  "variables": {
    "deliveryId": "dbe6be29-b520-5cdc-81a3-b7a0d5d8f62e"
  }
}'

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 RedeliverWebhookDeliveryDefault($deliveryId: ID!) {
  redeliverWebhookDelivery(deliveryId: $deliveryId) {
    webhookDelivery {
      id
      subscriptionId
      eventId
      status
      attemptCount
      lastResponseStatus
      responseTimeMs
    }
    userErrors {
      field
      message
    }
  }
}`,
    variables: {
      "deliveryId": "dbe6be29-b520-5cdc-81a3-b7a0d5d8f62e"
    }
  })
})
console.log(JSON.stringify(await response.json(), null, 2))

Request · Ruby

require "json"
require "net/http"

query = <<~'GRAPHQL'
  mutation RedeliverWebhookDeliveryDefault($deliveryId: ID!) {
    redeliverWebhookDelivery(deliveryId: $deliveryId) {
      webhookDelivery {
        id
        subscriptionId
        eventId
        status
        attemptCount
        lastResponseStatus
        responseTimeMs
      }
      userErrors {
        field
        message
      }
    }
  }
GRAPHQL

response = Net::HTTP.post(
  URI("https://app.archive.com/api/v2"),
  { query: query, variables: { "deliveryId" => "dbe6be29-b520-5cdc-81a3-b7a0d5d8f62e" } }.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 RedeliverWebhookDeliveryDefault($deliveryId: ID!) {
  redeliverWebhookDelivery(deliveryId: $deliveryId) {
    webhookDelivery {
      id
      subscriptionId
      eventId
      status
      attemptCount
      lastResponseStatus
      responseTimeMs
    }
    userErrors {
      field
      message
    }
  }
}
"""

response = requests.post(
    "https://app.archive.com/api/v2",
    json={"query": query, "variables": {"deliveryId": "dbe6be29-b520-5cdc-81a3-b7a0d5d8f62e"}},
    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": {
    "redeliverWebhookDelivery": {
      "webhookDelivery": {
        "id": "dbe6be29-b520-5cdc-81a3-b7a0d5d8f62e",
        "subscriptionId": "41662e09-10c4-52e4-844a-62ddedb38f11",
        "eventId": "0f8e0d63-409e-5fd1-88bd-2febbe05fa53",
        "status": "PENDING",
        "attemptCount": 8,
        "lastResponseStatus": null,
        "responseTimeMs": 87
      },
      "userErrors": []
    }
  }
}