Problem Statement

The api documentation for Satellite, located at satellite.example.com/apidoc doesn't specify what type of vm id needs to be used to associate a vm to a compute resource.  It should specify that it needs to be a uuid, otherwise users will try and use the foreman host id, which is not correct.

Also, the /apidoc link says the vm_id is optional, but this is a required field.

The documentation just says:

string from 2 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..

It should indicate that the actual uuid of the vm needs to be used, otherwise users will try and use the foreman host id.