slackhq / slack-api-docs

API Docs for Slack.com
https://api.slack.com/
426 stars 85 forks source link

Group/IM object clarification #13

Open mpickering opened 9 years ago

mpickering commented 9 years ago

There are several places in the documentation where I was a bit confused about what should actually be in an object. Thanks for your help resolving some of these mysteries but there is a more general point that I still would like resolved.

The line below is taken from the documentation for the 'IM object'.

Some API methods will include extra state information for the channel.

Why do some methods include this extra information and some don't? It seems like all the given information should be available anytime an IM object is requested but sometimes information like im_open and last_read is omitted.