![](\"\/wp-content\/themes\/jumpcloud\/assets\/images\/gutenberg-blocks\/note-icon.png\"){kind=icon}
<\/p><\/div>
Note:<\/strong> \n
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
- \n
- Both the Manager and the user who will be reporting to the Manager have to already exist.<\/li>\n<\/ul>\n\n\n\n
Considerations<\/strong><\/p>\n\n\n\n
- \n
- The manager\u2019s unique ID is stored as the value for the manager attribute. This allows us to be flexible when exporting manager to downstream resources.<\/li>\n\n\n\n
- The Manager attribute export is limited to Google Workspace for now. Stay tuned for more to come in the future!\n
- \n
- Within Directory Integrations<\/strong>, Manager will function like other existing attributes, remaining unchecked (not exported) by default. Admins can select the manager attribute to be exported if desired.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n
![](\"\/wp-content\/themes\/jumpcloud\/assets\/images\/gutenberg-blocks\/warning-icon.png\")
<\/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
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
- Log in to the JumpCloud Admin Portal<\/a>.<\/li>\n\n\n\n
- Go to USER MANAGEMENT<\/strong> > Users<\/strong>. <\/li>\n\n\n\n
- Click on a user to bring up their information. <\/li>\n\n\n\n
- Click on the Details<\/strong> tab. <\/li>\n\n\n\n
- Scroll down to Employment Information<\/strong> and click on it to expand the section.<\/li>\n\n\n\n
- Under Manager<\/strong>, you can search for the user you want to assign as Manager.<\/li>\n<\/ol>\n\n\n\n
![](\"\/wp-content\/themes\/jumpcloud\/assets\/images\/gutenberg-blocks\/important-icon.png\")
<\/p><\/div>Important:<\/strong> \nOnly 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
- \n
- Select the user and click save user<\/strong>.<\/li>\n<\/ol>\n\n\n\n
To remove a Manager<\/strong><\/h3>\n\n\n\n
- \n
- Go to USER MANAGEMENT<\/strong> > Users<\/strong>.<\/li>\n\n\n\n
- Click on a user to bring up their information.<\/li>\n\n\n\n
- Click on the Details<\/strong> tab.<\/li>\n\n\n\n
- Scroll down to Employment Information<\/strong> and click on it to expand the section.<\/li>\n\n\n\n
- Under Manager<\/strong>, click the ( x<\/strong> ) next to the user\u2019s email to remove this Manager.<\/li>\n\n\n\n
- From here, you can either assign another Manager or leave it blank.<\/li>\n\n\n\n
- Click save user<\/strong>. <\/li>\n<\/ol>\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
- Log in to both your JumpCloud Admin Portal<\/a>, and your preferred API client account.<\/li>\n\n\n\n
- In your admin portal, go to USER MANAGEMENT<\/strong> > Users<\/strong>. <\/li>\n\n\n\n
- Select the user that you would like to add a Manager for. <\/li>\n\n\n\n
- Find the Unique ID (UID)<\/strong> at the end of the URL – there is a numerical + alphabetical character string in between \/users\/ and \/details. <\/li>\n\n\n\n
- Copy only the numbers and letters, leaving behind any punctuation. <\/li>\n\n\n\n
- Go to your API account dashboard. <\/li>\n\n\n\n
- In the Uniform Resource Identifier (URI)<\/strong> field, after https:\/\/console.jumpcloud.com\/api\/systemusers\/<\/kbd>, paste the user\u2019s UID and click Send<\/strong>.\n
- \n
- Make sure that you are sending a GET<\/strong> request.<\/li>\n<\/ul>\n<\/li>\n\n\n\n
- The response should include \u201c
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\nFind the line with the \u201cmanager<\/code>\u201d: attribute and delete thenull<\/code> within the quotation marks \u201c \u201d.<\/li>\n\n\n\nGo back to your JumpCloud admin portal. <\/li>\n\n\n\nUnder USER MANAGEMENT<\/strong> > Users<\/strong>. Search for the user that you want to be the Manager for the user above. <\/li>\n\n\n\nClick on the user, and copy their UID, (the directions on finding this are above). <\/li>\n\n\n\nReturn to your API client and paste the user\u2019s UID in between the quotation marks \u201c \u201d. <\/li>\n\n\n\nChange the dropdown from GET<\/strong> to PUT<\/strong>.<\/li>\n<\/ol>\n\n\n\n<\/p><\/div>Note:<\/strong> \nDouble-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
manager<\/code>\u201d: attribute.<\/p>\n <\/div><\/div><\/div><\/div>\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 ofnull<\/code>. <\/li>\n\n\n\n Now, go back to your JumpCloud admin portal and refresh the page. <\/li>\n\n\n\nSelect your user who you just assigned a Manager for. <\/li>\n\n\n\nClick on the Details<\/strong> tab. <\/li>\n\n\n\nExpand 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 withnull<\/code>. <\/li>\n\n\n\n Change the dropdown from GET<\/strong> to PUT<\/strong>, and click Send<\/strong>.<\/li>\n\n\n\nYou should receive a ‘200 OK’ Status<\/strong>. <\/li>\n\n\n\nScroll down to confirm that the \u201cmanager<\/code>\u201d: attribute hasnull<\/code> instead of the Manager\u2019s UID. <\/li>\n\n\n\nNow, go back to your JumpCloud admin portal and refresh the page. <\/li>\n\n\n\nSelect your user who you just removed the Manager for. <\/li>\n\n\n\nClick on the Details<\/strong> tab. <\/li>\n\n\n\nExpand the Employment Information<\/strong> section and confirm that the Manager<\/strong> field is empty. <\/li>\n<\/ol>\n\n\n\nTo 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\nMake sure the dropdown selected is for the DELETE<\/strong> request, and click Send<\/strong>.<\/li>\n\n\n\nYou should receive a ‘200 OK’ Status<\/strong>. <\/li>\n\n\n\nScroll down to confirm that the \u201cmanager<\/code>\u201d: attribute hasnull<\/code> instead of the Manager\u2019s UID. <\/li>\n\n\n\nNow, go back to your JumpCloud admin portal and refresh the page. <\/li>\n\n\n\nSelect a user who you just deleted the Manager for. <\/li>\n\n\n\nClick on the Details<\/strong> tab. <\/li>\n\n\n\nExpand the Employment Information<\/strong> section and confirm that the Manager<\/strong> field is empty.<\/li>\n\n\n\nClose 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\nFAQs<\/strong><\/h2>\n\n\n\n
What 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}]}}
- The flag
\n
- Select the user and click save user<\/strong>.<\/li>\n<\/ol>\n\n\n\n
- Within Directory Integrations<\/strong>, Manager will function like other existing attributes, remaining unchecked (not exported) by default. Admins can select the manager attribute to be exported if desired.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n