Stack Apps is a question and answer site for apps, scripts, and development with the Stack Exchange API. Join them; it only takes a minute:

Sign up
Here's how it works:
  1. Anybody can ask a question
  2. Anybody can answer
  3. The best answers are voted up and rise to the top

This is probably just a simple documentation fix and not really a bug. The doc for the /questions/{id}/timeline method says that the user and owner objects are not optional, but they aren't always present in the results.


API Help:{id}/timeline

share|improve this question
up vote 2 down vote accepted

Technically that's incorrect.

The help docs say nothing about the required/optional nature of user and owner, only whether certain of their subfields are required should they be present. This is a gap in our automagic doc generation system which will - eventually - be fixed.

When it is, user and owner will be marked "optional."

share|improve this answer
D'oh! You're right. My eye skipped into the user_id field because I was only looking for one specific attribute. Thanks for the clarification. – Bill the Lizard May 30 '10 at 22:26
Did you really make an "automagic" doc generation system? Neat! – Nathan Osman May 30 '10 at 23:23
@George - the majority of the /help information is generated in code. We did this so its harder (though, obviously not impossible) for the docs and the code to get out of sync. – Kevin Montrose May 30 '10 at 23:29

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .