New! Use the 1Password Credential Broker to give CI/CD and other machine workflows short-lived access to secrets, without managing service account tokens.
using RestSharp;
var options = new RestClientOptions("https://app.trelica.com/api/people/v1/{id}");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n \"jobTitle\": \"Senior Customer Success Manager\",\n \"costCenter\": \"Customer Success\",\n \"lineManagerEmail\": \"jane.smith@example.com\"\n}", false);
var response = await client.PatchAsync(request);
Console.WriteLine("{0}", response.Content);
{
"type": "about:blank",
"title": "One or more validation errors occurred.",
"status": 400,
"detail": "The request body failed validation. See errors for the offending fields.",
"errors": {
"email": [
"The email field is required."
]
},
"traceId": "00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01"
}
{
"type": "about:blank",
"title": "Not found.",
"status": 404,
"detail": "The requested resource does not exist or you do not have access to it.",
"traceId": "00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01"
}
{
"type": "about:blank",
"title": "Conflict.",
"status": 409,
"detail": "The request conflicts with the current state (for example, the resource already exists).",
"traceId": "00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01"
}
People
Update selected details of a person
Partially updates a person: only the fields present in the request body are changed.
Omitting a field leaves it untouched, whereas sending an explicit null clears it.
At least one field must be supplied.
Required scope:People.Write (Write access to people and teams)
using RestSharp;
var options = new RestClientOptions("https://app.trelica.com/api/people/v1/{id}");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n \"jobTitle\": \"Senior Customer Success Manager\",\n \"costCenter\": \"Customer Success\",\n \"lineManagerEmail\": \"jane.smith@example.com\"\n}", false);
var response = await client.PatchAsync(request);
Console.WriteLine("{0}", response.Content);
{
"type": "about:blank",
"title": "One or more validation errors occurred.",
"status": 400,
"detail": "The request body failed validation. See errors for the offending fields.",
"errors": {
"email": [
"The email field is required."
]
},
"traceId": "00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01"
}
{
"type": "about:blank",
"title": "Not found.",
"status": 404,
"detail": "The requested resource does not exist or you do not have access to it.",
"traceId": "00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01"
}
{
"type": "about:blank",
"title": "Conflict.",
"status": 409,
"detail": "The request conflicts with the current state (for example, the resource already exists).",
"traceId": "00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01"
}
The person's login name on the local domain. Used in conjunction with the SaaS Manager Browser Extension Helper to determine the identity of the logged in user.
The person's line manager. On input, set it by the line manager's id or email (other fields are ignored); alternatively use lineManagerId or lineManagerEmail. These three forms are mutually exclusive.
The teams the person belongs to. When creating or replacing, supply teams by ID, or by name (a team is created if the name is not found); mutually exclusive with teamIds.
The timestamp for when the person record was last modified
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"1Password Developer","description":"Developer docs for 1Password. Keep secrets out of your code with the CLI, SSH agent, Environments, service accounts, SDKs, and tools for AI agents.","colors":{"primary":"#145FE4","light":"#b8d7ff","dark":"#303136"},"logo":{"light":"https://mintcdn.com/ab-634991b8/tWWm5UFlpZQ9nof8/images/logo-1password-dark.svg?fit=max\u0026auto=format\u0026n=tWWm5UFlpZQ9nof8\u0026q=85\u0026s=2c2acc6dc5f817defe70ebdef67c9b11","dark":"https://mintcdn.com/ab-634991b8/tWWm5UFlpZQ9nof8/images/logo-1password-light.svg?fit=max\u0026auto=format\u0026n=tWWm5UFlpZQ9nof8\u0026q=85\u0026s=0dae06f9dd5b1f569de5cb9fba337405"},"favicon":"https://mintcdn.com/ab-634991b8/s4Wjy03jBRs6hcHb/favicon.ico?fit=max\u0026auto=format\u0026n=s4Wjy03jBRs6hcHb\u0026q=85\u0026s=dd03b4bc604b342373aa4d3e21be4310","api":{"playground":{"display":"interactive"},"examples":{"languages":["curl","node","python","go","dotnet","java","php","powershell","ruby"]}},"background":{"color":{"light":"#ffffff","dark":"#1a1b1e"}},"navbar":{"links":[{"icon":"github","href":"https://github.com/1Password","label":"GitHub"},{"icon":"slack","href":"https://www.1password.dev/joinslack","label":"Join Slack"}],"primary":{"type":"button","label":"Try free","href":"https://1password.com/pricing/business"}},"footer":{"socials":{"github":"https://github.com/1Password","x":"https://x.com/1PasswordDev","reddit":"https://www.reddit.com/r/1Password","linkedin":"https://www.linkedin.com/company/1password","youtube":"https://www.youtube.com/1PasswordVideos","facebook":"https://www.facebook.com/1Password","instagram":"https://www.instagram.com/1password"},"links":[{"header":"Get started","items":[{"label":"Developer quickstart","href":"/get-started/developer-quickstart"},{"label":"Admin quickstart","href":"/get-started/administrator-quickstart"},{"label":"Partner quickstart","href":"/get-started/partner-quickstart"},{"label":"All setup guides","href":"/get-started"}]},{"header":"Help and resources","items":[{"label":"CLI troubleshooting","href":"/cli/app-integration"},{"label":"SSH troubleshooting","href":"/ssh/agent/troubleshooting"},{"label":"System status","href":"https://status.1password.com"},{"label":"CLI release notes","href":"/cli/release-notes"},{"label":"1Password University","href":"https://www.1password.university/?utm_ref=website-footer"},{"label":"Blog","href":"https://blog.1password.com"}]},{"header":"Community","items":[{"label":"Developer community","href":"/community"},{"label":"Events","href":"https://luma.com/1password"},{"label":"Developer Slack","href":"/joinslack"},{"label":"Newsletter","href":"https://1password.com/developer-newsletter"},{"label":"Code of Conduct","href":"/code-of-conduct"},{"label":"Projects disclaimer","href":"/community/disclaimer"}]},{"header":"Legal","items":[{"label":"Terms of Service","href":"https://1password.com/legal/terms-of-service"},{"label":"Privacy Policy","href":"https://1password.com/legal/privacy"},{"label":"Cookie Policy","href":"https://1password.com/legal/cookies"},{"label":"Accessibility","href":"https://1password.com/legal/accessibility"}]}]},"seo":{"metatags":{"canonical":"https://www.1password.dev","google-site-verification":"YserOhXnJUjFfIZ4K3qgxkVSlQZQdXtIbBiKzZ35Nvs"}},"fonts":{"heading":{"family":"Public Sans"},"body":{"family":"Public Sans"}},"banner":{"content":"**New!** Use the [1Password Credential Broker](https://www.1password.dev/brokered-access) to give CI/CD and other machine workflows short-lived access to secrets, without managing service account tokens.","dismissible":true,"color":{"light":"#145fe4","dark":"#145fe4"}},"errors":{"404":{"redirect":false,"title":"This page can't be found","description":"Our docs have moved to [www.1password.dev](https://www.1password.dev). Try searching for what you need or selecting from the list of tools."}},"contextual":{"options":["copy","view","mcp","cursor","vscode","chatgpt","claude","perplexity"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ab-634991b8","hasAudioNarration":false,"actualSubdomain":"ab-634991b8","customDomains":["www.1password.dev"],"gitSource":{"type":"github","owner":"1password","repo":"1password.dev","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"contextualFeedback":{"allowEmail":false},"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af4cc23835e7d1bb15472d7","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"CLI","count":320},{"language":"default","tag":"SDKs \u0026 APIs","count":120},{"language":"default","tag":"Shell Plugins","count":104},{"language":"default","tag":"Plugins","count":97},{"language":"default","tag":"CI/CD \u0026 infrastructure","count":92},{"language":"default","tag":"SaaS Manager API","count":88},{"language":"default","tag":"API Reference","count":64},{"language":"default","tag":"Reference","count":56},{"language":"default","tag":"SDKs","count":51},{"language":"default","tag":"Events API","count":44}]},"assistantConfig":{"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"deflection":{"enabled":true,"email":"support@1password.com","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"rbac-expansion","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":"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":"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":"editor-metadata","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},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"styles.css","content":":root{--op-secure-blue: #104ebb;--op-secure-blue-hover: #0e46a8;--op-iron-ore: #303136;--op-page-bg-dark: #1a1b1e;--op-white: #ffffff;--op-icy-blue: #dcebff;--op-cornflower: #b8d7ff;--op-biscuit: #fbf8f4;--op-sunbeam: #fad785;--op-tangerine: #ff8f78;--op-enable-mint: #76e0bd;--op-gold: #cbb88e;--op-status-success: #10622f;--op-status-warning: #8a4006;--op-status-error: #a71c1c;--op-status-info: var(--op-secure-blue);--op-border-ui: #949494;--op-border-ui-dark: #6b7280;--op-border-subtle: rgb(3 7 18 / 0.12);--op-border-subtle-dark: rgb(251 248 244 / 0.25);--op-border-footer-dark: rgb(251 248 244 / 0.37);--op-border-navbar-light: rgb(107 114 128 / 0.05);--op-border-navbar-dark: rgb(209 213 219 / 0.06);--op-border-card-light: rgb(3 7 18 / 0.1);--op-border-card-dark: rgb(255 255 255 / 0.1);--op-border-hero-light: rgb(255 255 255 / 0.08);--op-border-hero-dark: rgb(255 255 255 / 0.12);--op-border-badge-light: rgb(16 78 187 / 0.2);--op-border-badge-dark: rgb(184 215 255 / 0.25);--op-border-workflow-dark: rgb(251 248 244 / 0.2);--op-text-body: var(--op-iron-ore);--op-text-body-dark: var(--op-biscuit);--op-surface-card-light: var(--op-white);--op-surface-card-dark: #25262a;--op-surface-callout-light: rgb(220 235 255 / 0.45);--op-surface-callout-dark: rgb(184 215 255 / 0.08)}#content.prose{--tw-prose-body: var(--op-text-body)}.dark #content.prose{--tw-prose-body: var(--op-text-body-dark)}#content.prose :where(p,span[data-as=\"p\"],li,td,th,blockquote,figcaption):not(a.op-cta-primary span){color:var(--op-text-body)}.dark #content.prose :where(p,span[data-as=\"p\"],li,td,th,blockquote,figcaption):not(a.op-cta-primary span){color:var(--op-text-body-dark)}#content :is(p,li,div,span,button,h1,h2,h3,h4,h5,h6).text-gray-600,#content :is(p,li,div,span,button,h1,h2,h3,h4,h5,h6).text-gray-700,#content :is(p,li,span,button,h1,h2,h3,h4,h5,h6).text-gray-500{color:var(--op-text-body)}.dark #content :is(p,li,div,span,button,h1,h2,h3,h4,h5,h6).dark\\:text-gray-400,.dark #content :is(p,li,div,span,button,h1,h2,h3,h4,h5,h6).dark\\:text-gray-300,.dark #content :is(p,li,span,button,h1,h2,h3,h4,h5,h6).dark\\:text-gray-500{color:var(--op-text-body-dark)}#content .text-gray-400:not(:is(p,li,span,button,h1,h2,h3,h4,h5,h6)){color:var(--op-border-ui)}.dark #content .text-gray-400:not(:is(p,li,span,button,h1,h2,h3,h4,h5,h6)),.dark #content .text-gray-500:not(:is(p,li,span,button,h1,h2,h3,h4,h5,h6)){color:var(--op-border-ui-dark)}.dark .card-group{--background-dark: 37 38 42}.dark .card-group .card{background-color:rgb(var(--background-dark))!important}.card-group .card{border-color:var(--op-border-card-light)!important}.dark .card-group .card{border-color:var(--op-border-card-dark)!important}.op-card-surface{border:1px solid var(--op-border-card-light)}.dark .op-card-surface{border-color:var(--op-border-card-dark)}#content .hover\\:border-gray-300:hover{border-color:var(--op-iron-ore)}.dark #content .hover\\:border-gray-600:hover{border-color:var(--op-biscuit)}.community-card{border:1px solid var(--op-border-card-light);border-radius:0.5rem;background-color:var(--op-surface-card-light)}.dark .community-card{border-color:var(--op-border-card-dark);background-color:var(--op-surface-card-dark)}.community-card .community-card-chevron{color:var(--op-border-ui)}.dark .community-card .community-card-chevron{color:var(--op-cornflower)}a.community-card:hover{border-color:var(--op-secure-blue)}.dark a.community-card:hover{border-color:var(--op-cornflower)}.community-callout{border:1px solid var(--op-border-card-light);border-radius:0.5rem;background-color:var(--op-surface-callout-light)}.dark .community-callout{border-color:var(--op-border-card-dark);background-color:var(--op-surface-callout-dark)}.community-link{color:var(--op-secure-blue);text-decoration:none}.community-link:hover{color:var(--op-secure-blue-hover);text-decoration:underline}.dark .community-link{color:var(--op-cornflower)}.dark .community-link:hover{color:var(--op-white)}:is(#sidebar-content a:not([aria-current=\"page\"]),#table-of-contents,#table-of-contents a,#navbar .nav-tabs-item:not([data-active]),#navbar nav ul>li:not(#topbar-cta-button)>a,#search-bar-entry,#search-bar-entry-mobile,#assistant-entry,#assistant-entry-mobile,[data-component-name=\"theme-toggle\"]){color:var(--op-text-body)}.dark :is(#sidebar-content a:not([aria-current=\"page\"]),#table-of-contents,#table-of-contents a,#navbar .nav-tabs-item:not([data-active]),#navbar nav ul>li:not(#topbar-cta-button)>a,#search-bar-entry,#search-bar-entry-mobile,#assistant-entry,#assistant-entry-mobile,[data-component-name=\"theme-toggle\"]){color:var(--op-text-body-dark)}:is(#search-bar-entry,#search-bar-entry-mobile,#assistant-entry,#assistant-entry-mobile,[data-component-name=\"theme-toggle\"]) svg{color:inherit}#footer a.h-fit svg{background-color:var(--op-biscuit)}#footer a.h-fit:hover svg{background-color:var(--op-white)}.hero-background{background-color:var(--op-iron-ore);background-image:radial-gradient(\n ellipse 75% 100% at 100% 50%,\n rgb(20 95 228 / 0.55) 0%,\n rgb(20 95 228 / 0.2) 40%,\n transparent 70%\n )}.dark .hero-background{background-color:var(--op-page-bg-dark);background-image:radial-gradient(\n ellipse 80% 100% at 100% 50%,\n rgb(20 95 228 / 0.7) 0%,\n rgb(20 95 228 / 0.3) 45%,\n transparent 75%\n )}.hero-section{border-bottom:1px solid var(--op-border-hero-light)}.dark .hero-section{border-bottom-color:var(--op-border-hero-dark)}.hero-cta{background-color:var(--op-secure-blue);color:var(--op-white);box-shadow:0 1px 3px rgb(0 0 0 / 0.25)}.hero-cta svg,.hero-cta svg path{fill:currentColor!important;color:currentColor!important}.hero-cta:hover{background-color:var(--op-secure-blue-hover)}#content.prose a.op-cta-primary,#content a.op-cta-primary{background-color:var(--op-secure-blue);color:var(--op-white)!important;text-decoration:none}#content.prose a.op-cta-primary span[data-as=\"p\"],#content.prose a.op-cta-primary span,#content a.op-cta-primary span[data-as=\"p\"],#content a.op-cta-primary span{color:var(--op-white)!important}#content.prose a.op-cta-primary:hover,#content a.op-cta-primary:hover{background-color:var(--op-secure-blue-hover);color:var(--op-white)!important}#content.prose a.op-cta-primary:hover span[data-as=\"p\"],#content.prose a.op-cta-primary:hover span,#content a.op-cta-primary:hover span[data-as=\"p\"],#content a.op-cta-primary:hover span{color:var(--op-white)!important}#topbar-cta-button a>span.absolute{background-color:var(--op-secure-blue)!important}#topbar-cta-button a:hover>span.absolute{background-color:var(--op-secure-blue-hover)!important}#topbar-cta-button a span.z-10{color:var(--op-white)!important}#topbar-cta-button a svg{color:var(--op-white)!important}.card-group{gap:1rem}#content .card-group img[src*=\"/homepage-icons/brand/\"]{width:32px;height:32px;flex-shrink:0}.homepage-card-title{display:inline-flex;flex-wrap:wrap;align-items:center;gap:0.25rem 0.5rem}.image-button-link img{margin:10px 0}.dark #content a>div>span{color:var(--op-cornflower)!important}.docs-higlight-cards{display:grid;grid-template-columns:repeat(auto-fill, minmax(250px, 1fr));gap:1rem;margin-bottom:1rem}.highlight-card-link{color:var(--op-secure-blue)!important}.highlight-card-link:hover{color:var(--op-secure-blue-hover)!important}.dark .highlight-card-link{color:var(--op-cornflower)!important}.dark .highlight-card-link:hover{color:var(--op-white)!important}.highlight-card-link svg{background-color:var(--op-secure-blue)!important}.dark .highlight-card-link svg{background-color:var(--op-cornflower)!important}.coloredCodeWrapper .code-block>div:nth-child(3){--fade-color-light: transparent !important;--fade-color-dark: transparent !important}.badge{border-radius:0.4rem;color:var(--op-white);font-weight:700;line-height:1;padding:3px 5px}.badge--primary{background-color:var(--op-secure-blue)}.badge--secondary{background-color:var(--op-biscuit);color:var(--op-iron-ore)}.op-status-badge{display:inline-flex;flex-shrink:0;align-items:center;white-space:nowrap;vertical-align:middle;border:1px solid var(--op-border-badge-light);border-radius:0.25rem;background-color:var(--op-icy-blue);color:var(--op-iron-ore);padding:0.125rem 0.625rem;font-size:0.75rem;line-height:1rem;font-weight:600}.dark .op-status-badge{border-color:var(--op-border-badge-dark);background-color:rgb(184 215 255 / 0.12);color:var(--op-icy-blue)}.op-workflow-guide-badge{display:inline-flex;flex-shrink:0;align-items:center;white-space:nowrap;margin-top:0.75rem;border:1px solid transparent;border-radius:0.25rem;background-color:var(--op-biscuit);color:var(--op-iron-ore);padding:0.125rem 0.625rem;font-size:0.75rem;line-height:1rem;font-weight:600}.dark .op-workflow-guide-badge{border-color:var(--op-border-workflow-dark);background-color:rgb(251 248 244 / 0.1);color:var(--op-biscuit)}.op-beta-badge-inline{display:inline-flex;align-items:center;margin-left:0.5rem;vertical-align:middle}.mdx-content a[href^=\"http\"]:not([href*=\"://1password.com/\"],[href$=\"://1password.com\"],[href*=\".1password.com/\"],[href$=\".1password.com\"],[href*=\"://1password.dev/\"],[href$=\"://1password.dev\"],[href*=\".1password.dev/\"],[href$=\".1password.dev\"],[href*=\"://1password.ca/\"],[href$=\"://1password.ca\"],[href*=\".1password.ca/\"],[href$=\".1password.ca\"],[href*=\"://1password.eu/\"],[href$=\"://1password.eu\"],[href*=\".1password.eu/\"],[href$=\".1password.eu\"],[href*=\"://1password.io/\"],[href$=\"://1password.io\"],[href*=\".1password.io/\"],[href$=\".1password.io\"],[href*=\"://1password.university/\"],[href$=\"://1password.university\"],[href*=\".1password.university/\"],[href$=\".1password.university\"],[href*=\"://agilebits.com/\"],[href$=\"://agilebits.com\"],[href*=\".agilebits.com/\"],[href$=\".agilebits.com\"],[href*=\"://b5dev.com/\"],[href$=\"://b5dev.com\"],[href*=\".b5dev.com/\"],[href$=\".b5dev.com\"],[href*=\"://b5local.com/\"],[href$=\"://b5local.com\"],[href*=\".b5local.com/\"],[href$=\".b5local.com\"],[href*=\"://1infra.dev/\"],[href$=\"://1infra.dev\"],[href*=\".1infra.dev/\"],[href$=\".1infra.dev\"],[href*=\"://kolide.com/\"],[href$=\"://kolide.com\"],[href*=\".kolide.com/\"],[href$=\".kolide.com\"],[href*=\"://trelica.app/\"],[href$=\"://trelica.app\"],[href*=\".trelica.app/\"],[href$=\".trelica.app\"],[href*=\"://trelica.eu/\"],[href$=\"://trelica.eu\"],[href*=\".trelica.eu/\"],[href$=\".trelica.eu\"],[href*=\"://trelica.com/\"],[href$=\"://trelica.com\"],[href*=\".trelica.com/\"],[href$=\".trelica.com\"],[href*=\"://1password.community/\"],[href$=\"://1password.community\"],[href*=\".1password.community/\"],[href$=\".1password.community\"],[href*=\"://1pw.ca/\"],[href$=\"://1pw.ca\"],[href*=\".1pw.ca/\"],[href$=\".1pw.ca\"]):not(.card *,.op-card-surface *,.image-button-link,.community-card,.community-card *,pre *,:has(img))::after{content:\"\";display:inline-block;width:1em;height:1em;margin-left:0.25em;vertical-align:-0.125em;background-color:currentColor;-webkit-mask:var(--op-link-icon, url(\"/static/img/icons/external-link.svg\")) no-repeat center / contain;mask:var(--op-link-icon, url(\"/static/img/icons/external-link.svg\")) no-repeat center / contain}.mdx-content a:is([href*=\"://github.com/\"],[href$=\"://github.com\"],[href*=\".github.com/\"],[href$=\".github.com\"],[href*=\"://github.blog/\"],[href$=\"://github.blog\"]){--op-link-icon: url(\"/static/img/logos/github.svg\")}#content>h5,#content>h6{font-weight:700}.dark #content>h5,.dark #content>h6{color:var(--op-white)}.accordion{background-color:var(--op-icy-blue)}.dark .accordion{background-color:var(--op-surface-card-dark)}.accordion .mint-bg-white{padding:1rem}.accordion .mint-bg-white [class*=\"-mx-\"]{margin:0!important;padding:0!important;width:100%!important;--page-padding: 0px}#footer>div>div.flex.flex-col.md\\:flex-row.gap-8.justify-between.min-h-\\[76px\\]>div.flex.flex-col.sm\\:grid.max-md\\:\\!grid-cols-2.gap-8.flex-1>div>div>p{display:none!important}footer#footer.advanced-footer{display:flex!important}footer#footer{align-items:unset;background-color:var(--op-iron-ore);color:var(--op-white)}#footer img.nav-logo.dark\\:hidden{display:none!important}#footer img.nav-logo.dark\\:block{display:block!important}#footer p.font-semibold,#footer a{color:var(--op-white)}#footer>div.flex.w-full.flex-col.gap-12.justify-between.px-8.py-16.md\\:py-20.lg\\:py-28.z-20>div.h-\\[1px\\].w-full.bg-gray-100.dark\\:bg-white\\/5{background-color:var(--op-border-footer-dark)}#footer>div.flex.w-full.flex-col.gap-12.justify-between.px-8.py-16.md\\:py-20.lg\\:py-28.z-20{margin:0 auto}footer .email_form{max-width:650px;margin:auto}.codeblock_accordion{margin-top:10px}.codeblock_accordion .code-block{margin:0!important}.codeblock_accordion>div>.code-block,.codeblock_accordion>div>.code-block>div:nth-child(2){border-bottom-left-radius:0;border-bottom-right-radius:0}.codeblock_accordion .see_results_container{border-bottom-left-radius:1rem;border-bottom-right-radius:1rem}.codeblock_accordion .see_results_container .code-block,.codeblock_accordion .see_results_container .code-block>div:nth-child(2){border-top-left-radius:0;border-top-right-radius:0}.hide_bullets ul li{padding-left:0!important}.hide_bullets ul li::before{content:none!important}#navigation-items a[href^=\"/\"]:not([href^=\"//\"])>div>div:nth-child(2){display:none}a[href^=\"http\"] .flex-shrink-0 svg,a[href^=\"//\"] .flex-shrink-0 svg{display:block}h1 code,h2 code,h3 code,h4 code,h5 code,h6 code{white-space:nowrap}h2.flex.whitespace-pre-wrap span.cursor-pointer svg.icon,h4.flex.whitespace-pre-wrap span.cursor-pointer svg.icon{margin:0;vertical-align:baseline}table thead tr th code{padding-left:0!important;padding-right:0!important}.tabs.tab-container{padding:0 0.8rem 1rem;border:1px solid var(--op-border-subtle);border-radius:4px}.dark .tabs.tab-container{border-color:var(--op-border-subtle-dark)}nav-tabs-item:nth-child(3),.nav-tabs-item:nth-child(3){--tab-gap-before-divider: 8px;--nav-tabs-item-gap: 0.5rem;margin-left:var(--tab-gap-before-divider)!important;padding-left:calc(\n var(--tab-gap-before-divider) + var(--nav-tabs-item-gap)\n )!important;border-left:1px solid var(--op-border-navbar-light)}.dark nav-tabs-item:nth-child(3),.dark .nav-tabs-item:nth-child(3){border-left-color:var(--op-border-navbar-dark)}.peer.is-center~div:has(.tutorial-explorer){max-width:84rem!important}@media (max-width: 639px){.tutorial-filter-bar{display:grid!important;grid-template-columns:minmax(0, 1fr)}.tutorial-filter-search{grid-column:1 / -1;width:100%}.tutorial-filter-search input{width:100%!important}.tutorial-filter-topic,.tutorial-filter-tools{grid-column:1 / -1;width:100%}.tutorial-filter-dropdown>button,.tutorial-filter-menu{width:100%}.tutorial-filter-dropdown>button{justify-content:space-between}.tutorial-filter-menu{min-width:0!important}.tutorial-filter-sort{grid-column:1 / -1;justify-self:end;margin-left:0!important}}#navbar.is-custom .nav-tabs-item[data-active]{color:var(--op-text-body);text-shadow:none}.dark #navbar.is-custom .nav-tabs-item[data-active]{color:var(--op-text-body-dark)}#navbar.is-custom .nav-tabs-item[data-active]>div{background-color:transparent!important}#navbar.is-custom .nav-tabs-item[data-active]:hover>div{background-color:rgb(229 231 235)!important}.dark #navbar.is-custom .nav-tabs-item[data-active]:hover>div{background-color:rgb(55 65 81)!important}#footer .api-sdk-terms-notice{margin:0;padding:0 0 1.25rem;font-size:0.875rem;font-style:italic;line-height:1.5;text-align:center;color:rgb(251 248 244 / 0.8);pointer-events:auto}#footer .api-sdk-terms-notice a{position:relative;z-index:2;color:var(--op-cornflower);text-decoration:underline;text-underline-offset:2px;pointer-events:auto;cursor:pointer}a:has(>img.nav-logo){display:flex;align-items:center;gap:0.25rem}a:has(>img.nav-logo)::after{content:\"Developers\";font-weight:700;font-size:1.3125rem;line-height:1;letter-spacing:-0.01em;color:#303136;white-space:nowrap}.dark a:has(>img.nav-logo)::after,#footer a:has(>img.nav-logo)::after{color:#FFFEFB}#footer a:has(>img.nav-logo)::after{font-size:1.25rem}"}],"page":{"pagePath":"saas-manager-api/reference/people/update-selected-details-of-a-person","slug":"/saas-manager-api/reference/people/update-selected-details-of-a-person","pageMetadata":{"title":"Update selected details of a person","description":"Partially updates a person: only the fields present in the request body are changed.\nOmitting a field leaves it untouched, whereas sending an explicit `null` clears it.\nAt least one field must be supplied.\n\n**Required scope:** `People.Write` (Write access to people and teams)","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json patch /api/people/v1/{id}","href":"/saas-manager-api/reference/people/update-selected-details-of-a-person","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 code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Partially updates a person: only the fields present in the request body are changed.\\nOmitting a field leaves it untouched, whereas sending an explicit \", _jsx(_components.code, {\n children: \"null\"\n }), \" clears it.\\nAt least one field must be supplied.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Required scope:\"\n }), \" \", _jsx(_components.code, {\n children: \"People.Write\"\n }), \" (Write access to people and teams)\"]\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Update selected details of a person","description":"Partially updates a person: only the fields present in the request body are changed.\nOmitting a field leaves it untouched, whereas sending an explicit `null` clears it.\nAt least one field must be supplied.\n\n**Required scope:** `People.Write` (Write access to people and teams)","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json patch /api/people/v1/{id}","href":"/saas-manager-api/reference/people/update-selected-details-of-a-person","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/ab-634991b8/5ebc0d10523e8210/static/js/analytics.js","/_mintlify/custom/ab-634991b8/5bb7437b1c9dcb44/static/js/gtag-prod-sst.js","/_mintlify/custom/ab-634991b8/ee8ea0eeb20ecd1e/static/js/gtag-sst.js","/_mintlify/custom/ab-634991b8/31610123c784b7c4/api-sdk-terms-notice.js","/_mintlify/custom/ab-634991b8/3604035e212f8294/homepage-card-icons.js"],"openApiReferenceData":{"operation":{"tags":["People"],"summary":"Update selected details of a person","description":"Partially updates a person: only the fields present in the request body are changed.\nOmitting a field leaves it untouched, whereas sending an explicit `null` clears it.\nAt least one field must be supplied.\n\n**Required scope:** `People.Write` (Write access to people and teams)","parameters":["6ea64437-90e7-45e8-bc6a-e1499dc5a468"],"requestBody":"e3ecdfcc-8012-4fea-bf1e-88718567a3e8","responses":{"200":"07e0da95-a67a-4d8c-abb0-4643a78f1d63","400":"e65a5550-fce3-4e66-8a39-2a1f52cc81d7","401":"7eb79cf2-669f-4751-9fbc-2a7f96263922","403":"83444852-28b4-444f-bb81-cb78f3adea8b","404":"daa4ccf6-36a1-4543-86e2-d0d576106067","409":"31be1154-5db0-47f8-aca1-98f4978e1f04"},"security":["70d58171-dad1-43c2-be8a-98dc326a8dc3"],"method":"patch","type":"path","servers":["2546427b-f901-49c7-91b1-a82c39cd49e7","6a0f7815-ac3d-49fb-aabf-4b5324e7ee2c"],"path":"/api/people/v1/{id}","baseUrlOptions":["https://app.trelica.com","https://eu.trelica.com"],"title":"Update selected details of a person","codeSamples":[],"requestExampleLanguages":["bash","node","python","go","dotnet","java","php","powershell","ruby"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"6ea64437-90e7-45e8-bc6a-e1499dc5a468":{"name":"id","in":"path","description":"The person's SaaS Manager ID (UUID) or an email address.","required":true,"schema":{"type":"string","isRequired":true,"description":"The person's SaaS Manager ID (UUID) or an email address.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"firstName":{"oneOf":[{"type":"string","description":"First name","uniqueKey":"firstName.oneOf.0","typeLabel":"string"},{"type":"null","description":"First name","uniqueKey":"firstName.oneOf.1","typeLabel":"null"}],"uniqueKey":"firstName","typeLabel":"string | null"},"lastName":{"oneOf":[{"type":"string","description":"Last name","uniqueKey":"lastName.oneOf.0","typeLabel":"string"},{"type":"null","description":"Last name","uniqueKey":"lastName.oneOf.1","typeLabel":"null"}],"uniqueKey":"lastName","typeLabel":"string | null"},"email":{"oneOf":[{"type":"string","description":"Primary email address","uniqueKey":"email.oneOf.0","typeLabel":"string"},{"type":"null","description":"Primary email address","uniqueKey":"email.oneOf.1","typeLabel":"null"}],"uniqueKey":"email","typeLabel":"string | null"},"aliases":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"aliases.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Additional email addresses linked to this person","uniqueKey":"aliases.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"description":"Additional email addresses linked to this person","uniqueKey":"aliases.oneOf.1","typeLabel":"null"}],"uniqueKey":"aliases","typeLabel":"string[] | null"},"employeeId":{"oneOf":[{"type":"string","description":"Employee ID","uniqueKey":"employeeId.oneOf.0","typeLabel":"string"},{"type":"null","description":"Employee ID","uniqueKey":"employeeId.oneOf.1","typeLabel":"null"}],"uniqueKey":"employeeId","typeLabel":"string | null"},"employeeType":{"oneOf":[{"type":"string","description":"A free-text employee type (e.g. full-time, part-time). Distinct from personType.","uniqueKey":"employeeType.oneOf.0","typeLabel":"string"},{"type":"null","description":"A free-text employee type (e.g. full-time, part-time). Distinct from personType.","uniqueKey":"employeeType.oneOf.1","typeLabel":"null"}],"uniqueKey":"employeeType","typeLabel":"string | null"},"personType":{"oneOf":[{"type":"string","description":"Classifies the person: Employee, Contractor, ServiceAccount or External. Distinct from the free-text employeeType.","enum":["Employee","Contractor","ServiceAccount","External"],"uniqueKey":"personType.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","uniqueKey":"personType.oneOf.1","typeLabel":"null"}],"uniqueKey":"personType","typeLabel":"enum\u003cstring> | null"},"jobTitle":{"oneOf":[{"type":"string","description":"Job title","uniqueKey":"jobTitle.oneOf.0","typeLabel":"string"},{"type":"null","description":"Job title","uniqueKey":"jobTitle.oneOf.1","typeLabel":"null"}],"uniqueKey":"jobTitle","typeLabel":"string | null"},"location":{"oneOf":[{"type":"string","description":"A description of the person's location. A matching location is found or created.","uniqueKey":"location.oneOf.0","typeLabel":"string"},{"type":"null","description":"A description of the person's location. A matching location is found or created.","uniqueKey":"location.oneOf.1","typeLabel":"null"}],"uniqueKey":"location","typeLabel":"string | null"},"costCenter":{"oneOf":[{"type":"string","description":"Cost center. A matching cost center is found or created.","uniqueKey":"costCenter.oneOf.0","typeLabel":"string"},{"type":"null","description":"Cost center. A matching cost center is found or created.","uniqueKey":"costCenter.oneOf.1","typeLabel":"null"}],"uniqueKey":"costCenter","typeLabel":"string | null"},"startDate":{"oneOf":[{"type":"string","description":"(ISO format) Date the person joined the organization. Pass null to clear.","format":"date-time","uniqueKey":"startDate.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","description":"(ISO format) Date the person joined the organization. Pass null to clear.","format":"date-time","uniqueKey":"startDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"startDate","typeLabel":"string\u003cdate-time> | null"},"leavingDate":{"oneOf":[{"type":"string","description":"(ISO format) Date the person left, or is due to leave, the organization. Pass null to clear.","format":"date-time","uniqueKey":"leavingDate.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","description":"(ISO format) Date the person left, or is due to leave, the organization. Pass null to clear.","format":"date-time","uniqueKey":"leavingDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"leavingDate","typeLabel":"string\u003cdate-time> | null"},"loginName":{"oneOf":[{"type":"string","description":"The person's login name on the local domain, used by the Browser Extension Helper.","uniqueKey":"loginName.oneOf.0","typeLabel":"string"},{"type":"null","description":"The person's login name on the local domain, used by the Browser Extension Helper.","uniqueKey":"loginName.oneOf.1","typeLabel":"null"}],"uniqueKey":"loginName","typeLabel":"string | null"},"teamIds":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"teamIds.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Replace the person's team memberships by team ID. Mutually exclusive with teams.","uniqueKey":"teamIds.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"description":"Replace the person's team memberships by team ID. Mutually exclusive with teams.","uniqueKey":"teamIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"teamIds","typeLabel":"string[] | null"},"teams":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"id":{"oneOf":[{"type":"string","description":"The team's unique ID. Omit when creating a team by name.","uniqueKey":"teams.oneOf.0.items.[INDEX].id.oneOf.0","typeLabel":"string"},{"type":"null","description":"The team's unique ID. Omit when creating a team by name.","uniqueKey":"teams.oneOf.0.items.[INDEX].id.oneOf.1","typeLabel":"null"}],"uniqueKey":"teams.oneOf.0.items.[INDEX].id","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","description":"The team's name","uniqueKey":"teams.oneOf.0.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","description":"The team's name","uniqueKey":"teams.oneOf.0.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"teams.oneOf.0.items.[INDEX].name","typeLabel":"string | null"}},"additionalProperties":false,"description":"A team that a person can belong to","uniqueKey":"teams.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Replace the person's team memberships by team (ID or name). Mutually exclusive with teamIds.","uniqueKey":"teams.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"id":{"oneOf":[{"type":"string","description":"The team's unique ID. Omit when creating a team by name."},{"type":"null","description":"The team's unique ID. Omit when creating a team by name."}]},"name":{"oneOf":[{"type":"string","description":"The team's name"},{"type":"null","description":"The team's name"}]}},"additionalProperties":false,"description":"A team that a person can belong to"},"description":"Replace the person's team memberships by team (ID or name). Mutually exclusive with teamIds.","uniqueKey":"teams.oneOf.1","typeLabel":"null"}],"uniqueKey":"teams","typeLabel":"object[] | null"},"lineManagerEmail":{"oneOf":[{"type":"string","description":"Set the line manager by email address. Mutually exclusive with lineManagerId.","uniqueKey":"lineManagerEmail.oneOf.0","typeLabel":"string"},{"type":"null","description":"Set the line manager by email address. Mutually exclusive with lineManagerId.","uniqueKey":"lineManagerEmail.oneOf.1","typeLabel":"null"}],"uniqueKey":"lineManagerEmail","typeLabel":"string | null"},"lineManagerId":{"oneOf":[{"type":"string","description":"Set the line manager by SaaS Manager person ID. Mutually exclusive with lineManagerEmail.","uniqueKey":"lineManagerId.oneOf.0","typeLabel":"string"},{"type":"null","description":"Set the line manager by SaaS Manager person ID. Mutually exclusive with lineManagerEmail.","uniqueKey":"lineManagerId.oneOf.1","typeLabel":"null"}],"uniqueKey":"lineManagerId","typeLabel":"string | null"}},"additionalProperties":false,"description":"Selected person fields to update. Omitted fields are left unchanged; fields set to null are cleared.","uniqueKey":"","typeLabel":"object"},"example":{"jobTitle":"Senior Customer Success Manager","costCenter":"Customer Success","lineManagerEmail":"jane.smith@example.com"},"examples":{"Example":{"title":"Example","value":{"jobTitle":"Senior Customer Success Manager","costCenter":"Customer Success","lineManagerEmail":"jane.smith@example.com"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"07e0da95-a67a-4d8c-abb0-4643a78f1d63":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"The person's unique ID","uniqueKey":"id","typeLabel":"string"},"employeeType":{"type":"string","description":"A free-text employee type (e.g. full-time, part-time). Distinct from personType.","uniqueKey":"employeeType","typeLabel":"string"},"personType":{"type":"string","description":"Classifies the person: Employee, Contractor, ServiceAccount or External. Distinct from the free-text employeeType.","enum":["Employee","Contractor","ServiceAccount","External"],"uniqueKey":"personType","typeLabel":"enum\u003cstring>"},"aliases":{"type":"array","items":{"type":"string","uniqueKey":"aliases.items.[INDEX]","typeLabel":"string"},"description":"Email addresses linked to this person","uniqueKey":"aliases","typeLabel":"string[]"},"userName":{"type":"string","description":"The user's logon name (from integrations)","uniqueKey":"userName","typeLabel":"string"},"firstName":{"type":"string","description":"First name","uniqueKey":"firstName","typeLabel":"string"},"lastName":{"type":"string","description":"Last name","uniqueKey":"lastName","typeLabel":"string"},"email":{"type":"string","description":"Primary email address","uniqueKey":"email","typeLabel":"string"},"jobTitle":{"type":"string","description":"Job title","uniqueKey":"jobTitle","typeLabel":"string"},"locationId":{"type":"string","description":"The location's unique identifier (derived from location)","uniqueKey":"locationId","typeLabel":"string"},"location":{"type":"string","description":"A description of the user's location. A matching location is found or created when set.","uniqueKey":"location","typeLabel":"string"},"locationCountryCode":{"type":"string","description":"The user's country (derived from location)","uniqueKey":"locationCountryCode","typeLabel":"string"},"locationTimezone":{"type":"string","description":"The IANA time zone name of the user's location, e.g. `America/New_York` (derived from location)","uniqueKey":"locationTimezone","typeLabel":"string"},"costCenterId":{"type":"string","description":"The ID of the cost center (derived from costCenter)","uniqueKey":"costCenterId","typeLabel":"string"},"costCenter":{"type":"string","description":"Cost center. A matching cost center is found or created when set.","uniqueKey":"costCenter","typeLabel":"string"},"organizationalUnit":{"type":"string","description":"The organizational unit, sourced from directory integrations (e.g. Google Workspace, Active Directory).","uniqueKey":"organizationalUnit","typeLabel":"string"},"loginName":{"type":"string","description":"The person's login name on the local domain. Used in conjunction with the SaaS Manager Browser Extension Helper to determine the identity of the logged in user.","uniqueKey":"loginName","typeLabel":"string"},"timezone":{"type":"string","description":"The person's IANA time zone name, e.g. `America/New_York`","uniqueKey":"timezone","typeLabel":"string"},"employeeId":{"type":"string","description":"Employee ID","uniqueKey":"employeeId","typeLabel":"string"},"phoneNumber":{"type":"string","description":"Phone number","uniqueKey":"phoneNumber","typeLabel":"string"},"status":{"type":"string","description":"Status (new, terminated, etc)","enum":["New","Terminated","Active","Unknown"],"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"personalAddress":{"type":"object","description":"Home address","properties":{"streetAddress1":{"oneOf":[{"type":"string","uniqueKey":"personalAddress.streetAddress1.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"personalAddress.streetAddress1.oneOf.1","typeLabel":"null"}],"uniqueKey":"personalAddress.streetAddress1","typeLabel":"string | null"},"streetAddress2":{"oneOf":[{"type":"string","uniqueKey":"personalAddress.streetAddress2.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"personalAddress.streetAddress2.oneOf.1","typeLabel":"null"}],"uniqueKey":"personalAddress.streetAddress2","typeLabel":"string | null"},"city":{"oneOf":[{"type":"string","uniqueKey":"personalAddress.city.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"personalAddress.city.oneOf.1","typeLabel":"null"}],"uniqueKey":"personalAddress.city","typeLabel":"string | null"},"stateOrProvince":{"oneOf":[{"type":"string","uniqueKey":"personalAddress.stateOrProvince.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"personalAddress.stateOrProvince.oneOf.1","typeLabel":"null"}],"uniqueKey":"personalAddress.stateOrProvince","typeLabel":"string | null"},"zipOrPostalCode":{"oneOf":[{"type":"string","uniqueKey":"personalAddress.zipOrPostalCode.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"personalAddress.zipOrPostalCode.oneOf.1","typeLabel":"null"}],"uniqueKey":"personalAddress.zipOrPostalCode","typeLabel":"string | null"},"countryCode":{"oneOf":[{"type":"string","uniqueKey":"personalAddress.countryCode.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"personalAddress.countryCode.oneOf.1","typeLabel":"null"}],"uniqueKey":"personalAddress.countryCode","typeLabel":"string | null"}},"additionalProperties":false,"uniqueKey":"personalAddress","typeLabel":"object"},"lineManager":{"type":"object","description":"The person's line manager. On input, set it by the line manager's id or email (other fields are ignored); alternatively use lineManagerId or lineManagerEmail. These three forms are mutually exclusive.","properties":{"id":{"oneOf":[{"type":"string","uniqueKey":"lineManager.id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"lineManager.id.oneOf.1","typeLabel":"null"}],"uniqueKey":"lineManager.id","typeLabel":"string | null"},"personType":{"type":"string","enum":["Contact","User"],"uniqueKey":"lineManager.personType","typeLabel":"enum\u003cstring>"},"name":{"oneOf":[{"type":"string","uniqueKey":"lineManager.name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"lineManager.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"lineManager.name","typeLabel":"string | null"},"email":{"oneOf":[{"type":"string","uniqueKey":"lineManager.email.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"lineManager.email.oneOf.1","typeLabel":"null"}],"uniqueKey":"lineManager.email","typeLabel":"string | null"}},"additionalProperties":false,"uniqueKey":"lineManager","typeLabel":"object"},"teams":{"type":"array","items":{"type":"object","properties":{"id":{"oneOf":[{"type":"string","description":"The team's unique ID. Omit when creating a team by name.","uniqueKey":"teams.items.[INDEX].id.oneOf.0","typeLabel":"string"},{"type":"null","description":"The team's unique ID. Omit when creating a team by name.","uniqueKey":"teams.items.[INDEX].id.oneOf.1","typeLabel":"null"}],"uniqueKey":"teams.items.[INDEX].id","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","description":"The team's name","uniqueKey":"teams.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","description":"The team's name","uniqueKey":"teams.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"teams.items.[INDEX].name","typeLabel":"string | null"}},"additionalProperties":false,"description":"A team that a person can belong to","uniqueKey":"teams.items.[INDEX]","typeLabel":"object"},"description":"The teams the person belongs to. When creating or replacing, supply teams by ID, or by name (a team is created if the name is not found); mutually exclusive with teamIds.","uniqueKey":"teams","typeLabel":"object[]"},"customFields":{"type":"object","additionalProperties":{"type":"object","properties":{"numberValue":{"oneOf":[{"type":"number","format":"double","uniqueKey":"customFields.additionalProperties.numberValue.oneOf.0","typeLabel":"number\u003cdouble>"},{"type":"null","format":"double","uniqueKey":"customFields.additionalProperties.numberValue.oneOf.1","typeLabel":"null"}],"uniqueKey":"customFields.additionalProperties.numberValue","typeLabel":"number\u003cdouble> | null"},"optionValue":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"customFields.additionalProperties.optionValue.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"customFields.additionalProperties.optionValue.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"uniqueKey":"customFields.additionalProperties.optionValue.oneOf.1","typeLabel":"null"}],"uniqueKey":"customFields.additionalProperties.optionValue","typeLabel":"string[] | null"},"textValue":{"oneOf":[{"type":"string","uniqueKey":"customFields.additionalProperties.textValue.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"customFields.additionalProperties.textValue.oneOf.1","typeLabel":"null"}],"uniqueKey":"customFields.additionalProperties.textValue","typeLabel":"string | null"},"dateValue":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"customFields.additionalProperties.dateValue.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"customFields.additionalProperties.dateValue.oneOf.1","typeLabel":"null"}],"uniqueKey":"customFields.additionalProperties.dateValue","typeLabel":"string\u003cdate-time> | null"},"linkValue":{"oneOf":[{"type":"object","properties":{"href":{"oneOf":[{"type":"string","uniqueKey":"customFields.additionalProperties.linkValue.oneOf.0.href.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"customFields.additionalProperties.linkValue.oneOf.0.href.oneOf.1","typeLabel":"null"}],"uniqueKey":"customFields.additionalProperties.linkValue.oneOf.0.href","typeLabel":"string | null"},"description":{"oneOf":[{"type":"string","uniqueKey":"customFields.additionalProperties.linkValue.oneOf.0.description.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"customFields.additionalProperties.linkValue.oneOf.0.description.oneOf.1","typeLabel":"null"}],"uniqueKey":"customFields.additionalProperties.linkValue.oneOf.0.description","typeLabel":"string | null"}},"additionalProperties":false,"uniqueKey":"customFields.additionalProperties.linkValue.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"customFields.additionalProperties.linkValue.oneOf.1","typeLabel":"null"}],"uniqueKey":"customFields.additionalProperties.linkValue","typeLabel":"object | null"},"personValue":{"oneOf":[{"type":"object","properties":{"id":{"oneOf":[{"type":"string","uniqueKey":"customFields.additionalProperties.personValue.oneOf.0.id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"customFields.additionalProperties.personValue.oneOf.0.id.oneOf.1","typeLabel":"null"}],"uniqueKey":"customFields.additionalProperties.personValue.oneOf.0.id","typeLabel":"string | null"},"personType":{"type":"string","enum":["Contact","User"],"uniqueKey":"customFields.additionalProperties.personValue.oneOf.0.personType","typeLabel":"enum\u003cstring>"},"name":{"oneOf":[{"type":"string","uniqueKey":"customFields.additionalProperties.personValue.oneOf.0.name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"customFields.additionalProperties.personValue.oneOf.0.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"customFields.additionalProperties.personValue.oneOf.0.name","typeLabel":"string | null"},"email":{"oneOf":[{"type":"string","uniqueKey":"customFields.additionalProperties.personValue.oneOf.0.email.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"customFields.additionalProperties.personValue.oneOf.0.email.oneOf.1","typeLabel":"null"}],"uniqueKey":"customFields.additionalProperties.personValue.oneOf.0.email","typeLabel":"string | null"},"externalId":{"oneOf":[{"type":"string","uniqueKey":"customFields.additionalProperties.personValue.oneOf.0.externalId.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"customFields.additionalProperties.personValue.oneOf.0.externalId.oneOf.1","typeLabel":"null"}],"uniqueKey":"customFields.additionalProperties.personValue.oneOf.0.externalId","typeLabel":"string | null"}},"additionalProperties":false,"uniqueKey":"customFields.additionalProperties.personValue.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"customFields.additionalProperties.personValue.oneOf.1","typeLabel":"null"}],"uniqueKey":"customFields.additionalProperties.personValue","typeLabel":"object | null"}},"additionalProperties":false,"uniqueKey":"customFields.additionalProperties","typeLabel":"object"},"description":"Custom field values","uniqueKey":"customFields","typeLabel":"object"},"startDate":{"type":"string","description":"(ISO format) Date that the person joined the organization. Passing null clears the date.","format":"date-time","uniqueKey":"startDate","typeLabel":"string\u003cdate-time>"},"leavingDate":{"type":"string","description":"(ISO format) Date that the person left the organization or is due to lave. Passing null clears the date.","format":"date-time","uniqueKey":"leavingDate","typeLabel":"string\u003cdate-time>"},"createdBy":{"type":"object","description":"The user that created the person record","properties":{"userId":{"oneOf":[{"type":"string","uniqueKey":"createdBy.userId.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"createdBy.userId.oneOf.1","typeLabel":"null"}],"uniqueKey":"createdBy.userId","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","uniqueKey":"createdBy.name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"createdBy.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"createdBy.name","typeLabel":"string | null"},"email":{"oneOf":[{"type":"string","uniqueKey":"createdBy.email.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"createdBy.email.oneOf.1","typeLabel":"null"}],"uniqueKey":"createdBy.email","typeLabel":"string | null"}},"additionalProperties":false,"uniqueKey":"createdBy","typeLabel":"object"},"createdDtm":{"type":"string","description":"The timestamp for when the person record was created","format":"date-time","uniqueKey":"createdDtm","typeLabel":"string\u003cdate-time>"},"lastModifiedBy":{"type":"object","description":"The user that last modified the person record","properties":{"userId":{"oneOf":[{"type":"string","uniqueKey":"lastModifiedBy.userId.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"lastModifiedBy.userId.oneOf.1","typeLabel":"null"}],"uniqueKey":"lastModifiedBy.userId","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","uniqueKey":"lastModifiedBy.name.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"lastModifiedBy.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"lastModifiedBy.name","typeLabel":"string | null"},"email":{"oneOf":[{"type":"string","uniqueKey":"lastModifiedBy.email.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"lastModifiedBy.email.oneOf.1","typeLabel":"null"}],"uniqueKey":"lastModifiedBy.email","typeLabel":"string | null"}},"additionalProperties":false,"uniqueKey":"lastModifiedBy","typeLabel":"object"},"lastModifiedDtm":{"type":"string","description":"The timestamp for when the person record was last modified","format":"date-time","uniqueKey":"lastModifiedDtm","typeLabel":"string\u003cdate-time>"}},"additionalProperties":false,"description":"A SaaS Manager person","uniqueKey":"","typeLabel":"object"},"example":{"id":"123e4567e89b12d3a456426614174000","employeeType":"Part-time","personType":"Employee","aliases":["john.doe@example.com","john@example.com","j.doe@example.com","johnny.d@example.com"],"userName":"johndoe123","firstName":"John","lastName":"Doe","email":"john.doe@example.com","jobTitle":"Customer Success Manager","organizationalUnit":"/","loginName":"johndoe","employeeId":"123","status":"Active","lineManager":{"id":"765e4321b98e21d3b456426614174000","personType":"User","name":"Jane Smith","email":"jane.smith@example.com"},"teams":[{"id":"65207c3ffa0d2abb07955316","name":"Customer Success"}],"createdBy":{"userId":"321cba98-765e-4321-0d3b-456789abcdef","name":"System","email":"admin@example.com"},"createdDtm":"2020-03-09T06:09:26Z","lastModifiedBy":{"userId":"321cba98-765e-4321-0d3b-456789abcdef","name":"System","email":"admin@example.com"},"lastModifiedDtm":"2024-05-26T01:01:43Z"},"examples":{"Example":{"title":"Example","value":{"id":"123e4567e89b12d3a456426614174000","employeeType":"Part-time","personType":"Employee","aliases":["john.doe@example.com","john@example.com","j.doe@example.com","johnny.d@example.com"],"userName":"johndoe123","firstName":"John","lastName":"Doe","email":"john.doe@example.com","jobTitle":"Customer Success Manager","organizationalUnit":"/","loginName":"johndoe","employeeId":"123","status":"Active","lineManager":{"id":"765e4321b98e21d3b456426614174000","personType":"User","name":"Jane Smith","email":"jane.smith@example.com"},"teams":[{"id":"65207c3ffa0d2abb07955316","name":"Customer Success"}],"createdBy":{"userId":"321cba98-765e-4321-0d3b-456789abcdef","name":"System","email":"admin@example.com"},"createdDtm":"2020-03-09T06:09:26Z","lastModifiedBy":{"userId":"321cba98-765e-4321-0d3b-456789abcdef","name":"System","email":"admin@example.com"},"lastModifiedDtm":"2024-05-26T01:01:43Z"}}},"exampleType":"examples"}},"exampleType":"examples"},"e65a5550-fce3-4e66-8a39-2a1f52cc81d7":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","description":"A URI reference identifying the problem type.","uniqueKey":"type","typeLabel":"string"},"title":{"type":"string","description":"A short, human-readable summary of the problem.","uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","description":"The HTTP status code.","format":"int32","uniqueKey":"status","typeLabel":"integer\u003cint32>"},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem.","uniqueKey":"detail","typeLabel":"string"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"errors.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"errors.additionalProperties","typeLabel":"string[]"},"description":"Validation errors keyed by field name. Present on 400 responses.","uniqueKey":"errors","typeLabel":"object"},"traceId":{"type":"string","description":"A trace identifier for correlating the error with SaaS Manager support.","uniqueKey":"traceId","typeLabel":"string"}},"additionalProperties":false,"description":"An error response (RFC 7807 problem details).","uniqueKey":"","typeLabel":"object"},"example":{"type":"about:blank","title":"One or more validation errors occurred.","status":400,"detail":"The request body failed validation. See errors for the offending fields.","errors":{"email":["The email field is required."]},"traceId":"00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01"},"examples":{"Example":{"title":"Example","value":{"type":"about:blank","title":"One or more validation errors occurred.","status":400,"detail":"The request body failed validation. See errors for the offending fields.","errors":{"email":["The email field is required."]},"traceId":"00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01"}}},"exampleType":"examples"}},"exampleType":"examples"},"7eb79cf2-669f-4751-9fbc-2a7f96263922":{"description":"Unauthorized","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"83444852-28b4-444f-bb81-cb78f3adea8b":{"description":"Forbidden","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"daa4ccf6-36a1-4543-86e2-d0d576106067":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","description":"A URI reference identifying the problem type.","uniqueKey":"type","typeLabel":"string"},"title":{"type":"string","description":"A short, human-readable summary of the problem.","uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","description":"The HTTP status code.","format":"int32","uniqueKey":"status","typeLabel":"integer\u003cint32>"},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem.","uniqueKey":"detail","typeLabel":"string"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"errors.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"errors.additionalProperties","typeLabel":"string[]"},"description":"Validation errors keyed by field name. Present on 400 responses.","uniqueKey":"errors","typeLabel":"object"},"traceId":{"type":"string","description":"A trace identifier for correlating the error with SaaS Manager support.","uniqueKey":"traceId","typeLabel":"string"}},"additionalProperties":false,"description":"An error response (RFC 7807 problem details).","uniqueKey":"","typeLabel":"object"},"example":{"type":"about:blank","title":"Not found.","status":404,"detail":"The requested resource does not exist or you do not have access to it.","traceId":"00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01"},"examples":{"Example":{"title":"Example","value":{"type":"about:blank","title":"Not found.","status":404,"detail":"The requested resource does not exist or you do not have access to it.","traceId":"00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01"}}},"exampleType":"examples"}},"exampleType":"examples"},"31be1154-5db0-47f8-aca1-98f4978e1f04":{"description":"Conflict","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","description":"A URI reference identifying the problem type.","uniqueKey":"type","typeLabel":"string"},"title":{"type":"string","description":"A short, human-readable summary of the problem.","uniqueKey":"title","typeLabel":"string"},"status":{"type":"integer","description":"The HTTP status code.","format":"int32","uniqueKey":"status","typeLabel":"integer\u003cint32>"},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem.","uniqueKey":"detail","typeLabel":"string"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"errors.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"errors.additionalProperties","typeLabel":"string[]"},"description":"Validation errors keyed by field name. Present on 400 responses.","uniqueKey":"errors","typeLabel":"object"},"traceId":{"type":"string","description":"A trace identifier for correlating the error with SaaS Manager support.","uniqueKey":"traceId","typeLabel":"string"}},"additionalProperties":false,"description":"An error response (RFC 7807 problem details).","uniqueKey":"","typeLabel":"object"},"example":{"type":"about:blank","title":"Conflict.","status":409,"detail":"The request conflicts with the current state (for example, the resource already exists).","traceId":"00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01"},"examples":{"Example":{"title":"Example","value":{"type":"about:blank","title":"Conflict.","status":409,"detail":"The request conflicts with the current state (for example, the resource already exists).","traceId":"00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"70d58171-dad1-43c2-be8a-98dc326a8dc3":{"oauth2":{"type":"oauth2","description":"OAuth 2.0. Obtain an access token via the Client Credentials or Authorization Code flow, then send it as `Authorization: Bearer \u003ctoken>`.","flows":{"clientCredentials":{"tokenUrl":"https://app.trelica.com/connect/token","scopes":{"Apps.Read":"Read-only access to applications","Apps.Users.Read":"Read-only access to application accounts","Apps.Write":"Write access to applications","Assets.Read":"Read-only access to devices","Assets.Write":"Write access to devices","AuditLog.Read":"Read-only access to the audit log","Contracts.Read":"Read-only access to contracts","Contracts.Write":"Write access to contracts","People.Read":"Read-only access to people and teams","People.Write":"Write access to people and teams","Users.Read":"Read-only access to users with access to SaaS Manager","Users.Write":"Write access to users with access to SaaS Manager","Workflows.Read":"Read-only access to workflow definitions","Workflows.Runs.Read":"Read-only access to workflow runs","Workflows.Runs.Execute":"Execute workflow run actions","Workflows.Runs.ReadSecrets":"Read workflow run secrets","offline_access":"Issue a refresh token alongside the access token (Authorization Code flow)"}},"authorizationCode":{"authorizationUrl":"https://app.trelica.com/connect/authorize","tokenUrl":"https://app.trelica.com/connect/token","scopes":{"Apps.Read":"Read-only access to applications","Apps.Users.Read":"Read-only access to application accounts","Apps.Write":"Write access to applications","Assets.Read":"Read-only access to devices","Assets.Write":"Write access to devices","AuditLog.Read":"Read-only access to the audit log","Contracts.Read":"Read-only access to contracts","Contracts.Write":"Write access to contracts","People.Read":"Read-only access to people and teams","People.Write":"Write access to people and teams","Users.Read":"Read-only access to users with access to SaaS Manager","Users.Write":"Write access to users with access to SaaS Manager","Workflows.Read":"Read-only access to workflow definitions","Workflows.Runs.Read":"Read-only access to workflow runs","Workflows.Runs.Execute":"Execute workflow run actions","Workflows.Runs.ReadSecrets":"Read workflow run secrets","offline_access":"Issue a refresh token alongside the access token (Authorization Code flow)"}}},"scopes":["People.Write"]}}},"servers":{"2546427b-f901-49c7-91b1-a82c39cd49e7":{"url":"https://app.trelica.com","description":"United States"},"6a0f7815-ac3d-49fb-aabf-4b5324e7ee2c":{"url":"https://eu.trelica.com","description":"Europe"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"oauth2","description":"OAuth 2.0. Obtain an access token via the Client Credentials or Authorization Code flow, then send it as `Authorization: Bearer \u003ctoken>`.","flows":{"clientCredentials":{"tokenUrl":"https://app.trelica.com/connect/token","scopes":{"Apps.Read":"Read-only access to applications","Apps.Users.Read":"Read-only access to application accounts","Apps.Write":"Write access to applications","Assets.Read":"Read-only access to devices","Assets.Write":"Write access to devices","AuditLog.Read":"Read-only access to the audit log","Contracts.Read":"Read-only access to contracts","Contracts.Write":"Write access to contracts","People.Read":"Read-only access to people and teams","People.Write":"Write access to people and teams","Users.Read":"Read-only access to users with access to SaaS Manager","Users.Write":"Write access to users with access to SaaS Manager","Workflows.Read":"Read-only access to workflow definitions","Workflows.Runs.Read":"Read-only access to workflow runs","Workflows.Runs.Execute":"Execute workflow run actions","Workflows.Runs.ReadSecrets":"Read workflow run secrets","offline_access":"Issue a refresh token alongside the access token (Authorization Code flow)"}},"authorizationCode":{"authorizationUrl":"https://app.trelica.com/connect/authorize","tokenUrl":"https://app.trelica.com/connect/token","scopes":{"Apps.Read":"Read-only access to applications","Apps.Users.Read":"Read-only access to application accounts","Apps.Write":"Write access to applications","Assets.Read":"Read-only access to devices","Assets.Write":"Write access to devices","AuditLog.Read":"Read-only access to the audit log","Contracts.Read":"Read-only access to contracts","Contracts.Write":"Write access to contracts","People.Read":"Read-only access to people and teams","People.Write":"Write access to people and teams","Users.Read":"Read-only access to users with access to SaaS Manager","Users.Write":"Write access to users with access to SaaS Manager","Workflows.Read":"Read-only access to workflow definitions","Workflows.Runs.Read":"Read-only access to workflow runs","Workflows.Runs.Execute":"Execute workflow run actions","Workflows.Runs.ReadSecrets":"Read workflow run secrets","offline_access":"Issue a refresh token alongside the access token (Authorization Code flow)"}}},"scopes":["People.Write"]},"schema":{"title":"OAuth2 Auth","type":"string","isRequired":true,"description":"OAuth 2.0. Obtain an access token via the Client Credentials or Authorization Code flow, then send it as `Authorization: Bearer \u003ctoken>`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"oauth2","name":"Authorization"}],"title":"oauth2"}]},"originalFileLocation":"openapi/saas_manager_api.json"},"subdomain":"ab-634991b8","siteName":"1Password Developer","title":"Update selected details of a person - 1Password Developer","relatedPagesConfig":{"enabled":true,"limit":3,"mode":"automatic"},"contextualStarterQuestions":[],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-11T20:12:30.319Z","originalFileLocation":"saas-manager-api/reference/people/update-selected-details-of-a-person.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=\"Partially updates a person: only the fields present in the request body are changed. Omitting a field leaves it untouched, whereas sending an explicit null clears it. At least one field must be supplied. Required scope: People.Write (Write access to people and teams)\">\u003cmeta data-mint-head name=\"application-name\" content=\"1Password Developer\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ab-634991b8/cic7o6CrHhA6877e/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/ab-634991b8/cic7o6CrHhA6877e/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ab-634991b8/cic7o6CrHhA6877e/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ab-634991b8/cic7o6CrHhA6877e/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ab-634991b8/cic7o6CrHhA6877e/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ab-634991b8/cic7o6CrHhA6877e/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ab-634991b8/cic7o6CrHhA6877e/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ab-634991b8/cic7o6CrHhA6877e/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ab-634991b8/cic7o6CrHhA6877e/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Update selected details of a person - 1Password Developer\">\u003cmeta data-mint-head property=\"og:description\" content=\"Partially updates a person: only the fields present in the request body are changed. Omitting a field leaves it untouched, whereas sending an explicit null clears it. At least one field must be supplied. Required scope: People.Write (Write access to people and teams)\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"1Password Developer\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.1password.dev/saas-manager-api/reference/people/update-selected-details-of-a-person\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ab-634991b8.mintlify.site/_mintlify/api/og/v2?division=People\u0026amp;title=Update+selected+details+of+a+person\u0026amp;description=Partially+updates+a+person%3A+only+the+fields+present+in+the+request+body+are+changed.%0AOmitting+a+field+leaves+it+untouched%2C+whereas+sending+an+explicit+%60null%60+cl\u0026amp;theme=4f276e23841331680610e0c6\u0026amp;signature=9cae01eae10acf270e6f06bc6e2f9ce98443cccbd62c9e27d56bf5097dd66eca\">\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 selected details of a person - 1Password Developer\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Partially updates a person: only the fields present in the request body are changed. Omitting a field leaves it untouched, whereas sending an explicit null clears it. At least one field must be supplied. Required scope: People.Write (Write access to people and teams)\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ab-634991b8.mintlify.site/_mintlify/api/og/v2?division=People\u0026amp;title=Update+selected+details+of+a+person\u0026amp;description=Partially+updates+a+person%3A+only+the+fields+present+in+the+request+body+are+changed.%0AOmitting+a+field+leaves+it+untouched%2C+whereas+sending+an+explicit+%60null%60+cl\u0026amp;theme=4f276e23841331680610e0c6\u0026amp;signature=9cae01eae10acf270e6f06bc6e2f9ce98443cccbd62c9e27d56bf5097dd66eca\">\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=\"/mintlify-assets/_mintlify/favicons/ab-634991b8/cic7o6CrHhA6877e/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"1Password Developer\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#145FE4\">\u003cmeta data-mint-head name=\"google-site-verification\" content=\"YserOhXnJUjFfIZ4K3qgxkVSlQZQdXtIbBiKzZ35Nvs\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.1password.dev/saas-manager-api/reference/people/update-selected-details-of-a-person\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/saas-manager-api/reference/people/update-selected-details-of-a-person.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.1password.dev/#organization\",\"name\":\"1Password Developer\",\"url\":\"https://www.1password.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/ab-634991b8/tWWm5UFlpZQ9nof8/images/logo-1password-dark.svg?fit=max\u0026auto=format\u0026n=tWWm5UFlpZQ9nof8\u0026q=85\u0026s=2c2acc6dc5f817defe70ebdef67c9b11\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.1password.dev#website\",\"name\":\"1Password Developer\",\"url\":\"https://www.1password.dev\",\"publisher\":{\"@id\":\"https://www.1password.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.1password.dev/saas-manager-api/reference/people/update-selected-details-of-a-person#webpage\",\"url\":\"https://www.1password.dev/saas-manager-api/reference/people/update-selected-details-of-a-person\",\"name\":\"Update selected details of a person\",\"description\":\"Partially updates a person: only the fields present in the request body are changed. Omitting a field leaves it untouched, whereas sending an explicit null clears it. At least one field must be supplied. Required scope: People.Write (Write access to people and teams)\",\"dateModified\":\"2026-11-11T20:12:30.319Z\",\"isPartOf\":{\"@id\":\"https://www.1password.dev#website\"},\"breadcrumb\":{\"@id\":\"https://www.1password.dev/saas-manager-api/reference/people/update-selected-details-of-a-person#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.1password.dev/saas-manager-api/reference/people/update-selected-details-of-a-person#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"SaaS Manager API\",\"item\":\"https://www.1password.dev/saas-manager-api\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"API Reference\",\"item\":\"https://www.1password.dev/saas-manager-api/reference/people/list-people\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"People\",\"item\":\"https://www.1password.dev/saas-manager-api/reference/people/list-people\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Update selected details of a person\",\"item\":\"https://www.1password.dev/saas-manager-api/reference/people/update-selected-details-of-a-person\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.1password.dev/saas-manager-api/reference/people/update-selected-details-of-a-person#apireference\",\"headline\":\"Update selected details of a person\",\"name\":\"Update selected details of a person\",\"description\":\"Partially updates a person: only the fields present in the request body are changed. Omitting a field leaves it untouched, whereas sending an explicit null clears it. At least one field must be supplied. Required scope: People.Write (Write access to people and teams)\",\"url\":\"https://www.1password.dev/saas-manager-api/reference/people/update-selected-details-of-a-person\",\"mainEntityOfPage\":{\"@id\":\"https://www.1password.dev/saas-manager-api/reference/people/update-selected-details-of-a-person#webpage\"},\"dateModified\":\"2026-11-11T20:12:30.319Z\",\"publisher\":{\"@id\":\"https://www.1password.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://www.1password.dev#website\"}}]}\u003c/script>","agentPointerHref":"/saas-manager-api/reference/people/update-selected-details-of-a-person.md","siteName":"1Password Developer","nav":{"global":null,"tabs":[{"tab":"Get started","pages":[{"title":"Get started","href":"/get-started/developer-quickstart"}]},{"tab":"CLI","pages":[{"title":"CLI","href":"/cli"}]},{"tab":"SSH \u0026 Git","pages":[{"title":"SSH \u0026 Git","href":"/ssh"}]},{"tab":"Environments","pages":[{"title":"Environments","href":"/environments"}]},{"tab":"AI agents","pages":[{"title":"AI agents","href":"/security-for-ai"}]},{"tab":"Service Accounts","pages":[{"title":"Service Accounts","href":"/service-accounts"}]},{"tab":"CI/CD \u0026 infrastructure","pages":[{"title":"CI/CD \u0026 infrastructure","href":"/integrations"}]},{"tab":"SDKs \u0026 APIs","menu":[{"item":"SDKs","icon":"cube","pages":[{"title":"SDKs","href":"/sdks"}]},{"item":"Events API","icon":"sensor-triangle-exclamation","pages":[{"title":"Events API","href":"/events-api"}]},{"item":"Users API","icon":"id-badge","pages":[{"title":"Users API","href":"/users-api"}]},{"item":"SaaS Manager API","icon":"chart-line","groups":[{"group":"SaaS Manager API","pages":[{"title":"1Password SaaS Manager API","sidebarTitle":"Overview","href":"/saas-manager-api"},{"group":"API Reference","pages":[{"group":"People","pages":[{"title":"List people","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/people/v1","href":"/saas-manager-api/reference/people/list-people"},{"title":"Get a person","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/people/v1/{id}","href":"/saas-manager-api/reference/people/get-a-person"},{"title":"Create or replace a person","description":"Creates a new person, or fully replaces an existing one when an ID is supplied (in the\nroute or in the body). When creating, the email address must not already be in use.\nSet the line manager with lineManagerId or lineManagerEmail. Team membership is replaced\nwholesale: supply either teams (by ID or name) or teamIds (not both) — omitting both\nremoves the person's manually-assigned teams.\n\n**Required scope:** `People.Write` (Write access to people and teams)","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json put /api/people/v1/{id}","href":"/saas-manager-api/reference/people/create-or-replace-a-person"},{"title":"Update selected details of a person","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json patch /api/people/v1/{id}","href":"/saas-manager-api/reference/people/update-selected-details-of-a-person"},{"title":"List a person's applications","description":"Returns a paginated list of the applications a person has an account on, identified by their\nSaaS Manager ID or email address. If an email address matches more than one person a 409\nConflict is returned.\n\n**Required scope:** `People.Read` (Read-only access to people and teams)","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/people/v1/{id}/apps","href":"/saas-manager-api/reference/people/list-a-persons-applications"}]},{"group":"Teams","pages":[{"title":"Create or update a team","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json put /api/people/v1/teams","href":"/saas-manager-api/reference/teams/create-or-update-a-team"},{"title":"Get a team","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/people/v1/teams/{id}","href":"/saas-manager-api/reference/teams/get-a-team"},{"title":"Delete a team","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json delete /api/people/v1/teams/{id}","href":"/saas-manager-api/reference/teams/delete-a-team"},{"title":"List teams","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/people/v1/teams/list","href":"/saas-manager-api/reference/teams/list-teams"},{"title":"Get the team hierarchy","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/people/v1/teams/tree","href":"/saas-manager-api/reference/teams/get-the-team-hierarchy"}]},{"group":"Applications","pages":[{"title":"List applications","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/apps/v1","href":"/saas-manager-api/reference/applications/list-applications"},{"title":"Create an application","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json post /api/apps/v1","href":"/saas-manager-api/reference/applications/create-an-application"},{"title":"Get an application","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/apps/v1/{appId}","href":"/saas-manager-api/reference/applications/get-an-application"},{"title":"Update selected details of an application","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json patch /api/apps/v1/{id}","href":"/saas-manager-api/reference/applications/update-selected-details-of-an-application"},{"title":"List application accounts","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/apps/v1/{appId}/users","href":"/saas-manager-api/reference/applications/list-application-accounts"},{"title":"Get application categories","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/apps/v1/categories","href":"/saas-manager-api/reference/applications/get-application-categories"},{"title":"List application custom fields","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/apps/v1/customfields","href":"/saas-manager-api/reference/applications/list-application-custom-fields"}]},{"group":"Devices","pages":[{"title":"List devices","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/assets/v1","href":"/saas-manager-api/reference/devices/list-devices"},{"title":"Get a device","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/assets/v1/{id}","href":"/saas-manager-api/reference/devices/get-a-device"},{"title":"Create or replace a device","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json put /api/assets/v1/{id}","href":"/saas-manager-api/reference/devices/create-or-replace-a-device"},{"title":"Delete a device","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json delete /api/assets/v1/{id}","href":"/saas-manager-api/reference/devices/delete-a-device"},{"title":"Update selected details of a device","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json patch /api/assets/v1/{id}","href":"/saas-manager-api/reference/devices/update-selected-details-of-a-device"},{"title":"List device custom fields","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/assets/v1/customfields","href":"/saas-manager-api/reference/devices/list-device-custom-fields"}]},{"group":"Contracts","pages":[{"title":"List contracts","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/contracts/v1","href":"/saas-manager-api/reference/contracts/list-contracts"},{"title":"Create or update a contract","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json put /api/contracts/v1","href":"/saas-manager-api/reference/contracts/create-or-update-a-contract"},{"title":"Get a contract","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/contracts/v1/{id}","href":"/saas-manager-api/reference/contracts/get-a-contract"},{"title":"Delete a contract","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json delete /api/contracts/v1/{id}","href":"/saas-manager-api/reference/contracts/delete-a-contract"}]},{"group":"Workflows","pages":[{"title":"List workflows","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/workflows/v1","href":"/saas-manager-api/reference/workflows/list-workflows"},{"title":"Get a workflow","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/workflows/v1/{workflowId}","href":"/saas-manager-api/reference/workflows/get-a-workflow"},{"title":"List workflow runs","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/workflows/v1/{workflowId}/runs","href":"/saas-manager-api/reference/workflows/list-workflow-runs"},{"title":"Get a workflow run","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/workflows/v1/{workflowId}/runs/{runId}","href":"/saas-manager-api/reference/workflows/get-a-workflow-run"},{"title":"Fire a signal","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json post /api/workflows/v1/{workflowId}/runs/{runId}/firedSignals/{activityId}/{signalName}","href":"/saas-manager-api/reference/workflows/fire-a-signal"}]},{"group":"Audit log","pages":[{"title":"List audit log events","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/audit/v1/logs","href":"/saas-manager-api/reference/audit-log/list-audit-log-events"}]},{"group":"SCIM","pages":[{"title":"List resource types","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/scim/v2/ResourceTypes","href":"/saas-manager-api/reference/scim/list-resource-types"},{"title":"List users","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/scim/v2/Users","href":"/saas-manager-api/reference/scim/list-users"},{"title":"Create a user","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json post /api/scim/v2/Users","href":"/saas-manager-api/reference/scim/create-a-user"},{"title":"Get a user","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/scim/v2/Users/{userId}","href":"/saas-manager-api/reference/scim/get-a-user"},{"title":"Replace a user","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json put /api/scim/v2/Users/{userId}","href":"/saas-manager-api/reference/scim/replace-a-user"},{"title":"Delete a user","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json delete /api/scim/v2/Users/{userId}","href":"/saas-manager-api/reference/scim/delete-a-user"},{"title":"Update a user","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json patch /api/scim/v2/Users/{userId}","href":"/saas-manager-api/reference/scim/update-a-user"},{"title":"Get the User resource type","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /api/scim/v2/ResourceTypes/User","href":"/saas-manager-api/reference/scim/get-the-user-resource-type"}]},{"group":"Authentication","pages":[{"title":"Request an access token","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json post /connect/token","href":"/saas-manager-api/reference/authentication/request-an-access-token"},{"title":"Authorize (Authorization Code flow)","deprecated":null,"version":null,"openapi":"/openapi/saas_manager_api.json get /connect/authorize","href":"/saas-manager-api/reference/authentication/authorize-authorization-code-flow"}]}]}]}]},{"item":"Partnership API","icon":"users","pages":[{"title":"Partnership API","href":"/partnership-api/reference"}]},{"item":"Accounts API","icon":"user-gear","pages":[{"title":"Accounts API","href":"/accounts-api"}]},{"item":"Web Development","icon":"code","pages":[{"title":"Web Development","href":"/web/add-1password-button-website"}]}]},{"tab":"Community","menu":[{"item":"Developer community","icon":"users","href":"/community"},{"item":"Events","icon":"calendar","href":"https://luma.com/1password"},{"item":"Newsletter","icon":"envelope","href":"https://1password.com/developer-newsletter"},{"item":"Slack","icon":"slack","href":"https://www.1password.dev/joinslack"},{"item":"1Password Academy","icon":"graduation-cap","href":"https://www.1password.academy/path/1password-developer-tools"}]},{"tab":"Agentic Autofill partner guide","hidden":true,"pages":[{"title":"Agentic Autofill partner guide","href":"/agentic-autofill/partners"}]}]},"basePath":"","title":"Update selected details of a person - 1Password Developer","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["10e4515597","c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["BannerMarkdown-DV3Oq1fY.js","dist-C-XZBk9h.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","clsx-D3Isdib3.js","html-void-elements-mCSPHezU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-CybtLBIt.js","utils-BMLj2fvV.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B6In562Y.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dr8Mfhp9.js","snippetPresets-2rmQvMVl.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-WMqJYdZj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CJ-MlPHu.js","shallow-dY3TMRCk.js","getApiPlaygroundDisplay-v-1B2bKm.js","CodeSnippet-BDhiTB7U.js","CodeSnippets-D9hnzQcS.js","Page-C4GwDT3_.js","getPastedJson-Th2V45jI.js","icon-BQXch1W9.js","MethodPill-BCqUneP3.js","DuplicateIcon-Q_-bhurZ.js","createIcon-DUjLHRqp.js","DynamicMarkdown-B-f2cqXQ.js","SectionHeading-Da5NsV4v.js","axios-vUo_bRtp.js","Markdown-D13FWkIM.js","AssistantPageLink--qIqmmVG.js"]}