---
title: "Revoke a receipt share link"
method: DELETE
path: "/v1/agent/receipts/share"
tags: ["Proof"]
---

# Revoke a receipt share link

`DELETE /v1/agent/receipts/share`

## Request

- Base URL: `https://www.farmdash.one`
- URL: `https://www.farmdash.one/v1/agent/receipts/share`
- Auth: one of:
  - HTTP bearer
  - none

Revokes the share (public URL returns 410 afterwards). Only the
creating agent (or internal service key) can revoke. Pass the token
as ?token= or in the body, AND the session credentials used at
creation (sessionId, agentAddress, and sessionToken via body or the
X-FarmDash-Session-Token header). Revocation propagates immediately —
share responses are served with Cache-Control: no-store.

## Query parameters

- `token` string, required

## Headers

- `X-ClawHub-Skill` string

## Request body

- object
  - `token` string
  - `sessionId` string
  - `agentAddress` string
  - `sessionToken` string

## Response `200`

Share revoked

- object
  - `ok` true
  - `revoked` true

## Other responses

- `400`: Invalid parameters
- `402`: Free-tier limit exceeded — x402 payment required
- `403`: Unknown share, already revoked, or not the creator
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/farmdash/apis/farmdash-agent-api.md) · [All operations](https://skmtc.dev/farmdash/apis/farmdash-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/farmdash/apis/farmdash-agent-api/revisions/96310281f58c?raw)