Webhooks
Custom HTTP Config
Configure global target URL/secret and default-enable behavior for custom webhook delivery.
Global custom webhook config is user-scoped and managed at:
GET /v1/webhooks/custom-http-configPUT /v1/webhooks/custom-http-configDELETE /v1/webhooks/custom-http-config
GET config
curl -sS -X GET "https://api.fastfold.ai/v1/webhooks/custom-http-config" \
-H "Authorization: Bearer $FASTFOLD_API_KEY"Example response:
{
"user_id": "9a361e2b-0d22-4f08-8f26-c3c7a1266e48",
"is_active": true,
"enabled_by_default": true,
"target_url": "https://example.com/fastfold/hooks",
"token_header": "X-Webhook-Token",
"http_auth_mode": "x_webhook_token",
"has_token": true,
"secret_token_masked": "whk_********************9k2a",
"secret_rotated_at": "2026-04-23T17:31:48.224Z",
"updated_at": "2026-04-23T17:31:48.224Z",
"is_configured": true
}PUT config
curl -sS -X PUT "https://api.fastfold.ai/v1/webhooks/custom-http-config" \
-H "Authorization: Bearer $FASTFOLD_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"target_url": "https://example.com/fastfold/hooks",
"token_value": "whk_very_strong_secret",
"enabled_by_default": true
}'Request fields:
target_url(required)token_value(optional on update, required for first-time usable config)enabled_by_default(optional bool)
DELETE config
curl -sS -X DELETE "https://api.fastfold.ai/v1/webhooks/custom-http-config" \
-H "Authorization: Bearer $FASTFOLD_API_KEY"This deactivates global custom webhook delivery for future runs unless configured again.
Last updated on