# Deprecation information

This page lists all the fields in our GQL API that have been marked as deprecated along with suggestions on possible alternatives.

We will try to keep all these fields available for at least 3 months after they've been tagged deprecated. You're highly encouraged to update any code still using them to avoid issues once the deprecation period runs out and the fields are removed.

## 2023-12-05

* Field `organization.apiKey` was deprecated. Use `organization.accessTokens` instead.

## 2023-11-21

* Field `manuallySetHealthThreshold` was deprecated. Use `earliestNonhealthyThreshold` instead, it has the same logic as the deprecated field.

## 2023-10-17

* Object type `DeployInProgress` was deprecated. We stopped creating `WorkInProgressItemType` items for future deploys. Instead we now create `PrInProgress` items for merged pull requests.

## 2023-08-02

* Field `builds` was deprecated. Use field `organization.buildDefinitions` instead.

## 2023-05-10

* Mutation `triggerIssueStatusesSync` was deprecated. Use `triggerRemoteObjectSync` instead.
* Field `canSeeOrgDashboard` on `UserPermissionsType` was deprecated. The permission in question is enabled for all users, so the field is no longer required.

## 2023-04-04

* Top level field `projects` was deprecated. Use field `organization.projects` instead.

## 2023-03-10

* Top-level field `context` was deprecated. See subfield deprecation messages for more information about alternatives.
* Field `project` was deprecated from object type `ContextType`. Use field `organization.projects` with `slug` argument query type instead.
* Field `environment` was deprecated from object type `ContextType`. Use field `organization.project.environment` query type instead.

## 2023-03-08

* Field `org` was deprecated from object type `ContextType`. Use field `organization` on root query type instead.

## 2023-03-07

* Field `visibleOrganizations` was deprecated from object type `ContextType`. Use field `organizations` on type `UserType` instead.
* Field `visibleProjects` was deprecated from object type `ContextType`. Use field `projects` on type `OrganizationType` instead.

## 2023-03-06

* Field `user` was deprecated from object type `ContextType`. Use field `user` on root query type instead.
* Field `messages` was deprecated from object type `ContextType`. Use field `flashMessages` on root query type instead.
* Field `baseurl` was deprecated from object type `ContextType`. Use field `baseurl` on root query type instead.

## 2023-03-02

* Field `flags` was deprecated from object type `ContextType`. Use field `flags` on type `OrganizationType` instead.

## 2022-06-24

* Enum `OrderField` 's option `health` is deprecated. Use option `health_time` instead.
* Field `orgChanges` has the following arguments deprecated:
  * `healths`, use `health_times` instead
  * `start_date`, use `start` instead
  * `end_date`, use `end` instead
* For the following fields the arguments `start_date` and `end_date` are deprecated, use `start` and `end` instead:
  * `ProjectType.metricMTTR`
  * `ProjectType.metricFrequency`
  * `ProjectType.metricLeadTime`
  * `ProjectType.metricFailureRate`
  * `ProjectType.metricRecap`
  * `ProjectType.metricSlowestPrs`
  * `ProjectType.metricBiggestDeploys`
  * `ProjectType.metricTopUnhealthyDeploys`
  * `ProjectType.insights`

## 2022-06-07

* Field `impactHistory` was deprecated from object type `Environment`. Use field `healthEvents` instead.
* Field `impactHistory` was deprecated from object type `ChangeModelType`. Use field `healthEvents` instead.

## 2022-05-23

* Field `health` was deprecated from object type `ChangeType`. Use field `currentHealth` on type `Environment` instead.

## 2022-04-26

* Mutation `create_nr_integration` was deprecated. Use mutation `create_newrelic_integration` instead.
* Mutation `create_dd_integration` was deprecated. Use mutation `create_datadog_integration` instead.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.sleuth.io/sleuth-dora/sleuth-api/deprecation-information.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.