Get a webhook delivery

get

https://api.andesine.app/webhooks/{id}/deliveries/{deliveryID}

Returns retained delivery metadata and, with content authority, the immutable event payload. Expired deliveries return not found even before physical cleanup.

Required API key permissions: read:webhooks. Write permissions also grant read access for the same resource.

Authentication

apiKeyhttp, bearer, Andesine API key

Use an Andesine API key as a Bearer token

oauthhttp, bearer, Andesine OAuth access token

Use an OAuth access token with andesine:api scope. Send x-workspace-id for workspace operations. Current user permissions apply.

Path parameters

id*string

deliveryID*string

Headers

x-workspace-idstring

Required for OAuth: ID of the workspace to access. API keys use their own workspace.

Responses

200OKapplication/json

Bodyobject

3 fields

delivery*WebhookDelivery

16 fields

id*string

endpointID*string

eventID*string

type*WebhookEventName

One of: "entry.created", "entry.updated", "entry.content_saved", "entry.moved", "entry.deleted", "entry.restored", "collection.created", "collection.updated", "collection.moved", "collection.deleted", "collection.restored", "publishing.channel_advanced", "publishing.channel_created", "publishing.channel_deleted"

occurredAt*string

test*boolean

state*string

One of: "pending", "in_flight", "succeeded", "failed", "cancelled"

selectedRevision*number

createdAt*string

expiresAt*string

retentionDays*number

attemptCount*number

currentRunID*any of

Options

Any of

Option 1string

Option 2null

nextAttemptAt*any of

Options

Any of

Option 1string

Option 2null

lastHTTPStatus*any of

Options

Any of

Option 1number

Option 2null

lastFailureCategory*any of

Options

Any of

Option 1string

One of: "http_status", "timeout", "network", "destination_policy", "internal"

Option 2null

payload*any of

Options

Any of

Option 1object

availability*constant

Value: "available"

event*WebhookEvent

Options

Any of

Option 1object

id*string

operationID*string

schemaVersion*constant

Value: 1

occurredAt*string

workspaceID*string

actorany of

Default: null

Options

Any of

Option 1any of

Who made the change; null for changes by Andesine itself

Any of

Option 1object

type*constant

Value: "member"

memberID*string

Option 2object

type*constant

Value: "key"

keyID*string

Option 3object

type*constant

Value: "extension"

extensionID*string

Option 4object

type*constant

Value: "app"

memberID*string

The member who authorized the app

clientID*string

OAuth client ID

name*string

Name that the app registered, such as an MCP client

Option 2null

test*boolean

subject*object

2 fields

kind*constant

Value: "entry"

id*string

type*constant

Value: "entry.created"

data*object

3 fields

name*string

collectionID*any of

Options

Any of

Option 1string

Option 2null

contentHashstring

Option 2object

id*string

operationID*string

schemaVersion*constant

Value: 1

occurredAt*string

workspaceID*string

actorany of

Default: null

Options

Any of

Option 1any of

Who made the change; null for changes by Andesine itself

Any of

Option 1object

type*constant

Value: "member"

memberID*string

Option 2object

type*constant

Value: "key"

keyID*string

Option 3object

type*constant

Value: "extension"

extensionID*string

Option 4object

type*constant

Value: "app"

memberID*string

The member who authorized the app

clientID*string

OAuth client ID

name*string

Name that the app registered, such as an MCP client

Option 2null

test*boolean

subject*object

2 fields

kind*constant

Value: "entry"

id*string

type*constant

Value: "entry.updated"

data*object

2 fields

collectionID*any of

Options

Any of

Option 1string

Option 2null

changedFields*array of constant

Option 3object

id*string

operationID*string

schemaVersion*constant

Value: 1

occurredAt*string

workspaceID*string

actorany of

Default: null

Options

Any of

Option 1any of

Who made the change; null for changes by Andesine itself

Any of

Option 1object

type*constant

Value: "member"

memberID*string

Option 2object

type*constant

Value: "key"

keyID*string

Option 3object

type*constant

Value: "extension"

extensionID*string

Option 4object

type*constant

Value: "app"

memberID*string

The member who authorized the app

clientID*string

OAuth client ID

name*string

Name that the app registered, such as an MCP client

Option 2null

test*boolean

subject*object

2 fields

kind*constant

Value: "entry"

id*string

type*constant

Value: "entry.content_saved"

data*object

3 fields

collectionID*any of

Options

Any of

Option 1string

Option 2null

contentHash*string

savedAt*string

Option 4object

id*string

operationID*string

schemaVersion*constant

Value: 1

occurredAt*string

workspaceID*string

actorany of

Default: null

Options

Any of

Option 1any of

Who made the change; null for changes by Andesine itself

Any of

Option 1object

type*constant

Value: "member"

memberID*string

Option 2object

type*constant

Value: "key"

keyID*string

Option 3object

type*constant

Value: "extension"

extensionID*string

Option 4object

type*constant

Value: "app"

memberID*string

The member who authorized the app

clientID*string

OAuth client ID

name*string

Name that the app registered, such as an MCP client

Option 2null

test*boolean

subject*object

2 fields

kind*constant

Value: "entry"

id*string

type*constant

Value: "entry.moved"

data*any of

Options

Any of

Option 1object

scopeTransition*constant

Value: "within"

reason*string

One of: "direct", "ancestor_moved", "reordered"

from*object

3 fields

visibility*constant

Value: "visible"

parentID*any of

Null means the workspace root, never a hidden parent

Options

Any of

Option 1string

Option 2null

orderstring

to*object

3 fields

visibility*constant

Value: "visible"

parentID*any of

Null means the workspace root, never a hidden parent

Options

Any of

Option 1string

Option 2null

orderstring

Option 2object

scopeTransition*constant

Value: "entered"

reason*string

One of: "direct", "ancestor_moved", "reordered"

from*object

1 field

visibility*constant

Value: "hidden"

to*object

3 fields

visibility*constant

Value: "visible"

parentID*any of

Null means the workspace root, never a hidden parent

Options

Any of

Option 1string

Option 2null

orderstring

Option 3object

scopeTransition*constant

Value: "left"

reason*string

One of: "direct", "ancestor_moved", "reordered"

from*object

3 fields

visibility*constant

Value: "visible"

parentID*any of

Null means the workspace root, never a hidden parent

Options

Any of

Option 1string

Option 2null

orderstring

to*object

1 field

visibility*constant

Value: "hidden"

Option 5object

id*string

operationID*string

schemaVersion*constant

Value: 1

occurredAt*string

workspaceID*string

actorany of

Default: null

Options

Any of

Option 1any of

Who made the change; null for changes by Andesine itself

Any of

Option 1object

type*constant

Value: "member"

memberID*string

Option 2object

type*constant

Value: "key"

keyID*string

Option 3object

type*constant

Value: "extension"

extensionID*string

Option 4object

type*constant

Value: "app"

memberID*string

The member who authorized the app

clientID*string

OAuth client ID

name*string

Name that the app registered, such as an MCP client

Option 2null

test*boolean

subject*object

2 fields

kind*constant

Value: "entry"

id*string

type*constant

Value: "entry.deleted"

data*object

3 fields

name*string

collectionID*any of

Options

Any of

Option 1string

Option 2null

deletedAt*string

Option 6object

id*string

operationID*string

schemaVersion*constant

Value: 1

occurredAt*string

workspaceID*string

actorany of

Default: null

Options

Any of

Option 1any of

Who made the change; null for changes by Andesine itself

Any of

Option 1object

type*constant

Value: "member"

memberID*string

Option 2object

type*constant

Value: "key"

keyID*string

Option 3object

type*constant

Value: "extension"

extensionID*string

Option 4object

type*constant

Value: "app"

memberID*string

The member who authorized the app

clientID*string

OAuth client ID

name*string

Name that the app registered, such as an MCP client

Option 2null

test*boolean

subject*object

2 fields

kind*constant

Value: "entry"

id*string

type*constant

Value: "entry.restored"

data*object

2 fields

name*string

collectionID*any of

Options

Any of

Option 1string

Option 2null

Option 7object

id*string

operationID*string

schemaVersion*constant

Value: 1

occurredAt*string

workspaceID*string

actorany of

Default: null

Options

Any of

Option 1any of

Who made the change; null for changes by Andesine itself

Any of

Option 1object

type*constant

Value: "member"

memberID*string

Option 2object

type*constant

Value: "key"

keyID*string

Option 3object

type*constant

Value: "extension"

extensionID*string

Option 4object

type*constant

Value: "app"

memberID*string

The member who authorized the app

clientID*string

OAuth client ID

name*string

Name that the app registered, such as an MCP client

Option 2null

test*boolean

subject*object

2 fields

kind*constant

Value: "collection"

id*string

type*constant

Value: "collection.created"

data*object

2 fields

name*string

parentID*any of

Options

Any of

Option 1string

Option 2null

Option 8object

id*string

operationID*string

schemaVersion*constant

Value: 1

occurredAt*string

workspaceID*string

actorany of

Default: null

Options

Any of

Option 1any of

Who made the change; null for changes by Andesine itself

Any of

Option 1object

type*constant

Value: "member"

memberID*string

Option 2object

type*constant

Value: "key"

keyID*string

Option 3object

type*constant

Value: "extension"

extensionID*string

Option 4object

type*constant

Value: "app"

memberID*string

The member who authorized the app

clientID*string

OAuth client ID

name*string

Name that the app registered, such as an MCP client

Option 2null

test*boolean

subject*object

2 fields

kind*constant

Value: "collection"

id*string

type*constant

Value: "collection.updated"

data*object

2 fields

parentID*any of

Options

Any of

Option 1string

Option 2null

changedFields*array of string

Unique items: true

Option 9object

id*string

operationID*string

schemaVersion*constant

Value: 1

occurredAt*string

workspaceID*string

actorany of

Default: null

Options

Any of

Option 1any of

Who made the change; null for changes by Andesine itself

Any of

Option 1object

type*constant

Value: "member"

memberID*string

Option 2object

type*constant

Value: "key"

keyID*string

Option 3object

type*constant

Value: "extension"

extensionID*string

Option 4object

type*constant

Value: "app"

memberID*string

The member who authorized the app

clientID*string

OAuth client ID

name*string

Name that the app registered, such as an MCP client

Option 2null

test*boolean

subject*object

2 fields

kind*constant

Value: "collection"

id*string

type*constant

Value: "collection.moved"

data*any of

Options

Any of

Option 1object

scopeTransition*constant

Value: "within"

reason*string

One of: "direct", "ancestor_moved", "reordered"

from*object

3 fields

visibility*constant

Value: "visible"

parentID*any of

Null means the workspace root, never a hidden parent

Options

Any of

Option 1string

Option 2null

orderstring

to*object

3 fields

visibility*constant

Value: "visible"

parentID*any of

Null means the workspace root, never a hidden parent

Options

Any of

Option 1string

Option 2null

orderstring

Option 2object

scopeTransition*constant

Value: "entered"

reason*string

One of: "direct", "ancestor_moved", "reordered"

from*object

1 field

visibility*constant

Value: "hidden"

to*object

3 fields

visibility*constant

Value: "visible"

parentID*any of

Null means the workspace root, never a hidden parent

Options

Any of

Option 1string

Option 2null

orderstring

Option 3object

scopeTransition*constant

Value: "left"

reason*string

One of: "direct", "ancestor_moved", "reordered"

from*object

3 fields

visibility*constant

Value: "visible"

parentID*any of

Null means the workspace root, never a hidden parent

Options

Any of

Option 1string

Option 2null

orderstring

to*object

1 field

visibility*constant

Value: "hidden"

Option 10object

id*string

operationID*string

schemaVersion*constant

Value: 1

occurredAt*string

workspaceID*string

actorany of

Default: null

Options

Any of

Option 1any of

Who made the change; null for changes by Andesine itself

Any of

Option 1object

type*constant

Value: "member"

memberID*string

Option 2object

type*constant

Value: "key"

keyID*string

Option 3object

type*constant

Value: "extension"

extensionID*string

Option 4object

type*constant

Value: "app"

memberID*string

The member who authorized the app

clientID*string

OAuth client ID

name*string

Name that the app registered, such as an MCP client

Option 2null

test*boolean

subject*object

2 fields

kind*constant

Value: "collection"

id*string

type*constant

Value: "collection.deleted"

data*object

3 fields

name*string

parentID*any of

Options

Any of

Option 1string

Option 2null

deletedAt*string

Option 11object

id*string

operationID*string

schemaVersion*constant

Value: 1

occurredAt*string

workspaceID*string

actorany of

Default: null

Options

Any of

Option 1any of

Who made the change; null for changes by Andesine itself

Any of

Option 1object

type*constant

Value: "member"

memberID*string

Option 2object

type*constant

Value: "key"

keyID*string

Option 3object

type*constant

Value: "extension"

extensionID*string

Option 4object

type*constant

Value: "app"

memberID*string

The member who authorized the app

clientID*string

OAuth client ID

name*string

Name that the app registered, such as an MCP client

Option 2null

test*boolean

subject*object

2 fields

kind*constant

Value: "collection"

id*string

type*constant

Value: "collection.restored"

data*object

2 fields

name*string

parentID*any of

Options

Any of

Option 1string

Option 2null

Option 12object

id*string

operationID*string

schemaVersion*constant

Value: 1

occurredAt*string

workspaceID*string

actorany of

Default: null

Options

Any of

Option 1any of

Who made the change; null for changes by Andesine itself

Any of

Option 1object

type*constant

Value: "member"

memberID*string

Option 2object

type*constant

Value: "key"

keyID*string

Option 3object

type*constant

Value: "extension"

extensionID*string

Option 4object

type*constant

Value: "app"

memberID*string

The member who authorized the app

clientID*string

OAuth client ID

name*string

Name that the app registered, such as an MCP client

Option 2null

test*boolean

subject*object

2 fields

kind*constant

Value: "channel"

code*string

type*constant

Value: "publishing.channel_advanced"

data*object

3 fields

previousSnapshotID*string

snapshotID*string

reason*string

One of: "publish", "unpublish"

Option 13object

id*string

operationID*string

schemaVersion*constant

Value: 1

occurredAt*string

workspaceID*string

actorany of

Default: null

Options

Any of

Option 1any of

Who made the change; null for changes by Andesine itself

Any of

Option 1object

type*constant

Value: "member"

memberID*string

Option 2object

type*constant

Value: "key"

keyID*string

Option 3object

type*constant

Value: "extension"

extensionID*string

Option 4object

type*constant

Value: "app"

memberID*string

The member who authorized the app

clientID*string

OAuth client ID

name*string

Name that the app registered, such as an MCP client

Option 2null

test*boolean

subject*object

2 fields

kind*constant

Value: "channel"

code*string

type*constant

Value: "publishing.channel_created"

data*object

3 fields

name*string

builtIn*boolean

snapshotID*string

Option 14object

id*string

operationID*string

schemaVersion*constant

Value: 1

occurredAt*string

workspaceID*string

actorany of

Default: null

Options

Any of

Option 1any of

Who made the change; null for changes by Andesine itself

Any of

Option 1object

type*constant

Value: "member"

memberID*string

Option 2object

type*constant

Value: "key"

keyID*string

Option 3object

type*constant

Value: "extension"

extensionID*string

Option 4object

type*constant

Value: "app"

memberID*string

The member who authorized the app

clientID*string

OAuth client ID

name*string

Name that the app registered, such as an MCP client

Option 2null

test*boolean

subject*object

2 fields

kind*constant

Value: "channel"

code*string

type*constant

Value: "publishing.channel_deleted"

data*object

2 fields

name*string

snapshotID*string

Option 2object

availability*constant

Value: "forbidden"

currentRun*any of

Options

Any of

WebhookRunobject

id*string

deliveryID*string

number*number

trigger*string

One of: "automatic", "manual", "test"

destinationRevision*number

state*string

One of: "pending", "in_flight", "succeeded", "failed", "cancelled"

createdAt*string

deadlineAt*string

finishedAt*any of

Options

Any of

Option 1string

Option 2null

nextAttemptAt*any of

Options

Any of

Option 1string

Option 2null

attemptCount*number

stopReason*any of

Options

Any of

Option 1string

One of: "retry_exhausted", "expired", "disabled", "endpoint_deleted", "destination_changed", "selection_changed", "access_revoked", "destination_policy", "test_completed"

Option 2null

400Bad Requestapplication/json

Bodyone of

Options

One of

Option 1object

defined*constant

Value: true

code*constant

Value: "BAD_REQUEST"

status*constant

Value: 400

message*string

Default: "Bad Request"

dataValidationErrorData

2 fields

hintsarray of string

Suggested next steps. Wording can change; use error codes and structured data for program logic.

issuesarray of ValidationIssue

3 fields

message*string

codestring

patharray of any of

Options

Any of

Option 1string

Option 2number

Option 3object

key*any of

Options

Any of

Option 1string

Option 2number

Option 2object

defined*constant

Value: false

code*string

status*number

message*string

dataany

401Unauthorizedapplication/json

Bodyone of

Options

One of

Option 1object

defined*constant

Value: true

code*constant

Value: "UNAUTHORIZED"

status*constant

Value: 401

message*string

Default: "Unauthorized"

dataErrorData

1 field

hintsarray of string

Suggested next steps. Wording can change; use error codes and structured data for program logic.

Option 2object

defined*constant

Value: false

code*string

status*number

message*string

dataany

403Forbiddenapplication/json

Bodyone of

Options

One of

Option 1object

defined*constant

Value: true

code*constant

Value: "FORBIDDEN"

status*constant

Value: 403

message*string

Default: "Forbidden"

dataForbiddenErrorData

4 fields

hintsarray of string

Suggested next steps. Wording can change; use error codes and structured data for program logic.

missingPermissionsarray of string

requiredPlanconstant

Value: "pro"

actionstring

The requested action that was denied

Option 2object

defined*constant

Value: false

code*string

status*number

message*string

dataany

404Not Foundapplication/json

Bodyone of

Options

One of

Option 1object

defined*constant

Value: true

code*constant

Value: "NOT_FOUND"

status*constant

Value: 404

message*string

Default: "Not Found"

dataErrorData

1 field

hintsarray of string

Suggested next steps. Wording can change; use error codes and structured data for program logic.

Option 2object

defined*constant

Value: false

code*string

status*number

message*string

dataany

409Conflictapplication/json

Bodyone of

Options

One of

Option 1object

defined*constant

Value: true

code*constant

Value: "CONFLICT"

status*constant

Value: 409

message*string

Default: "Conflict"

dataErrorData

1 field

hintsarray of string

Suggested next steps. Wording can change; use error codes and structured data for program logic.

Option 2object

defined*constant

Value: false

code*string

status*number

message*string

dataany

429Too Many Requestsapplication/json

Bodyone of

Options

One of

Option 1object

defined*constant

Value: true

code*constant

Value: "TOO_MANY_REQUESTS"

status*constant

Value: 429

message*string

Default: "Too Many Requests"

dataRateLimitErrorData

3 fields

hintsarray of string

Suggested next steps. Wording can change; use error codes and structured data for program logic.

limitstring

The limit that was reached: a short-term rate limit, or a monthly API call, AI credit, or spending limit

One of: "rate", "api-calls", "ai-credits", "spending"

retryAfterSecondsnumber

Minimum delay before another attempt, in seconds. Also sent in Retry-After.

Option 2object

defined*constant

Value: false

code*string

status*number

message*string

dataany

500Internal Server Errorapplication/json

Bodyone of

Options

One of

Option 1object

defined*constant

Value: true

code*constant

Value: "INTERNAL_SERVER_ERROR"

status*constant

Value: 500

message*string

Default: "Internal Server Error"

dataErrorData

1 field

hintsarray of string

Suggested next steps. Wording can change; use error codes and structured data for program logic.

Option 2object

defined*constant

Value: false

code*string

status*number

message*string

dataany

503Service Unavailableapplication/json

Bodyone of

Options

One of

Option 1object

defined*constant

Value: true

code*constant

Value: "SERVICE_UNAVAILABLE"

status*constant

Value: 503

message*string

Default: "Service Unavailable"

dataErrorData

1 field

hintsarray of string

Suggested next steps. Wording can change; use error codes and structured data for program logic.

Option 2object

defined*constant

Value: false

code*string

status*number

message*string

dataany

Request

bash

curl --request GET \
  --url 'https://api.andesine.app/webhooks/string/deliveries/string' \
  --header 'Authorization: Bearer <token>'

javascript

const response = await fetch("https://api.andesine.app/webhooks/string/deliveries/string", {
  method: "GET",
  headers: {
    "Authorization": "Bearer <token>"
  }
});

const data = await response.json();

python

import requests

response = requests.get(
    "https://api.andesine.app/webhooks/string/deliveries/string",
    headers={
        "Authorization": "Bearer <token>",
    },
)

print(response.json())

Response

json

{
  "delivery": {
    "id": "string",
    "endpointID": "string",
    "eventID": "string",
    "type": "entry.created",
    "occurredAt": "string",
    "test": true,
    "state": "pending",
    "selectedRevision": 0,
    "createdAt": "string",
    "expiresAt": "string",
    "retentionDays": 0,
    "attemptCount": 0,
    "currentRunID": "string",
    "nextAttemptAt": "string",
    "lastHTTPStatus": 0,
    "lastFailureCategory": "http_status"
  },
  "payload": {
    "availability": "available",
    "event": {
      "id": "string",
      "operationID": "string",
      "schemaVersion": 1,
      "occurredAt": "string",
      "workspaceID": "string",
      "actor": null,
      "test": true,
      "subject": {
        "kind": "entry",
        "id": "string"
      },
      "type": "entry.created",
      "data": {
        "name": "string",
        "collectionID": "string",
        "contentHash": "string"
      }
    }
  },
  "currentRun": {
    "id": "string",
    "deliveryID": "string",
    "number": 0,
    "trigger": "automatic",
    "destinationRevision": 0,
    "state": "pending",
    "createdAt": "string",
    "deadlineAt": "string",
    "finishedAt": "string",
    "nextAttemptAt": "string",
    "attemptCount": 0,
    "stopReason": "retry_exhausted"
  }
}

json

{
  "defined": true,
  "code": "BAD_REQUEST",
  "status": 400,
  "message": "Bad Request",
  "data": {
    "hints": [
      "string"
    ],
    "issues": [
      {
        "message": "string",
        "code": "string",
        "path": [
          "string"
        ]
      }
    ]
  }
}

json

{
  "defined": true,
  "code": "UNAUTHORIZED",
  "status": 401,
  "message": "Unauthorized",
  "data": {
    "hints": [
      "string"
    ]
  }
}

json

{
  "defined": true,
  "code": "FORBIDDEN",
  "status": 403,
  "message": "Forbidden",
  "data": {
    "hints": [
      "string"
    ],
    "missingPermissions": [
      "string"
    ],
    "requiredPlan": "pro",
    "action": "string"
  }
}

json

{
  "defined": true,
  "code": "NOT_FOUND",
  "status": 404,
  "message": "Not Found",
  "data": {
    "hints": [
      "string"
    ]
  }
}

json

{
  "defined": true,
  "code": "CONFLICT",
  "status": 409,
  "message": "Conflict",
  "data": {
    "hints": [
      "string"
    ]
  }
}

json

{
  "defined": true,
  "code": "TOO_MANY_REQUESTS",
  "status": 429,
  "message": "Too Many Requests",
  "data": {
    "hints": [
      "string"
    ],
    "limit": "rate",
    "retryAfterSeconds": 0
  }
}

json

{
  "defined": true,
  "code": "INTERNAL_SERVER_ERROR",
  "status": 500,
  "message": "Internal Server Error",
  "data": {
    "hints": [
      "string"
    ]
  }
}

json

{
  "defined": true,
  "code": "SERVICE_UNAVAILABLE",
  "status": 503,
  "message": "Service Unavailable",
  "data": {
    "hints": [
      "string"
    ]
  }
}