Create
cancel
Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

Next challenges

Recent achievements

  • Global
  • Personal

Recognition

  • Give kudos
  • Received
  • Given

Leaderboard

  • Global

Trophy case

Kudos (beta program)

Kudos logo

You've been invited into the Kudos (beta program) private group. Chat with others in the program, or give feedback to Atlassian.

View group

It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

Prevent notifications when using REST API

I am using the Confluence REST API for our Server installation in VBA macros to update (change or add) attachments to Confluence pages and to edit the page content.

Everything works fine but currently I have many subsequent API calls to a given page each of which triggers a notification e-mail to all people watching the page.

Is there an option in the API that I can use to use the "save" instead of the "save and notify" option?

Alternatively, is there a way to combine multiple calls to a given page so that they are all done together?

3 answers

1 accepted

1 vote
Answer accepted

Hello Rosario,

Using the Confluence API allows for easier integration and awesome amounts of automation. When you’re editing multiple (hundreds of pages) at a time, and all those watches get notifications it can be painful to deal with. I have experienced the exact issue you are trying to avoid when bulk updating/automating.

There is a feature request to give you additional functionality to disable notifications of watchers. That Feature request can be found at CONFSERVER-38804 for server and for cloud CONFCLOUD-38804. If you are interested in seeing these feature become part of the product then we would suggest you vote and watch them to receive updates as they progress.

There is a way to disable notifications upon updating content. The work around is from the server feature request and it states the following:

Workaround

Comment from development:

Suppressing notifications upon updating a content via REST is already supported. You currently have to supply a version with an incremented number in the request payload. Add the "minorEdit" field to the

The version payload also supports minor edits and comments as follow

"version" : {
 "number"    : incrementedFromPrevious,
 "minorEdit" : true,
 "message"   : "some version comment to keep on the content history"
}

As stated above, without the work around, watchers of a space/page will be notified on creation/update of content.

I hope this clarifies the capabilities of the Confluence REST API along with a possible work around to your problem.

Regards,
Stephen Sifers

Is there a similar workaround also for adding or updating attachments?

Forget the question this is already possible in the API call itself...

Like Pavel likes this

+1 

I started using "minorEdit" : true, no more page change messages. But a lot of messages about adding attachments. This is not good!

@Rosario De Domenico How do you disable notification when uploading or deleting attachments? The minorEdit thing does not seem to apply there.

Thanks!

In the REST API call itself, you can use the option "-F minorEdit=true" which does the job.

It works for me.

Refer to: https://docs.atlassian.com/atlassian-confluence/REST/6.6.0/#content/{id}/child/attachment-createAttachments

I'll check, I'm using the python requests package though, not curl, so not sure how to pass that in there. 

Thanks!

with the minorEdit =True option like below:-
"version": {
"number":41,
"minorEdit" : "true",
},

 

Watchers are still getting email about content changes. THough emails were sent after some delay :). It would be helpful if someone guide in this issue.

How do we prevent notifications when creating a new page?

With the minorEdit =True option like below:-
"version": {
"number":41,
"minorEdit" : "true",
},

 

Watchers are still getting email about content changes. THough emails were sent after some delay :). It would be helpful if someone guide in this issue.

Suggest an answer

Log in or Sign up to answer
TAGS
Community showcase
Posted in Confluence

What do you think is the most *delightful* Confluence feature? Comment for a prize!

- Create your own custom emoji 🔥 - "Shake for Feedback" on mobile 📱 - An endless supply of GIFs via GIPHY 🤩 Is there anything quite as nice as a pleasant surprise? Comment below with what...

408 views 23 8
Join discussion

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you