Adds or updates workspace user shares on a Vault project. This endpoint uses an additive/partial-update model: users in the request are added or have their access level updated; users not in the request are left unchanged. The project owner cannot be included in the request.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Harvey","colors":{"primary":"#000000","light":"#FFFFFF","dark":"#000000"},"logo":{"light":"https://mintcdn.com/counselai/MseNlCOSIs-6XLeD/logo/Harvey_Logo_Ink.svg?fit=max\u0026auto=format\u0026n=MseNlCOSIs-6XLeD\u0026q=85\u0026s=749bc9fa610e1b9ba2b7ffce7dd5f04a","dark":"https://mintcdn.com/counselai/MseNlCOSIs-6XLeD/logo/Harvey_Logo_Ivory.svg?fit=max\u0026auto=format\u0026n=MseNlCOSIs-6XLeD\u0026q=85\u0026s=d8d9762153d411d19bcd8a8e17d4d5d3"},"favicon":"https://mintcdn.com/counselai/MseNlCOSIs-6XLeD/Harvey_Glyph.svg?fit=max\u0026auto=format\u0026n=MseNlCOSIs-6XLeD\u0026q=85\u0026s=0b2b40a43d7c86d305d6d3fc2501444c","api":{"playground":{"display":"simple"}},"navbar":{"links":[{"href":"mailto:support@harvey.ai","label":"Contact Support"}],"primary":{"type":"button","label":"app.harvey.ai","href":"https://app.harvey.ai"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/harvey-ai","twitter":"https://x.com/harvey_ai"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"counselai","hasAudioNarration":false,"actualSubdomain":"counselai","customDomains":["developers.harvey.ai"],"gitSource":{"type":"github","owner":"harveyai","repo":"public-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae518c061b5d761a7858447","collectionId":"e9276e64-02a5-431d-b17d-09a8c91bb256","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae518c061b5d761a7858447"},"feedback":{"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae518c061b5d761a7858447","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"API Reference","count":37},{"language":"default","tag":"Vault","count":32},{"language":"default","tag":"Guides","count":11},{"language":"default","tag":"Endpoint Overview","count":8},{"language":"default","tag":"Client Matters","count":7},{"language":"default","tag":"Intake","count":6},{"language":"default","tag":"Getting Started","count":4},{"language":"default","tag":"Audit Logs","count":4},{"language":"default","tag":"History Export","count":4},{"language":"default","tag":"Delete","count":3}],"searchSettings":{"showContentSnippets":true,"isFiltersEnabled":false}},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"privacy":{"consentBanner":{"enabled":false}},"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/vault/update-project-users","slug":"/api-reference/vault/update-project-users","pageMetadata":{"title":"Update Project Users","description":"Adds or updates workspace user shares on a Vault project. This endpoint uses an additive/partial-update model: users in the request are added or have their access level updated; users not in the request are left unchanged. The project owner cannot be included in the request.\n\nRequires vault sharing to be enabled.","deprecated":null,"version":null,"openapi":"/vault_api.json post /api/v1/vault/projects/{project_id}/users","href":"/api-reference/vault/update-project-users","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Adds or updates workspace user shares on a Vault project. This endpoint uses an additive/partial-update model: users in the request are added or have their access level updated; users not in the request are left unchanged. The project owner cannot be included in the request.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Requires vault sharing to be enabled.\"\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,..._provideComponents(),...props.components},{Heading}=_components;if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`3`,id:`permissions`,children:`Permissions`}),`\n`,_jsxs(_components.p,{children:[`Requires `,_jsx(_components.code,{children:`Vault API`}),` and `,_jsx(_components.code,{children:`Vault sharing`}),` permissions.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Update Project Users","description":"Adds or updates workspace user shares on a Vault project. This endpoint uses an additive/partial-update model: users in the request are added or have their access level updated; users not in the request are left unchanged. The project owner cannot be included in the request.\n\nRequires vault sharing to be enabled.","deprecated":null,"version":null,"openapi":"/vault_api.json post /api/v1/vault/projects/{project_id}/users","href":"/api-reference/vault/update-project-users","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Permissions","slug":"permissions","depth":3,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"x-mint":{"content":"### Permissions\nRequires `Vault API` and `Vault sharing` permissions."},"tags":["Vault"],"summary":"Update Project Users","description":"Adds or updates workspace user shares on a Vault project. This endpoint uses an additive/partial-update model: users in the request are added or have their access level updated; users not in the request are left unchanged. The project owner cannot be included in the request.\n\nRequires vault sharing to be enabled.","operationId":"updateProjectUsers","parameters":["5018a5b5-8d29-4458-be96-2f064d59175b"],"requestBody":"737176a2-6cd1-4ca3-b75a-ec44d42663a7","responses":{"200":"00d5947b-3d2a-49d1-a1b3-b742d84c1a7e","400":"07a3c9a6-9668-4272-a546-7bb0f105d7e7","401":"a45f061b-9311-4068-bd1b-30ac9bf494fc","403":"d5591e09-cbc4-40e6-8e22-acfdb2ae5565","404":"6a79f79e-9843-4cd7-904c-89089f6c0b7f","429":"9e986390-a870-482d-a11a-fb76e0c0acf3","500":"91f8df0d-69ea-41e0-85bb-1ff2846004ef"},"security":["5891c80f-45b1-4297-9ec0-5f69ce8e402c"],"method":"post","type":"path","servers":["90f64933-3153-44fc-b1af-99ad0618b3dc"],"path":"/api/v1/vault/projects/{project_id}/users","baseUrlOptions":["https://api.harvey.ai"],"title":"Update Project Users","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"5018a5b5-8d29-4458-be96-2f064d59175b":{"name":"project_id","in":"path","required":true,"description":"The unique identifier of the Vault project","schema":{"type":"string","format":"uuid","isRequired":true,"description":"The unique identifier of the Vault project","uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"users":{"type":"array","items":{"type":"object","properties":{"email":{"type":"string","format":"email","description":"The email address of the workspace user","isRequired":true,"uniqueKey":"users.items.[INDEX].email","typeLabel":"string\u003cemail>"},"access_level":{"type":"string","enum":["READ","WRITE","MANAGE"],"description":"The desired access level for this user","isRequired":true,"uniqueKey":"users.items.[INDEX].access_level","typeLabel":"enum\u003cstring>"}},"required":["email","access_level"],"uniqueKey":"users.items.[INDEX]","typeLabel":"object"},"description":"The list of users and their desired access levels to add or update. Users omitted from this list are left unchanged.","isRequired":true,"uniqueKey":"users","typeLabel":"object[]"}},"required":["users"],"uniqueKey":"","typeLabel":"object"},"examples":{"updateProjectUsers":{"title":"updateProjectUsers","value":{"users":[{"email":"admin@example.com","access_level":"MANAGE"},{"email":"reviewer@example.com","access_level":"READ"}]}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"00d5947b-3d2a-49d1-a1b3-b742d84c1a7e":{"description":"Project users successfully updated","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["COMPLETED"],"description":"Status of the request","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"data":{"type":"object","properties":{"project_id":{"type":"string","format":"uuid","description":"The project ID","isRequired":true,"uniqueKey":"data.project_id","typeLabel":"string\u003cuuid>"},"added":{"type":"array","description":"Users that were newly granted access","items":{"type":"object","properties":{"email":{"type":"string","format":"email","isRequired":true,"uniqueKey":"data.added.items.[INDEX].email","typeLabel":"string\u003cemail>"},"access_level":{"type":"string","enum":["READ","WRITE","MANAGE"],"isRequired":true,"uniqueKey":"data.added.items.[INDEX].access_level","typeLabel":"enum\u003cstring>"}},"required":["email","access_level"],"uniqueKey":"data.added.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.added","typeLabel":"object[]"},"updated":{"type":"array","description":"Users whose access level was changed","items":{"type":"object","properties":{"email":{"type":"string","format":"email","isRequired":true,"uniqueKey":"data.updated.items.[INDEX].email","typeLabel":"string\u003cemail>"},"access_level":{"type":"string","enum":["READ","WRITE","MANAGE"],"isRequired":true,"uniqueKey":"data.updated.items.[INDEX].access_level","typeLabel":"enum\u003cstring>"},"previous_access_level":{"type":"string","enum":["READ","WRITE","MANAGE"],"isRequired":true,"uniqueKey":"data.updated.items.[INDEX].previous_access_level","typeLabel":"enum\u003cstring>"}},"required":["email","access_level","previous_access_level"],"uniqueKey":"data.updated.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.updated","typeLabel":"object[]"},"failed":{"type":"array","description":"Users whose share update failed, with the reason","items":{"type":"object","properties":{"email":{"type":"string","format":"email","isRequired":true,"uniqueKey":"data.failed.items.[INDEX].email","typeLabel":"string\u003cemail>"},"reason":{"type":"string","description":"Why the share update failed for this user","isRequired":true,"uniqueKey":"data.failed.items.[INDEX].reason","typeLabel":"string"}},"required":["email","reason"],"uniqueKey":"data.failed.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.failed","typeLabel":"object[]"}},"required":["project_id","added","updated","failed"],"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"required":["status","data"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"COMPLETED","data":{"project_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","added":[{"email":"jsmith@example.com","access_level":"READ"}],"updated":[{"email":"jsmith@example.com","access_level":"READ","previous_access_level":"READ"}],"failed":[{"email":"jsmith@example.com","reason":"\u003cstring>"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"07a3c9a6-9668-4272-a546-7bb0f105d7e7":{"description":"Bad request - malformed request body (e.g. missing required fields, invalid JSON)","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"a45f061b-9311-4068-bd1b-30ac9bf494fc":{"description":"Unauthorized - Invalid or missing API token","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"d5591e09-cbc4-40e6-8e22-acfdb2ae5565":{"description":"Forbidden - User lacks required permissions, vault sharing is disabled, or project access is denied","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"6a79f79e-9843-4cd7-904c-89089f6c0b7f":{"description":"Project not found","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"9e986390-a870-482d-a11a-fb76e0c0acf3":{"description":"Rate limit exceeded","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"91f8df0d-69ea-41e0-85bb-1ff2846004ef":{"description":"Internal server error","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"5891c80f-45b1-4297-9ec0-5f69ce8e402c":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"90f64933-3153-44fc-b1af-99ad0618b3dc":{"url":"https://api.harvey.ai","description":"Harvey API server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"vault_api.json"},"subdomain":"counselai","siteName":"Harvey","title":"Update Project Users - Harvey","relatedPagesConfig":{"enabled":true,"limit":3,"mode":"automatic"},"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-30T02:36:53.604Z","originalFileLocation":"api-reference/vault/update-project-users.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Adds or updates workspace user shares on a Vault project. This endpoint uses an additive/partial-update model: users in the request are added or have their access level updated; users not in the request are left unchanged. The project owner cannot be included in the request. Requires vault sharing to be enabled.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Harvey\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/svg+xml\" sizes=\"180x180\" href=\"https://mintcdn.com/counselai/MseNlCOSIs-6XLeD/Harvey_Glyph.svg?fit=max\u0026amp;auto=format\u0026amp;n=MseNlCOSIs-6XLeD\u0026amp;q=85\u0026amp;s=0b2b40a43d7c86d305d6d3fc2501444c\">\u003clink data-mint-head rel=\"icon\" type=\"image/svg+xml\" sizes=\"32x32\" href=\"https://mintcdn.com/counselai/MseNlCOSIs-6XLeD/Harvey_Glyph.svg?fit=max\u0026amp;auto=format\u0026amp;n=MseNlCOSIs-6XLeD\u0026amp;q=85\u0026amp;s=0b2b40a43d7c86d305d6d3fc2501444c\">\u003clink data-mint-head rel=\"icon\" type=\"image/svg+xml\" sizes=\"16x16\" href=\"https://mintcdn.com/counselai/MseNlCOSIs-6XLeD/Harvey_Glyph.svg?fit=max\u0026amp;auto=format\u0026amp;n=MseNlCOSIs-6XLeD\u0026amp;q=85\u0026amp;s=0b2b40a43d7c86d305d6d3fc2501444c\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/svg+xml\" href=\"https://mintcdn.com/counselai/MseNlCOSIs-6XLeD/Harvey_Glyph.svg?fit=max\u0026amp;auto=format\u0026amp;n=MseNlCOSIs-6XLeD\u0026amp;q=85\u0026amp;s=0b2b40a43d7c86d305d6d3fc2501444c\">\u003cmeta data-mint-head property=\"og:title\" content=\"Update Project Users - Harvey\">\u003cmeta data-mint-head property=\"og:description\" content=\"Adds or updates workspace user shares on a Vault project. This endpoint uses an additive/partial-update model: users in the request are added or have their access level updated; users not in the request are left unchanged. The project owner cannot be included in the request. Requires vault sharing to be enabled.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Harvey\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.harvey.ai/api-reference/vault/update-project-users\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://counselai.mintlify.app/_mintlify/api/og/v2?division=Vault\u0026amp;title=Update+Project+Users\u0026amp;description=Adds+or+updates+workspace+user+shares+on+a+Vault+project.+This+endpoint+uses+an+additive%2Fpartial-update+model%3A+users+in+the+request+are+added+or+have+their+acce\u0026amp;theme=ca09a866a969d63910536c2f\u0026amp;signature=f2b83623308c96e42e741d9a399901c77e59cd3cdca01a3e619d88a086a378dc\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Update Project Users - Harvey\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Adds or updates workspace user shares on a Vault project. This endpoint uses an additive/partial-update model: users in the request are added or have their access level updated; users not in the request are left unchanged. The project owner cannot be included in the request. Requires vault sharing to be enabled.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://counselai.mintlify.app/_mintlify/api/og/v2?division=Vault\u0026amp;title=Update+Project+Users\u0026amp;description=Adds+or+updates+workspace+user+shares+on+a+Vault+project.+This+endpoint+uses+an+additive%2Fpartial-update+model%3A+users+in+the+request+are+added+or+have+their+acce\u0026amp;theme=ca09a866a969d63910536c2f\u0026amp;signature=f2b83623308c96e42e741d9a399901c77e59cd3cdca01a3e619d88a086a378dc\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"https://mintlify.s3.us-west-1.amazonaws.com/counselai/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Harvey\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.harvey.ai/api-reference/vault/update-project-users\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/vault/update-project-users.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.harvey.ai/#organization\",\"name\":\"Harvey\",\"url\":\"https://developers.harvey.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/counselai/MseNlCOSIs-6XLeD/logo/Harvey_Logo_Ink.svg?fit=max\u0026auto=format\u0026n=MseNlCOSIs-6XLeD\u0026q=85\u0026s=749bc9fa610e1b9ba2b7ffce7dd5f04a\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.harvey.ai#website\",\"name\":\"Harvey\",\"url\":\"https://developers.harvey.ai\",\"publisher\":{\"@id\":\"https://developers.harvey.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.harvey.ai/api-reference/vault/update-project-users#webpage\",\"url\":\"https://developers.harvey.ai/api-reference/vault/update-project-users\",\"name\":\"Update Project Users\",\"description\":\"Adds or updates workspace user shares on a Vault project. This endpoint uses an additive/partial-update model: users in the request are added or have their access level updated; users not in the request are left unchanged. The project owner cannot be included in the request. Requires vault sharing to be enabled.\",\"dateModified\":\"2026-10-30T02:36:53.604Z\",\"isPartOf\":{\"@id\":\"https://developers.harvey.ai#website\"},\"breadcrumb\":{\"@id\":\"https://developers.harvey.ai/api-reference/vault/update-project-users#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.harvey.ai/api-reference/vault/update-project-users#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Vault\",\"item\":\"https://developers.harvey.ai/api-reference/vault/list-vault-projects-and-knowledge-bases\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Vault\",\"item\":\"https://developers.harvey.ai/api-reference/vault/list-vault-projects-and-knowledge-bases\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Update Project Users\",\"item\":\"https://developers.harvey.ai/api-reference/vault/update-project-users\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.harvey.ai/api-reference/vault/update-project-users#apireference\",\"headline\":\"Update Project Users\",\"name\":\"Update Project Users\",\"description\":\"Adds or updates workspace user shares on a Vault project. This endpoint uses an additive/partial-update model: users in the request are added or have their access level updated; users not in the request are left unchanged. The project owner cannot be included in the request. Requires vault sharing to be enabled.\",\"url\":\"https://developers.harvey.ai/api-reference/vault/update-project-users\",\"mainEntityOfPage\":{\"@id\":\"https://developers.harvey.ai/api-reference/vault/update-project-users#webpage\"},\"dateModified\":\"2026-10-30T02:36:53.604Z\",\"publisher\":{\"@id\":\"https://developers.harvey.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.harvey.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Harvey\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Harvey","nav":{"global":null,"tabs":[{"tab":"API Reference","groups":[{"group":"Getting Started","pages":[{"title":"Authentication","href":"/api-reference/authentication"},{"title":"Rate Limits","href":"/api-reference/ratelimits"}]},{"group":"Assistant","pages":[{"group":"Completion","pages":[{"title":"Completion","deprecated":null,"version":null,"openapi":"/v2_completion_api.json post /api/v2/completion","href":"/api-reference/completion/completion"}]}]},{"group":"Vault","pages":[{"group":"Vault","pages":[{"title":"List Vault Projects and Knowledge Bases","deprecated":null,"version":null,"openapi":"/vault_api.json get /api/v1/vault/workspace/projects","href":"/api-reference/vault/list-vault-projects-and-knowledge-bases"},{"title":"List Vaults in the Recycle Bin","deprecated":null,"version":null,"openapi":"/vault_api.json get /api/v1/vault/workspace/recycle_bin","href":"/api-reference/vault/list-vaults-in-the-recycle-bin"},{"title":"Get Vault Project Metadata","deprecated":null,"version":null,"openapi":"/vault_api.json get /api/v1/vault/get_metadata/{project_id}","href":"/api-reference/vault/get-vault-project-metadata"},{"title":"Get Review Table Metadata","deprecated":null,"version":null,"openapi":"/vault_api.json get /api/v1/vault/review_table/{review_table_id}","href":"/api-reference/vault/get-review-table-metadata"},{"title":"Get File Details","deprecated":null,"version":null,"openapi":"/vault_api.json get /api/v1/vault/get_files","href":"/api-reference/vault/get-file-details"},{"title":"Get Review Table Row Details","deprecated":null,"version":null,"openapi":"/vault_api.json get /api/v1/vault/get_row/{review_table_id}/{file_id}","href":"/api-reference/vault/get-review-table-row-details"},{"title":"Add Row to Review Table","deprecated":null,"version":null,"openapi":"/vault_api.json post /api/v1/vault/add_row/{review_table_id}","href":"/api-reference/vault/add-row-to-review-table"},{"title":"List Files in a Vault Project","deprecated":null,"version":null,"openapi":"/vault_api.json get /api/v1/vault/projects/{project_id}/files","href":"/api-reference/vault/list-files-in-a-vault-project"},{"title":"List Project Users","description":"Lists all workspace users with current active access to a specified Vault project, along with their access levels. Includes effective user access (including inherited access), and the project owner is always included with `MANAGE` access.\n\nRequires vault sharing to be enabled.","deprecated":null,"version":null,"openapi":"/vault_api.json get /api/v1/vault/projects/{project_id}/users","href":"/api-reference/vault/list-project-users"},{"title":"Update Project Users","deprecated":null,"version":null,"openapi":"/vault_api.json post /api/v1/vault/projects/{project_id}/users","href":"/api-reference/vault/update-project-users"},{"title":"Remove Project Users","description":"Removes direct workspace user shares for specified users (identified by email address) from a Vault project. Only direct `WORKSPACE_USER` shares are removed; inherited access via workspace, group, or space shares is not affected. Per-user validation failures (e.g. unknown email, inactive user, project owner, self-removal) are returned in the `failed` list rather than rejecting the entire request.\n\nRequires vault sharing to be enabled.","deprecated":null,"version":null,"openapi":"/vault_api.json delete /api/v1/vault/projects/{project_id}/users","href":"/api-reference/vault/remove-project-users"},{"title":"Create a new Vault project","deprecated":null,"version":null,"openapi":"/vault_api.json post /api/v1/vault/create_project","href":"/api-reference/vault/create-a-new-vault-project"},{"title":"Upload Files to Project","deprecated":null,"version":null,"openapi":"/vault_api.json post /api/v1/vault/upload_files/{project_id}","href":"/api-reference/vault/upload-files-to-project"},{"title":"Semantic search over a vault project","deprecated":null,"version":null,"openapi":"/vault_api.json post /api/v1/vault/semantic_search","href":"/api-reference/vault/semantic-search-over-a-vault-project"},{"title":"Delete a file from a Vault project","deprecated":null,"version":null,"openapi":"/vault_api.json delete /api/v1/vault/delete_file/{file_id}","href":"/api-reference/vault/delete-a-file-from-a-vault-project"},{"title":"Delete an entire vault project and all its contents","deprecated":null,"version":null,"openapi":"/vault_api.json delete /api/v1/vault/delete_project/{project_id}","href":"/api-reference/vault/delete-an-entire-vault-project-and-all-its-contents"}]}]},{"group":"History Export","pages":[{"group":"Usage","pages":[{"title":"Get Usage History","deprecated":null,"version":null,"openapi":"/history_export_api.json get /api/v1/history/usage","href":"/history-export/usage/get-usage-history"},{"title":"Get Usage History (v2)","deprecated":null,"version":null,"openapi":"/history_export_api.json get /api/v2/history/usage","href":"/history-export/usage/get-usage-history-v2"}]},{"group":"Queries","pages":[{"title":"Get Query History","deprecated":null,"version":null,"openapi":"/history_export_api.json get /api/v1/history/query","href":"/history-export/queries/get-query-history"},{"title":"Get Query History (v2)","deprecated":null,"version":null,"openapi":"/history_export_api.json get /api/v2/history/query","href":"/history-export/queries/get-query-history-v2"}]}]},{"group":"Audit Logs","pages":[{"group":"Search","pages":[{"title":"Search Audit Logs","deprecated":null,"version":null,"openapi":"/audit_logs_api.json get /api/v1/logs/audit/search/","href":"/api-reference/search/search-audit-logs"}]},{"group":"Retrieve","pages":[{"title":"Retrieve Earliest Audit Log","deprecated":null,"version":null,"openapi":"/audit_logs_api.json get /api/v1/logs/audit/earliest","href":"/api-reference/retrieve/retrieve-earliest-audit-log"},{"title":"Retrieve Latest Audit Log","deprecated":null,"version":null,"openapi":"/audit_logs_api.json get /api/v1/logs/audit/latest","href":"/api-reference/retrieve/retrieve-latest-audit-log"}]},{"group":"Query","pages":[{"title":"Query Audit Logs","deprecated":null,"version":null,"openapi":"/audit_logs_api.json get /api/v1/logs/audit","href":"/api-reference/query/query-audit-logs"}]}]},{"group":"Client Matters","pages":[{"group":"Retrieve","pages":[{"title":"Get Client Matters","deprecated":null,"version":null,"openapi":"/client_matters_api.json get /api/v1/client_matters","href":"/api-reference/retrieve/get-client-matters"}]},{"group":"Add","pages":[{"title":"Add Client Matters","deprecated":true,"version":null,"openapi":"/client_matters_api.json post /api/v1/client_matters","href":"/api-reference/add/add-client-matters"}]},{"group":"Delete","pages":[{"title":"Delete Client Matters","deprecated":null,"version":null,"openapi":"/client_matters_api.json delete /api/v1/client_matters","href":"/api-reference/delete/delete-client-matters"},{"title":"Delete Clients","deprecated":null,"version":null,"openapi":"/client_matters_api.json delete /api/v2/clients","href":"/api-reference/delete/delete-clients"},{"title":"Delete Matters","deprecated":null,"version":null,"openapi":"/client_matters_api.json delete /api/v2/matters","href":"/api-reference/delete/delete-matters"}]},{"group":"Upsert","pages":[{"title":"Upsert Clients","deprecated":null,"version":null,"openapi":"/client_matters_api.json post /api/v2/clients","href":"/api-reference/upsert/upsert-clients"},{"title":"Upsert Matters","deprecated":null,"version":null,"openapi":"/client_matters_api.json post /api/v2/matters","href":"/api-reference/upsert/upsert-matters"}]}]},{"group":"Intake","pages":[{"group":"Intake","pages":[{"title":"Create Request","deprecated":null,"version":null,"openapi":"/intake_api.json post /api/v1/intake/requests","href":"/api-reference/intake/create-request"},{"title":"Get Request","deprecated":null,"version":null,"openapi":"/intake_api.json get /api/v1/intake/requests/{request_id}","href":"/api-reference/intake/get-request"},{"title":"Update Request","deprecated":null,"version":null,"openapi":"/intake_api.json patch /api/v1/intake/requests/{request_id}","href":"/api-reference/intake/update-request"}]}]}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/introduction"}]}]},"basePath":"","title":"Update Project Users - Harvey","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}