{"openapi":"3.0.3","info":{"title":"HopTire Public Guide API","version":"1.0.0","description":"Published reference guidance only. Not live quotes, fitment or safety diagnosis, availability, booking, or payment. The user controls the handoff."},"servers":[{"url":"https://hoptire.com"}],"security":[],"paths":{"/api/agent/guides":{"get":{"operationId":"hoptire_list_public_guides","summary":"List published quote-preparation guides","description":"Returns at most ten explicitly approved public guides. No query parameters or personal data are accepted. Held pages are omitted. Published reference guidance only. Not live quotes, fitment or safety diagnosis, availability, booking, or payment. The user controls the handoff.","security":[],"parameters":[],"responses":{"200":{"description":"Available public guide summaries.","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Public responses require revalidation. Errors use no-store."},"Access-Control-Allow-Origin":{"schema":{"type":"string","enum":["*"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GuideList"}}}},"400":{"description":"Invalid query. No input is echoed.","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Public responses require revalidation. Errors use no-store."},"Access-Control-Allow-Origin":{"schema":{"type":"string","enum":["*"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvalidRequest"}}}},"404":{"description":"Guide unavailable. No publication or storage details are disclosed.","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Public responses require revalidation. Errors use no-store."},"Access-Control-Allow-Origin":{"schema":{"type":"string","enum":["*"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}}}}}},"/api/agent/guide":{"get":{"operationId":"hoptire_get_public_guide","summary":"Read one published quote-preparation guide","description":"Use exactly one path parameter. Duplicate and unknown parameters are rejected. Absolute URLs, traversal, query strings inside the path, and private paths are not accepted. Do not send personal data. Published reference guidance only. Not live quotes, fitment or safety diagnosis, availability, booking, or payment. The user controls the handoff.","security":[],"parameters":[{"name":"path","in":"query","required":true,"allowEmptyValue":false,"description":"Exact canonical path from the integration allowlist. A listed path can be unavailable when publication is held.","schema":{"type":"string","minLength":1,"maxLength":160,"pattern":"^/[a-z0-9-]+(?:/[a-z0-9-]+)*$","enum":["/locations/boise-id","/locations/denver-co","/locations/savannah-ga","/locations/los-angeles-ca","/guides/free-flat-tire-repair","/guides/flat-tire-in-driveway","/guides/flat-tire-at-work","/guides/prepare-for-mobile-tire-service","/guides/nail-in-tire-can-it-be-repaired","/cost/mobile-tire-replacement"]}}],"responses":{"200":{"description":"Public guide with cleaned Markdown.","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Public responses require revalidation. Errors use no-store."},"Access-Control-Allow-Origin":{"schema":{"type":"string","enum":["*"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GuideDetail"}}}},"400":{"description":"Invalid query. No input is echoed.","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Public responses require revalidation. Errors use no-store."},"Access-Control-Allow-Origin":{"schema":{"type":"string","enum":["*"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvalidRequest"}}}},"404":{"description":"Guide unavailable. No publication or storage details are disclosed.","headers":{"Cache-Control":{"schema":{"type":"string"},"description":"Public responses require revalidation. Errors use no-store."},"Access-Control-Allow-Origin":{"schema":{"type":"string","enum":["*"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFound"}}}}}}}},"components":{"schemas":{"GuideSummary":{"type":"object","additionalProperties":false,"required":["title","description","canonicalUrl","updatedAt","handoffUrl"],"properties":{"title":{"type":"string","minLength":1,"description":"Public page title."},"description":{"type":"string","minLength":1,"description":"Public page description."},"canonicalUrl":{"type":"string","format":"uri","enum":["https://hoptire.com/locations/boise-id","https://hoptire.com/locations/denver-co","https://hoptire.com/locations/savannah-ga","https://hoptire.com/locations/los-angeles-ca","https://hoptire.com/guides/free-flat-tire-repair","https://hoptire.com/guides/flat-tire-in-driveway","https://hoptire.com/guides/flat-tire-at-work","https://hoptire.com/guides/prepare-for-mobile-tire-service","https://hoptire.com/guides/nail-in-tire-can-it-be-repaired","https://hoptire.com/cost/mobile-tire-replacement"]},"updatedAt":{"type":"string","format":"date","nullable":true,"description":"Published lastVerifiedAt date; null when unknown. Not a live availability timestamp."},"handoffUrl":{"type":"string","format":"uri","enum":["https://hoptire.com/book?utm_source=composio&utm_medium=agent&utm_campaign=toolkit"],"description":"Offer this link to the user. Do not submit the form for the user."}}},"Guide":{"type":"object","additionalProperties":false,"required":["title","description","canonicalUrl","updatedAt","handoffUrl","bodyMarkdown"],"properties":{"title":{"type":"string","minLength":1,"description":"Public page title."},"description":{"type":"string","minLength":1,"description":"Public page description."},"canonicalUrl":{"type":"string","format":"uri","enum":["https://hoptire.com/locations/boise-id","https://hoptire.com/locations/denver-co","https://hoptire.com/locations/savannah-ga","https://hoptire.com/locations/los-angeles-ca","https://hoptire.com/guides/free-flat-tire-repair","https://hoptire.com/guides/flat-tire-in-driveway","https://hoptire.com/guides/flat-tire-at-work","https://hoptire.com/guides/prepare-for-mobile-tire-service","https://hoptire.com/guides/nail-in-tire-can-it-be-repaired","https://hoptire.com/cost/mobile-tire-replacement"]},"updatedAt":{"type":"string","format":"date","nullable":true,"description":"Published lastVerifiedAt date; null when unknown. Not a live availability timestamp."},"handoffUrl":{"type":"string","format":"uri","enum":["https://hoptire.com/book?utm_source=composio&utm_medium=agent&utm_campaign=toolkit"],"description":"Offer this link to the user. Do not submit the form for the user."},"bodyMarkdown":{"type":"string","minLength":1,"maxLength":100000,"description":"Public Markdown, with internal render markers and comments removed. Published prices are reference guidance, not live quotes."}}},"GuideList":{"type":"object","additionalProperties":false,"required":["limitations","guides"],"properties":{"limitations":{"type":"string","enum":["Published reference guidance only. Not live quotes, fitment or safety diagnosis, availability, booking, or payment. The user controls the handoff."]},"guides":{"type":"array","maxItems":10,"items":{"$ref":"#/components/schemas/GuideSummary"}}}},"GuideDetail":{"type":"object","additionalProperties":false,"required":["limitations","guide"],"properties":{"limitations":{"type":"string","enum":["Published reference guidance only. Not live quotes, fitment or safety diagnosis, availability, booking, or payment. The user controls the handoff."]},"guide":{"$ref":"#/components/schemas/Guide"}}},"InvalidRequest":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"string","enum":["Invalid request."]}}},"NotFound":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"string","enum":["Guide not found."]}}}}}}