feat: API specs update for version latest - #105
Conversation
Greptile SummaryThis PR refreshes the latest OpenAPI contracts, adds a canonical combined specification, annotates security schemes with platform availability, and updates dedicated-database pricing, autoscaling, and resize-state schemas.
Confidence Score: 4/5The PR appears safe to merge after correcting the non-blocking but misleading database autoscaling example. The contract changes are internally aligned across the latest artifacts, but the database example describes a 30 GB autoscaling ceiling for a database already at 100 GB and resizing to 120 GB. Files Needing Attention: specs/latest/open-api3-latest-server.json, specs/latest/open-api3-latest-console.json, specs/latest/open-api3-latest.json Important Files Changed
Prompt To Fix All With AI### Issue 1
specs/latest/open-api3-latest-server.json:107067
**Autoscaling example contradicts limits**
The example enables autoscaling while reporting `storage: 100`, `storageTargetGb: 120`, and `storageAutoscalingMaxGb: 30`. Because the documented maximum is below both the current and target sizes, this cannot represent a coherent resize state and may produce misleading generated documentation or mock data. The same contradictory example appears in the Console and canonical artifacts.
---
For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.Reviews (1): Last reviewed commit: "chore: add the canonical OpenAPI documen..." | Re-trigger Greptile |
| @@ -107045,7 +107067,7 @@ | |||
| "pitrRetentionDays": 14, | |||
There was a problem hiding this comment.
Autoscaling example contradicts limits
The example enables autoscaling while reporting storage: 100, storageTargetGb: 120, and storageAutoscalingMaxGb: 30. Because the documented maximum is below both the current and target sizes, this cannot represent a coherent resize state and may produce misleading generated documentation or mock data. The same contradictory example appears in the Console and canonical artifacts.
Prompt To Fix With AI
This is a comment left during a code review.
Path: specs/latest/open-api3-latest-server.json
Line: 107067
Comment:
**Autoscaling example contradicts limits**
The example enables autoscaling while reporting `storage: 100`, `storageTargetGb: 120`, and `storageAutoscalingMaxGb: 30`. Because the documented maximum is below both the current and target sizes, this cannot represent a coherent resize state and may produce misleading generated documentation or mock data. The same contradictory example appears in the Console and canonical artifacts.
---
For each issue above, determine whether it is valid and should be fixed. If so, fix it directly.
This PR contains API specification updates for version latest.