---
title: "Changes to List the deployments that satisfy the provided filters. We accept new deployment notifications at `/events/deployments`."
method: POST
path: "/filter/deployments"
---

# Changes to List the deployments that satisfy the provided filters. We accept new deployment notifications at `/events/deployments`.

`POST /filter/deployments`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 110 revisions.

- **2023-03-03** `f9fdd9fbfc25`: 1 info
- **2023-01-13** `d08637dcd231`: 2 breaking, 1 info
- **2022-11-23** `7748d08da314`: 6 breaking, 1 warning, 1 info
- **2022-11-16** `fcf829c0439e`: 1 info
- **2022-11-16** `cb74c2b3ef0d`: 1 warning
- **2022-11-16** `7ce5052fc811`: 1 info

## Changes

- **2023-03-03** `f9fdd9fbfc25`: 1 info
  - added the new optional request property `jira/status_categories`
- **2023-01-13** `d08637dcd231`: 2 breaking, 1 info
  - the `deployments/items/allOf[#/components/schemas/DeploymentNotification]/name` response property's maxLength was unset from `100` for the response status `200`
  - the `deployments/items/allOf[#/components/schemas/DeploymentNotification]/name` response property's minLength was decreased from `1` to `0` for the response status `200`
  - the `deployments/items/allOf[#/components/schemas/DeploymentNotification]/name` response's property pattern `^([^'\s]| ){1,100}$` was added for the status `200`
- **2022-11-23** `7748d08da314`: 6 breaking, 1 warning, 1 info
  - removed the required property `deployments/items/allOf[#/components/schemas/DeploymentAnalysis]/prs/items/additions` from the response with the `200` status
  - removed the required property `deployments/items/allOf[#/components/schemas/DeploymentAnalysis]/prs/items/author` from the response with the `200` status
  - removed the required property `deployments/items/allOf[#/components/schemas/DeploymentAnalysis]/prs/items/created` from the response with the `200` status
  - removed the required property `deployments/items/allOf[#/components/schemas/DeploymentAnalysis]/prs/items/deletions` from the response with the `200` status
  - removed the required property `deployments/items/allOf[#/components/schemas/DeploymentAnalysis]/prs/items/number` from the response with the `200` status
  - removed the required property `deployments/items/allOf[#/components/schemas/DeploymentAnalysis]/prs/items/title` from the response with the `200` status
  - removed the optional property `deployments/items/allOf[#/components/schemas/DeploymentAnalysis]/prs/items/jira` from the response with the `200` status
  - added `#/components/schemas/ReleasedPullRequest, subschema #1` to the `deployments/items/allOf[#/components/schemas/DeploymentAnalysis]/prs/items/` response property `allOf` list for the response status `200`
- **2022-11-16** `fcf829c0439e`: 1 info
  - added the new optional request property `jira/priorities`
- **2022-11-16** `cb74c2b3ef0d`: 1 warning
  - removed the request property `jira/priorities`
- **2022-11-16** `7ce5052fc811`: 1 info
  - added the new optional request property `jira/priorities`

---

[Operation](https://skmtc.dev/athenian/apis/title/docs/filter/deployments/post.md) - [API](https://skmtc.dev/athenian/apis/title.md) - [Page](https://skmtc.dev/athenian/apis/title/changes/filter/deployments/post)