{"uid":"cap_rmAY0-V7rE0YSA1-Qi54k","slug":"loyal-spark-update-reward-status-ed9954a2","name":"Loyal Spark Update Reward Status","description":"Onchain loyalty protocol on Base L2. Launch B20 rewards, earn and redeem tokens, trade P2P, automate with AI agents via REST and MCP.","url":"https://api.loyalspark.online/x402-gateway/mcp-tools/update_reward_status","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","toolName","inputSchema"],"properties":{"type":{"type":"string","const":"mcp"},"example":{"type":"object"},"toolName":{"type":"string"},"transport":{"enum":["streamable-http","sse"],"type":"string"},"description":{"type":"string"},"inputSchema":{"type":"object"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{}}}}},"responseSchema":{"type":"json"},"example":{"request":{"id":1,"method":"tools/call","params":{"name":"get_platform_info","arguments":{}},"jsonrpc":"2.0"},"response":{"id":1,"result":{"content":[{"text":"{\"name\":\"Loyal Spark\",\"chain\":\"Base L2\",\"chain_id\":8453,\"token_standard\":\"ERC-20\",\"features\":[\"loyalty_programs\",\"rewards\",\"marketplace\",\"tiers\",\"referrals\",\"vouchers\",\"analytics\"],\"api_docs\":\"https://loyalspark.online/api-docs\"}","type":"text"}]},"jsonrpc":"2.0"}},"exampleRequest":{"id":1,"method":"tools/call","params":{"name":"get_platform_info","arguments":{}},"jsonrpc":"2.0"},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_NvFpbImHtlkuZuyuqoEnO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Updates the status of a loyalty reward on the Loyal Spark onchain protocol running on Base L2","exampleAgentPrompt":"On Loyal Spark, update the status of reward ID 'rwrd_abc123' in my 'CoffeeClub' loyalty program to 'redeemed' — it was just claimed by a customer.","exampleUseCases":[{"title":"Disable expired loyalty offer quickly","prompt":"Hey, mark reward ID 'seasonal_summer_2024' as expired on our Loyal Spark program — we're wrapping up that promotion today and customers shouldn't see it anymore."},{"title":"Manage customer tier reward availability","prompt":"Update the status of our VIP tier reward 'vip_exclusive_50off' to inactive on Loyal Spark — we're pausing it while we reset the tier qualifications this month."},{"title":"Track redeemed rewards across campaigns","prompt":"On Loyal Spark, set reward ID 'flash_sale_bonus' to redeemed for our November campaign — we need to mark it as used so it doesn't get double-claimed by our customer base."}],"resultDescription":"A JSON response confirming the updated status of the specified loyalty reward, including the reward ID, new status value, and any relevant transaction or confirmation details from the Base L2 chain.","failureModes":["Invalid or non-existent reward ID returns an error response","Unauthorized access if caller lacks permission to modify the reward","Invalid status value supplied results in validation error","Network or Base L2 chain latency causes timeout","Payment of $0.01 USDC not fulfilled causes x402 payment required error","Reward already in terminal state (e.g. already redeemed) may reject update"],"whenToPreferThis":"Use this endpoint when you need to change the lifecycle state of an existing loyalty reward on the Loyal Spark protocol — for example marking it as redeemed, expired, or inactive after a customer claims it. Prefer this over creating a new reward when the reward already exists and only its status needs to change.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:46:45.043Z","isFirstParty":false}