Remove deprecated /webhooks route and related dead code#26311
Merged
rijkvanzanten merged 13 commits intodirectus:mainfrom Dec 24, 2025
Merged
Remove deprecated /webhooks route and related dead code#26311rijkvanzanten merged 13 commits intodirectus:mainfrom
rijkvanzanten merged 13 commits intodirectus:mainfrom
Conversation
mobml
force-pushed
the
cleanup/remove-deprecated-webhooks-code
branch
from
712f94d to
d4a1b9e
Compare
ComfortablyCoding
previously requested changes
Dec 17, 2025
Member
There was a problem hiding this comment.
Thanks for the PR! While the endpoints have been removed, there are still remaining references and usage that should be cleaned up. In addition to any other potential occurrences, these places still reference webhooks:
- The
WebhookServiceand related files - The
directus_webhookspath in thegetServicefunction - The
ExtensionsServicestype - Webhook-related pages and routes in the app
- The webhooks database table
- Any relevant
en-UStranslations - System data fields
- SDK types & schema
The initial deprecation PR may be helpful for identifying additional areas to update: #21808
Contributor
There was a problem hiding this comment.
Pull request overview
This PR removes the deprecated /webhooks API route and all related code that has been unused since webhooks were deprecated and migrated to Flows in early 2024. The changes span multiple packages including the API, SDK, types, system-data, specs, and app.
Key Changes:
- Removed the deprecated
/webhooksAPI controller and route registration - Removed WebhooksService and all related service code and tests
- Added database migration to drop the
directus_webhookstable - Removed SDK webhook commands (create, read, update, delete) and schema types
- Removed OpenAPI specifications for the deprecated webhook endpoints
- Removed UI components and routes for managing webhooks in the app
Reviewed changes
Copilot reviewed 39 out of 39 changed files in this pull request and generated 3 comments.
Show a summary per file
| File | Description |
|---|---|
| api/src/app.ts | Removed webhook router registration from Express app |
| api/src/app.test.ts | Removed webhook initialization mock |
| api/src/controllers/webhooks.ts | Deleted entire deprecated webhook controller |
| api/src/services/webhooks.ts | Deleted WebhooksService that threw deprecation errors |
| api/src/services/webhooks.test.ts | Deleted service tests |
| api/src/services/index.ts | Removed webhook service export |
| api/src/utils/get-service.ts | Removed WebhooksService import and case handling |
| api/src/database/migrations/20251224A-remove-webhooks.ts | Added migration to drop directus_webhooks table |
| api/src/database/migrations/20240311A-deprecate-webhooks.ts | Moved Webhook type definitions into migration file since types package no longer exports them |
| sdk/src/schema/webhook.ts | Deleted DirectusWebhook schema type |
| sdk/src/schema/index.ts | Removed webhook schema export |
| sdk/src/schema/core.ts | Removed DirectusWebhook from core schema |
| sdk/src/rest/commands/*/webhooks.ts | Deleted all webhook CRUD command implementations |
| sdk/src/rest/commands/*/index.ts | Removed webhook command exports |
| packages/types/src/webhooks.ts | Deleted Webhook and WebhookHeader type definitions |
| packages/types/src/services.ts | Removed WebhooksService from ExtensionsServices interface |
| packages/types/src/index.ts | Removed webhook types export |
| packages/system-data/src/fields/webhooks.yaml | Deleted webhook field definitions |
| packages/system-data/src/fields/index.ts | Removed webhook fields processing |
| packages/system-data/src/collections/collections.yaml | Removed directus_webhooks collection entry |
| packages/system-data/src/relations/relations.yaml | Removed webhook-to-flow relation definition |
| packages/specs/src/paths/webhooks/*.yaml | Deleted all webhook endpoint OpenAPI specs |
| packages/specs/src/components/webhook.yaml | Deleted webhook component schema |
| packages/specs/src/openapi.yaml | Removed webhook paths and schema references |
| app/src/modules/settings/routes/webhooks/*.vue | Deleted webhook collection and item management components |
| app/src/modules/settings/index.ts | Removed webhook route configuration |
| app/src/stores/presets.ts | Removed directus_webhooks preset configuration |
| app/src/utils/get-route.ts | Removed directus_webhooks route mapping |
| contributors.yml | Added contributor mobml |
| .changeset/lazy-insects-tap.md | Added changeset documenting the removal |
rijkvanzanten
approved these changes
Dec 24, 2025
Member
|
Thanks for kicking this off @mobml! |
Codecov Report❌ Patch coverage is Additional details and impacted files@@ Coverage Diff @@
## main #26311 +/- ##
==========================================
- Coverage 62.90% 62.86% -0.05%
==========================================
Files 2105 2098 -7
Lines 136189 135761 -428
Branches 8236 8230 -6
==========================================
- Hits 85673 85348 -325
+ Misses 50516 50413 -103
Flags with carried forward coverage won't be shown. Click here to find out more. 🚀 New features to boost your workflow:
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Scope
What's changed:
/webhooksAPI routePotential Risks / Drawbacks
Tested Scenarios
/webhooksrouteReview Notes / Questions
Checklist
Fixes #26257