What is the difference between agile and v3 apis for jira?

[Mansi Gusain]

Hi, I want to use the apis to create issues in a project . I have these links- 

The Jira Cloud platform REST API

The Jira Software Cloud REST API

So I want to create the issues in my cloud only which doc should I follow? Please help . 

Sometimes I may need to create issues in the epic also but epic is missing from - 

The Jira Cloud platform REST API

Can some one please tell the difference? and suggest ?

[Aron Gombas _Midori_ · Accepted solution]

The difference between the two:

1. "Jira Cloud" REST API supports the "common" concepts and their operations. Issue is a common concept, therefore you can use this API to create an issue.
2. "Jira Software Cloud" REST API supports the "software team specific" concept and their operations. Agile sprint, epic are software-specific concepts. Therefore, you can use this API to work with epics.

Note that it is totally legal to "mix" the two APIs.

[Mansi Gusain]

Great thankyou for this information. 

[Karan Sachdev]

Hey @Mansi Gusain

The Jira Cloud Platform APIs are for any core Jira related operations like creating/accessing projects, issues etc. These operations are common across multiple JIra products like Jira Software, Jira Service Management etc.

Jira Software Cloud APIs on the other hand are operations specific to Jira Software projects, like sprint related or board related operations.

Thanks!