Skip to main content

Maintenance Mode

Overview

The Catalog API may occasionally enter maintenance mode for system updates, database optimizations, or other operational requirements. During these maintenance periods, certain API functionalities will be restricted.

Impact on API Operations

When the Catalog API is in maintenance mode:

  • All write operations (create, update, delete) across all endpoints will be unavailable
  • All import operations will be suspended
  • All read operations (listing, retrieving data) will remain available

API Response During Maintenance

When attempting to perform a write or import operation during maintenance mode, the API will respond with:

  • HTTP Status Code: 503 Service Unavailable
  • Error Message: "Catalog manager is in maintenance mode - all processing is suspended and changes are currently not possible"

Example Response

{
"detail": "Catalog manager is in maintenance mode - all processing is suspended and changes are currently not possible"
}

Maintenance Schedule

Maintenance operations are typically scheduled during off-peak hours to minimize disruption. For information about planned maintenance windows, please contact Partium support.

Recommendations

If you encounter a 503 error during your API operations:

  1. Wait for the maintenance to complete before retrying your request
  2. Monitor your application for 503 responses and implement appropriate retry logic with backoff periods
  3. For time-sensitive operations, consider scheduling them outside of typical maintenance windows

For any urgent issues during maintenance periods, please contact Partium support.