{"slug":"api-versioning","source_name":"api-versioning","name":"API URL versioning","description":"Use when adding or evolving the version scheme of a resource-style HTTP API: put a single integer major as a `/v2/` leading path prefix, bump the major only on a breaking change while additive changes keep the version, serve the old and new majors in parallel behind Deprecation and Sunset response headers, and version the whole API as one unit — which cheaper models do not do by default. Do NOT use for library or package release numbers (SemVer), for generic REST resource-and-collection URL naming, or for documenting operations in an OpenAPI schema.","version":1,"lift":{"pass_rate_delta_pts":16,"pass_rate_pct":24,"total_cases":25,"passed_cases":6,"tokens_delta_pct":24.3,"turns_delta_pct":0,"verdict":"mixed","benchmark_model":"gemini-3.6-flash","grading_method":"judged","completed_at":"2026-07-29T03:14:55.717750+00:00"},"skill_score":0.24,"benchmark_models":[{"model":"gemini-3.6-flash","headline":true,"delta_pts":16,"with_pass_pct":24,"without_pass_pct":8,"tokens_delta_pct":24.3,"turns_delta_pct":0,"total_cases":25,"cases_aggregated":25,"verdict":"mixed","never_hurt":true,"completed_at":"2026-07-29T03:14:55.717750+00:00","run_id":"045aa404-c17d-4bd3-8d31-09990dcb28e5","version_number":1,"is_latest_version":true,"gate":null},{"model":"gemini-3.5-flash","headline":false,"delta_pts":null,"with_pass_pct":null,"without_pass_pct":null,"tokens_delta_pct":508.8,"turns_delta_pct":0,"total_cases":22,"cases_aggregated":22,"verdict":"mixed","never_hurt":true,"completed_at":"2026-07-10T10:29:34.572156+00:00","run_id":"c843becd-93d2-41ce-9e6e-c57fa96c5130","version_number":1,"is_latest_version":true,"gate":"not_comparable"}],"trust":{"skill_safety":"passed","safety_status":"clean","intent_verdict":"safe","content_status":"clean","indexable":true},"license":null,"install_count":0,"manifest_hash":"5eb4418e5d15bffaf88ec408f77af7a2d7aadd80f40ab9beff1cf08789d71ef7","raw_url":"https://app.decimal.ai/s/api-versioning/SKILL.md","scorecard_url":"https://app.decimal.ai/skills/api-versioning"}