Feature/update api example outputs (#2547)

* /v1/workspace/{slug} actually returns an array - update example output

* update swagger example to show array output