changes following Jamie's comments

- UUID syntax
- URL format
- some wording
- restrictions on text data passed
- slug rules for receiver
link to API spec