Add Subscriptions API suspend and reactivate paths

[asonnenschein]

Add Subscription Suspend and Reactivate Support

Summary

Adds support for suspending and reactivating subscriptions in the Planet SDK. Users can now temporarily pause subscriptions without canceling them, and resume them
later with their original configuration intact.

What's New

SDK Methods (Async & Sync)

• suspend_subscription(subscription_id, details=None) - Suspend a single subscription
• reactivate_subscription(subscription_id) - Reactivate a suspended subscription
• bulk_suspend_subscriptions(subscription_ids=None, details=None, all_subscriptions=False) - Suspend multiple subscriptions
• bulk_reactivate_subscriptions(subscription_ids=None, all_subscriptions=False) - Reactivate multiple subscriptions

CLI Commands

planet subscriptions suspend <id> [--details <text>]
planet subscriptions reactivate <id>
planet subscriptions bulk-suspend [--subscription-ids <ids>] [--all] [--details <text>]
planet subscriptions bulk-reactivate [--subscription-ids <ids>] [--all]

Bulk Operation Modes

1. No flags - All user subscriptions (default)
2. --subscription-ids - Specific subscriptions
3. --all - All organization subscriptions (admin only)

Files Changed

• planet/clients/subscriptions.py - Async client methods
• planet/sync/subscriptions.py - Sync wrapper methods
• planet/cli/subscriptions.py - CLI commands
• tests/integration/test_subscriptions_api.py - API tests (24 new tests)
• tests/integration/test_subscriptions_cli.py - CLI tests (16 new tests)
• docs/cli/cli-subscriptions.md - Documentation

Example Usage

  from planet import Planet

  pl = Planet()

  # Suspend with details
  pl.subscriptions.suspend_subscription(
      "cb817760-1f07-4ee7-bba6-bcac5346343f",
      details="Maintenance window"
  )

  # Reactivate
  pl.subscriptions.reactivate_subscription("cb817760-1f07-4ee7-bba6-bcac5346343f")

  # Bulk suspend all user subscriptions
  pl.subscriptions.bulk_suspend_subscriptions(details="System maintenance")

  # Bulk suspend specific subscriptions
  pl.subscriptions.bulk_suspend_subscriptions(subscription_ids=["id1", "id2"])

[Copilot]

Pull request overview

This PR adds subscription suspend and reactivate functionality to the Planet SDK, enabling users to temporarily pause subscriptions without canceling them. The implementation follows the existing patterns in the codebase and includes comprehensive test coverage.

Changes:

• Added four new SDK methods (async and sync): suspend_subscription, reactivate_subscription, bulk_suspend_subscriptions, and bulk_reactivate_subscriptions
• Added four new CLI commands: suspend, reactivate, bulk-suspend, and bulk-reactivate with flexible operation modes
• Fixed minor documentation typos in existing methods (Args: instead of Args)

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
planet/clients/subscriptions.py	Async client methods for suspend/reactivate operations with validation logic
planet/sync/subscriptions.py	Synchronous wrapper methods and typo fixes
planet/cli/subscriptions.py	CLI commands for suspend/reactivate with optional parameters
tests/integration/test_subscriptions_api.py	24 new test cases covering success/failure scenarios and parameter validation
tests/integration/test_subscriptions_cli.py	16 new CLI test cases with proper mock setup
docs/cli/cli-subscriptions.md	Comprehensive documentation with usage examples

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[charcey]

LGTM!