About breaking changes
Breaking changes are any changes that might require action from our integrators. We divide these changes into two categories:
- Breaking: Changes that will break existing queries to the GraphQL API. For example, removing a field would be a breaking change.
- Dangerous: Changes that won't break existing queries but could affect the runtime behavior of clients. Adding an enum value is an example of a dangerous change.
We'll announce upcoming breaking changes at least three months before making changes to the GraphQL schema, to give integrators time to make the necessary adjustments. Changes go into effect on the first day of a quarter (January 1st, April 1st, July 1st, or October 1st). For example, if we announce a change on January 15th, it will be made on July 1st.
Changes scheduled for 2026-04-01
- Breaking A change will be made to
TeamRemoveRepositoryAuditEntry.userUrl.Description:userUrlwill 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:userResourcePathwill 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:userLoginwill 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:userwill 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:organizationUrlwill 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:organizationResourcePathwill 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:organizationNamewill 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:organizationwill 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:operationTypewill 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:isLdapMappedwill 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:createdAtwill 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:actorUrlwill 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:actorResourcePathwill be removed.Reason:The GraphQL audit-log is deprecated. Please use the REST API instead.
- Breaking A change will be made to
TeamRemoveRepositoryAuditEntry.actorLogin.Description:actorLoginwill be removed.Reason:The GraphQL audit-log is deprecated. Please use the REST API instead.
- Breaking A change will be made to
TeamRemoveRepositoryAuditEntry.actorLocation.Description:actorLocationwill be removed.Reason:The GraphQL audit-log is deprecated. Please use the REST API instead.
- Breaking A change will be made to
TeamRemoveRepositoryAuditEntry.actorIp.Description:actorIpwill be removed.Reason:The GraphQL audit-log is deprecated. Please use the REST API instead.
- Breaking A change will be made to
TeamRemoveRepositoryAuditEntry.actor.Description:actorwill be removed.Reason:The GraphQL audit-log is deprecated. Please use the REST API instead.
- Breaking A change will be made to
TeamRemoveRepositoryAuditEntry.action.Description:actionwill be removed.Reason:The GraphQL audit-log is deprecated. Please use the REST API instead.
- Breaking A change will be made to
TeamRemoveMemberAuditEntry.userUrl.Description:userUrlwill be removed.Reason:The GraphQL audit-log is deprecated. Please use the REST API instead.
- Breaking A change will be made to
TeamRemoveMemberAuditEntry.userResourcePath.Description:userResourcePathwill be removed.Reason:The GraphQL audit-log is deprecated. Please use the REST API instead.
- Breaking A change will be made to
TeamRemoveMemberAuditEntry.userLogin.Description:userLoginwill be removed.Reason:The GraphQL audit-log is deprecated. Please use the REST API instead.
- Breaking A change will be made to
TeamRemoveMemberAuditEntry.user.Description:userwill be removed.Reason:The GraphQL audit-log is deprecated. Please use the REST API instead.
- Breaking A change will be made to
TeamRemoveMemberAuditEntry.organizationUrl.Description:organizationUrlwill be removed.Reason:The GraphQL audit-log is deprecated. Please use the REST API instead.