> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oneshotagent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tag Receipt Value

> Report business value generated by a tool execution. Tags are pending until validated by the judge service.

Report the business value a tool execution generated. Tags are stored as **pending** and only count toward [RoCS](/api-reference/analytics/rocs) after validation by the judge service.

## Path Parameters

<ParamField path="receiptId" type="string" required>
  Either the `rcpt_*` receipt ID **or** the `request_id`/`job_id` (UUID) returned from the originating tool call. The API resolves a UUID via `Receipt.job_id`, so you can tag value using whichever identifier you kept — no [List Receipts](/api-reference/analytics/receipts) lookup required.
</ParamField>

## Body

<ParamField body="type" type="string" required>
  Value type. One of: `revenue`, `lead`, `conversion`, `savings`, `engagement`
</ParamField>

<ParamField body="amount" type="number" required>
  Value amount in USD. Must be positive, max \$1,000,000.
</ParamField>

<ParamField body="label" type="string">
  Optional description (max 200 characters)
</ParamField>

<RequestExample>
  ```bash By receipt id theme={null}
  curl -X PATCH https://win.oneshotagent.com/v1/analytics/receipts/rcpt_01HGW2HB4V/value \
    -H "X-Agent-ID: 0xYourWalletAddress" \
    -H "Content-Type: application/json" \
    -d '{"type": "revenue", "amount": 50.00, "label": "Sale from outbound email"}'
  ```

  ```bash By request_id theme={null}
  # Use the request_id you kept from the original tool call — no lookup needed.
  curl -X PATCH https://win.oneshotagent.com/v1/analytics/receipts/0cbb87ee-1f2a-4c3d-9e8b-7a6f5d4c3b2a/value \
    -H "X-Agent-ID: 0xYourWalletAddress" \
    -H "Content-Type: application/json" \
    -d '{"type": "lead", "amount": 1, "label": "Replied to outreach"}'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "receipt_id": "rcpt_01HGW2HB4V",
    "value_tag": {
      "type": "revenue",
      "amount": 50.00,
      "status": "pending"
    }
  }
  ```
</ResponseExample>

<Note>
  Value tags start as `pending`. A judge service validates claims against observed outcomes (email replies, payment confirmations, notification events) before promoting to `confirmed`. Only confirmed tags count toward RoCS.
</Note>