{"id":20714,"date":"2020-10-02T13:30:18","date_gmt":"2020-10-02T12:30:18","guid":{"rendered":"https:\/\/marvelapp.com\/blog\/?p=20714"},"modified":"2020-10-02T15:50:11","modified_gmt":"2020-10-02T14:50:11","slug":"easy-api-hacks-for-managing-large-design-teams-in-marvel-workspaces","status":"publish","type":"post","link":"https:\/\/marvelapp.com\/blog\/easy-api-hacks-for-managing-large-design-teams-in-marvel-workspaces\/","title":{"rendered":"Easy API Hacks for Managing Large Design Teams in Marvel"},"content":{"rendered":"<p class=\"pageWrap pageWrap--s marginBottom-m paddingBottom-s c-slate lineHeight-l fontSize-l fontWeight-3 breakPointM-fontSize-xl breakPointM-lineHeight-xl\">We have several customers who have a large number of users in Marvel; from a variety of different teams; including design, product, engineering, marketing, support and more. Whilst the <a class=\"link link--blue fontWeight-4\"href=\"https:\/\/marvelapp.com\/blog\/introducing-user-roles-add-editors-clientsreviewers-admins-and-more\/\">user roles<\/a> in Marvel allow companies to easily manage access and permissions for all their users, when your design team grows to hundreds of people, you can imagine this process needs to be well managed; people leave or change role, new folk join and so on.<\/p>\n<p class=\"pageWrap pageWrap--s marginBottom-m paddingBottom-s c-slate lineHeight-l fontSize-l fontWeight-3 breakPointM-fontSize-xl breakPointM-lineHeight-xl\">To help our admin users with this process, we\u2019ve created this cheat sheet for using our API.<\/p>\n<h2 class=\"pageWrap pageWrap--s marginTop-xl marginBottom-l c-black lineHeight-xl fontSize-xl fontWeight-5 breakPointM-lineHeight-xxl breakPointM-fontSize-xxl\" style=\"margin-left: auto; margin-right: auto;\">A quick word on the Marvel API<\/h2>\n<p class=\"pageWrap pageWrap--s marginBottom-m paddingBottom-s c-slate lineHeight-l fontSize-l fontWeight-3 breakPointM-fontSize-xl breakPointM-lineHeight-xl\">The <a class=\"link link--blue fontWeight-4\"href=\"https:\/\/marvelapp.com\/developers\">Marvel API<\/a> was developed for anyone who wants to build custom apps on top of Marvel. We\u2019ve already built loads of useful integrations using the API that will charge up your design process, including;<\/p>\n<ul class=\"pageWrap pageWrap--s list list--unordered marginBottom-l lineHeight-l fontSize-l fontWeight-3 breakPointM-fontSize-xl breakPointM-lineHeight-xl\">\n<li><a class=\"link link--blue fontWeight-4\"href=\"https:\/\/userflows.marvelapp.com\/\">User Flows<\/a> \u2013 a sitemap tool that syncs with your prototypes to visualise the UX flow; great for providing a top-level view of your projects when showcasing to clients<\/li>\n<li><a class=\"link link--blue fontWeight-4\"href=\"https:\/\/botbot.marvelapp.com\/\">Bot Bot<\/a> \u2013 a Slack integration that enables you to create new users, projects, folders etc. in Marvel directly from Slack; this is really useful for admin users who need to help with account set-up, but don\u2019t actually need to be in Marvel<\/li>\n<\/ul>\n<h2 class=\"pageWrap pageWrap--s marginTop-xl marginBottom-l c-black lineHeight-xl fontSize-xl fontWeight-5 breakPointM-lineHeight-xxl breakPointM-fontSize-xxl\" style=\"margin-left: auto; margin-right: auto;\">Using the API to query your Marvel account<\/h2>\n<p class=\"pageWrap pageWrap--s marginBottom-m paddingBottom-s c-slate lineHeight-l fontSize-l fontWeight-3 breakPointM-fontSize-xl breakPointM-lineHeight-xl\">Aside from these integrations, what you can also do is query data in your Marvel account. This is perfect for account owners and administrator of large companies who need to monitor their user lists and usage.<\/p>\n<h3 class=\"pageWrap pageWrap--s marginTop-l marginBottom-m c-black lineHeight-xl fontSize-xl fontWeight-5\">How to extract a list of users from Marvel with the API<\/h3>\n<p class=\"pageWrap pageWrap--s marginBottom-m paddingBottom-s c-slate lineHeight-l fontSize-l fontWeight-3 breakPointM-fontSize-xl breakPointM-lineHeight-xl\">Follow these six easy steps to extract a list of all your users and their role from Marvel using our API:<\/p>\n<ol class=\"pageWrap pageWrap--s list list--ordered marginBottom-l lineHeight-l fontSize-l fontWeight-3 breakPointM-fontSize-xl breakPointM-lineHeight-xl\">\n<li><a class=\"link link--blue fontWeight-4\"href=\"https:\/\/marvelapp.com\/signin\">Login into your Marvel account<\/a> as either an Admin or Owner<\/li>\n<li>Copy and paste this URL into a new browser tab; <a class=\"link link--blue fontWeight-4\"href=\"https:\/\/marvelapp.com\/graphql?query=%23%20Let%27s%20get%20you%20started%20with%20a%20query%20to%20retrieve%20your%20user%20account%0A%23%20and%20its%20first%203%20projects%3A%0A%0Aquery%20%7B%0A%20%20user%20%7B%0A%09%09company%20%7B%0A%20%20%20%20%20%20members(first%3A%201000)%20%7B%0A%20%20%20%20%20%20%20%20edges%20%7B%0A%20%20%20%20%20%20%20%20%20%20node%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20email%0A%20%20%20%20%20%20%20%20%20%20%20%20username%0A%20%20%20%20%20%20%20%20%20%20%20%20role%0A%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20pageInfo%20%7B%0A%20%20%20%20%20%20%20%20%20%20endCursor%0A%20%20%20%20%20%20%20%20%20%20startCursor%0A%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%7D%20%20%20%20%20%20%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A\">copy and paste me<\/a><\/li>\n<li>The graphiQL will open with this query in it;<img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-medium wp-image-20716\" src=\"https:\/\/marvelapp.com\/wp-content\/uploads\/2020\/09\/Screenshot-2020-09-29-at-08.36.19-600x390.png\" alt=\"GraphiQL - Marvel API Queries\" width=\"600\" height=\"390\" srcset=\"https:\/\/marvelapp.com\/wp-content\/uploads\/2020\/09\/Screenshot-2020-09-29-at-08.36.19-600x390.png 600w, https:\/\/marvelapp.com\/wp-content\/uploads\/2020\/09\/Screenshot-2020-09-29-at-08.36.19-768x499.png 768w, https:\/\/marvelapp.com\/wp-content\/uploads\/2020\/09\/Screenshot-2020-09-29-at-08.36.19.png 1278w\" sizes=\"auto, (max-width: 600px) 100vw, 600px\" \/><\/li>\n<li>Press the Play button to run the query; you should then see a list of all users in your Marvel account on the right hand side; <img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-medium wp-image-20725\" src=\"https:\/\/marvelapp.com\/wp-content\/uploads\/2020\/09\/Screenshot-2020-09-29-at-18.57.22-484x600.png\" alt=\"API query results\" width=\"484\" height=\"600\" srcset=\"https:\/\/marvelapp.com\/wp-content\/uploads\/2020\/09\/Screenshot-2020-09-29-at-18.57.22-484x600.png 484w, https:\/\/marvelapp.com\/wp-content\/uploads\/2020\/09\/Screenshot-2020-09-29-at-18.57.22-768x953.png 768w, https:\/\/marvelapp.com\/wp-content\/uploads\/2020\/09\/Screenshot-2020-09-29-at-18.57.22.png 864w\" sizes=\"auto, (max-width: 484px) 100vw, 484px\" \/><\/li>\n<li>Copy all of the data on the right hand side and paste in it into the top box here; <a class=\"link link--blue fontWeight-4\"href=\"https:\/\/konklone.io\/json\/\">https:\/\/konklone.io\/json\/<\/a> (<em>We need this step as GraphQL is designed for hierarchical data and this tool will convert your JSON output to .CSV to present the data in a more user friendly format).<\/em><\/li>\n<li>Finally, you will see the option to download all the data into CSV format.<\/li>\n<\/ol>\n<h3 class=\"pageWrap pageWrap--s marginTop-l marginBottom-m c-black lineHeight-xl fontSize-xl fontWeight-5\">Things to know<\/h3>\n<p class=\"pageWrap pageWrap--s marginBottom-m paddingBottom-s c-slate lineHeight-l fontSize-l fontWeight-3 breakPointM-fontSize-xl breakPointM-lineHeight-xl\">Our backend naming conventions for user roles are slightly different from what you see when you look at the <a class=\"link link--blue fontWeight-4\"href=\"https:\/\/marvelapp.com\/company\/people\/members\">people section<\/a> in Marvel, for clarification, the table below matches the roles up:<\/p>\n<ul class=\"pageWrap pageWrap--s list list--unordered marginBottom-l lineHeight-l fontSize-l fontWeight-3 breakPointM-fontSize-xl breakPointM-lineHeight-xl\">\n<li>Member (can edit) = Editor<\/li>\n<li>Member (View Only) = INTERNAL_REVIEWER<\/li>\n<li>Contributor (Can Edit) = EXTERNAL_EDITOR<\/li>\n<li>Contributor (View Only) = EXTERNAL_REVIEWER<\/li>\n<li>Admin = Admin<\/li>\n<li>Owner = Owner<\/li>\n<\/ul>\n<p class=\"pageWrap pageWrap--s marginBottom-m paddingBottom-s c-slate lineHeight-l fontSize-l fontWeight-3 breakPointM-fontSize-xl breakPointM-lineHeight-xl\">If this post was helpful and you'd like to learn about more the queries you can use with the Marvel API, let us know!<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Learn how to manage your design team by extracting useful data and streamline your workflow with Marvel&#8217;s API<\/p>\n","protected":false},"author":236,"featured_media":20720,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[453],"tags":[],"class_list":["post-20714","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-integrations-api"],"acf":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v15.5 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<meta name=\"description\" content=\"Make managing large design teams easy by learning how to run basic API queries in Marvel to extract user lists, user roles, login dates etc.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/marvelapp.com\/blog\/easy-api-hacks-for-managing-large-design-teams-in-marvel-workspaces\/\" \/>\n<meta property=\"og:locale\" content=\"en_GB\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"API Hacks to Help You Manage Your Design Team in Marvel\" \/>\n<meta property=\"og:description\" content=\"Make managing large design teams easy by learning how to run basic API queries in Marvel to extract user lists, user roles, login dates etc.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/marvelapp.com\/blog\/easy-api-hacks-for-managing-large-design-teams-in-marvel-workspaces\/\" \/>\n<meta property=\"og:site_name\" content=\"Marvel Blog\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/marvelapp\" \/>\n<meta property=\"article:published_time\" content=\"2020-10-02T12:30:18+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2020-10-02T14:50:11+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/marvelapp.com\/wp-content\/uploads\/2020\/09\/Blog-pink.png\" \/>\n\t<meta property=\"og:image:width\" content=\"720\" \/>\n\t<meta property=\"og:image:height\" content=\"414\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@marvelapp\" \/>\n<meta name=\"twitter:site\" content=\"@marvelapp\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\">\n\t<meta name=\"twitter:data1\" content=\"2 minutes\">\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https:\/\/marvelapp.com\/blog\/#organization\",\"name\":\"Marvel\",\"url\":\"https:\/\/marvelapp.com\/blog\/\",\"sameAs\":[\"https:\/\/www.facebook.com\/marvelapp\",\"https:\/\/www.instagram.com\/marvelapp\/\",\"https:\/\/www.linkedin.com\/company\/marvel-app\/\",\"https:\/\/twitter.com\/marvelapp\"],\"logo\":{\"@type\":\"ImageObject\",\"@id\":\"https:\/\/marvelapp.com\/blog\/#logo\",\"inLanguage\":\"en-GB\",\"url\":\"https:\/\/marvelapp.com\/wp-content\/uploads\/2018\/06\/Logo-Light.png\",\"width\":1605,\"height\":1130,\"caption\":\"Marvel\"},\"image\":{\"@id\":\"https:\/\/marvelapp.com\/blog\/#logo\"}},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/marvelapp.com\/blog\/#website\",\"url\":\"https:\/\/marvelapp.com\/blog\/\",\"name\":\"Marvel Blog\",\"description\":\"Ideas and words on user experience, design, collaboration and more\",\"publisher\":{\"@id\":\"https:\/\/marvelapp.com\/blog\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":\"https:\/\/marvelapp.com\/blog\/?s={search_term_string}\",\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-GB\"},{\"@type\":\"ImageObject\",\"@id\":\"https:\/\/marvelapp.com\/blog\/easy-api-hacks-for-managing-large-design-teams-in-marvel-workspaces\/#primaryimage\",\"inLanguage\":\"en-GB\",\"url\":\"https:\/\/marvelapp.com\/wp-content\/uploads\/2020\/09\/Blog-pink.png\",\"width\":720,\"height\":414,\"caption\":\"Marvel developers\"},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/marvelapp.com\/blog\/easy-api-hacks-for-managing-large-design-teams-in-marvel-workspaces\/#webpage\",\"url\":\"https:\/\/marvelapp.com\/blog\/easy-api-hacks-for-managing-large-design-teams-in-marvel-workspaces\/\",\"name\":\"API Hacks to Help You Manage Your Design Team in Marvel\",\"isPartOf\":{\"@id\":\"https:\/\/marvelapp.com\/blog\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/marvelapp.com\/blog\/easy-api-hacks-for-managing-large-design-teams-in-marvel-workspaces\/#primaryimage\"},\"datePublished\":\"2020-10-02T12:30:18+00:00\",\"dateModified\":\"2020-10-02T14:50:11+00:00\",\"description\":\"Make managing large design teams easy by learning how to run basic API queries in Marvel to extract user lists, user roles, login dates etc.\",\"inLanguage\":\"en-GB\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/marvelapp.com\/blog\/easy-api-hacks-for-managing-large-design-teams-in-marvel-workspaces\/\"]}]},{\"@type\":\"Article\",\"@id\":\"https:\/\/marvelapp.com\/blog\/easy-api-hacks-for-managing-large-design-teams-in-marvel-workspaces\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/marvelapp.com\/blog\/easy-api-hacks-for-managing-large-design-teams-in-marvel-workspaces\/#webpage\"},\"author\":{\"@id\":\"https:\/\/marvelapp.com\/blog\/#\/schema\/person\/01b90131740157c661c719f0733ebdd7\"},\"headline\":\"Easy API Hacks for Managing Large Design Teams in Marvel\",\"datePublished\":\"2020-10-02T12:30:18+00:00\",\"dateModified\":\"2020-10-02T14:50:11+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/marvelapp.com\/blog\/easy-api-hacks-for-managing-large-design-teams-in-marvel-workspaces\/#webpage\"},\"commentCount\":0,\"publisher\":{\"@id\":\"https:\/\/marvelapp.com\/blog\/#organization\"},\"image\":{\"@id\":\"https:\/\/marvelapp.com\/blog\/easy-api-hacks-for-managing-large-design-teams-in-marvel-workspaces\/#primaryimage\"},\"articleSection\":\"Integrations &amp; API\",\"inLanguage\":\"en-GB\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/marvelapp.com\/blog\/easy-api-hacks-for-managing-large-design-teams-in-marvel-workspaces\/#respond\"]}]},{\"@type\":\"Person\",\"@id\":\"https:\/\/marvelapp.com\/blog\/#\/schema\/person\/01b90131740157c661c719f0733ebdd7\",\"name\":\"Diana Gray\",\"image\":{\"@type\":\"ImageObject\",\"@id\":\"https:\/\/marvelapp.com\/blog\/#personlogo\",\"inLanguage\":\"en-GB\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/ae74e8cd3d40b5d7a5190327b3f1468c1e9b1e5d57364323fa75a8b822ce0ef4?s=96&d=mm&r=g\",\"caption\":\"Diana Gray\"},\"description\":\"Hello I'm Diana and I head up our Customer Experience (CX) team. When not CX'ing, I love cooking on wood fires, smashing tennis balls and all fun outdoor activities.\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","_links":{"self":[{"href":"https:\/\/marvelapp.com\/blog\/wp-json\/wp\/v2\/posts\/20714","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/marvelapp.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/marvelapp.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/marvelapp.com\/blog\/wp-json\/wp\/v2\/users\/236"}],"replies":[{"embeddable":true,"href":"https:\/\/marvelapp.com\/blog\/wp-json\/wp\/v2\/comments?post=20714"}],"version-history":[{"count":0,"href":"https:\/\/marvelapp.com\/blog\/wp-json\/wp\/v2\/posts\/20714\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/marvelapp.com\/blog\/wp-json\/wp\/v2\/media\/20720"}],"wp:attachment":[{"href":"https:\/\/marvelapp.com\/blog\/wp-json\/wp\/v2\/media?parent=20714"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/marvelapp.com\/blog\/wp-json\/wp\/v2\/categories?post=20714"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/marvelapp.com\/blog\/wp-json\/wp\/v2\/tags?post=20714"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}