# Mint One-Click Ack Link for Inbox Message

> Mint One-Click Ack Link for Inbox Message is a free API for AI agents from inbox.withzero.xyz, Free, status unknown (last checked 2026-09-15).

Generates a signed, time-limited URL that allows a human to acknowledge (clear) an inbox message without needing a crypto wallet.

## Facts

- Endpoint: POST https://inbox.withzero.xyz/api/v1/inbox/ack-link
- Price: Free
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 3
- Provider: inbox.withzero.xyz
- Website: https://inbox.withzero.xyz
- Canonical page: https://www.zero.xyz/c/inbox-withzero-xyz-mint-one-click-ack-link-for-inbox-message-ae7d999d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rxk2kmLPSLbFYyBXif3S4

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability inbox-withzero-xyz-mint-one-click-ack-link-for-inbox-message-ae7d999d -d '<json body>'
```

Example prompt: Generate a one-click acknowledgment link for inbox message id a3f1c2d4-5678-4abc-89de-0123456789ab that expires in 3 days, so a human reviewer can clear it from a hosted dashboard without needing a wallet.

## When to prefer this

Use this endpoint when you need a human (who does not have a crypto wallet or agent identity) to acknowledge or clear an inbox message, for example in dashboard UIs, email workflows, or scheduler interfaces where wallet-signing is impractical. Prefer this over direct ack endpoints when the acknowledging party is a human end-user rather than the agent itself.

## Known failure modes

- Message UUID not found or not owned by caller — 404 error
- TTL exceeds maximum of 30 days (2592000 seconds) — 422 validation error
- Invalid UUID format — 422 schema validation error
- Missing or invalid signed proof credential — 401 unauthorized
- Link already redeemed or expired — redemption failure at /api/v1/inbox/ack/redeem

## How this service works

Mint a signed one-click ack link for one of your messages. Embed it in a hosted page so a human can clear the item without a wallet. Redeemed at GET/POST /api/v1/inbox/ack/redeem. 📖 Full guide: https://inbox.withzero.xyz/llms.txt

## Output

Returns a JSON object containing a public one-click ack URL (suitable for embedding in a hosted page or dashboard) and an expiration timestamp. When a human clicks the URL and confirms, the message is acknowledged without requiring any wallet or cryptographic proof from the clicker.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "id"
 ],
 "properties": {
  "id": {
   "type": "string",
   "format": "uuid",
   "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
   "description": "Message id to mint a one-click ack link for."
  },
  "ttl_sec": {
   "type": "integer",
   "maximum": 2592000,
   "description": "Link lifetime in seconds (default 7 days, max 30 days).",
   "exclusiveMinimum": 0
  }
 },
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "url",
  "expires_at"
 ],
 "properties": {
  "url": {
   "type": "string",
   "description": "Public one-click ack URL. Embed it in a hosted page (e.g. a scheduler cdn dashboard); clicking it (with a confirm step) acks the message — no wallet/proof needed by the clicker."
  },
  "expires_at": {
   "type": "string"
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/inbox-withzero-xyz-mint-one-click-ack-link-for-inbox-message-ae7d999d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from inbox.withzero.xyz](https://www.zero.xyz/host/inbox.withzero.xyz/llms.txt)