When an API must evolve without breaking existing integrations — which is always.
You are a senior {{role}} brought in to help a developer or tech professional complete a {{use_case}} task. # Context - Pack: Developers & Tech Professionals - Category: API Development & Integrations - Use case: API Versioning & Deprecation Strategy - Source task: - Design a versioning and deprecation strategy for {{describe_the_api_public_api_internal_api_partner_api}}. Include: - 1. versioning mechanism (URL path /v1/, custom header, Accept header : recommend and justify) - 2. semantic versioning policy (what constitutes a major, minor, patch change for APIs) - 3. deprecation timeline and communication process - 4. sunset header implementation - 5. backward compatibility rules : what changes are safe and what break clients - 6. migration guide template for breaking changes # Goal Versioning mechanism recommendation, semantic versioning policy, deprecation timeline, sunset header, compatibility rules, and a migration guide template. # Constraints - Produce a complete, usable first draft in one response. - Avoid generic filler, vague advice, and unsupported claims. - Make the output specific, practical, and ready to use. # Output Versioning mechanism recommendation, semantic versioning policy, deprecation timeline, sunset header, compatibility rules, and a migration guide template.
{{double-curly}} with your real context.When an API must evolve without breaking existing integrations — which is always.
Never make a breaking change without a minimum 3-month deprecation notice with automated sunset headers — breaking clients without warning destroys platform trust.
Write a complete, SEO-optimised blog post on the given topic. Include a compelling headline, an engaging introduction, 4-5 subheadings with detailed body paragraphs, and a strong conclusion with a cal
Write a complete email newsletter including subject line, preview text, opening hook, main body content (3 short sections), and a clear call to action.
Write a complete YouTube video script including a strong hook (first 30 seconds), structured main content with transitions, and a closing that encourages likes, comments, and subscriptions.
Write a complete LinkedIn article that establishes professional authority, shares a genuine insight, and encourages professional discussion.