Technical Tip: How to move a collector to a collector group in another tenant using the API

To move a collector to a collector group in another tenant, the following URL can be used:

https://<manager console URL>/management-rest/inventory/move-collectors?collectors=Orgname\collector&targetCollectorGroup=Orgname-new\collector-group

However, the following error may be encountered if the targetCollectorGroup parameter in the URL request is set with a  tenant or collector group name containing special characters such as spaces:

Error: b'{"errorMessage":"No group found matching the given \\"targetCollectorGroup\\" parameter"}'

To resolve this, special characters should be replaced with their URL-encoded equivalents (%20 in the case of spaces):

https://<manager console URL>/management-rest/inventory/move-collectors?collectors=Orgname\collector&targetCollectorGroup=Orgname%20new\collector-group"

For other API operations available on the manager console, refer to the official REST API guide in the Fortinet Developer Network: https://fndn.fortinet.net.