The API endpoints for managing secrets are being updated, with some deprecated and new ones introduced. On December 31, 2024, GET /apps/{app-slug}/secrets/{secret-name}/value and PUT /apps/{app-slug}/secrets/{secret-name} will be removed. New endpoints include POST /apps/{app-slug}/secrets for creating secrets, PATCH /apps/{app-slug}/secrets/{secret-name} for updates, and an enhanced GET/apps/{app-slug}/secrets/{secret-name} that fetches secret details and is backward compatible. Users should switch to the new endpoints for a smooth transition.