To add an owner or moderator to the members list of a forum, send an Atom entry document containing the new member to the access control list feed. Use the <snx:role> element to specify which role you want the person to have. You can only add one member per post.
Forums are public, so anyone who can authenticate with IBM Connections can access a forum. Therefor, there is no member level role in the members list of a forum, only owner and moderator roles.
See Authenticating requests
for information about how to authenticate the request. Only forum owners can add people to a forum as owners and moderators.
Table 1. Atom API request details
|POST||Members feed||Value of the href attribute of the <link> element with the rel="http://www.ibm.com/xmlns/prod/sn/member-list" attribute value in one of the forums feeds, such as My Forums.||member|
Provide a member Atom entry document.
The content type of the Atom entry document must be application/atom+xml
An Atom entry document containing the new member entry.
Returned HTTP headers
HTTP/1.1 201 Created
Indicates that the owner was successfully added. If an error occurs, this header contains one of the error codes.Location: url
Link to edit_url of the member. You can use the web address specified here to subsequently retrieve and update the forum owner.Error codes
- HTTP/1.1 400 Bad Request
- HTTP/1.1 403 Forbidden
POST /forums/atom/acl?forumUuid=1A1GC0A80221E5C54FA8D3BE4D1E1B000032 HTTP/1.1
Authorization: Basic xxx
<category scheme="http://www.ibm.com/xmlns/prod/sn/type" term="person" />
Parent topic: Working with stand-alone forum members
Member entry content
HTTP 201 Created