Webhook Endpoint を有効化する

Webhook は現在 Beta 機能です。API、フィールド、および動作は今後のバージョンで変更される可能性があります。

POST /api/v1/forward/webhook/endpoints/{endpoint_id}/enable Endpoint がすでに有効な場合に繰り返し呼び出しても、現在の状態が返されます。

リクエストヘッダー

Header	必須	説明
`Authorization`	はい	`Bearer <PAT または管理者 SAT>`

パスパラメーター

パラメーター	型	必須	説明
`endpoint_id`	string	はい	Webhook Endpoint ID。

リクエスト例

curl -s -X POST 'https://api.qoder.com/api/v1/forward/webhook/endpoints/e149c233-1234-4abc-8def-1234567890ab/enable' \
  -H "Authorization: Bearer $QODER_PAT"

レスポンス例

HTTP 200 OK 状態変更後の完全な Endpoint オブジェクトが返されます。例：

{
  "id": "e149c233-1234-4abc-8def-1234567890ab",
  "url": "https://example.com/webhooks/qoder",
  "events": ["forward.schedule_run.succeeded"],
  "metadata": {},
  "active": true,
  "last_success_at": null,
  "last_failure_at": null,
  "consecutive_fail": 0,
  "created_at": "2026-09-01T08:00:00Z",
  "updated_at": "2026-09-01T10:00:00Z"
}

レスポンスフィールドは、Webhook Endpoint を取得するを参照してください。

エラー

HTTP	Type	発生条件
`401`	`authentication_error`	認証情報がない、無効、または期限切れです。
`403`	`permission_error`	現在のトークンでは Webhook を管理できません。
`404`	`not_found_error`	Endpoint が存在しないか、現在のアカウントから参照できません。
`500/502/503`	`api_error`	サービスが一時的に利用できません。

Webhook Endpoint を有効化する

リクエストヘッダー

パスパラメーター

リクエスト例

レスポンス例

エラー

関連

Webhook Endpoint を無効化する

テストイベントを送信する

​リクエストヘッダー

​パスパラメーター

​リクエスト例

​レスポンス例

​エラー

​関連

Webhook Endpoint を無効化する

テストイベントを送信する

リクエストヘッダー

パスパラメーター

リクエスト例

レスポンス例

エラー

関連