{"openapi":"3.0.3","info":{"title":"idlidu Robots API","version":"2026.09.0","description":"Point-in-time robots.txt / AI-policy evidence archive. Evidence product — not legal advice; does not authorize crawling."},"servers":[{"url":"https://robots-api.idlidu.com"}],"paths":{"/v1/health":{"get":{"summary":"Health","responses":{"200":{"description":"OK"}}}},"/v1/openapi.json":{"get":{"summary":"OpenAPI document","responses":{"200":{"description":"OpenAPI 3 JSON"}}}},"/v1/public/tools":{"get":{"summary":"Public MCP tool catalog","responses":{"200":{"description":"Tool definitions"}}}},"/v1/public/sample/domains":{"get":{"summary":"Free sample domains (≤3, no key)","responses":{"200":{"description":"Sample"}}}},"/v1/billing/webhook":{"post":{"summary":"Checkout / subscription webhook (mint idl_robots_ keys)","responses":{"200":{"description":"Handled"},"400":{"description":"Invalid payload"}}}},"/v1/billing/portal":{"get":{"summary":"Portal placeholder URL","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Portal"},"401":{"description":"Unauthorized"}}}},"/v1/usage":{"get":{"summary":"API usage","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Usage"},"401":{"description":"Unauthorized"}}}},"/v1/domains":{"get":{"summary":"List archive domains (plan domain cap)","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Domains"},"401":{"description":"Unauthorized"}}}},"/v1/domains/{domain}/as-of":{"get":{"summary":"Domain snapshot as-of date","security":[{"bearerAuth":[]}],"parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string"}},{"name":"date","in":"query","schema":{"type":"string"}},{"name":"artifact_kind","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Snapshot"},"401":{"description":"Unauthorized"},"403":{"description":"History depth upgrade required"},"404":{"description":"No snapshot"}}}},"/v1/domains/{domain}/history":{"get":{"summary":"Domain snapshot history","security":[{"bearerAuth":[]}],"parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string"}},{"name":"since","in":"query","schema":{"type":"string"}},{"name":"artifact_kind","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"History"},"401":{"description":"Unauthorized"}}}},"/v1/permission":{"get":{"summary":"Agent permission query (evidence)","security":[{"bearerAuth":[]}],"parameters":[{"name":"domain","in":"query","required":true,"schema":{"type":"string"}},{"name":"agent","in":"query","required":true,"schema":{"type":"string"}},{"name":"path","in":"query","schema":{"type":"string"}},{"name":"date","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Permission exhibit"},"401":{"description":"Unauthorized"},"404":{"description":"No snapshot"}}}},"/v1/indices":{"get":{"summary":"List indices","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Index ids"},"401":{"description":"Unauthorized"}}}},"/v1/indices/{indexId}":{"get":{"summary":"Index time series","security":[{"bearerAuth":[]}],"parameters":[{"name":"indexId","in":"path","required":true,"schema":{"type":"string"}},{"name":"from","in":"query","schema":{"type":"string"}},{"name":"to","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Points"},"401":{"description":"Unauthorized"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API key with prefix idl_robots_"}}}}