Änderungen mit disruptiven Auswirkungen

Erfahre mehr über aktuelle und bevorstehende Breaking Changes an der GitHub-GraphQL-API.

In diesem Artikel

Informationen zu Breaking Changes

Schwerwiegende Änderungen sind Änderungen, die möglicherweise Maßnahmen von unseren Integratoren erfordern. Diese Änderungen werden in zwei Kategorien unterteilt:

  • Eilmeldung: Änderungen, die bestehende Abfragen der GraphQL-API unterbrechen. Ein Beispiel wäre etwa das Entfernen eines Felds.
  • Gefährliche Änderung: Änderungen, die nicht dazu führen, dass bereits vorhandene Abfragen nicht mehr funktionieren, aber das Laufzeitverhalten von Clients beeinflussen können. Ein Beispiel für eine gefährliche Änderung ist das Hinzufügen eines Enum-Werts.

Bevorstehende Breaking Changes werden von uns mindestens drei Monate vor der Implementierung der Änderung am GraphQL-Schema angekündigt, damit Integratoren genügend Zeit haben, die erforderlichen Anpassungen vorzunehmen. Änderungen werden am ersten Tag eines Quartals wirksam (also am 1. Januar, 1. April, 1. Juli oder 1. Oktober). Eine am 15. Januar angekündigte Änderung wird also beispielsweise am 1. Juli vorgenommen.

Changes scheduled for 2027-01-01

  • Breaking A change will be made to CheckAnnotation.databaseId.
    Description:

    databaseId will be removed. Use fullDatabaseId instead.

    Reason:

    databaseId will be removed because it does not support 64-bit signed integer identifiers.

  • Breaking A change will be made to Artifact.databaseId.
    Description:

    databaseId will be removed. Use fullDatabaseId instead.

    Reason:

    databaseId will be removed because it does not support 64-bit signed integer identifiers.

Changes scheduled for 2026-10-01

  • Breaking A change will be made to User.viewerRelevantRepositories.
    Description:

    viewerRelevantRepositories will be removed. Use viewerCopilotChatRepositorySuggestions instead.

    Reason:

    viewerRelevantRepositories has been renamed to viewerCopilotChatRepositorySuggestions.

  • Breaking A change will be made to CopilotAgentTask.type.
    Description:

    type will be removed. Use codingAgentFilter and codingAgentTypeFilter instead.

    Reason:

    type will be removed.

Changes scheduled for 2026-07-01

  • Breaking A change will be made to Team.viewerSubscription.
    Description:

    viewerSubscription will be removed.

    Reason:

    Team.viewerSubscription will be removed. Team notifications subscriptions are being deprecated.

  • Breaking A change will be made to Team.viewerCanSubscribe.
    Description:

    viewerCanSubscribe will be removed.

    Reason:

    Team.viewerCanSubscribe will be removed. Team notifications subscriptions are being deprecated.

Changes scheduled for 2026-04-01

  • Breaking A change will be made to TeamRemoveRepositoryAuditEntry.userUrl.
    Description:

    userUrl will be removed.

    Reason:

    The GraphQL audit-log is deprecated. Please use the REST API instead.

  • Breaking A change will be made to TeamRemoveRepositoryAuditEntry.userResourcePath.
    Description:

    userResourcePath will be removed.

    Reason:

    The GraphQL audit-log is deprecated. Please use the REST API instead.

  • Breaking A change will be made to TeamRemoveRepositoryAuditEntry.userLogin.
    Description:

    userLogin will be removed.

    Reason:

    The GraphQL audit-log is deprecated. Please use the REST API instead.

  • Breaking A change will be made to TeamRemoveRepositoryAuditEntry.user.
    Description:

    user will be removed.

    Reason:

    The GraphQL audit-log is deprecated. Please use the REST API instead.

  • Breaking A change will be made to TeamRemoveRepositoryAuditEntry.organizationUrl.
    Description:

    organizationUrl will be removed.

    Reason:

    The GraphQL audit-log is deprecated. Please use the REST API instead.

  • Breaking A change will be made to TeamRemoveRepositoryAuditEntry.organizationResourcePath.
    Description:

    organizationResourcePath will be removed.

    Reason:

    The GraphQL audit-log is deprecated. Please use the REST API instead.

  • Breaking A change will be made to TeamRemoveRepositoryAuditEntry.organizationName.
    Description:

    organizationName will be removed.

    Reason:

    The GraphQL audit-log is deprecated. Please use the REST API instead.

  • Breaking A change will be made to TeamRemoveRepositoryAuditEntry.organization.
    Description:

    organization will be removed.

    Reason:

    The GraphQL audit-log is deprecated. Please use the REST API instead.

  • Breaking A change will be made to TeamRemoveRepositoryAuditEntry.operationType.
    Description:

    operationType will be removed.

    Reason:

    The GraphQL audit-log is deprecated. Please use the REST API instead.

  • Breaking A change will be made to TeamRemoveRepositoryAuditEntry.isLdapMapped.
    Description:

    isLdapMapped will be removed.

    Reason:

    The GraphQL audit-log is deprecated. Please use the REST API instead.

  • Breaking A change will be made to TeamRemoveRepositoryAuditEntry.createdAt.
    Description:

    createdAt will be removed.

    Reason:

    The GraphQL audit-log is deprecated. Please use the REST API instead.

  • Breaking A change will be made to TeamRemoveRepositoryAuditEntry.actorUrl.
    Description:

    actorUrl will be removed.

    Reason:

    The GraphQL audit-log is deprecated. Please use the REST API instead.

  • Breaking A change will be made to TeamRemoveRepositoryAuditEntry.actorResourcePath.
    Description:

    actorResourcePath will be removed.

    Reason:

    The GraphQL audit-log is deprecated. Please use the REST API instead.

  • Breaking A change will be made to TeamRemoveRepositoryAuditEntry.actorLogin.