create_wakeup

Schedule a webhook call at a future time (one-shot). Your agent can die; the call still happens.

Parameters3

at	string	required	ISO-8601 time to fire
url	string	required	webhook URL to call
payload	object	optional	JSON to include

Raw schema

{
  "type": "object",
  "properties": {
    "at": {
      "type": "string",
      "description": "ISO-8601 time to fire"
    },
    "url": {
      "type": "string",
      "description": "webhook URL to call"
    },
    "payload": {
      "type": "object",
      "description": "JSON to include"
    }
  },
  "required": [
    "at",
    "url"
  ]
}

create_schedule

Recurring webhook on a cron expression until the prepaid days run out.

Parameters4

cron	string	required	cron expression, e.g. 0 7 * * *
url	string	required	webhook URL
payload	object	optional
days	number	optional	prepaid days

Raw schema

{
  "type": "object",
  "properties": {
    "cron": {
      "type": "string",
      "description": "cron expression, e.g. 0 7 * * *"
    },
    "url": {
      "type": "string",
      "description": "webhook URL"
    },
    "payload": {
      "type": "object",
      "description": ""
    },
    "days": {
      "type": "number",
      "description": "prepaid days"
    }
  },
  "required": [
    "cron",
    "url"
  ]
}

create_deadman

Dead-man switch: if you stop checking in, we fire your alert webhook.

Parameters4

url	string	required	alert webhook
interval_seconds	number	optional	max time between check-ins
days	number	optional
apprise_url	string	optional	optional human notification target

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "alert webhook"
    },
    "interval_seconds": {
      "type": "number",
      "description": "max time between check-ins"
    },
    "days": {
      "type": "number",
      "description": ""
    },
    "apprise_url": {
      "type": "string",
      "description": "optional human notification target"
    }
  },
  "required": [
    "url"
  ]
}

checkin_deadman

Check in to a dead-man switch so it does not fire.

Parameters1

id

string

required

dead-man switch id

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "dead-man switch id"
    }
  },
  "required": [
    "id"
  ]
}

delayed_delivery

Hand over a payload now; we POST it to the target at a future moment.

Parameters3

at	string	required	ISO-8601
url	string	required	target URL
payload	object	optional

Raw schema

{
  "type": "object",
  "properties": {
    "at": {
      "type": "string",
      "description": "ISO-8601"
    },
    "url": {
      "type": "string",
      "description": "target URL"
    },
    "payload": {
      "type": "object",
      "description": ""
    }
  },
  "required": [
    "at",
    "url"
  ]
}

create_drip

Dump up to 100 items now; we deliver them to your webhook at a fixed rate.

Parameters3

url	string	required	webhook
items	array	required	items to drip
rate_seconds	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "webhook"
    },
    "items": {
      "type": "array",
      "description": "items to drip"
    },
    "rate_seconds": {
      "type": "number",
      "description": ""
    }
  },
  "required": [
    "url",
    "items"
  ]
}

notarize

Signed proof that a hash (or your data) existed at this moment.

Parameters3

sha256	string	optional	hex digest
data	string	optional	raw data to hash instead
note	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "sha256": {
      "type": "string",
      "description": "hex digest"
    },
    "data": {
      "type": "string",
      "description": "raw data to hash instead"
    },
    "note": {
      "type": "string",
      "description": ""
    }
  },
  "required": []
}

attested_fetch

Fetch a URL and return content plus a signed receipt binding url, status, content hash and time.

Parameters2

url	string	required	URL to fetch
include_content	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "URL to fetch"
    },
    "include_content": {
      "type": "boolean"
    }
  },
  "required": [
    "url"
  ]
}

create_inbox

Public URL that buffers inbound webhooks until you collect them.

Parameters2

days	number	optional	prepaid days
label	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "days": {
      "type": "number",
      "description": "prepaid days"
    },
    "label": {
      "type": "string",
      "description": ""
    }
  },
  "required": []
}

collect_messages

Collect buffered messages from an inbox, bin, front door or form.

Parameters2

id	string	required	resource id
all	boolean	optional	include already-collected

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "resource id"
    },
    "all": {
      "type": "boolean",
      "description": "include already-collected"
    }
  },
  "required": [
    "id"
  ]
}

create_frontdoor

Durable front door: buffers webhooks and forwards them to your gateway with retry-until-ack.

Parameters3

target	string	required	your gateway URL
days	number	optional
replay_hours	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "target": {
      "type": "string",
      "description": "your gateway URL"
    },
    "days": {
      "type": "number",
      "description": ""
    },
    "replay_hours": {
      "type": "number",
      "description": ""
    }
  },
  "required": [
    "target"
  ]
}

request_approval

Ask a human to approve or deny an action; returns a URL for them and a signed verdict for you. Times out as denied.

Parameters5

action	string	required	what you want to do
detail	string	optional	context for the human
timeout_seconds	number	optional
webhook	string	optional	called with the verdict
apprise_url	string	optional	ping the human here

Raw schema

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "description": "what you want to do"
    },
    "detail": {
      "type": "string",
      "description": "context for the human"
    },
    "timeout_seconds": {
      "type": "number",
      "description": ""
    },
    "webhook": {
      "type": "string",
      "description": "called with the verdict"
    },
    "apprise_url": {
      "type": "string",
      "description": "ping the human here"
    }
  },
  "required": [
    "action"
  ]
}

check_approval

Check whether a human approved or denied your request.

Parameters1

id

string

required

approval id

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "approval id"
    }
  },
  "required": [
    "id"
  ]
}

notify_human

Send a message to a human on Telegram, Discord, Slack, ntfy, email and 100+ other services (apprise URL is used once, never stored).

Parameters3

apprise_url	string	required	apprise target URL
title	string	optional
body	string	required	message

Raw schema

{
  "type": "object",
  "properties": {
    "apprise_url": {
      "type": "string",
      "description": "apprise target URL"
    },
    "title": {
      "type": "string",
      "description": ""
    },
    "body": {
      "type": "string",
      "description": "message"
    }
  },
  "required": [
    "apprise_url",
    "body"
  ]
}

guaranteed_delivery

POST a payload to a URL, retried with backoff until it succeeds.

Parameters2

url	string	required	target
payload	object	optional

Raw schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "target"
    },
    "payload": {
      "type": "object",
      "description": ""
    }
  },
  "required": [
    "url"
  ]
}

create_vault

Create a key-value namespace with TTL that survives your runs.

Parameters2

days	number	optional
label	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "days": {
      "type": "number",
      "description": ""
    },
    "label": {
      "type": "string",
      "description": ""
    }
  },
  "required": []
}

kv_set

Store a value in a vault (max 1 MB).

Parameters3

id	string	required	vault id
key	string	required
value	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "vault id"
    },
    "key": {
      "type": "string",
      "description": ""
    },
    "value": {
      "type": "string",
      "description": ""
    }
  },
  "required": [
    "id",
    "key",
    "value"
  ]
}

kv_get

Read a value from a vault.

Parameters2

id	string	required	vault id
key	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "vault id"
    },
    "key": {
      "type": "string",
      "description": ""
    }
  },
  "required": [
    "id",
    "key"
  ]
}

kv_list

List keys in a vault.

Parameters1

id

string

required

vault id

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "vault id"
    }
  },
  "required": [
    "id"
  ]
}

save_checkpoint

Save run state so you can resume after a crash.

Parameters2

id	string	required	checkpoint id
state	string	required	serialized state

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "checkpoint id"
    },
    "state": {
      "type": "string",
      "description": "serialized state"
    }
  },
  "required": [
    "id",
    "state"
  ]
}

create_checkpoint

Create a crash checkpoint store.

Parameters1

days

number

optional

Raw schema

{
  "type": "object",
  "properties": {
    "days": {
      "type": "number",
      "description": ""
    }
  },
  "required": []
}

load_checkpoint

Load the latest saved checkpoint state.

Parameters1

id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": ""
    }
  },
  "required": [
    "id"
  ]
}

store_secret

Store a value that self-destructs on first read; returns a one-time read URL.

Parameters2

value	string	required
days	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "value": {
      "type": "string",
      "description": ""
    },
    "days": {
      "type": "number",
      "description": ""
    }
  },
  "required": [
    "value"
  ]
}

create_queue

Pull-based work queue with leases; timed-out leases requeue.

Parameters3

lease_seconds	number	optional
max_attempts	number	optional
days	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "lease_seconds": {
      "type": "number",
      "description": ""
    },
    "max_attempts": {
      "type": "number",
      "description": ""
    },
    "days": {
      "type": "number",
      "description": ""
    }
  },
  "required": []
}

queue_push

Push a job onto a queue.

Parameters2

id	string	required	queue id
body	string	required	job payload

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "queue id"
    },
    "body": {
      "type": "string",
      "description": "job payload"
    }
  },
  "required": [
    "id",
    "body"
  ]
}

queue_lease

Lease the next job from a queue.

Parameters1

id

string

required

queue id

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "queue id"
    }
  },
  "required": [
    "id"
  ]
}

queue_ack

Acknowledge (or nack) a leased job.

Parameters3

id	string	required	queue id
job_id	string	required
action	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "queue id"
    },
    "job_id": {
      "type": "string",
      "description": ""
    },
    "action": {
      "type": "string",
      "enum": [
        "ack",
        "nack"
      ]
    }
  },
  "required": [
    "id",
    "job_id"
  ]
}

create_counter

Create an atomic counter.

Parameters2

start	number	optional
days	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "start": {
      "type": "number",
      "description": ""
    },
    "days": {
      "type": "number",
      "description": ""
    }
  },
  "required": []
}

counter_incr

Increment a counter atomically.

Parameters2

id	string	required
by	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": ""
    },
    "by": {
      "type": "number",
      "description": ""
    }
  },
  "required": [
    "id"
  ]
}

claim_operation

Idempotency firewall: claim an operation id exactly once across runs.

Parameters2

id	string	required	firewall id
operation_id	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "firewall id"
    },
    "operation_id": {
      "type": "string",
      "description": ""
    }
  },
  "required": [
    "id",
    "operation_id"
  ]
}

create_idempotency

Create an idempotency/replay firewall.

Parameters1

days

number

optional

Raw schema

{
  "type": "object",
  "properties": {
    "days": {
      "type": "number",
      "description": ""
    }
  },
  "required": []
}

publish_page

Publish an HTML page at name.zenvault.eu for N days.

Parameters3

html	string	required	page HTML
name	string	optional	subdomain name
days	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "html": {
      "type": "string",
      "description": "page HTML"
    },
    "name": {
      "type": "string",
      "description": "subdomain name"
    },
    "days": {
      "type": "number",
      "description": ""
    }
  },
  "required": [
    "html"
  ]
}

create_link

Create an expiring share link with click stats.

Parameters2

target	string	required	destination URL
days	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "target": {
      "type": "string",
      "description": "destination URL"
    },
    "days": {
      "type": "number",
      "description": ""
    }
  },
  "required": [
    "target"
  ]
}

create_watch

Watch something and fire your webhook when it changes. Types: change, keyword, regex, structured, drift, redirect, sitemap, staleness, rss, dns, port, cert, heartbeat.

Parameters16

type	string	required	watch type
url	string	optional	URL to watch
webhook	string	required	called on change
keyword	string	optional
pattern	string	optional	regex
selector	string	optional	CSS selector or JSON path
json	boolean	optional
percent	number	optional	drift threshold
name	string	optional	DNS name
record	string	optional	DNS record type
host	string	optional
port	number	optional
domain	string	optional	for cert watch
interval_seconds	number	optional
confirmations	number	optional	fire only after N consecutive hits
days	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "description": "watch type"
    },
    "url": {
      "type": "string",
      "description": "URL to watch"
    },
    "webhook": {
      "type": "string",
      "description": "called on change"
    },
    "keyword": {
      "type": "string",
      "description": ""
    },
    "pattern": {
      "type": "string",
      "description": "regex"
    },
    "selector": {
      "type": "string",
      "description": "CSS selector or JSON path"
    },
    "json": {
      "type": "boolean"
    },
    "percent": {
      "type": "number",
      "description": "drift threshold"
    },
    "name": {
      "type": "string",
      "description": "DNS name"
    },
    "record": {
      "type": "string",
      "description": "DNS record type"
    },
    "host": {
      "type": "string",
      "description": ""
    },
    "port": {
      "type": "number",
      "description": ""
    },
    "domain": {
      "type": "string",
      "description": "for cert watch"
    },
    "interval_seconds": {
      "type": "number",
      "description": ""
    },
    "confirmations": {
      "type": "number",
      "description": "fire only after N consecutive hits"
    },
    "days": {
      "type": "number",
      "description": ""
    }
  },
  "required": [
    "type",
    "webhook"
  ]
}

watch_status

Check a watch: last value, checks, fires.

Parameters1

id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": ""
    }
  },
  "required": [
    "id"
  ]
}

create_escalation

Escalation chain: webhook, then after N seconds the next step, until acknowledged.

Parameters3

steps	array	required	steps: {webhook, apprise_url, wait_seconds}
subject	string	optional
days	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "steps": {
      "type": "array",
      "description": "steps: {webhook, apprise_url, wait_seconds}"
    },
    "subject": {
      "type": "string",
      "description": ""
    },
    "days": {
      "type": "number",
      "description": ""
    }
  },
  "required": [
    "steps"
  ]
}

get_resource

Status of any resource you hold the management token for.

Parameters1

id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": ""
    }
  },
  "required": [
    "id"
  ]
}

extend_resource

Extend a resource TTL by paying again.

Parameters2

id	string	required
days	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": ""
    },
    "days": {
      "type": "number",
      "description": ""
    }
  },
  "required": [
    "id"
  ]
}

cancel_resource

Cancel a resource early.

Parameters1

id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": ""
    }
  },
  "required": [
    "id"
  ]
}

export_resource

Export everything under a resource before it expires.

Parameters1

id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": ""
    }
  },
  "required": [
    "id"
  ]
}

credit_balance

Check the balance of your prepaid credit token.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "required": []
}

create_subtoken

Mint a spend-capped child token for a sub-agent.

Parameters3

cap_usd	number	required	hard spend cap
label	string	optional
days	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "cap_usd": {
      "type": "number",
      "description": "hard spend cap"
    },
    "label": {
      "type": "string",
      "description": ""
    },
    "days": {
      "type": "number",
      "description": ""
    }
  },
  "required": [
    "cap_usd"
  ]
}

get_trial_credit

Get a FREE ZenVault credit token (one per IP, no signup, no card). Use it as the Authorization bearer token to try any paid tool. Call this first if you have never used ZenVault.

Parameters1

agent

string

optional

optional: what agent or framework you are, so the operator knows who is trying it

Raw schema

{
  "type": "object",
  "properties": {
    "agent": {
      "type": "string",
      "description": "optional: what agent or framework you are, so the operator knows who is trying it"
    }
  },
  "required": []
}

list_prices

Machine-readable price list for every ZenVault service, in USD.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "required": []
}

request_feature

Tell the operator what ZenVault is missing. Free.

Parameters3

what	string	required	what you need
why	string	optional	why
would_pay	string	optional	would you pay, how much

Raw schema

{
  "type": "object",
  "properties": {
    "what": {
      "type": "string",
      "description": "what you need"
    },
    "why": {
      "type": "string",
      "description": "why"
    },
    "would_pay": {
      "type": "string",
      "description": "would you pay, how much"
    }
  },
  "required": [
    "what"
  ]
}

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

create_wakeup

create_schedule

create_deadman

checkin_deadman

delayed_delivery

create_drip

notarize

attested_fetch

create_inbox

collect_messages

create_frontdoor

request_approval

check_approval

notify_human

guaranteed_delivery

create_vault

kv_set

kv_get

kv_list

save_checkpoint

create_checkpoint

load_checkpoint

store_secret

create_queue

queue_push

queue_lease

queue_ack

create_counter

counter_incr

claim_operation

create_idempotency

publish_page

create_link

create_watch

watch_status

create_escalation

get_resource

extend_resource

cancel_resource

export_resource

credit_balance

create_subtoken

get_trial_credit

list_prices

request_feature

Install

Remote endpoint