Here is yet another example of unfinished documentation:

How is the "attachment" parameter specified? 

Is it a resource id?

Is it a fully-qualified url, such as a permalink or external share link?