Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions openapi/components/schemas/webhooks/WebhookType.yaml
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
type: string
enum:
- INCOMING_PAYMENT
- OUTGOING_PAYMENT
- TRANSACTIONS_INCOMING_PAYMENT
- TRANSACTIONS_OUTGOING_PAYMENT
- TEST
- BULK_UPLOAD
- INVITATION_CLAIMED
- KYC_STATUS
- ACCOUNT_STATUS
- UMA_INVITATION_CLAIMED
- CUSTOMERS_KYC_UPDATE
- INTERNAL_ACCOUNTS_BALANCE_UPDATE
Comment on lines 1 to +9
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The enum values have been renamed but the examples in webhook schema files still reference old names. This creates inconsistency:

  • openapi/components/schemas/webhooks/IncomingPaymentWebhook.yaml:12 has example: INCOMING_PAYMENT
  • openapi/components/schemas/webhooks/OutgoingPaymentWebhook.yaml:12 has example: OUTGOING_PAYMENT
  • openapi/components/schemas/webhooks/InvitationClaimedWebhook.yaml:11 has enum: [INVITATION_CLAIMED]

These must be updated to match the new enum values or the OpenAPI spec will be invalid.

Prompt To Fix With AI
This is a comment left during a code review.
Path: openapi/components/schemas/webhooks/WebhookType.yaml
Line: 1-9

Comment:
The enum values have been renamed but the examples in webhook schema files still reference old names. This creates inconsistency:

- `openapi/components/schemas/webhooks/IncomingPaymentWebhook.yaml:12` has `example: INCOMING_PAYMENT`
- `openapi/components/schemas/webhooks/OutgoingPaymentWebhook.yaml:12` has `example: OUTGOING_PAYMENT`  
- `openapi/components/schemas/webhooks/InvitationClaimedWebhook.yaml:11` has `enum: [INVITATION_CLAIMED]`

These must be updated to match the new enum values or the OpenAPI spec will be invalid.

How can I resolve this? If you propose a fix, please make it concise.

Comment on lines 1 to +9
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Webhook endpoint example payloads still use old type names. These files need updating:

  • openapi/webhooks/incoming-payment.yaml lines 101, 127: type: INCOMING_PAYMENT
  • openapi/webhooks/outgoing-payment.yaml lines 87, 122: type: OUTGOING_PAYMENT
  • openapi/webhooks/invitation-claimed.yaml line 73: type: INVITATION_CLAIMED
  • openapi/webhooks/kyc-status.yaml line 61: type: KYC_STATUS
  • openapi/webhooks/account-status.yaml line 70: type: ACCOUNT_STATUS

After running make build, these will propagate to the bundled spec.

Prompt To Fix With AI
This is a comment left during a code review.
Path: openapi/components/schemas/webhooks/WebhookType.yaml
Line: 1-9

Comment:
Webhook endpoint example payloads still use old type names. These files need updating:

- `openapi/webhooks/incoming-payment.yaml` lines 101, 127: `type: INCOMING_PAYMENT`
- `openapi/webhooks/outgoing-payment.yaml` lines 87, 122: `type: OUTGOING_PAYMENT`
- `openapi/webhooks/invitation-claimed.yaml` line 73: `type: INVITATION_CLAIMED`
- `openapi/webhooks/kyc-status.yaml` line 61: `type: KYC_STATUS`
- `openapi/webhooks/account-status.yaml` line 70: `type: ACCOUNT_STATUS`

After running `make build`, these will propagate to the bundled spec.

How can I resolve this? If you propose a fix, please make it concise.

Comment on lines 1 to +9
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Documentation in mintlify/ramps/platform-tools/webhooks.mdx still references old webhook type names (OUTGOING_PAYMENT, ACCOUNT_STATUS, KYC_STATUS) in code examples on lines 17, 41, 50, 66, 75, and 81. These need updating to match the new naming convention.

Prompt To Fix With AI
This is a comment left during a code review.
Path: openapi/components/schemas/webhooks/WebhookType.yaml
Line: 1-9

Comment:
Documentation in `mintlify/ramps/platform-tools/webhooks.mdx` still references old webhook type names (`OUTGOING_PAYMENT`, `ACCOUNT_STATUS`, `KYC_STATUS`) in code examples on lines 17, 41, 50, 66, 75, and 81. These need updating to match the new naming convention.

How can I resolve this? If you propose a fix, please make it concise.

Comment on lines 1 to +9
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a breaking change for existing webhook consumers. Verify that backend services parsing the type field are updated to handle new names, and check if a migration path exists for existing webhook subscriptions.

Prompt To Fix With AI
This is a comment left during a code review.
Path: openapi/components/schemas/webhooks/WebhookType.yaml
Line: 1-9

Comment:
This is a breaking change for existing webhook consumers. Verify that backend services parsing the `type` field are updated to handle new names, and check if a migration path exists for existing webhook subscriptions.

How can I resolve this? If you propose a fix, please make it concise.

description: >-
Type of webhook event, used by the receiver to identify which webhook is being
received