How to upload a file to Atlassian Confluence page using curl

Question

I am trying to upload an .xls file to a Confluence wiki page following the guidelines given in the Remote API documentation : https://developer.atlassian.com/confdev/confluence-server-rest-api/confluence-rest-api-examples#ConfluenceRESTAPIExamples-Uploadanattachment

curl -v -S -u admin:admin -X POST -H "X-Atlassian-Token: nocheck" -F "[email protected]" -F "comment=this is my file" "http://localhost:8080/confluence/rest/api/content/3604482/child/attachment" | python -mjson.tool

This is what I am doing:

curl -v -S -u username:password -X POST -H "X-Atlassian-Token: nocheck" -F "file=@/path/to/local/excelsheet.xls" https://<Confluence server>/display/page

I omitted the Python -mjson.tool as it says 'No JSON object could be decoded' and it didn't make sense as I am not posting JSON.

However the above curl command is not working for me. I see the html of the target page on my console and the file doesn't get uploaded. I tried modifying the curl command in several ways but nothing worked.

Also for the URL of the page I am trying to upload to, it doesn't have any contentID as suggested in the documentation. The target URL is a page which accepts attachments and shows the uploaded file list.

Could someone please point out where am I going wrong? I don't have much experience with Curl.

Community · Accepted Answer · 2017-05-23 12:17:41Z

4

David Vonka answer is correct except for header "X-Atlassian-Token" value. It must be "no-check" (instead of "nocheck")

So corrected command is:

curl -v -S -X POST -H "X-Atlassian-Token: no-check" -F "file_0=@<file name>" -F "comment_0=<upload comment>" "http://<server>:<port>/<context>/pages/doattachfile.action?pageId=<page id>&os_username=<username>&os_password=<password>"

NOTE: replace all the <...> placeholders with your values

edited May 23, 2017 at 12:17

CommunityBot

11 silver badge

answered Apr 15, 2014 at 12:00

rubensa

1,31016 silver badges9 bronze badges

Sign up to request clarification or add additional context in comments.

Comments

m.wasowski · Accepted Answer · 2014-03-21 06:40:45Z

3

you need to use REST API in url: .../confluence/rest/api/content/$PAGE_ID/child/attachment and now you are using url of view page.

answered Mar 21, 2014 at 6:40

m.wasowski

6,3761 gold badge25 silver badges30 bronze badges

9 Comments

Periastron Over a year ago

I tried this as well. It didn't work :( I looked up the page_id from the Page Information section under Tools.

m.wasowski Over a year ago

What exactly did you try? Also, make sure that: 1) rest api is enabled by admin (by default it's off IIRC), 2) you have rights to use it, 3) it is not restricted to intranet/whitelist/otherwise_authorized_users, 4) it is under the same host as 'viewable' confluence.

Periastron Over a year ago

I tried curl -v -S -u username:password -X POST -H "X-Atlassian-Token: nocheck" -F "[email protected]" -F "comment=this is my file" "https://<confluence server>/confluence/rest/api/content/889912330/child/attachment" 889912330 is the page id that I found when I looked it up under Tools. On the console, it returns a 404 along with all the html.

m.wasowski Over a year ago

you should wrap your comment with single quotes:

curl -v -S -u username:password -X POST -H "X-Atlassian-Token: nocheck" -F "[email protected]" -F "comment='this is my file'" "http://<confluence server>/confluence/rest/api/content/889912330/child

Periastron Over a year ago

I removed the comments altogether. curl -v -S -u username:password -X POST -H "X-Atlassian-Token: nocheck" -F "[email protected]" "https://<confluence server>/confluence/rest/api/content/889912330/child/attachment. Still not working :(

|

David Vonka · Accepted Answer · 2014-03-22 13:42:07Z

1

I do not think that confluence rest api allows file upload. Please do this instead

curl -v -S -X POST -H "X-Atlassian-Token: nocheck" -F "file_0=@<file name>" -F "comment_0=<upload comment>" "http://<server>:<port>/<context>/pages/doattachfile.action?pageId=<page id>&os_username=<username>&os_password=<password>"

replace all the <...> placeholders with your values

answered Mar 22, 2014 at 13:42

David Vonka

5355 silver badges16 bronze badges

1 Comment

David Vonka Over a year ago

works for me on Confluence 3.5, the newer version do indeed have a res api that allows upload.

mercedes · Accepted Answer · 2019-10-17 06:45:28Z

0

The API POST syntax should be corrected from "https://ConfluenceServer/display/page" to the correct res/api/content syntax eg: "https://companyName.atlassian.net/display/rest/api/content/pageIDxxxxx":

 curl -v -S  -X POST -H "X-Atlassian-Token: no-check" -F "file_0=@<file name>" -F "comment_0=<upload comment>" https://<companyName>.atlassian.net/display/rest/api/content/<pageID15398762>/child/attachment

The pageID can be found in the URL display page. For example: https://companyName.atlassian.net/display/spaces/DEV/pages/pageID15398762/Page+Title+Name

For more API syntax details please refer to this documentation:
https://docs.atlassian.com/atlassian-confluence/REST/6.6.0/#content-createContent

edited Oct 17, 2019 at 6:45

answered Oct 17, 2019 at 6:29

mercedes

1891 silver badge5 bronze badges

Collectives™ on Stack Overflow

How to upload a file to Atlassian Confluence page using curl

4 Answers 4

Comments

9 Comments

1 Comment

Comments

Your Answer

Linked

Hot Network Questions

Collectives™ on Stack Overflow

4 Answers 4

Comments

9 Comments

1 Comment

Comments

Your Answer

Sign up or log in

Post as a guest

Linked

Related