Deprecation Alerts

Get notified before models you depend on are deprecated, giving you time to plan migrations.

How Alerts Work

GateFlow monitors:

• Provider announcements (blogs, changelogs, docs)
• API responses indicating deprecation
• Community reports of issues

When a deprecation is detected for a model you use:

Enabling Alerts

Via Dashboard

1. Go to Settings → Change Management
2. Enable Deprecation Alerts
3. Configure notification channels
4. Set alert thresholds

Via API

curl -X PATCH https://api.gateflow.ai/v1/management/settings/alerts \
  -H "Authorization: Bearer gw_prod_admin_key" \
  -H "Content-Type: application/json" \
  -d '{
    "deprecation_alerts": {
      "enabled": true,
      "channels": ["email", "slack", "webhook"],
      "thresholds": {
        "planning": 90,
        "action_needed": 30,
        "urgent": 7
      }
    }
  }'

Notification Channels

Email

{
  "channels": {
    "email": {
      "recipients": ["team@company.com", "oncall@company.com"]
    }
  }
}

Slack

{
  "channels": {
    "slack": {
      "webhook_url": "https://hooks.slack.com/services/...",
      "channel": "#ai-platform"
    }
  }
}

Webhook

{
  "channels": {
    "webhook": {
      "url": "https://your-service.com/webhooks/gateflow",
      "headers": {
        "Authorization": "Bearer your-secret"
      }
    }
  }
}

Webhook payload:

{
  "event": "deprecation.alert",
  "severity": "action_needed",
  "deprecation": {
    "model": "gpt-4-turbo",
    "provider": "openai",
    "sunset_date": "2026-06-01",
    "days_remaining": 30,
    "your_usage": {
      "requests_last_30d": 15420,
      "cost_last_30d": 234.56
    },
    "recommended_action": "migrate_to_gpt-5.2"
  }
}

PagerDuty

{
  "channels": {
    "pagerduty": {
      "integration_key": "...",
      "severity_mapping": {
        "urgent": "critical",
        "action_needed": "warning",
        "planning": "info"
      }
    }
  }
}

Alert Content

Planning Alert (90 days)

Subject: [GateFlow] Model Deprecation Notice: gpt-4-turbo

Hi,

OpenAI has announced that gpt-4-turbo will be deprecated on 2026-06-01.

Your usage (last 30 days):
- Requests: 15,420
- Cost: $234.56
- Affected services: api-service, chatbot

Recommended replacement: gpt-5.2
- Superior capabilities
- Larger context window (256k)
- Better cost per token

No action required yet. Start planning your migration.

View migration guide: https://gateflow.ai/docs/migrations/gpt-4-turbo

Action Needed Alert (30 days)

Subject: [GateFlow] Action Required: gpt-4-turbo deprecation in 30 days

ATTENTION: gpt-4-turbo will stop working on 2026-06-01.

You have 30 days to migrate. GateFlow will automatically
fall back to gpt-5.2 after the sunset date.

To prepare:
1. Review the migration wizard
2. Test with gpt-5.2 in staging
3. Enable auto-fallback (recommended)

Auto-fallback status: ENABLED
Fallback model: gpt-5.2

Take action: https://gateflow.ai/dashboard/change-management

Urgent Alert (7 days)

Subject: [GateFlow] URGENT: gpt-4-turbo deprecation in 7 days

Warning: gpt-4-turbo will be deprecated in 7 days.

Current status:
- Auto-fallback: ENABLED
- Fallback model: gpt-5.2
- Test results: PASSED

You're protected. On 2026-06-01, requests will automatically
route to gpt-5.2.

If you haven't tested yet, do so now.

Viewing Deprecations

All Upcoming Deprecations

curl https://api.gateflow.ai/v1/management/deprecations \
  -H "Authorization: Bearer gw_prod_admin_key"

Deprecations Affecting You

curl https://api.gateflow.ai/v1/management/deprecations?affecting=me \
  -H "Authorization: Bearer gw_prod_admin_key"

Response:

{
  "deprecations": [
    {
      "model": "gpt-4-turbo",
      "provider": "openai",
      "sunset_date": "2026-06-01",
      "days_remaining": 45,
      "status": "action_needed",
      "your_usage": {
        "requests_last_30d": 15420,
        "cost_last_30d": 234.56,
        "affected_api_keys": ["key_abc", "key_def"]
      },
      "fallback_configured": true,
      "fallback_model": "gpt-5.2",
      "recommended_replacement": "gpt-5.2"
    }
  ]
}

Snoozing Alerts

Temporarily silence alerts:

curl -X POST https://api.gateflow.ai/v1/management/deprecations/gpt-4-turbo/snooze \
  -H "Authorization: Bearer gw_prod_admin_key" \
  -H "Content-Type: application/json" \
  -d '{
    "until": "2026-05-01",
    "reason": "Migration scheduled for April"
  }'

WARNING

Snoozing doesn't prevent deprecation. The model will still stop working on the sunset date.

Custom Alert Rules

Create alerts for specific conditions:

curl -X POST https://api.gateflow.ai/v1/management/alerts/rules \
  -H "Authorization: Bearer gw_prod_admin_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "High-usage model deprecation",
    "conditions": {
      "all": [
        {"type": "deprecation_announced"},
        {"type": "usage_above", "threshold": 10000, "period": "30d"}
      ]
    },
    "notify": {
      "channels": ["pagerduty"],
      "severity": "critical"
    }
  }'

Alert History

View past alerts:

curl https://api.gateflow.ai/v1/management/alerts/history \
  -H "Authorization: Bearer gw_prod_admin_key" \
  -G -d "type=deprecation"

Next Steps

• Migration Wizard - Plan your migration
• Automated Fallbacks - Set up protection