Update a webhook event schema

Updates the GraphQL selection set for a webhook event schema. The namespace is immutable. Changes apply to future event snapshots only.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

webhook_idstringRequired

Webhook ID

idstringRequired

Webhook event schema ID

Request

This endpoint expects an object.

schemastringRequired

GraphQL selection set rooted at the event object for the namespace. Updating this value affects future event snapshots only. Existing event snapshots continue to deliver the payload captured when the event was created.

Response

webhook event schema updated

objectenum

idstringformat: "uuid"

Unique identifier for this webhook event schema.

namespacestring

Event namespace for the schema override. Currently supported business event namespaces are business.created and business.updated.

schemastring

GraphQL selection set rooted at the event object for the namespace. For business.updated, write fields directly against the Business object, for example ”{ id name runs { id agent } }”. The selected object replaces only data.object in delivered webhook payloads.

created_atdatetime

updated_atdatetime

Errors

404

Update Webhook Event Schema Request Not Found Error

422

Update Webhook Event Schema Request Unprocessable Entity Error

$	curl -X PATCH https://api.middesk.com/v1/webhooks/webhook_id/event_schemas/id \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"schema": "{ id name addresses { full_address } }"
>	}'

1	{
2	"object": "webhook_event_schema",
3	"id": "3f2a1c9e-8b4d-4e21-9c77-1a2b3c4d5e6f",
4	"namespace": "business.updated",
5	"schema": "{ id name addresses { full_address } }",
6	"created_at": "2025-01-07T12:00:00Z",
7	"updated_at": "2025-01-07T12:00:00Z"
8	}