To create a community file, send a POST request to the remote applications feed of the community to which you want to add the file.
See Authenticating requests
for information about how to authenticate the request.
- Determine the URI to which to POST the file Atom document to create the community file by first accessing the service document for remote applications. See Retrieving a remote applications list for more details.
- Create an Atom document to represent the community file.
- Send the Atom document using a POST request to the following URI:
Table 1. Atom API request details
|POST||Communities remote applications feed||From the entry in the Communities remote application feed that contains the following category: <category term="Files" scheme="http://www.ibm.com/xmlns/prod/sn/type" /> , find the value of the href attribute in the <link> element that has the following rel attribute value: rel="http://www.ibm.com/xmlns/prod/sn/remote-application/publish".||file|
Provide a file Atom entry document.
The content type of the Atom entry document must be application/atom+xml
An Atom entry document containing the new file entry.
Returned HTTP headers
HTTP/1.1 201 Created
Indicates that the community file was successfully created. If an error occurs, this header contains one of the error codes.Location: url
Link to edit_url of the new community file. You can use the web address specified here to subsequently update the community file.Error codes
- HTTP/1.1 400 Bad Request
- HTTP/1.1 403 Forbidden: Authorization failed.
Parent topic: Working with remote applications
Retrieving a remote applications list