Docs
Launch GraphOS Studio

Schema change notifications

Receive alerts whenever changes are made to your graph's schema


You can configure GraphOS to notify your team whenever any changes (additions, deprecations, removals, etc.) are made to your 's registered schema:

Schema notification Slack message.

You can configure separate change notifications for each variant of your graph.

Setup

See Setting up GraphOS Notifications.

Webhook format

If you receive schema change notifications via a custom webhook, notification details are provided as a JSON object in the request body.

The JSON object conforms to the structure of the ResponseShape interface:

interface Change {
description: string;
}
interface ResponseShape {
eventType: "SCHEMA_PUBLISH"; // Currently, only SCHEMA_PUBLISH webhooks are supported
eventID: string;
changes: Change[]; // Set of schema changes that occurred
schemaURL: string; // See description below
schemaURLExpiresAt: string; // ISO 8601 Date string
graphID: string;
variantID: string; // See description below
timestamp: string; // ISO 8601 Date string
}
  • The value of schemaURL is a short-lived (24-hour) URL that enables you to fetch the published schema without authenticating (such as with an API key). The URL expires at the time indicated by schemaURLExpiresAt.

  • The value of variantID is in the format graphID@variantName (for example, mygraph@staging).

Previous
Daily reports
Next
Performance alerts
Edit on GitHubEditForumsDiscord

© 2024 Apollo Graph Inc.

Privacy Policy

Company