スケジュールを一括アーカイブする

​

ヘッダー

​

リクエストボディ

​

リクエスト例

curl -s -X POST 'https://api.qoder.com/api/v1/forward/schedules/archive' \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: archive-schedules-20260821" \
  -d '{"schedule_ids":["sched_019f00112233445566778899aabbccdd","sched_019f00112233445566778899aabbccee"]}'

​

レスポンス例

{"archived_count": 2}

​

アーカイブの動作

• active と paused の両方をアーカイブできます。archived_at が設定され、次回実行時刻が消去され、新しい Run は作成されません。
• owner 内ですべての ID を解決してから更新します。存在しない ID や別 owner の ID が 1 件でもあると、バッチ全体が 404 になります。
• アーカイブ済み ID は no-op です。すべてアーカイブ済みなら archived_count: 0 を返します。
• 既存の pending または running Run はキャンセル、変更、削除されません。
• Schedule は ID または include_archived=true で取得でき、履歴 Run も引き続き取得できます。
• Idempotency-Key を省略しても、同じリクエストの再実行は冪等です。同じキーと本文を再利用すると、最初のレスポンスが Idempotency-Replayed: true とともに返されます。
• Forward は DELETE /api/v1/forward/schedules を提供せず、Schedule または Schedule Run の物理削除も提供しません。

​

エラー

​

関連