Add more prose to requests API docs

In a discussion with Everett Toews, he pointed out that our API docs could use a bit of motivation.
Is the script the body of this request or an existing object in a container?