{"uid":"cap_2zhzWZGbEJS8k4Zug-AKU","slug":"agenttimetools-add-datetime-addition-by-lin-desk-1bbf6140","name":"AgentTimeTools Add — Datetime Addition by LIN Desk","description":"Pay-per-call API for AI agents: turn any public web page or PDF into clean, LLM-ready Markdown. $0.002 per call in USDC on Base via x402. No API key, no signup.","url":"https://lin-desk-x402.lindesk.workers.dev/v1/timetools/add?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["input"],"properties":{"tz":{"type":"string","description":"IANA timezone, e.g. Asia/Tokyo"},"days":{"type":"string","pattern":"^-?\\d+(\\.\\d+)?$"},"input":{"type":"string","description":"Datetime / unix / ISO string (empty for diff with a,b)"},"seconds":{"type":"string","pattern":"^-?\\d+(\\.\\d+)?$"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"op":{"type":"string"},"meta":{"type":"object","properties":{"chars_in":{"type":"integer"},"chars_out":{"type":"integer"},"elapsed_ms":{"type":"integer"}}},"result":{}}}}}}},"responseSchema":{"type":"json","example":{"op":"add","meta":{"chars_in":20,"chars_out":25,"elapsed_ms":0},"result":"2026-10-04T19:00:00+00:00"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_dMMLy4nhLD8WyaML81Aqf","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Adds a specified number of days and/or seconds to a given datetime string, returning the result as an ISO 8601 timestamp in the requested timezone","exampleAgentPrompt":"What is the ISO datetime exactly 14 days and 3600 seconds after 2025-06-15T09:00:00 in the Asia/Tokyo timezone?","exampleUseCases":[{"title":"Compute subscription expiry date","prompt":"My user's subscription starts on 2025-07-01T00:00:00 UTC — what is the exact ISO datetime 30 days later in the America/New_York timezone?"},{"title":"Schedule follow-up reminder offset","prompt":"I need to schedule a follow-up exactly 7 days and 7200 seconds after 2025-08-10T14:30:00 in Europe/London — what's the resulting ISO timestamp?"},{"title":"Deadline calculation for a task","prompt":"A task was created at 2025-09-01T08:00:00 and is due 45 days later in Asia/Singapore time — can you compute the exact ISO deadline?"}],"resultDescription":"Returns a JSON object with: 'op' (the operation name, e.g. 'add'), 'meta' containing chars_in, chars_out, and elapsed_ms, and 'result' as the computed ISO 8601 datetime string in the requested timezone (e.g. '2026-10-04T19:00:00+08:00').","failureModes":["Invalid or unrecognized datetime input string — returns error or unexpected result","Unknown IANA timezone string — may return error or fall back to UTC","Non-numeric days or seconds parameter — rejected by schema pattern validation","Missing required 'input' query parameter — request fails validation","Network timeout on the Cloudflare Worker edge — rare but possible"],"whenToPreferThis":"Choose this endpoint when an AI agent needs deterministic, arithmetic datetime addition — adding a fixed number of days and/or seconds to a known datetime — especially when timezone-aware ISO output is required. Prefer it over general LLM reasoning for date math (which can hallucinate) or over full calendar APIs when you only need a simple offset computation with no scheduling side effects.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:44:29.952Z","isFirstParty":false,"canonicalSlug":"agenttimetools-add-datetime-addition-by-lin-desk-1bbf6140"}