{"openapi":"3.1.0","info":{"title":"ArgonautWorks Schedule Fit API","version":"0.2.0","description":"DST-aware overlap calculation for shared business hours across 2 to 8 IANA time zones.","license":{"name":"MIT","identifier":"MIT"},"contact":{"name":"ArgonautWorks","url":"https://github.com/ArgonautWorks/schedule-fit-api"},"x-guidance":"Use this endpoint when an agent must determine whether a meeting of a requested duration fits inside the same local work hours for participants in multiple IANA time zones."},"servers":[{"url":"https://argonaut-schedule-fit.vercel.app"}],"paths":{"/api/v1/overlap":{"get":{"operationId":"calculateBusinessHoursOverlap","summary":"Find a shared DST-aware business-hours window","parameters":[{"name":"zones","required":true,"description":"Two to eight comma-separated IANA time zones.","schema":{"type":"string"},"example":"America/New_York,Europe/Berlin","in":"query"},{"name":"date","required":true,"description":"Local calendar date applied in every zone.","schema":{"type":"string","format":"date"},"example":"2026-08-04","in":"query"},{"name":"work_start","required":false,"schema":{"type":"string","default":"09:00"},"in":"query"},{"name":"work_end","required":false,"schema":{"type":"string","default":"17:00"},"in":"query"},{"name":"duration_minutes","required":false,"schema":{"type":"integer","minimum":1,"maximum":1440,"default":30},"in":"query"}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Overlap calculation","content":{"application/json":{"schema":{"type":"object","required":["feasible","requested_duration_minutes","available_minutes","non_overlapping_slot_count","query","overlap","work_windows","assumptions"],"properties":{"feasible":{"type":"boolean"},"requested_duration_minutes":{"type":"integer"},"available_minutes":{"type":"integer"},"non_overlapping_slot_count":{"type":"integer"},"query":{"type":"object"},"overlap":{"type":["object","null"]},"work_windows":{"type":"object"},"assumptions":{"type":"array","items":{"type":"string"}}}}}}},"400":{"description":"Invalid date, time, duration, or IANA zone"},"402":{"description":"x402 Base-USDC payment challenge"}}},"post":{"operationId":"calculateBusinessHoursOverlapFromJson","summary":"Find a shared DST-aware business-hours window","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["zones","date"],"additionalProperties":false,"properties":{"zones":{"type":"string","description":"Two to eight comma-separated IANA time zones."},"date":{"type":"string","format":"date"},"work_start":{"type":"string","default":"09:00"},"work_end":{"type":"string","default":"17:00"},"duration_minutes":{"type":"integer","minimum":1,"maximum":1440,"default":30}}},"example":{"zones":"America/New_York,Europe/Berlin","date":"2026-08-04","duration_minutes":30}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Overlap calculation"},"400":{"description":"Invalid date, time, duration, or IANA zone"},"402":{"description":"x402 Base-USDC payment challenge"}}}}}}