{"openapi":"3.0.3","info":{"title":"Codex Resets Public API","version":"1.0.0","description":"Read-only access to Codex usage-limit announcements tracked by codex.si-resets.com. Independent project; not affiliated with OpenAI. Every entry links to the original public X post."},"servers":[{"url":"https://codex.si-resets.com"}],"paths":{"/api/v1/status":{"get":{"summary":"Get the current reset status","responses":{"200":{"description":"Latest reset plus aggregate stats","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/resets":{"get":{"summary":"List reset announcements","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0}},{"name":"kind","in":"query","schema":{"type":"string","enum":["reset","policy","all"],"default":"reset"}}],"responses":{"200":{"description":"Announcements, newest first","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/resets.csv":{"get":{"summary":"Download every reset as CSV","description":"RFC 4180 CSV, newest first. Columns: id, date (ISO-8601 UTC), type (full, partial or banked), scope, author (X handle), url (the source post).","responses":{"200":{"description":"CSV of every reset","content":{"text/csv":{"schema":{"type":"string"}}}}}}},"/rss/resets.xml":{"get":{"summary":"Resets as RSS 2.0","description":"One item per reset, newest first, linking its /resets/YYYY-MM-DD permalink. Limit changes are not resets and are not in this feed.","responses":{"200":{"description":"RSS 2.0 feed","content":{"application/rss+xml":{"schema":{"type":"string"}}}}}}},"/calendar.ics":{"get":{"summary":"Resets as an iCalendar feed","description":"RFC 5545 VCALENDAR. One VEVENT per reset at its announcement time, plus a deadline VEVENT for a banked reset that names a usable_until.","responses":{"200":{"description":"iCalendar file","content":{"text/calendar":{"schema":{"type":"string"}}}}}}},"/data/summary.json":{"get":{"summary":"One object of summary numbers","description":"Last reset, last full reset, counts of resets, banked and partial resets and limit changes, mean and longest gap, pace per month, every feed URL, and a definition of each reset type.","responses":{"200":{"description":"Summary","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/data/resets.json":{"get":{"summary":"Every event as JSON","description":"All events, newest first, in the same shape as /api/v1/resets. Resets also carry permalink and days_after_previous.","responses":{"200":{"description":"Events","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/data/monthly-resets.csv":{"get":{"summary":"Monthly counts across every tracker","description":"RFC 4180 CSV, one row per calendar month. Columns: month, window_start_utc, window_end_utc, partial_month, then <tracker>_resets and <tracker>_limit_changes per tracker.","responses":{"200":{"description":"CSV of monthly counts","content":{"text/csv":{"schema":{"type":"string"}}}}}}},"/api/statusline":{"get":{"summary":"One line for a terminal status line","description":"Text, one line: how long since the last reset, and the nearest open banked deadline.","responses":{"200":{"description":"One line","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/statusline.sh":{"get":{"summary":"Status-line script","description":"A bash script that prints /api/statusline, caches it for ten minutes, and falls back to the cached line offline.","responses":{"200":{"description":"Shell script","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/mcp":{"post":{"summary":"Model Context Protocol endpoint","description":"JSON-RPC 2.0 over HTTP (MCP Streamable HTTP, application/json responses). Tools: get_status and list_resets.","responses":{"200":{"description":"JSON-RPC response","content":{"application/json":{"schema":{"type":"object"}}}},"202":{"description":"Notification accepted, no body"}}}}},"externalDocs":{"description":"Markdown summary for agents","url":"https://codex.si-resets.com/llms.txt"}}