I'd like to see other points of reference in other REST APIs or "best practices" for this first. /discussion/id to me seems odd. Considering we have .../messages/... and .../comments/... (I think?) as well. I get the impression that other popular APIs would use a plural for digging into a "collection" of resources. 

On 2013-05-19, at 11:22 PM, nicolaasmatthijs <notifications@github.com> wrote:

> In node_modules/oae-discussions/lib/rest.js:
> 
> > +var OAE = require('oae-util/lib/oae');
> > +var PreviewProcessorAPI = require('oae-preview-processor');
> > +var Util = require('oae-util/lib/util');
> > +
> > +var DiscussionsAPI = require('oae-discussions');
> > +var DiscussionsConstants = require('oae-discussions/lib/constants').DiscussionsConstants;
> > +
> > +
> > +//////////////////////////////
> > +// CREATE / GET DISCUSSIONS //
> > +//////////////////////////////
> > +
> > +/*!
> > + * Create a new discussion
> > + */
> > +OAE.tenantServer.post('/api/discussions/create', function(req, res) {
> All of these endpoints should be /api/discussion/, so the resourceType and identifier are the same. This is in line with the other endpoints.
> 
> —
> Reply to this email directly or view it on GitHub.