{"id":75875,"date":"2023-05-16T18:07:50","date_gmt":"2023-05-16T22:07:50","guid":{"rendered":"https:\/\/jumpcloud.com\/?post_type=support&p=75875"},"modified":"2024-02-27T11:52:03","modified_gmt":"2024-02-27T16:52:03","slug":"use-the-manager-attribute-in-admin-portal-and-api","status":"publish","type":"support","link":"https:\/\/jumpcloud.com\/support\/use-the-manager-attribute-in-admin-portal-and-api","title":{"rendered":"Use the Manager Attribute in the Admin Portal and API"},"content":{"rendered":"\n
Attributes are how access and role decisions are made. Introducing the Manager attribute helps Admins centralize and streamline their user management across recourses. Admins will no longer have to manually set the Manager attribute in external bound directories. The Manager attribute can be exported to downstream directories. <\/p>\n\n\n\n
<\/p><\/div>
Google Workspace is currently available for exporting Manager, as our teams work on adding other Directories. <\/p>\n <\/div><\/div><\/div><\/div>\n\n\n\n
Prerequisites<\/strong><\/p>\n\n\n\n Considerations<\/strong><\/p>\n\n\n\n <\/p><\/div> Warning:<\/strong> If Export is selected, existing Managers in downstream directories could be overwritten with empty values if they don’t already exist in JumpCloud. <\/p><\/div><\/div><\/div>\n\n\n\n <\/p><\/div> Only one user can be entered in the Manager<\/strong> field. If another user is added, it will override the other user. <\/p>\n <\/div><\/div><\/div><\/div>\n\n\n\n <\/p><\/div> Double-check that your user\u2019s UID is in the top API request field following the https:\/\/console.jumpcloud.com\/api\/systemusers\/ URL<\/kbd>, and the Manager\u2019s UID is in the Body<\/strong> field below following the \u201c <\/p><\/div> Note:<\/strong> If you try to send a DELETE request, you will receive an error message stating that you need to remove or replace them as a Manager for all direct reports. Fortunately, we have an API flag that you can use to help minimize the effort for this process.<\/p><\/div><\/div><\/div>\n\n\n\n Via the Admin Portal: You receive a confirmation prompt with a list of the selected user(s) that are currently Managers of other users. By deleting these Managers, all direct reports will have their Manager attribute cleared.\n\nVia API: If a DELETE request is sent for a current Manager, the request is rejected with a message stating that the Admin needs to remove or change the Manager for all direct reports. Optionally, the Admin can use an API flag in order to clear the Manager attribute on all direct reports when sending the DELETE request.<\/p><\/div><\/div>\n\n\n\n Google Workspace, with other integrations to come in the future.\n<\/p><\/div><\/div>\n\n\n\n The Manager\u2019s Company Email.\n<\/p><\/div><\/div>\n\n\n\n At the time of the initial import, the Manager attribute is not supported. It is available only after the initial import has been completed.<\/p>\n<\/div><\/div><\/div>\n\n\n\n\n
\n
\n
Adding and Removing Managers in the Admin Portal<\/strong><\/h2>\n\n\n\n
To add a Manager<\/strong><\/h3>\n\n\n\n
\n
\n
To remove a Manager<\/strong><\/h3>\n\n\n\n
\n
Adding, Removing and Deleting the Manager Attribute in JumpCloud\u2019s API<\/strong><\/h2>\n\n\n\n
To add a Manager<\/strong><\/h3>\n\n\n\n
\n
\n
manager\u201d: null<\/code>.<\/li>\n\n\n\n
manager<\/code>\u201d: attribute and delete the
null<\/code> within the quotation marks \u201c \u201d.<\/li>\n\n\n\n
manager<\/code>\u201d: attribute.<\/p>\n <\/div><\/div><\/div><\/div>\n\n\n\n
\n
manager<\/code>\u201d: attribute has the new UID populated instead of
null<\/code>. <\/li>\n\n\n\n
To remove a Manager<\/strong><\/h3>\n\n\n\n
\n
manager<\/code>\u201d: and delete the UID following \u201c
manager<\/code>\u201d: Replace it with
null<\/code>. <\/li>\n\n\n\n
manager<\/code>\u201d: attribute has
null<\/code> instead of the Manager\u2019s UID. <\/li>\n\n\n\n
To delete a Manager<\/strong><\/h3>\n\n\n\n
\n
\n
cascade_manager=null<\/code> is a query parameter for the DELETE<\/strong> request. This will remove the Manager from all their direct reports and delete the account. <\/li>\n\n\n\n
manager<\/code>\u201d: attribute has
null<\/code> instead of the Manager\u2019s UID. <\/li>\n\n\n\n
FAQs<\/strong><\/h2>\n\n\n\n