Create Version should return location and users

[bosschaert]

Expected Behaviour

The Create Version API should return the URL of the version created in the Location header.

It should also return the associated user(s) with the version in the metadata.

[auniverseaway]

FWIW, I don't think this should be stored in the header. I think this should be in the body. It's pretty un-conventional to get information client-side from a header object.

{
  "url": "https://...",
  "users": [{"email": "anonymous"}],
  "label": "My new version",
}

My expectation would be that the format matches what the list API gives.

[auniverseaway]

I also noticed that we are not sending the fully qualified domain... this means the client has to do more work:

URL is not actually a URL in the above screenshot. I would follow Helix conventions in that we always try to provide fully qualified URLs.

[bstopp]

URL is not actually a URL in the above screenshot. I would follow Helix conventions in that we always try to provide fully qualified URLs.

Doesn't the client have to do more work anyway? These paths are relative to the incoming origin path - and since the DA UI doesn't have to run on da.live - we don't know what the fully qualified URL is supposed to be, unless we look at the request origin header.

on Helix they can make it FQ since the origin is always a aem.page/live URL. To achieve the same the Route will need to reprocess/handle generating the response objects (which i'm not opposed to as i feel like the persistence operations do way too much handling/managing the format of data sent back to caller)