/**
  * METHOD URL
  * Description
  *
  * -- Parameters --
  * URL Params: [field only present if not empty]
  * - name: description and format
  *
  * Body: [field only present if not empty]
  * - name (type): description and format
  *
  * -- Success --
  * -  (type) description
  *
  * -- Failure --
  * - (error code): Error class
  *   - causes for this error
  *
  * -- Example --
  * Request:
  *
  * Response:
  */