The first step you must perform if you plan to update resources made available through the Atom APIs is to retrieve the service document for the application.
Before you begin
You cannot add an event to a community programmatically until the Events widget has been added to the community using the Customize menu option in the product user interface. It is not until the widget is explicitly added that the service document resource for Community Events is available from the remote applications feed.
See Authenticating requests
for information about how to authenticate the request.
Table 1. Atom API request details
Communities remote applications feed
Value of the href attribute in the <link> element that has the rel="http://www.ibm.com/xmlns/prod/sn/remote-application/publish" attribute for the entry with the Calendar category in the remote applications Atom document of the community to which you add/update/delete an event.
Retrieves a user's service document which contains the Community Events Collections workspace, for a given community.
To retrieve the service document for the Communities Events widget application, send the following HTTP request:
> GET /communities/calendar/atom/calendar/service?calendarUuid=ae2141c3-dfc5-43e5-b9b0-79f4a55d5e02 HTTP/1.1
> Host: enterprise.example.com
> Accept: */*
The service document for Communities Events is returned by the server. For example:
Parent topic: Working with Community Events widget