Jira REST API <<fields>> vs <<update>> parameter

[Ignacio Pizarro]

I'm diving into Jira cloud REST API and found that in some endpoints we have two available parameters to set or update jira fields: fields and update.

What's the difference between these fields?

Docs says about fields param:

List of issue screen fields to update, specifying the sub-field to update and its value for each field. This field provides a straightforward option when setting a sub-field. When multiple sub-fields or other operations are required, use update

But example itselfs update multiple fields using the fields param instead of update.

Here's and endpoint example: https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-post

Many thanks in advance.

[John Funk · Accepted solution]

Hola Ignacio,

Take a look at this article where it explains some about the difference in fields and update.

https://support.atlassian.com/jira-software-cloud/docs/advanced-field-editing-json/

[Ignacio Pizarro]

Hi John,

That article is the answer I was looking for. Thanks a lot!

[John Funk]

Great! Glad I could help a little.