# Upgrade Guidance

## Get Upgrade Guidance

> Get or generate version upgrade guidance.

OpenAPI:

```json
{"openapi":"3.1.0","info":{"title":"FastAPI","version":"0.1.0"},"security":[{"HTTPBearer":[]}],"components":{"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"}}},"paths":{"/api/upgrade-guidance/":{"post":{"tags":["upgrade-guidance"],"summary":"Get Upgrade Guidance","description":"Get or generate version upgrade guidance.","operationId":"get_upgrade_guidance_api_upgrade_guidance__post","requestBody":{"content":{"application/json":{"schema":{"properties":{"package_name":{"type":"string","title":"Package Name"},"package_manager":{"type":"string","enum":["default","maven","pypi","npm","go","nuget","rubygems","composer","cargo"],"title":"PackageManager"},"from_versions":{"items":{"type":"string"},"type":"array","title":"From Versions"},"to_version":{"type":"string","title":"To Version"}},"type":"object","required":["package_name","package_manager","from_versions","to_version"],"title":"UpgradeGuidanceRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"id":{"type":"integer","title":"Id"},"guidance":{"type":"string","title":"Guidance"},"generated_at":{"type":"string","format":"date-time","title":"Generated At"}},"type":"object","required":["id","guidance","generated_at"],"title":"UpgradeGuidanceResponse"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"}}}}}}}}}
```

## Invalidate Upgrade Guidance

> Get or generate version upgrade guidance.

OpenAPI:

```json
{"openapi":"3.1.0","info":{"title":"FastAPI","version":"0.1.0"},"security":[{"HTTPBearer":[]}],"components":{"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"}}},"paths":{"/api/upgrade-guidance/invalidate":{"post":{"tags":["upgrade-guidance"],"summary":"Invalidate Upgrade Guidance","description":"Get or generate version upgrade guidance.","operationId":"invalidate_upgrade_guidance_api_upgrade_guidance_invalidate_post","requestBody":{"content":{"application/json":{"schema":{"properties":{"package_name":{"type":"string","title":"Package Name"},"package_manager":{"type":"string","enum":["default","maven","pypi","npm","go","nuget","rubygems","composer","cargo"],"title":"PackageManager"},"from_versions":{"items":{"type":"string"},"type":"array","title":"From Versions"},"to_version":{"type":"string","title":"To Version"}},"type":"object","required":["package_name","package_manager","from_versions","to_version"],"title":"UpgradeGuidanceRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"ok":{"type":"boolean","title":"Ok"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"type":"object","required":["ok"],"title":"Status"}}}},"404":{"description":"Not found"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"}}}}}}}}}
```
