Describe all registered entities (xml)

General notes on special params and headers:
no-cache - this will cause the caching headers to be set for no caching (default caching is set based on last modified date on entity OR 5 minutes)
last-modified - this will force the last-modified date header to be set (unix timestamp in ms), no-cache overrides this
accept - this standard header can be used in place of format extensions (e.g. xml), just leave the extension off the URL

When searching for entities in a list, the following params are handled specially in the system (note that all the RoR conventions are followed for sorting/paging):
_start (number): the position of the first entity to return (0 is the first), e.g. _start=5
_page (number): the page of data to display (0 is first), e.g. _page=2
_perpage (number): the number of entities to return for the page (0 means all), e.g. _perpage=20
_limit (number): the maximum number of entities to return (0 means all), e.g. _limit=50
_order (string): the sort order to return entities in (default is ascending), should be a comma separated list of entity field names which optionally include a suffix to determine order, suffix can be _reverse or _desc for descending order OR '' (blank) or _asc for ascending order, e.g. _order=name OR _order=name_reverse OR _order=name,email_desc,firstname_asc,lastname_reverse
_sort (string): same as order
_validateSession: supply this parameter if sessions are to be explicitly checked to ensure a valid session. Without this, the session validation is left to the provider

Represents announcements for a given site (including merged announcements) or all announcements for a user. Also includes Message Of The Day and public announcements. There are three optional URL parameters available: 'n' to set the total number of announcements returned, 'd' to set the number of days in the past to retrieve announcements for, and 'a' to set an ascending sort order of true or false. If the system is configured with the (default) 'Announcement Reorder' property, announcements will be additionally sorted by the message_order. If these parameters are not set, they are retrieved from the tool configuration, or the standard defaults of n=3, d=10, a=0 are used. For example /announcements/site/mercury.json?n=20&d=100&a=1 will retrieve up to 20 total announcements for up to 100 days ago with an ascending order.

Represents assignments for a given site.

Batch is a special handler which provides batch processing for multiple entity requests at once

Represents an entry in a web log (blog)

Represents calendar events.

A chat channel represents a chat room in a context (site).

A chat message represents a message in a chat channel (room).

Provides a set of RESTful endpoints for retrieving COMMONS posts.

Represents the Content/Resources tool

Represents the Drop Box tool

Eval Reports allows for exporting reports in various formats.

Provides a set of RESTful endpoints for retrieving single fora, site collections of fora , individual topics (collections of conversations) and messages with their children. An example workflow would be to call the site action with /direct/forums/site/SITEID.json for the top level fora in a site, then to use /direct/forums/site/SITEID/forum/FORUMID.json to get an individual forum to the topic level. After that you would use /direct/forums/site/SITEID/forum/FORUMID/topic/TOPICID.json to get a topic, basicallya set of conversations, then you would call /direct/forums/site/SITEID/forum/FORUMID/topic/TOPICID/message/MESSAGEID.json to get a fully populated message with attachments and children.

Represent Gradebook items and also special provider that instead delegates to the Gradebook tool views

Allows access to the various data structures available from the LTIService support LTI 1.x and LTI 2.x work. Collection endpoints allow the use of first= last= and order= parameters.

Represents mailarchive messages for a given site

Represents a user's membership in a location (site, group, etc.) in the system, works with the site/group entities and the user entities. In the documentation below, a membership ID is a string in the form USER_ID::LOCATION_REFERENCE (e.g., "aaronz::site:mySiteId").

A set of URLs that can be used for directly linking to various pages and views in Profile2.

Allows access to Sakai's email notification handling

Represents the Podcast tool

Deprecated. Use polls entity provider. Represents a poll (single item survey) and optionally the votes (responses) to the poll and options (choices)

Deprecated. Use polls entity provider. Represents an option (choice) in a poll

Deprecated. Use polls entity provider. Represents a user's vote in a poll

Represents polls, options (choices), and votes of the poll tool.

Presents an HTTP interface onto Sakai's portal chat system.

Represents a user's profile. Because of the privacy settings that a user can set for individual parts of their profile, the information in the profile that is returned for a given user will be tailored based on the person requesting it.

Enables anonymous reporting of tool usage to SiteStats. There are no usable interfaces here.

Allows access to the Profile2 messaging system

Represents a user's status.

Represents roster of a site.

Represents settings in the server configuration

Represents a user or system session which is currently active, inactive sessions or information about inactive sessions cannot be accessed, the session is effectively immutable and removing it is the same as deactivating it, updating simply has the effect of refreshing it so it will not timeout

Represents a site (a collection of users and tools) in the Sakai system

Provides a set of RESTful endpoints for retrieving Sitestats event data.

Provides SiteStats event aggregator metrics for the current server node

Represents the Syllabus tool

An entity provider to allow shortening of URLs via the ShortenedUrlService

Represents a user in the system, user data is effectively immutable and removing users cannot override externally provided users

User Preference Values

Represents the Web Content tool

Provides a set of RESTful endpoints for retrieving wiki pages.

REST:: 1.0.1 SVN: $Revision$ : $Date$