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"}'
# Tags the most recently created receipt for this job. If the job produced
# more than one receipt, use its rcpt_… id instead to target a specific one.
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"}'
{
"success": true,
"receipt_id": "rcpt_01HGW2HB4V",
"value_tag": {
"type": "revenue",
"amount": 50.00,
"status": "pending"
}
}
Receipts & Analytics
Tag Receipt Value
Report business value generated by a tool execution. Tags are pending until validated by the judge service.
PATCH
/
v1
/
analytics
/
receipts
/
{receiptId}
/
value
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"}'
# Tags the most recently created receipt for this job. If the job produced
# more than one receipt, use its rcpt_… id instead to target a specific one.
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"}'
{
"success": true,
"receipt_id": "rcpt_01HGW2HB4V",
"value_tag": {
"type": "revenue",
"amount": 50.00,
"status": "pending"
}
}
Records the business value a tool execution generated, by receipt ID or
request_id. Tags are stored as pending and count toward RoCS only after the judge service validates them.
Path Parameters
string
required
The
rcpt_* receipt ID or the request_id/job_id (UUID) from the originating tool call. A job can produce several receipts (e.g. the email worker loop), so tagging by request_id tags the job’s most recently created receipt. The response returns the receipt_id (rcpt_…) that was updated. To target a specific receipt, use its rcpt_… id.Body
string
required
One of
revenue, lead, conversion, savings, engagement.number
required
Amount in USD. Positive, max $1,000,000.
string
Description (max 200 characters).
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"}'
# Tags the most recently created receipt for this job. If the job produced
# more than one receipt, use its rcpt_… id instead to target a specific one.
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"}'
{
"success": true,
"receipt_id": "rcpt_01HGW2HB4V",
"value_tag": {
"type": "revenue",
"amount": 50.00,
"status": "pending"
}
}
Value tags start as
pending. A judge service checks each claim against observed outcomes (email replies, payment confirmations, notification events) before promoting it to confirmed. Only confirmed tags count toward RoCS.