Update Deployments API docs to include finished before and after

What does this MR do and why?

This merge request updates the Deployments API documentation to match the changes introduced in !105017 (merged).

It basically adds the following two options to filter deployments by:

• finished_after: to retrieve successful deployments that finished after a certain datetime (in ISO-861 format).
• finished_before: to retrieve successful deployments that finished before a certain datetime (in ISO-861 format).

Resolves #332652 (closed).

MR acceptance checklist

This checklist encourages us to confirm any changes have been analyzed to reduce risks in quality, performance, reliability, security, and maintainability.

• I have evaluated the MR acceptance checklist for this MR.