v49

latestOpenAPI 3.0.0raw.githubusercontent.com2026-06-294147162.3 KB
Event Subscriptions

Update an Event Subscription

Update an event subscription with the given ID.

patch/v1/event_subscriptions/{id}

Path parameters

idstring required

The unique identifier for the event subscription

Request body

status'active' | 'disabled' | 'deleted'

The status of the event subscription:

  • active: The event subscription is active and events will be delivered
  • disabled: The event subscription is temporarily disabled and events will not be delivered
  • deleted: The event subscription is permanently deleted and events will not be delivered

Response

Updated

idstring

The unique identifier for the event subscription

created_atstring date-time

The date and time the event subscription was created

status'active' | 'disabled' | 'deleted' | 'requires_attention'

The status of the event subscription. This indicates if we'll send notifications to this subscription

  • active: subscription is active and events will be delivered normally
  • disabled: subscription is temporarily disabled and events will not be delivered
  • deleted: subscription has been deleted and events will not be delivered
  • requires_attention: subscription has been disabled due to delivery failures and events will not be delivered
urlstring required

The webhook url where we'll send notifications.

category'grant.created' | 'grant.updated' | 'unintegrated_grant.created' | 'unintegrated_grant.updated' | 'disbursement.created' | 'disbursement.updated' | 'inbound_transfer.created' | 'inbound_transfer.updated'

The category of the event. This is useful for filtering events.

Example response

{
  "id": "4d06d393-1f14-46cf-b02d-8db17d7ed06a",
  "created_at": "2024-01-14T12:48:56.37Z",
  "url": "https://example.com/webhook"
}