How to use the Jira Align REST API to update the "startInitiationDate" of a Portfolio Epic

Platform Notice: Cloud and Data Center - This article applies equally to both cloud and data center platforms.

Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Summary

It is possible to use the Epic REST API endpoint ( /align/api/2/Epics) to update the startInitiationDate field of a Portfolio Epic. this article provides the syntax to be used with the PATCH API call / method.

ℹ️ As which API client is being used to make the call is open to choice, this article does not discuss the specifics of making the call using a specific client

Environment

Jira Align

Solution

Use the below format to update "startInitiationDate" of a Portfolio Epic using the PATCH method.

1 2 3 4 5 { "op": "replace", "path": "/startInitiationDate", "value": "2023-10-10T13:10:31.648Z" }

ℹ️ Apply the Patch call to data from your own environment by using the ID of the Portfolio Epic being modified

⚠️ It is recommended to use a GET API call to review and take note of the current data for a specific Epic before attempting to modify it using a PATCH call

Related Content:

Getting started with the REST API 2.0

Updated on April 14, 2025

Still need help?

The Atlassian Community is here for you.