Maybe a little more appropriate to post this to a private list (no pun
intended) for beta users? I admit I feel a little jealous every time I see
one of these updates, unless there's some way to get into the beta.
On Wed, Oct 28, 2009 at 2:00 PM, Marcel Molina <mar...@twitter.com> wrote:
> Two additions and two changes to the List API will be deployed in the
> next few days:
> * List descriptions
> We're adding a description to every list. You'll be able to specify a
> description when you create or update a list and the description will
> be included in the payload.
> * Cursoring through lists of lists
> All resources that return a list of lists will include next and
> previous cursors and will accept a :cursor parameter.
> * Finding by list id rather than slug
> When you change the name of a list, the slug will be updated to
> reflect that change. That means using the slug in the url for
> resources to operate on lists requires the onerous task of validating
> that the slug for the list you are about to do something with hasn't
> been updated since the last time you stored its slug. What a nightmare
> Every list also has an id. This value won't change. We'll be changing
> the API to replace all instances of a list slug in urls to be list ids
> * Consistent names
> The terminology we've used thus far for people you follow with a list
> is members. The terminology for people who are following a list is
> subscribers. We're going to mirror the terminology used for users and
> change it to followers and following respectively.
> /:user/lists/:list_id/memberships becomes /:user/lists/:list_id/followers
> /:user/lists/:list_id/subscribers becomes /:user/lists/:list_id/following
> As we deploy these changes we'll send out a heads up on the dev list
> and @twitterapi.
> Marcel Molina
> Twitter Platform Team