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
manager\u201d: null<\/code>.<\/li>\n\n\n\n
Copy the entire body and paste it into the Body<\/strong> of the API request. <\/li>\n\n\n\n
Find the line with the \u201cmanager<\/code>\u201d: attribute and delete the null<\/code> within the quotation marks \u201c \u201d.<\/li>\n\n\n\n
Go back to your JumpCloud admin portal. <\/li>\n\n\n\n
Under USER MANAGEMENT<\/strong> > Users<\/strong>. Search for the user that you want to be the Manager for the user above. <\/li>\n\n\n\n
Click on the user, and copy their UID, (the directions on finding this are above). <\/li>\n\n\n\n
Return to your API client and paste the user\u2019s UID in between the quotation marks \u201c \u201d. <\/li>\n\n\n\n
Change the dropdown from GET<\/strong> to PUT<\/strong>.<\/li>\n<\/ol>\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 \u201cmanager<\/code>\u201d: attribute.<\/p>\n <\/div><\/div><\/div><\/div>\n\n\n\n
\n- Click Send<\/strong>. <\/li>\n\n\n\n
- You should receive a ‘200 OK’<\/strong> Status<\/strong>. <\/li>\n\n\n\n
- Scroll down to confirm that the \u201c
manager<\/code>\u201d: attribute has the new UID populated instead of null<\/code>. <\/li>\n\n\n\n
Now, go back to your JumpCloud admin portal and refresh the page. <\/li>\n\n\n\n
Select your user who you just assigned a Manager for. <\/li>\n\n\n\n
Click on the Details<\/strong> tab. <\/li>\n\n\n\n
Expand the Employment Information<\/strong> section and confirm that the new Manager you assigned for the user is populated in the Manager<\/strong> field.<\/li>\n<\/ol>\n\n\n\nTo remove a Manager<\/strong><\/h3>\n\n\n\n\n- Log in to both your JumpCloud Admin Portal<\/a>, and your preferred API client account.<\/li>\n\n\n\n
- You need to send a GET<\/strong> request for the user that you want to remove the Manager for. You will need the user\u2019s UID first, (the directions on finding this are above). <\/li>\n\n\n\n
- Copy\/paste the Manager\u2019s UID into the URI<\/strong> field, after https:\/\/console.jumpcloud.com\/api\/systemusers\/<\/kbd> and click Send<\/strong>. <\/li>\n\n\n\n
- The results will display in the second API request field. Scroll down to the line, \u201c
manager<\/code>\u201d: and delete the UID following \u201cmanager<\/code>\u201d: Replace it with null<\/code>. <\/li>\n\n\n\n
Change the dropdown from GET<\/strong> to PUT<\/strong>, and click Send<\/strong>.<\/li>\n\n\n\n
You should receive a ‘200 OK’ Status<\/strong>. <\/li>\n\n\n\n
Scroll down to confirm that the \u201cmanager<\/code>\u201d: attribute has null<\/code> instead of the Manager\u2019s UID. <\/li>\n\n\n\n
Now, go back to your JumpCloud admin portal and refresh the page. <\/li>\n\n\n\n
Select your user who you just removed the Manager for. <\/li>\n\n\n\n
Click on the Details<\/strong> tab. <\/li>\n\n\n\n
Expand the Employment Information<\/strong> section and confirm that the Manager<\/strong> field is empty. <\/li>\n<\/ol>\n\n\n\n
To delete a Manager<\/strong><\/h3>\n\n\n\n\n- Log in to both your JumpCloud Admin Portal<\/a>, and your preferred API client account.<\/li>\n\n\n\n
- You need to send a GET<\/strong> request for the Manager you want to delete. You will need the user\u2019s UID first, (the directions on finding this are above).<\/li>\n\n\n\n
- Copy\/paste the Manager\u2019s UID into the URI<\/strong> field, after https:\/\/console.jumpcloud.com\/api\/systemusers\/<\/kbd> and click Send<\/strong>. <\/li>\n\n\n\n
- The results will display in the API response.<\/li>\n<\/ol>\n\n\n\n
<\/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
\n- The flag
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
Copy this flag and paste it in the URI<\/strong> field, after the https:\/\/console.jumpcloud.com\/api\/systemusers\/<\/kbd> and UID, add a question mark ?, followed by the API flag provided.<\/li>\n\n\n\n
Make sure the dropdown selected is for the DELETE<\/strong> request, and click Send<\/strong>.<\/li>\n\n\n\n
You should receive a ‘200 OK’ Status<\/strong>. <\/li>\n\n\n\n
Scroll down to confirm that the \u201cmanager<\/code>\u201d: attribute has null<\/code> instead of the Manager\u2019s UID. <\/li>\n\n\n\n
Now, go back to your JumpCloud admin portal and refresh the page. <\/li>\n\n\n\n
Select a user who you just deleted the Manager for. <\/li>\n\n\n\n
Click on the Details<\/strong> tab. <\/li>\n\n\n\n
Expand the Employment Information<\/strong> section and confirm that the Manager<\/strong> field is empty.<\/li>\n\n\n\n
Close out of the user\u2019s information panel and search for the Manager that you just deleted. There should be no results, indicating that the Manager has been deleted. <\/li>\n<\/ol>\n\n\n\n
FAQs<\/strong><\/h2>\n\n\n\nWhat happens when an Admin deletes a Manager?<\/a>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
What directories can Manager be exported to?\n<\/a>Google Workspace, with other integrations to come in the future.\n<\/p><\/div><\/div>\n\n\n\n
What value will be exported to Google workspace?\n<\/a>The Manager\u2019s Company Email.\n<\/p><\/div><\/div>\n\n\n\n
Can I import Managers?\n<\/a>\nAt 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
Will a user be able to see that they are a Manager?\n<\/a>Users won’t have access to view if they are a Manager.\n<\/p><\/div><\/div>\n\n\n\n
Can Managers assign Groups?\n<\/a>Managers can’t assign Groups at this time. \n<\/p><\/div><\/div>\n","protected":false},"excerpt":{"rendered":"
Attributes are how access and role decisions are made. Introducing the Manager attribute helps Admins centralize and streamline their user […]<\/p>\n","protected":false},"author":207,"featured_media":0,"template":"","meta":{"_acf_changed":false,"_oasis_is_in_workflow":0,"_oasis_original":0,"_oasis_task_priority":"","inline_featured_image":false,"footnotes":""},"support_category":[3003,2932,2850],"support_tag":[],"coauthors":[2843],"acf":[],"yoast_head":"\n
Use the Manager Attribute in the Admin Portal and API - JumpCloud<\/title>\n<meta name=\"description\" content=\"Learn how to use the Manager attribute to centralize and streamline user management across recourses.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/jumpcloud.com\/support\/use-the-manager-attribute-in-admin-portal-and-api\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Use the Manager Attribute in the Admin Portal and API\" \/>\n<meta property=\"og:description\" content=\"Browse the JumpCloud Help Center by category, search for a specific topic, or check out our featured articles.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/jumpcloud.com\/support\/use-the-manager-attribute-in-admin-portal-and-api\" \/>\n<meta property=\"og:site_name\" content=\"JumpCloud\" \/>\n<meta property=\"article:modified_time\" content=\"2024-02-27T16:52:03+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/jumpcloud.com\/wp-content\/uploads\/2024\/07\/202405-MISC-JumpCloudHelpCenter-SiteDisplay-min-2.png\" \/>\n\t<meta property=\"og:image:width\" content=\"890\" \/>\n\t<meta property=\"og:image:height\" content=\"525\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"7 minutes\" \/>\n\t<meta name=\"twitter:label2\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data2\" content=\"sashaharrington\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/jumpcloud.com\/support\/use-the-manager-attribute-in-admin-portal-and-api\",\"url\":\"https:\/\/jumpcloud.com\/support\/use-the-manager-attribute-in-admin-portal-and-api\",\"name\":\"Use the Manager Attribute in the Admin Portal and API - JumpCloud\",\"isPartOf\":{\"@id\":\"https:\/\/jumpcloud.com\/#website\"},\"datePublished\":\"2023-05-16T22:07:50+00:00\",\"dateModified\":\"2024-02-27T16:52:03+00:00\",\"description\":\"Learn how to use the Manager attribute to centralize and streamline user management across recourses.\",\"breadcrumb\":{\"@id\":\"https:\/\/jumpcloud.com\/support\/use-the-manager-attribute-in-admin-portal-and-api#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/jumpcloud.com\/support\/use-the-manager-attribute-in-admin-portal-and-api\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/jumpcloud.com\/support\/use-the-manager-attribute-in-admin-portal-and-api#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/jumpcloud.com\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Support\",\"item\":\"https:\/\/jumpcloud.com\/support\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Use the Manager Attribute in the Admin Portal and API\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/jumpcloud.com\/#website\",\"url\":\"https:\/\/jumpcloud.com\/\",\"name\":\"JumpCloud\",\"description\":\"Daily insights on directory services, IAM, LDAP, identity security, SSO, system management (Mac, Windows, Linux), networking, and the cloud.\",\"publisher\":{\"@id\":\"https:\/\/jumpcloud.com\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/jumpcloud.com\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/jumpcloud.com\/#organization\",\"name\":\"JumpCloud\",\"url\":\"https:\/\/jumpcloud.com\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/jumpcloud.com\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/jumpcloud.com\/wp-content\/uploads\/2021\/01\/jc-logo-brand-2021.png\",\"contentUrl\":\"https:\/\/jumpcloud.com\/wp-content\/uploads\/2021\/01\/jc-logo-brand-2021.png\",\"width\":598,\"height\":101,\"caption\":\"JumpCloud\"},\"image\":{\"@id\":\"https:\/\/jumpcloud.com\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Use the Manager Attribute in the Admin Portal and API - JumpCloud","description":"Learn how to use the Manager attribute to centralize and streamline user management across recourses.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/jumpcloud.com\/support\/use-the-manager-attribute-in-admin-portal-and-api","og_locale":"en_US","og_type":"article","og_title":"Use the Manager Attribute in the Admin Portal and API","og_description":"Browse the JumpCloud Help Center by category, search for a specific topic, or check out our featured articles.","og_url":"https:\/\/jumpcloud.com\/support\/use-the-manager-attribute-in-admin-portal-and-api","og_site_name":"JumpCloud","article_modified_time":"2024-02-27T16:52:03+00:00","og_image":[{"width":890,"height":525,"url":"https:\/\/jumpcloud.com\/wp-content\/uploads\/2024\/07\/202405-MISC-JumpCloudHelpCenter-SiteDisplay-min-2.png","type":"image\/png"}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"7 minutes","Written by":"sashaharrington"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/jumpcloud.com\/support\/use-the-manager-attribute-in-admin-portal-and-api","url":"https:\/\/jumpcloud.com\/support\/use-the-manager-attribute-in-admin-portal-and-api","name":"Use the Manager Attribute in the Admin Portal and API - JumpCloud","isPartOf":{"@id":"https:\/\/jumpcloud.com\/#website"},"datePublished":"2023-05-16T22:07:50+00:00","dateModified":"2024-02-27T16:52:03+00:00","description":"Learn how to use the Manager attribute to centralize and streamline user management across recourses.","breadcrumb":{"@id":"https:\/\/jumpcloud.com\/support\/use-the-manager-attribute-in-admin-portal-and-api#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/jumpcloud.com\/support\/use-the-manager-attribute-in-admin-portal-and-api"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/jumpcloud.com\/support\/use-the-manager-attribute-in-admin-portal-and-api#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/jumpcloud.com\/"},{"@type":"ListItem","position":2,"name":"Support","item":"https:\/\/jumpcloud.com\/support"},{"@type":"ListItem","position":3,"name":"Use the Manager Attribute in the Admin Portal and API"}]},{"@type":"WebSite","@id":"https:\/\/jumpcloud.com\/#website","url":"https:\/\/jumpcloud.com\/","name":"JumpCloud","description":"Daily insights on directory services, IAM, LDAP, identity security, SSO, system management (Mac, Windows, Linux), networking, and the cloud.","publisher":{"@id":"https:\/\/jumpcloud.com\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/jumpcloud.com\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/jumpcloud.com\/#organization","name":"JumpCloud","url":"https:\/\/jumpcloud.com\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/jumpcloud.com\/#\/schema\/logo\/image\/","url":"https:\/\/jumpcloud.com\/wp-content\/uploads\/2021\/01\/jc-logo-brand-2021.png","contentUrl":"https:\/\/jumpcloud.com\/wp-content\/uploads\/2021\/01\/jc-logo-brand-2021.png","width":598,"height":101,"caption":"JumpCloud"},"image":{"@id":"https:\/\/jumpcloud.com\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/support\/75875"}],"collection":[{"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/support"}],"about":[{"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/types\/support"}],"author":[{"embeddable":true,"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/users\/207"}],"version-history":[{"count":3,"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/support\/75875\/revisions"}],"predecessor-version":[{"id":106483,"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/support\/75875\/revisions\/106483"}],"wp:attachment":[{"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/media?parent=75875"}],"wp:term":[{"taxonomy":"support_category","embeddable":true,"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/support_category?post=75875"},{"taxonomy":"support_tag","embeddable":true,"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/support_tag?post=75875"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/coauthors?post=75875"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}