Get the My Forums feed 

Get a feed that includes forums created by the authenticated user or associated with communities to which the user belongs. You can narrow down the forums that are returned by passing parameters to the request that you use to retrieve the feed.

Table 1. Atom API request details

Resource Description
/atom/forums/my Lists the forums created by the authenticated user or associated with communities to which the user belongs. Returns a feed containing forum entries with information about each forum.

You can use one or more of the input parameters to limit the number of forums returned in the feed. Separate multiple parameters with an ampersand (&).

Table 2. Input parameters

Parameter Description
communityUuid String. The unique ID of a community. Limits the returned entries to include only those forums associated with the specified community.
email Internet email address of a user. Specify this parameter to limit the returned entries to include only those forums that were created by the specified person. Format the HTTP request using the proper URL encoding. For example, the encoded form of the @ symbol is %40 as in:

adam_eventide%40garden.com

Note: Do not use this parameter if IBM Connections is configured to prevent email addresses from being displayed. It will return an error code 400 for an invalid request. Use the userid parameter instead.

page Page number. Specifies the page to be returned. The default value is 1.
ps Page size. Specifies the number of entries to return per page.
since Returns all entries last modified since a specified date. Specify the date in the number of milliseconds since January 1, 1970, 00:00:00 GMT time.
sortBy String. Specifies what to sort the returned entries by. Options are:
created

    Sorts the results by creation date.

lastmod

    Sorts the results by the date on which they were last modified.

sortOrder Defines the order in which to sort the results. Options are:
asc

    Ascending.

desc

    Descending.

tag Returns entries with the specified tag.

Note: Search by one tag at a time.

userid Unique ID that represents a specific person. This value is specified in the <snx:userid> element. Specify this parameter to limit the returned entries to include only those forums that were created by the specified person.
view Identifies the authenticated user's relationship to the forum. Options are:
follow

    Forums you are following.

member

    Community forums of which you are a member.

owner

The default value is owner.


Output

An Atom feed document containing the forum atom entries.


Parent topic

Getting Forums feeds


   

 

});