To create an entry in an activity, such as a to-do item or to add a reply to another entry, send an Atom entry document containing the new activity node of the appropriate type to the parent activity's node list.
To create an entry that includes a bookmark or file, post an entry node of type entry and include a field of the appropriate type, link or file respectively, in that entry. To create a stand-alone comment, post an entry node of type entry that has a field of type text. To post a comment as a reply to an existing entry, post a node of type reply.
Table 1. Atom API entry request details
activity node list
Value of the href attribute of the <app:collection> element of the activity.
Provide one of the activity node types as an Atom entry document.
The content type of the Atom entry document must be application/atom+xml
- To create an entry that contains a file attachment, use a multipart post method to post the file. The HTTP response represents the multipart post as an activity node of type entry that contains an <snx:field> element of type file.
- To add a standard entry or a todo entry to a specific activity section, in the Atom entry document that you use to define the entry, include a <thr:in-reply-to> element which identifies the section that you want to add the entry to.
If successful, an activity node type Atom entry document. If a failure, an error message in XML.
Returned HTTP headers
HTTP/1.1 201 Created
Indicates that the activity entry was successfully created. If an error occurs, this header contains one of the error codes.Location: url
Link to edit_url of the new activity node that can be used to update it.Error codes
Parent topic: Working with activity nodes
To-do item content
- HTTP/1.1 400 Bad Request
- HTTP/1.1 403 Forbidden: Authorization failed.
- HTTP/1.1 404 Not Found