---
title: "Mint a public proof-of-outcome share link for a receipt"
method: POST
path: "/v1/agent/receipts/share"
tags: ["Proof"]
---

# Mint a public proof-of-outcome share link for a receipt

`POST /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

Creates an unguessable, revocable bearer token (fdrsh_…) over a
TERMINAL intent receipt (CONFIRMED, FAILED, or REJECTED — in-flight
receipts are rejected with 409). Only the SHA-256 of the token is
stored; the token is returned once and cannot be recovered. The served
projection is sanitized (credential-shaped fields stripped recursively
and every stripped path disclosed), digest-bound (SHA-256 full + public
digests), outcome classified, and Ed25519-signed. Requires session
ownership of the receipt's parent intent.

## Headers

- `X-ClawHub-Skill` string

## Request body

- object
  - `receipt_id` string, required: Receipt id starting with fdrcpt_
  - `sessionId` string, required
  - `agentAddress` string, required
  - `sessionToken` string, required

## Response `201`

Share created — token shown once, never recoverable

- object
  - `ok` true, required
  - `token` string, required: fdrsh_-prefixed bearer token; store it now
  - `url` string, uri, required
  - `receipt_id` string, required
  - `created_at` string, date-time
  - `warning` string, required

## Other responses

- `400`: Invalid parameters
- `402`: Free-tier limit exceeded — x402 payment required
- `404`: Receipt not found
- `409`: Receipt not terminal (still in flight)
- `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)