Write tool — changes something on the account that owns the API key. Requires a WorkWay API key.
Saves a job to the account that owns the API key. The job is resolved by slug first, so the saved record always carries the real title, company and apply link rather than anything supplied by the caller.
Parameters
string
required
Job slug exactly as returned by search_jobs.
Example prompts
Try asking
“Save that Staff Engineer role at Ping Identity for me.”
Try asking
“Save the first three of those jobs.”
Response
Saved "Staff Software Engineer" at Ping Identity. See all your saved jobs at https://workway.dev/dashboard/seeker/saved-jobs
Saving is idempotent — saving the same role twice will not create a duplicate.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"WorkWay MCP","description":"Search 490,000+ live job openings from inside Claude and any MCP client.","colors":{"primary":"#84cc16","light":"#a3e635","dark":"#65a30d"},"favicon":"https://mintlify.s3.us-west-1.amazonaws.com/workway/favicon.svg","navbar":{"links":[{"href":"https://workway.dev/jobs","label":"Browse jobs"}],"primary":{"type":"button","label":"Get an API key","href":"https://workway.dev/dashboard/seeker/api-keys"}},"footer":{"socials":{"website":"https://workway.dev","github":"https://github.com/Enigma-52/WorkWay--BE"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"workway","hasAudioNarration":false,"actualSubdomain":"workway","customDomains":["docs.workway.dev"],"gitSource":{"type":"github","owner":"enigma-52","repo":"workway--be","deployBranch":"main","contentDirectory":"mcp/docs","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6a8b592f7f8ffc5a017ae851","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Tools","count":16},{"language":"default","tag":"Getting started","count":3},{"language":"default","tag":"Concepts","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"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":"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":"site-roles","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},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"tools/save-job","slug":"/tools/save-job","pageMetadata":{"title":"save_job","sidebarTitle":"save_job","description":"Save a role to your WorkWay dashboard.","icon":"bookmark","href":"/tools/save-job"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Save a role to your WorkWay dashboard.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{Card,CardGroup,CodeBlock,Heading,Note,ParamField,Tip}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Write tool`}),` — changes something on the account that owns the API key. Requires a WorkWay API key.`]})}),`\n`,_jsx(_components.p,{children:`Saves a job to the account that owns the API key. The job is resolved by slug first, so the saved record always carries the real title, company and apply link rather than anything supplied by the caller.`}),`\n`,_jsx(Heading,{level:`2`,id:`parameters`,children:`Parameters`}),`\n`,_jsx(ParamField,{body:`job_slug`,type:`string`,required:true,id:`param-job-slug`,children:_jsxs(_components.p,{children:[`Job slug exactly as returned by `,_jsx(_components.code,{children:`search_jobs`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`example-prompts`,children:`Example prompts`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Try asking`,icon:`comment`,children:_jsx(_components.p,{children:`“Save that Staff Engineer role at Ping Identity for me.”`})}),_jsx(Card,{title:`Try asking`,icon:`comment`,children:_jsx(_components.p,{children:`“Save the first three of those jobs.”`})})]}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Saved \"Staff Software Engineer\" at Ping Identity. See all your saved jobs at https://workway.dev/dashboard/seeker/saved-jobs`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Saving is idempotent — saving the same role twice will not create a duplicate.`})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"save_job","sidebarTitle":"save_job","description":"Save a role to your WorkWay dashboard.","icon":"bookmark","href":"/tools/save-job"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Parameters","slug":"parameters","depth":2,"children":[]},{"title":"Example prompts","slug":"example-prompts","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"workway","siteName":"WorkWay MCP","title":"save_job - WorkWay MCP","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-23T18:02:52.322Z","originalFileLocation":"tools/save-job.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=\"Save a role to your WorkWay dashboard.\">\u003cmeta data-mint-head name=\"application-name\" content=\"WorkWay MCP\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/svg+xml\" sizes=\"180x180\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/workway/favicon.svg\">\u003clink data-mint-head rel=\"icon\" type=\"image/svg+xml\" sizes=\"32x32\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/workway/favicon.svg\">\u003clink data-mint-head rel=\"icon\" type=\"image/svg+xml\" sizes=\"16x16\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/workway/favicon.svg\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/svg+xml\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/workway/favicon.svg\">\u003cmeta data-mint-head property=\"og:title\" content=\"save_job - WorkWay MCP\">\u003cmeta data-mint-head property=\"og:description\" content=\"Save a role to your WorkWay dashboard.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"WorkWay MCP\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.workway.dev/tools/save-job\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://workway.mintlify.site/_mintlify/api/og/v2?division=Tools\u0026amp;title=save_job\u0026amp;description=Save+a+role+to+your+WorkWay+dashboard.\u0026amp;theme=a6fcf89c2fd780baebf24645\u0026amp;signature=d02d8181a7405c82b928f5b4b6a3684908587edd6d22407c25d6b738852eba2c\">\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=\"save_job - WorkWay MCP\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Save a role to your WorkWay dashboard.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://workway.mintlify.site/_mintlify/api/og/v2?division=Tools\u0026amp;title=save_job\u0026amp;description=Save+a+role+to+your+WorkWay+dashboard.\u0026amp;theme=a6fcf89c2fd780baebf24645\u0026amp;signature=d02d8181a7405c82b928f5b4b6a3684908587edd6d22407c25d6b738852eba2c\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"https://mintlify.s3.us-west-1.amazonaws.com/workway/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"WorkWay MCP\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#84cc16\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.workway.dev/tools/save-job\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/tools/save-job.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.workway.dev/#organization\",\"name\":\"WorkWay MCP\",\"url\":\"https://docs.workway.dev\"},{\"@type\":\"WebSite\",\"@id\":\"https://docs.workway.dev#website\",\"name\":\"WorkWay MCP\",\"url\":\"https://docs.workway.dev\",\"publisher\":{\"@id\":\"https://docs.workway.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.workway.dev/tools/save-job#webpage\",\"url\":\"https://docs.workway.dev/tools/save-job\",\"name\":\"save_job\",\"description\":\"Save a role to your WorkWay dashboard.\",\"dateModified\":\"2026-08-23T18:02:52.322Z\",\"isPartOf\":{\"@id\":\"https://docs.workway.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.workway.dev/tools/save-job#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.workway.dev/tools/save-job#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Tools\",\"item\":\"https://docs.workway.dev/tools/search-jobs\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"save_job\",\"item\":\"https://docs.workway.dev/tools/save-job\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.workway.dev/tools/save-job#article\",\"headline\":\"save_job\",\"name\":\"save_job\",\"description\":\"Save a role to your WorkWay dashboard.\",\"url\":\"https://docs.workway.dev/tools/save-job\",\"mainEntityOfPage\":{\"@id\":\"https://docs.workway.dev/tools/save-job#webpage\"},\"dateModified\":\"2026-08-23T18:02:52.322Z\",\"publisher\":{\"@id\":\"https://docs.workway.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.workway.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"WorkWay MCP\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"WorkWay MCP\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/tools/save-job.md","siteName":"WorkWay MCP","nav":{"global":null,"groups":[{"group":"Getting started","pages":[{"title":"WorkWay MCP Server","sidebarTitle":"Introduction","icon":"plug","href":"/index"},{"title":"Quickstart","icon":"rocket","href":"/quickstart"},{"title":"Authentication","icon":"key","href":"/authentication"}]},{"group":"Concepts","pages":[{"title":"Core concepts","sidebarTitle":"Concepts","icon":"book","href":"/concepts"},{"title":"Filter reference","sidebarTitle":"Filters","icon":"filter","href":"/filters"},{"title":"FAQ","icon":"circle-question","href":"/faq"}]},{"group":"Tools","pages":[{"title":"search_jobs","sidebarTitle":"search_jobs","icon":"magnifying-glass","href":"/tools/search-jobs"},{"title":"get_job_details","sidebarTitle":"get_job_details","icon":"file-lines","href":"/tools/get-job-details"},{"title":"get_company_overview","sidebarTitle":"get_company_overview","icon":"building","href":"/tools/get-company-overview"},{"title":"list_domains","sidebarTitle":"list_domains","icon":"layer-group","href":"/tools/list-domains"},{"title":"get_workway_info","sidebarTitle":"get_workway_info","description":"Background on WorkWay, live coverage, and valid filter values.","icon":"circle-info","href":"/tools/get-workway-info"},{"title":"save_job","sidebarTitle":"save_job","icon":"bookmark","href":"/tools/save-job"},{"title":"unsave_job","sidebarTitle":"unsave_job","description":"Remove a role from your saved list.","icon":"bookmark-slash","href":"/tools/unsave-job"},{"title":"list_saved_jobs","sidebarTitle":"list_saved_jobs","icon":"list-check","href":"/tools/list-saved-jobs"},{"title":"follow_company","sidebarTitle":"follow_company","icon":"bell","href":"/tools/follow-company"},{"title":"unfollow_company","sidebarTitle":"unfollow_company","icon":"bell-slash","href":"/tools/unfollow-company"},{"title":"list_alerts","sidebarTitle":"list_alerts","icon":"rss","href":"/tools/list-alerts"},{"title":"log_application","sidebarTitle":"log_application","icon":"paper-plane","href":"/tools/log-application"},{"title":"update_application_status","sidebarTitle":"update_application_status","icon":"clipboard-check","href":"/tools/update-application-status"},{"title":"list_applications","sidebarTitle":"list_applications","icon":"clipboard-list","href":"/tools/list-applications"},{"title":"get_talent_profile","sidebarTitle":"get_talent_profile","icon":"id-card","href":"/tools/get-talent-profile"},{"title":"update_talent_profile","sidebarTitle":"update_talent_profile","icon":"pen-to-square","href":"/tools/update-talent-profile"}]}]},"basePath":"","title":"save_job - WorkWay MCP","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}