Community
Products
Confluence
Questions
How to post attachments to confluence page

How to post attachments to confluence page

Hi there, I have searched but with no luck so far? Is it possible to post .png images to a confluence page using either Rest API or Java API?The .png images are sourced from a 3rd party tool and the idea is to build a plugin that will export and import (post) the .png images to Confluence pages?

Any help will will be most welcome?

6 answers

7 votes

Hello Etienne,

Thank you for your inquire.

You could be running the following in Python, for instance:

# ===============
# upload attachment
# ===============
import requests
import json

# [CONFLUENCE-BASE-URL], i.e.: http://localhost:8090
# [CONTENT-ID], get content ID by running '[CONFLUENCE-BASE-URL]/rest/api/content'
url = '[CONFLUENCE-BASE-URL]/rest/api/content/[CONTENT-ID]/child/attachment'
headers = {"X-Atlassian-Token": "nocheck"}
data = {"comment":"this is my file"}


# please, uncomment to attach inline content
#files = {'file': ('report.xml', '&lt;?xml version="1.0" encoding="UTF-8"?&gt;&lt;note&gt;&lt;to&gt;RECIPIENT&lt;/to&gt;&lt;from&gt;SENDER&lt;/from&gt;&lt;heading&gt;ATTACHMENT&lt;/heading&gt;&lt;body&gt;CONTENT&lt;/body&gt;&lt;/note&gt;')}

# please uncomment to attach external file
#files = {'file': open('text.txt', 'rb')}
#files = {'file': open('image.png', 'rb')}

# upload file to page
# [USERNAME], i.e.: admin
# [PASSWORD], i.e.: admin
r = requests.post(url, data=data, auth=('[USERNAME]', '[PASSWORD]'), files=files, headers=headers)
print(r.status_code)
print(r.text)

Alternatively, you could be running the following cURL command:

# [USERNAME], i.e.: admininstrator
# [DOMAIN], i.e.: mycompany
# [CONTENT-ID], i.e.: 9666562
curl -D- -u [USERNAME] -p -H "X-Atlassian-Token: nocheck" -X POST -F file=@/full/path/to/image.png https://[DOMAIN].atlassian.net/wiki/rest/api/content/[CONTENT-ID]/child/attachment

If you find this answer useful, I would kindly ask you to accept it so the same will be visible to others who might be facing the same issue you have inquired.

Thank you for your understanding.

—

Kind regards,
Rafael P. Sperafico
Atlassian Support

You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.

Comment

Thanks for the very useful python example. I'm curious though, it seems to work for me when I first upload but if my change the file I want to attach and then run the python program again, I get a 400 Bad Request.

Is there some magic needed to allow updating an attachment?

You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.

Comment

I am using same CURL command to upload multiple html files but its not allowing me to do so. Could you please suggest. I am using Confluence cloud.

curl -D- -u $USERNAME:$PASSWORD -X PUT -H "X-Atlassian-Token: nocheck" -F "file=@code/pydoc/*.html" -F "minorEdit=false" 'https://alm-tuigroup.atlassian.net/wiki/rest/api/content/504955238/child/attachment'

You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.

Comment

@rsperafico , is there a way to include encrypted username and password in the request?

You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.

Comment

Hi Rafael ,

Thanks so much for your great python example, it's very helpful for me! great!

BR//Ming

You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.

Comment

I think the answer to Dan McMahill's question above is that once an attachment is attached, if you want to update that attachment, then you have to post to a different URL: you need to post to the attachment's data resource. In my case the resource for the attachment update was:

.../rest/api/content/253493424/child/attachment/281051237/data

I was able to find the resource for the attachment via:

curl -k https://.../rest/api/content/253493424/child/attachment | python -mjson.tool

You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.

Comment

Like • like this

1 vote

Using the Confluence Command Line Interface (CLI) might make it easier - use the addAttachment action.

You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.

Comment

0 votes

You can do a multipart POST call to upload multiple attachments at once. I wrote something like the following with apache http client mime library.

public int uploadAttachments(String path, List<String> attachmentNames) throws Exception {
CloseableHttpClient client = getClosableHttpClient();
HttpPost request = new HttpPost(buildURI(path));
MultipartEntityBuilder builder = MultipartEntityBuilder.create();
builder.setMode(HttpMultipartMode.BROWSER_COMPATIBLE);

for (String s : attachmentNames) {
if ("binary".equals(Utils.getFileType(s))) {
// System.out.println(s);
// builder.addBinaryBody("file", null)
builder.addBinaryBody("file", new File(s), ContentType.DEFAULT_BINARY, new File(s).getName());
} else if ("text".equals(Utils.getFileType(s))) {
builder.addBinaryBody("file", new File(s), ContentType.TEXT_PLAIN, new File(s).getName());
} else {

}
}
HttpEntity entity = builder.build();
request.setHeader(HttpHeaders.AUTHORIZATION, "Basic " + this.creds);
request.setHeader("X-Atlassian-Token", "no-check");
request.setEntity(entity);
// System.out.println(EntityUtils.toString(request.getEntity()));
CloseableHttpResponse response = client.execute(request);
// System.out.println(EntityUtils.toString(response.getEntity()));
return response.getStatusLine().getStatusCode();
}

You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.

Comment

0 votes

The python code will move the file in the attachment section. How can we show it in the page content. Any help?

You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.

Comment

0 votes

Thanks for the great Python program. Was breaking my head from morning . Finally this beautiful piece of code.

Thanka a lot Rafael P. Sperafico

You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.

Comment

0 votes

Moving attachments from its current space to a different space:

Using curl, the following can be used to attach the file to a page in a different space:

curl -v -u 'admin:XXX’ -X PUT -d '{"id":"attXXX”,”type":"attachment","title”:”xxx.jpeg","status":"current","ancestors":[],"version": {"number":"2"},"container": {"id": "34514","type": "page","status": "current","title": "Andro Homepage!","space": {"id": 34513,"key": “AR”,”name": "Andro"}}}' -H 'X-Atlassian-Token:<access-token>' -H 'Content-Type:application/json' https://XXX.atlassian.net/wiki/rest/api/content/<parent page id>/child/attachment/attXXX | python -m json.tool

You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.

Missed Team ’24? Catch up on announcements here.

Products

Community resources

Support

Top groups

Community resources

Support

Learn

Community resources

Support

Events

Community resources

Support

Get product advice from experts

Join a community group

Advance your career with learning paths

Earn badges and rewards

Connect and share ideas at events

How to post attachments to confluence page

6 answers

Suggest an answer

Was this helpful?

Thanks!

TAGS

Atlassian Community Events

Missed Team ’24? Catch up on announcements here.

Ask a question

Products

Community resources

Support

Top groups

Community resources

Support

Learn

Community resources

Support

Events

Community resources

Support

Get product advice from experts

Join a community group

Advance your career with learning paths

Earn badges and rewards

Connect and share ideas at events

How to post attachments to confluence page

6 answers

Suggest an answer

Was this helpful?

Thanks!

TAGS

Atlassian Community Events