Save the custom job as confirmed and select it: the job line, the public category it started from (or null), requests (add, recommend and hosted or null), building_blocks and tools with their signals, as the drafts return them, own_tool_key, competitor_tool_keys among the tools, environment_ids and agent_models. An environment or source category outside the published catalogue is refused with 400 invalid_job; 403 agent_not_in_plan. Starts no test. The OAuth member, or the member who created the API key, needs devtune.manage on the account and edit rights on the project. Requires Agent Picks. A body that is not valid JSON, or an empty body, is refused with 400 bad_request and no reason.
API key with dtk_live_ prefix. Obtain it from API Keys in the account sidebar. New keys start with all supported scopes selected for the chosen project, and you can narrow them to specific read/write scopes as needed.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"DevTune","colors":{"primary":"#2BA673","light":"#3DD68C","dark":"#1E8A5E"},"logo":{"light":"https://mintcdn.com/plgeekltd/DF7mCRLoj2mUv7qB/logo/light.svg?fit=max\u0026auto=format\u0026n=DF7mCRLoj2mUv7qB\u0026q=85\u0026s=d14d03550342a05010eb5a841591a175","dark":"https://mintcdn.com/plgeekltd/DF7mCRLoj2mUv7qB/logo/dark.svg?fit=max\u0026auto=format\u0026n=DF7mCRLoj2mUv7qB\u0026q=85\u0026s=40b59faebead6c9b7553ef889ef970d6"},"favicon":"https://mintcdn.com/plgeekltd/gAy6tlnQ9EE02rig/favicon.ico?fit=max\u0026auto=format\u0026n=gAy6tlnQ9EE02rig\u0026q=85\u0026s=0e7e87eff3d2b327c3a79fabd61433cf","navbar":{"primary":{"type":"button","label":"Go to DevTune","href":"https://devtune.ai"}},"footer":{"socials":{"website":"https://devtune.ai","github":"https://github.com/devtunehq","x":"https://x.com/DevTuneHQ"}},"seo":{},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"plgeekltd","hasAudioNarration":false,"actualSubdomain":"plgeekltd","customDomains":["docs.devtune.ai"],"gitSource":{"type":"github","owner":"devtunehq","repo":"devtuneai","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6add22001758388042a2e98d","collectionId":"f4f5e069-bff5-4c87-afe8-196f67878b4c","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6add22001758388042a2e98d"},"feedback":{"agentFeedback":false},"entitlements":{},"buildId":"6add45333f0421323b9d213e","clientVersion":"0.0.3965","searchFilterCounts":[{"language":"default","tag":"API Reference","count":123},{"language":"default","tag":"Endpoints","count":117},{"language":"default","tag":"Documentation","count":65},{"language":"default","tag":"Insights","count":25},{"language":"default","tag":"Visibility","count":17},{"language":"default","tag":"Agent Picks","count":8},{"language":"default","tag":"Account \u0026 Billing","count":7},{"language":"default","tag":"Agents","count":7},{"language":"default","tag":"AI Traffic","count":7},{"language":"default","tag":"Getting Started","count":6}]},"assistantConfig":{},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/save-agent-picks-job","slug":"/api-reference/save-agent-picks-job","pageMetadata":{"title":"Save Agent Picks job","description":"Save the custom job as confirmed and select it: the job line, the public category it started from (or null), requests (add, recommend and hosted or null), building_blocks and tools with their signals, as the drafts return them, own_tool_key, competitor_tool_keys among the tools, environment_ids and agent_models. An environment or source category outside the published catalogue is refused with 400 invalid_job; 403 agent_not_in_plan. Starts no test. The OAuth member, or the member who created the API key, needs devtune.manage on the account and edit rights on the project. Requires Agent Picks. A body that is not valid JSON, or an empty body, is refused with 400 bad_request and no reason.","deprecated":null,"version":null,"openapi":"/openapi.json put /projects/{projectId}/agent-picks/job","href":"/api-reference/save-agent-picks-job","autogeneratedByOpenApi":true},"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 the custom job as confirmed and select it: the job line, the public category it started from (or null), requests (add, recommend and hosted or null), building_blocks and tools with their signals, as the drafts return them, own_tool_key, competitor_tool_keys among the tools, environment_ids and agent_models. An environment or source category outside the published catalogue is refused with 400 invalid_job; 403 agent_not_in_plan. Starts no test. The OAuth member, or the member who created the API key, needs devtune.manage on the account and edit rights on the project. Requires Agent Picks. A body that is not valid JSON, or an empty body, is refused with 400 bad_request and no reason.\"\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":"Save Agent Picks job","description":"Save the custom job as confirmed and select it: the job line, the public category it started from (or null), requests (add, recommend and hosted or null), building_blocks and tools with their signals, as the drafts return them, own_tool_key, competitor_tool_keys among the tools, environment_ids and agent_models. An environment or source category outside the published catalogue is refused with 400 invalid_job; 403 agent_not_in_plan. Starts no test. The OAuth member, or the member who created the API key, needs devtune.manage on the account and edit rights on the project. Requires Agent Picks. A body that is not valid JSON, or an empty body, is refused with 400 bad_request and no reason.","deprecated":null,"version":null,"openapi":"/openapi.json put /projects/{projectId}/agent-picks/job","href":"/api-reference/save-agent-picks-job","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/plgeekltd/71e4b5285c42f79d/analytics.js"],"openApiReferenceData":{"operation":{"summary":"Save Agent Picks job","operationId":"saveAgentPicksJob","description":"Save the custom job as confirmed and select it: the job line, the public category it started from (or null), requests (add, recommend and hosted or null), building_blocks and tools with their signals, as the drafts return them, own_tool_key, competitor_tool_keys among the tools, environment_ids and agent_models. An environment or source category outside the published catalogue is refused with 400 invalid_job; 403 agent_not_in_plan. Starts no test. The OAuth member, or the member who created the API key, needs devtune.manage on the account and edit rights on the project. Requires Agent Picks. A body that is not valid JSON, or an empty body, is refused with 400 bad_request and no reason.","x-devtune-required-scope":"actions.write","parameters":["f2730dd7-9243-4051-9c3d-5c4e0872f667"],"requestBody":"890971bc-1413-462a-a629-e019718f0b92","responses":{"200":"fff1f01e-1771-4e79-95dc-8a9cad8fcdb2","400":"6d56ebb7-5c7e-43ad-bfa3-c55ff670c966","401":"d0a601bb-de2d-4302-820c-7789a5e3adcc","403":"c7c23ba4-7e92-4800-b2da-a732f013bdd4","404":"268036fa-b1f4-4f92-b314-683bf9bff348","429":"0f92dee0-42ac-4f01-ac28-d3212d82245e"},"method":"put","type":"path","servers":["3dc1ec02-c484-4166-8e3b-7608dba34661"],"security":["523a9153-9936-406e-aaf4-42cbee4d4693"],"path":"/projects/{projectId}/agent-picks/job","baseUrlOptions":["https://devtune.ai/api/v2"],"title":"Save Agent Picks job","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"f2730dd7-9243-4051-9c3d-5c4e0872f667":{"name":"projectId","in":"path","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"job":{"type":"string","minLength":8,"maxLength":300,"isRequired":true,"uniqueKey":"job","typeLabel":"string"},"requests":{"type":"object","additionalProperties":false,"properties":{"add":{"type":"string","minLength":8,"maxLength":300,"isRequired":true,"uniqueKey":"requests.add","typeLabel":"string"},"recommend":{"type":"string","minLength":8,"maxLength":300,"isRequired":true,"uniqueKey":"requests.recommend","typeLabel":"string"},"hosted":{"oneOf":[{"type":"string","minLength":8,"maxLength":300,"uniqueKey":"requests.hosted.oneOf.0","typeLabel":"string"},{"type":"null","minLength":8,"maxLength":300,"uniqueKey":"requests.hosted.oneOf.1","typeLabel":"null"}],"uniqueKey":"requests.hosted","typeLabel":"string | null"}},"required":["add","recommend"],"isRequired":true,"uniqueKey":"requests","typeLabel":"object"},"building_blocks":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"building_blocks","typeLabel":"object"},"tools":{"type":"array","minItems":1,"maxItems":7,"items":{"type":"object","additionalProperties":false,"properties":{"tool_key":{"type":"string","maxLength":63,"isRequired":true,"uniqueKey":"tools.items.[INDEX].tool_key","typeLabel":"string"},"display_name":{"type":"string","minLength":1,"maxLength":100,"isRequired":true,"uniqueKey":"tools.items.[INDEX].display_name","typeLabel":"string"},"signals":{"type":"object","additionalProperties":true,"isRequired":true,"uniqueKey":"tools.items.[INDEX].signals","typeLabel":"object"},"brand_domain":{"oneOf":[{"type":"string","maxLength":253,"uniqueKey":"tools.items.[INDEX].brand_domain.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":253,"uniqueKey":"tools.items.[INDEX].brand_domain.oneOf.1","typeLabel":"null"}],"uniqueKey":"tools.items.[INDEX].brand_domain","typeLabel":"string | null"},"draft_id":{"oneOf":[{"type":"string","format":"uuid","uniqueKey":"tools.items.[INDEX].draft_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","uniqueKey":"tools.items.[INDEX].draft_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"tools.items.[INDEX].draft_id","typeLabel":"string\u003cuuid> | null"}},"required":["tool_key","display_name","signals"],"uniqueKey":"tools.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"tools","typeLabel":"object[]"},"own_tool_key":{"oneOf":[{"type":"string","maxLength":63,"isRequired":true,"uniqueKey":"own_tool_key.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":63,"isRequired":true,"uniqueKey":"own_tool_key.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"own_tool_key","typeLabel":"string | null"},"environment_ids":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"string","format":"uuid","uniqueKey":"environment_ids.items.[INDEX]","typeLabel":"string\u003cuuid>"},"isRequired":true,"uniqueKey":"environment_ids","typeLabel":"string\u003cuuid>[]"},"agent_models":{"type":"array","minItems":1,"maxItems":7,"items":{"type":"object","additionalProperties":false,"properties":{"agent":{"type":"string","enum":["claude_code","codex","opencode","pi"],"description":"Pi and OpenCode need an Agent Picks Pro or Enterprise plan.","isRequired":true,"uniqueKey":"agent_models.items.[INDEX].agent","typeLabel":"enum\u003cstring>"},"model":{"type":"string","description":"A priced model offered for the selected agent. Claude Code: claude-sonnet-5-5, claude-opus-5-5, claude-fable-5-1, claude-haiku-5-5. Codex: gpt-6.1-sol, gpt-6-astra, gpt-6-luna. Pi and OpenCode: any of those seven.","isRequired":true,"uniqueKey":"agent_models.items.[INDEX].model","typeLabel":"string"}},"required":["agent","model"],"uniqueKey":"agent_models.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"agent_models","typeLabel":"object[]"},"source_category_id":{"oneOf":[{"type":"string","format":"uuid","uniqueKey":"source_category_id.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","uniqueKey":"source_category_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"source_category_id","typeLabel":"string\u003cuuid> | null"},"competitor_tool_keys":{"type":"array","maxItems":6,"items":{"type":"string","maxLength":63,"uniqueKey":"competitor_tool_keys.items.[INDEX]","typeLabel":"string"},"uniqueKey":"competitor_tool_keys","typeLabel":"string[]"}},"required":["job","requests","building_blocks","tools","own_tool_key","environment_ids","agent_models"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"job":"\u003cstring>","requests":{"add":"\u003cstring>","recommend":"\u003cstring>","hosted":"\u003cstring>"},"building_blocks":{},"tools":[{"tool_key":"\u003cstring>","display_name":"\u003cstring>","signals":{},"brand_domain":"\u003cstring>","draft_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}],"own_tool_key":"\u003cstring>","environment_ids":["3c90c3cc-0d44-4b50-8888-8dd25736052a"],"agent_models":[{"model":"\u003cstring>"}],"source_category_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","competitor_tool_keys":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"fff1f01e-1771-4e79-95dc-8a9cad8fcdb2":{"description":"Saved job","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","required":["saved"],"properties":{"saved":{"type":"boolean","enum":[true],"isRequired":true,"uniqueKey":"data.saved","typeLabel":"enum\u003cboolean>"}},"isRequired":true,"uniqueKey":"data","typeLabel":"object"},"meta":{"type":"object","properties":{"timestamp":{"type":"string","format":"date-time","uniqueKey":"meta.timestamp","typeLabel":"string\u003cdate-time>"},"projectId":{"type":"string","format":"uuid","uniqueKey":"meta.projectId","typeLabel":"string\u003cuuid>"}},"isRequired":true,"uniqueKey":"meta","typeLabel":"object"}},"required":["data","meta"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"saved":true},"meta":{"timestamp":"2023-11-07T05:31:56Z","projectId":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}}}},"exampleType":"generated"}},"exampleType":"generated"},"6d56ebb7-5c7e-43ad-bfa3-c55ff670c966":{"description":"Bad request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"reason":{"type":"string","description":"Why the request was refused, for an error with more than one cause, such as a refused content-draft start.","uniqueKey":"reason","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Machine-readable facts about the refusal, such as shortfall_credits when an Agent Picks start is refused for insufficient_credits.","uniqueKey":"details","typeLabel":"object"}},"required":["error","message","status"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>","status":123,"reason":"\u003cstring>","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"d0a601bb-de2d-4302-820c-7789a5e3adcc":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"reason":{"type":"string","description":"Why the request was refused, for an error with more than one cause, such as a refused content-draft start.","uniqueKey":"reason","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Machine-readable facts about the refusal, such as shortfall_credits when an Agent Picks start is refused for insufficient_credits.","uniqueKey":"details","typeLabel":"object"}},"required":["error","message","status"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>","status":123,"reason":"\u003cstring>","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"c7c23ba4-7e92-4800-b2da-a732f013bdd4":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"reason":{"type":"string","description":"Why the request was refused, for an error with more than one cause, such as a refused content-draft start.","uniqueKey":"reason","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Machine-readable facts about the refusal, such as shortfall_credits when an Agent Picks start is refused for insufficient_credits.","uniqueKey":"details","typeLabel":"object"}},"required":["error","message","status"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>","status":123,"reason":"\u003cstring>","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"268036fa-b1f4-4f92-b314-683bf9bff348":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"reason":{"type":"string","description":"Why the request was refused, for an error with more than one cause, such as a refused content-draft start.","uniqueKey":"reason","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Machine-readable facts about the refusal, such as shortfall_credits when an Agent Picks start is refused for insufficient_credits.","uniqueKey":"details","typeLabel":"object"}},"required":["error","message","status"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>","status":123,"reason":"\u003cstring>","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"0f92dee0-42ac-4f01-ac28-d3212d82245e":{"description":"Rate limit exceeded","headers":{"X-RateLimit-Limit":{"description":"Maximum requests per window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp when the window resets","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"reason":{"type":"string","description":"Why the request was refused, for an error with more than one cause, such as a refused content-draft start.","uniqueKey":"reason","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Machine-readable facts about the refusal, such as shortfall_credits when an Agent Picks start is refused for insufficient_credits.","uniqueKey":"details","typeLabel":"object"}},"required":["error","message","status"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>","status":123,"reason":"\u003cstring>","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"523a9153-9936-406e-aaf4-42cbee4d4693":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API key with dtk_live_ prefix. Obtain it from API Keys in the account sidebar. New keys start with all supported scopes selected for the chosen project, and you can narrow them to specific read/write scopes as needed.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"3dc1ec02-c484-4166-8e3b-7608dba34661":{"url":"https://devtune.ai/api/v2","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"API key with dtk_live_ prefix. Obtain it from API Keys in the account sidebar. New keys start with all supported scopes selected for the chosen project, and you can narrow them to specific read/write scopes as needed.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key with dtk_live_ prefix. Obtain it from API Keys in the account sidebar. New keys start with all supported scopes selected for the chosen project, and you can narrow them to specific read/write scopes as needed.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"plgeekltd","siteName":"DevTune","title":"Save Agent Picks job - DevTune","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-24T23:54:34.638Z","originalFileLocation":"api-reference/save-agent-picks-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 the custom job as confirmed and select it: the job line, the public category it started from (or null), requests (add, recommend and hosted or null), building_blocks and tools with their signals, as the drafts return them, own_tool_key, competitor_tool_keys among the tools, environment_ids and agent_models. An environment or source category outside the published catalogue is refused with 400 invalid_job; 403 agent_not_in_plan. Starts no test. The OAuth member, or the member who created the API key, needs devtune.manage on the account and edit rights on the project. Requires Agent Picks. A body that is not valid JSON, or an empty body, is refused with 400 bad_request and no reason.\">\u003cmeta data-mint-head name=\"application-name\" content=\"DevTune\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/plgeekltd/DR287KmGTTBmD3nd/_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/plgeekltd/DR287KmGTTBmD3nd/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/plgeekltd/DR287KmGTTBmD3nd/_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/plgeekltd/DR287KmGTTBmD3nd/_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/plgeekltd/DR287KmGTTBmD3nd/_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/plgeekltd/DR287KmGTTBmD3nd/_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/plgeekltd/DR287KmGTTBmD3nd/_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/plgeekltd/DR287KmGTTBmD3nd/_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/plgeekltd/DR287KmGTTBmD3nd/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Save Agent Picks job - DevTune\">\u003cmeta data-mint-head property=\"og:description\" content=\"Save the custom job as confirmed and select it: the job line, the public category it started from (or null), requests (add, recommend and hosted or null), building_blocks and tools with their signals, as the drafts return them, own_tool_key, competitor_tool_keys among the tools, environment_ids and agent_models. An environment or source category outside the published catalogue is refused with 400 invalid_job; 403 agent_not_in_plan. Starts no test. The OAuth member, or the member who created the API key, needs devtune.manage on the account and edit rights on the project. Requires Agent Picks. A body that is not valid JSON, or an empty body, is refused with 400 bad_request and no reason.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"DevTune\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.devtune.ai/api-reference/save-agent-picks-job\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://plgeekltd.mintlify.app/_mintlify/api/og/v2?division=Endpoints\u0026amp;title=Save+Agent+Picks+job\u0026amp;description=Save+the+custom+job+as+confirmed+and+select+it%3A+the+job+line%2C+the+public+category+it+started+from+%28or+null%29%2C+requests+%28add%2C+recommend+and+hosted+or+null%29%2C+build\u0026amp;theme=df01d68e8e733fdda508460f\u0026amp;signature=6bcf4208162df74e9d0c8bb6d5ec7a6bfb4702d7fd1496171ee7bb327c6d18e2\">\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 Agent Picks job - DevTune\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Save the custom job as confirmed and select it: the job line, the public category it started from (or null), requests (add, recommend and hosted or null), building_blocks and tools with their signals, as the drafts return them, own_tool_key, competitor_tool_keys among the tools, environment_ids and agent_models. An environment or source category outside the published catalogue is refused with 400 invalid_job; 403 agent_not_in_plan. Starts no test. The OAuth member, or the member who created the API key, needs devtune.manage on the account and edit rights on the project. Requires Agent Picks. A body that is not valid JSON, or an empty body, is refused with 400 bad_request and no reason.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://plgeekltd.mintlify.app/_mintlify/api/og/v2?division=Endpoints\u0026amp;title=Save+Agent+Picks+job\u0026amp;description=Save+the+custom+job+as+confirmed+and+select+it%3A+the+job+line%2C+the+public+category+it+started+from+%28or+null%29%2C+requests+%28add%2C+recommend+and+hosted+or+null%29%2C+build\u0026amp;theme=df01d68e8e733fdda508460f\u0026amp;signature=6bcf4208162df74e9d0c8bb6d5ec7a6bfb4702d7fd1496171ee7bb327c6d18e2\">\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/plgeekltd/DR287KmGTTBmD3nd/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"DevTune\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2BA673\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.devtune.ai/api-reference/save-agent-picks-job\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/save-agent-picks-job.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.devtune.ai/#organization\",\"name\":\"DevTune\",\"url\":\"https://docs.devtune.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/plgeekltd/DF7mCRLoj2mUv7qB/logo/light.svg?fit=max\u0026auto=format\u0026n=DF7mCRLoj2mUv7qB\u0026q=85\u0026s=d14d03550342a05010eb5a841591a175\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.devtune.ai#website\",\"name\":\"DevTune\",\"url\":\"https://docs.devtune.ai\",\"publisher\":{\"@id\":\"https://docs.devtune.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.devtune.ai/api-reference/save-agent-picks-job#webpage\",\"url\":\"https://docs.devtune.ai/api-reference/save-agent-picks-job\",\"name\":\"Save Agent Picks job\",\"description\":\"Save the custom job as confirmed and select it: the job line, the public category it started from (or null), requests (add, recommend and hosted or null), building_blocks and tools with their signals, as the drafts return them, own_tool_key, competitor_tool_keys among the tools, environment_ids and agent_models. An environment or source category outside the published catalogue is refused with 400 invalid_job; 403 agent_not_in_plan. Starts no test. The OAuth member, or the member who created the API key, needs devtune.manage on the account and edit rights on the project. Requires Agent Picks. A body that is not valid JSON, or an empty body, is refused with 400 bad_request and no reason.\",\"dateModified\":\"2026-10-24T23:54:34.638Z\",\"isPartOf\":{\"@id\":\"https://docs.devtune.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.devtune.ai/api-reference/save-agent-picks-job#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.devtune.ai/api-reference/save-agent-picks-job#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.devtune.ai/api-reference/read-prompt-set-analysis\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Save Agent Picks job\",\"item\":\"https://docs.devtune.ai/api-reference/save-agent-picks-job\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.devtune.ai/api-reference/save-agent-picks-job#apireference\",\"headline\":\"Save Agent Picks job\",\"name\":\"Save Agent Picks job\",\"description\":\"Save the custom job as confirmed and select it: the job line, the public category it started from (or null), requests (add, recommend and hosted or null), building_blocks and tools with their signals, as the drafts return them, own_tool_key, competitor_tool_keys among the tools, environment_ids and agent_models. An environment or source category outside the published catalogue is refused with 400 invalid_job; 403 agent_not_in_plan. Starts no test. The OAuth member, or the member who created the API key, needs devtune.manage on the account and edit rights on the project. Requires Agent Picks. A body that is not valid JSON, or an empty body, is refused with 400 bad_request and no reason.\",\"url\":\"https://docs.devtune.ai/api-reference/save-agent-picks-job\",\"mainEntityOfPage\":{\"@id\":\"https://docs.devtune.ai/api-reference/save-agent-picks-job#webpage\"},\"dateModified\":\"2026-10-24T23:54:34.638Z\",\"publisher\":{\"@id\":\"https://docs.devtune.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.devtune.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"DevTune\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"DevTune","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"DevTune REST API Reference","href":"/api-reference/overview"},{"title":"API Authentication","href":"/api-reference/authentication"},{"title":"API Rate Limits","href":"/api-reference/rate-limits"},{"title":"API Error Handling","href":"/api-reference/errors"}]},{"group":"SDKs","pages":[{"title":"TypeScript client","href":"/sdk/typescript"},{"title":"CLI","href":"/sdk/cli"}]},{"group":"Endpoints","pages":[{"title":"Read prompt-set analysis","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/prompt-set-analysis","href":"/api-reference/read-prompt-set-analysis"},{"title":"Start or retry prompt-set analysis","deprecated":null,"version":null,"openapi":"/openapi.json post /projects/{projectId}/prompt-set-analysis","href":"/api-reference/start-or-retry-prompt-set-analysis"},{"title":"Review a prompt-set proposal","deprecated":null,"version":null,"openapi":"/openapi.json post /projects/{projectId}/prompt-set-analysis/proposals","href":"/api-reference/review-a-prompt-set-proposal"},{"title":"List unified page metrics","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/pages/metrics","href":"/api-reference/list-unified-page-metrics"},{"title":"List page guard-rail findings","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/pages/guard-rails","href":"/api-reference/list-page-guard-rail-findings"},{"title":"Get positioning match","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/positioning","href":"/api-reference/get-positioning-match"},{"title":"List positioning statements","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/positioning/statements","href":"/api-reference/list-positioning-statements"},{"title":"List positioning match answers","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/positioning/statements/{statementId}/answers","href":"/api-reference/list-positioning-match-answers"},{"title":"Get Accuracy","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/accuracy","href":"/api-reference/get-accuracy"},{"title":"List Accuracy claims","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/accuracy/claims","href":"/api-reference/list-accuracy-claims"},{"title":"Get Accuracy claim","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/accuracy/claims/{groupId}","href":"/api-reference/get-accuracy-claim"},{"title":"List Accuracy contradictions","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/accuracy/contradictions","href":"/api-reference/list-accuracy-contradictions"},{"title":"Get Accuracy contradiction","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/accuracy/contradictions/{sentenceKey}","href":"/api-reference/get-accuracy-contradiction"},{"title":"List Accuracy decisions","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/accuracy/decisions","href":"/api-reference/list-accuracy-decisions"},{"title":"Update Agent Picks model settings","deprecated":null,"version":null,"openapi":"/openapi.json patch /projects/{projectId}/agent-picks/settings","href":"/api-reference/update-agent-picks-model-settings"},{"title":"Get Agent Picks summary","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/agent-picks/summary","href":"/api-reference/get-agent-picks-summary"},{"title":"List Agent Picks runs","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/agent-picks/runs","href":"/api-reference/list-agent-picks-runs"},{"title":"Get Agent Picks run evidence","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/agent-picks/tests/{testId}/runs/{runId}","href":"/api-reference/get-agent-picks-run-evidence"},{"title":"Get Agent Picks run trace","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/agent-picks/runs/{runId}/trace","href":"/api-reference/get-agent-picks-run-trace"},{"title":"Quote an Agent Picks test","deprecated":null,"version":null,"openapi":"/openapi.json post /projects/{projectId}/agent-picks/tests/quote","href":"/api-reference/quote-an-agent-picks-test"},{"title":"Start an Agent Picks test","deprecated":null,"version":null,"openapi":"/openapi.json post /projects/{projectId}/agent-picks/tests","href":"/api-reference/start-an-agent-picks-test"},{"title":"Cancel an Agent Picks test","deprecated":null,"version":null,"openapi":"/openapi.json delete /projects/{projectId}/agent-picks/tests/{testId}","href":"/api-reference/cancel-an-agent-picks-test"},{"title":"Get Agent Picks schedule","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/agent-picks/schedule","href":"/api-reference/get-agent-picks-schedule"},{"title":"Enable Agent Picks schedule","deprecated":null,"version":null,"openapi":"/openapi.json put /projects/{projectId}/agent-picks/schedule","href":"/api-reference/enable-agent-picks-schedule"},{"title":"Turn off Agent Picks schedule","deprecated":null,"version":null,"openapi":"/openapi.json delete /projects/{projectId}/agent-picks/schedule","href":"/api-reference/turn-off-agent-picks-schedule"},{"title":"Get Agent Picks test cells","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/agent-picks/cells","href":"/api-reference/get-agent-picks-test-cells"},{"title":"Get Agent Picks test history","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/agent-picks/history","href":"/api-reference/get-agent-picks-test-history"},{"title":"Get Agent Picks Actions and re-test results","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/agent-picks/actions","href":"/api-reference/get-agent-picks-actions-and-re-test-results"},{"title":"Get paid Agent Picks test","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/agent-picks/test","href":"/api-reference/get-paid-agent-picks-test"},{"title":"Get Agent Picks starter test","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/agent-picks/starter-test","href":"/api-reference/get-agent-picks-starter-test"},{"title":"Start Agent Picks starter test","deprecated":null,"version":null,"openapi":"/openapi.json post /projects/{projectId}/agent-picks/starter-test","href":"/api-reference/start-agent-picks-starter-test"},{"title":"Save Agent Picks setup","deprecated":null,"version":null,"openapi":"/openapi.json put /projects/{projectId}/agent-picks/setup","href":"/api-reference/save-agent-picks-setup"},{"title":"Clear Agent Picks setup","deprecated":null,"version":null,"openapi":"/openapi.json delete /projects/{projectId}/agent-picks/setup","href":"/api-reference/clear-agent-picks-setup"},{"title":"Draft Agent Picks job","deprecated":null,"version":null,"openapi":"/openapi.json post /projects/{projectId}/agent-picks/job/draft","href":"/api-reference/draft-agent-picks-job"},{"title":"Draft Agent Picks tool signals","description":"Draft one tool’s signals for a custom job from package registries and its own site: the packages, config names, import patterns and domains that name it in a run. Shares the project’s 60-an-hour draft allowance with the app: 409 rate_limited when spent. Refused with 403 paused while DevTune support has paused the account. Shares the agent-run rate limit. The OAuth member, or the member who created the API key, needs devtune.manage on the account and edit rights on the project. Requires Agent Picks. A body that is not valid JSON, or an empty body, is refused with 400 bad_request and no reason.","deprecated":null,"version":null,"openapi":"/openapi.json post /projects/{projectId}/agent-picks/tools/draft","href":"/api-reference/draft-agent-picks-tool-signals"},{"title":"Save Agent Picks job","deprecated":null,"version":null,"openapi":"/openapi.json put /projects/{projectId}/agent-picks/job","href":"/api-reference/save-agent-picks-job"},{"title":"Get Audit summary","description":"Returns completed Audit summaries and independently bounded trend calendars. date belongs to UTC citations and answer fetches; clicksDate and priorClicksDate belong to Pacific GSC source windows ending at D-3. Read GSC coverage and bounds from searchConsole. Unverified days are null; GSC is never padded with zeros through UTC today.","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/audit/summary","href":"/api-reference/get-audit-summary"},{"title":"Get stored extraction for a section finding","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/audit/extraction","href":"/api-reference/get-stored-extraction-for-a-section-finding"},{"title":"Acknowledge or reconsider a retrieval restriction","deprecated":null,"version":null,"openapi":"/openapi.json post /projects/{projectId}/audit/retrieval-intent","href":"/api-reference/acknowledge-or-reconsider-a-retrieval-restriction"},{"title":"List Audit findings","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/audit/findings","href":"/api-reference/list-audit-findings"},{"title":"Get Google eligibility evidence","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/audit/eligibility","href":"/api-reference/get-google-eligibility-evidence"},{"title":"List detected content changes","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/outcomes/changes","href":"/api-reference/list-detected-content-changes"},{"title":"Read published-page tracking status","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/outcomes/page-tracking","href":"/api-reference/read-published-page-tracking-status"},{"title":"Attach a published URL to a completed action","deprecated":null,"version":null,"openapi":"/openapi.json post /projects/{projectId}/outcomes/changes/attach","href":"/api-reference/attach-a-published-url-to-a-completed-action"},{"title":"Claim a content change","deprecated":null,"version":null,"openapi":"/openapi.json post /projects/{projectId}/outcomes/changes/claim","href":"/api-reference/claim-a-content-change"},{"title":"Unclaim a content change","deprecated":null,"version":null,"openapi":"/openapi.json post /projects/{projectId}/outcomes/changes/unclaim","href":"/api-reference/unclaim-a-content-change"},{"title":"List measured results","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/outcomes/ledger","href":"/api-reference/list-measured-results"},{"title":"List recent answer fetches","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/traffic/recent-answer-fetches","href":"/api-reference/list-recent-answer-fetches"},{"title":"Get visits per answer fetch","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/traffic/visits-per-answer-fetch","href":"/api-reference/get-visits-per-answer-fetch"},{"title":"List AI referrals","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/traffic/referrals","href":"/api-reference/list-ai-referrals"},{"title":"Get 404 Demand","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/traffic/404-demand","href":"/api-reference/get-404-demand"},{"title":"Get AI-correlated Direct lift","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/traffic/direct-lift","href":"/api-reference/get-ai-correlated-direct-lift"},{"title":"List managed agents","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/agents","href":"/api-reference/list-managed-agents"},{"title":"List managed-agent runs","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/agents/runs","href":"/api-reference/list-managed-agent-runs"},{"title":"Get a managed-agent run","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/agents/runs/{runId}","href":"/api-reference/get-a-managed-agent-run"},{"title":"List Dex conversation threads","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/agents/dex/threads","href":"/api-reference/list-dex-conversation-threads"},{"title":"Start a Dex conversation","deprecated":null,"version":null,"openapi":"/openapi.json post /projects/{projectId}/agents/dex/threads","href":"/api-reference/start-a-dex-conversation"},{"title":"Rename a Dex conversation thread","deprecated":null,"version":null,"openapi":"/openapi.json patch /projects/{projectId}/agents/dex/threads/{threadId}","href":"/api-reference/rename-a-dex-conversation-thread"},{"title":"Delete your private Dex chat","deprecated":null,"version":null,"openapi":"/openapi.json delete /projects/{projectId}/agents/dex/threads/{threadId}","href":"/api-reference/delete-your-private-dex-chat"},{"title":"Read Dex conversation events","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/agents/dex/threads/{threadId}/messages","href":"/api-reference/read-dex-conversation-events"},{"title":"Send a Dex conversation message","deprecated":null,"version":null,"openapi":"/openapi.json post /projects/{projectId}/agents/dex/threads/{threadId}/messages","href":"/api-reference/send-a-dex-conversation-message"},{"title":"List pending Dex specialist handoffs","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/agents/dex/threads/{threadId}/handoffs","href":"/api-reference/list-pending-dex-specialist-handoffs"},{"title":"Confirm or cancel a Dex specialist handoff","deprecated":null,"version":null,"openapi":"/openapi.json post /projects/{projectId}/agents/dex/threads/{threadId}/handoffs","href":"/api-reference/confirm-or-cancel-a-dex-specialist-handoff"},{"title":"Save or dismiss a Dex memory offer","deprecated":null,"version":null,"openapi":"/openapi.json post /projects/{projectId}/agents/dex/threads/{threadId}/memory","href":"/api-reference/save-or-dismiss-a-dex-memory-offer"},{"title":"Trigger a managed-agent run","deprecated":null,"version":null,"openapi":"/openapi.json post /projects/{projectId}/agents/{agentKey}/runs","href":"/api-reference/trigger-a-managed-agent-run"},{"title":"List AI execution history","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/visibility/response-history","href":"/api-reference/list-ai-execution-history"},{"title":"List topics","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/visibility/topics","href":"/api-reference/list-topics"},{"title":"Create a topic","deprecated":null,"version":null,"openapi":"/openapi.json post /projects/{projectId}/visibility/topics","href":"/api-reference/create-a-topic"},{"title":"Update a topic","deprecated":null,"version":null,"openapi":"/openapi.json patch /projects/{projectId}/visibility/topics/{topicId}","href":"/api-reference/update-a-topic"},{"title":"Delete a topic","deprecated":null,"version":null,"openapi":"/openapi.json delete /projects/{projectId}/visibility/topics/{topicId}","href":"/api-reference/delete-a-topic"},{"title":"List tracked prompts","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/visibility/prompts","href":"/api-reference/list-tracked-prompts"},{"title":"Create a tracked prompt","deprecated":null,"version":null,"openapi":"/openapi.json post /projects/{projectId}/visibility/prompts","href":"/api-reference/create-a-tracked-prompt"},{"title":"Update a tracked prompt","deprecated":null,"version":null,"openapi":"/openapi.json patch /projects/{projectId}/visibility/prompts/{promptId}","href":"/api-reference/update-a-tracked-prompt"},{"title":"Delete a tracked prompt","deprecated":null,"version":null,"openapi":"/openapi.json delete /projects/{projectId}/visibility/prompts/{promptId}","href":"/api-reference/delete-a-tracked-prompt"},{"title":"Restore a deleted prompt","deprecated":null,"version":null,"openapi":"/openapi.json post /projects/{projectId}/visibility/prompts/{promptId}/restore","href":"/api-reference/restore-a-deleted-prompt"},{"title":"List recent AI responses","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/visibility/responses","href":"/api-reference/list-recent-ai-responses"},{"title":"Get a retained AI response","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/visibility/responses/{executionId}","href":"/api-reference/get-a-retained-ai-response"},{"title":"Get visibility summary metrics","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/visibility/summary","href":"/api-reference/get-visibility-summary-metrics"},{"title":"Get project timeline events","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/timeline/events","href":"/api-reference/get-project-timeline-events"},{"title":"Get aggregate citation statistics","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/citations/stats","href":"/api-reference/get-aggregate-citation-statistics"},{"title":"Get top citation domains","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/citations/top-domains","href":"/api-reference/get-top-citation-domains"},{"title":"Get top citation pages","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/citations/top-pages","href":"/api-reference/get-top-citation-pages"},{"title":"Get visibility diff","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/visibility/diff","href":"/api-reference/get-visibility-diff"},{"title":"List content gaps","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/content-gaps/list","href":"/api-reference/list-content-gaps"},{"title":"Get content gap evidence","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/content-gaps/evidence","href":"/api-reference/get-content-gap-evidence"},{"title":"Get competitive positioning data","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/competitive/position","href":"/api-reference/get-competitive-positioning-data"},{"title":"Get adoption metrics","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/adoption/metrics","href":"/api-reference/get-adoption-metrics"},{"title":"List actions for a prompt","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/actions/from-prompt","href":"/api-reference/list-actions-for-a-prompt"},{"title":"Create an action from a prompt","deprecated":null,"version":null,"openapi":"/openapi.json post /projects/{projectId}/actions/from-prompt","href":"/api-reference/create-an-action-from-a-prompt"},{"title":"List actions","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/actions/list","href":"/api-reference/list-actions"},{"title":"Update an action","deprecated":null,"version":null,"openapi":"/openapi.json patch /projects/{projectId}/actions/{actionId}","href":"/api-reference/update-an-action"},{"title":"Change an action status","deprecated":null,"version":null,"openapi":"/openapi.json post /projects/{projectId}/actions/{actionId}/status","href":"/api-reference/change-an-action-status"},{"title":"List action edits","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/actions/{actionId}/events","href":"/api-reference/list-action-edits"},{"title":"Get action content draft","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/actions/{actionId}/draft","href":"/api-reference/get-action-content-draft"},{"title":"Start an action content draft","deprecated":null,"version":null,"openapi":"/openapi.json post /projects/{projectId}/actions/{actionId}/draft","href":"/api-reference/start-an-action-content-draft"},{"title":"Get action brief","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/actions/{actionId}/brief","href":"/api-reference/get-action-brief"},{"title":"Generate action brief","deprecated":null,"version":null,"openapi":"/openapi.json post /projects/{projectId}/actions/{actionId}/brief","href":"/api-reference/generate-action-brief"},{"title":"Get code-mode operation receipts","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/code-mode/executions/{executionId}","href":"/api-reference/get-code-mode-operation-receipts"},{"title":"Discover the authorized project","deprecated":null,"version":null,"openapi":"/openapi.json get /connection","href":"/api-reference/discover-the-authorized-project"},{"title":"Get the connection context","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/connection","href":"/api-reference/get-the-connection-context"},{"title":"Get project status and usage","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/usage","href":"/api-reference/get-project-status-and-usage"},{"title":"Get traffic summary","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/traffic/summary","href":"/api-reference/get-traffic-summary"},{"title":"Get search rollup totals","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/traffic/search-rollups","href":"/api-reference/get-search-rollup-totals"},{"title":"Get traffic by platform","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/traffic/platforms","href":"/api-reference/get-traffic-by-platform"},{"title":"Get what-works recommendations","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/intelligence/what-works","href":"/api-reference/get-what-works-recommendations"},{"title":"List Library items","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/library","href":"/api-reference/list-library-items"},{"title":"Upload a text document to the Library","deprecated":null,"version":null,"openapi":"/openapi.json post /projects/{projectId}/library","href":"/api-reference/upload-a-text-document-to-the-library"},{"title":"Hybrid-search Library items","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/library/search","href":"/api-reference/hybrid-search-library-items"},{"title":"Read a Library item","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/library/{itemId}","href":"/api-reference/read-a-library-item"},{"title":"Update Library grounding availability or version link","deprecated":null,"version":null,"openapi":"/openapi.json patch /projects/{projectId}/library/{itemId}","href":"/api-reference/update-library-grounding-availability-or-version-link"},{"title":"Read the Knowledge Profile and proposal queue","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/knowledge","href":"/api-reference/read-the-knowledge-profile-and-proposal-queue"},{"title":"Update one Knowledge Profile field","deprecated":null,"version":null,"openapi":"/openapi.json patch /projects/{projectId}/knowledge","href":"/api-reference/update-one-knowledge-profile-field"},{"title":"Review a Knowledge Profile proposal","deprecated":null,"version":null,"openapi":"/openapi.json post /projects/{projectId}/knowledge/proposals/{proposalId}","href":"/api-reference/review-a-knowledge-profile-proposal"},{"title":"List webhook subscriptions","deprecated":null,"version":null,"openapi":"/openapi.json get /projects/{projectId}/webhooks","href":"/api-reference/list-webhook-subscriptions"},{"title":"Create webhook subscription","deprecated":null,"version":null,"openapi":"/openapi.json post /projects/{projectId}/webhooks","href":"/api-reference/create-webhook-subscription"},{"title":"Delete webhook subscription","deprecated":null,"version":null,"openapi":"/openapi.json delete /projects/{projectId}/webhooks/{webhookId}","href":"/api-reference/delete-webhook-subscription"},{"title":"Rotate webhook signing secret","deprecated":null,"version":null,"openapi":"/openapi.json post /projects/{projectId}/webhooks/{webhookId}/rotate-secret","href":"/api-reference/rotate-webhook-signing-secret"}]}]}]},"title":"Save Agent Picks job - DevTune","buildId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","deploymentId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Bbp7I60D.js","utils-C3RIvJha.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DqD-vLt8.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B31Loprg.js","snippetPresets-DKpk-b8t.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Cj65AhOR.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BXtn5gcC.js","shallow-RY2b03Cp.js","getApiPlaygroundDisplay-B0jeiPk3.js","CodeSnippet-CYgBjjwn.js","CodeSnippets-DOngDrYB.js","Page-n7I5XbKb.js","getPastedJson-DRQbJx-T.js","icon-CQiQCicY.js","MethodPill-BKTLdNtu.js","DuplicateIcon-B9jpAdat.js","createIcon-DCddRrXv.js","DynamicMarkdown-a8hUKrw6.js","SectionHeading-eECVV2eH.js","axios-vUo_bRtp.js","Markdown--GF7ZIpf.js","clsx-DZLdJUrt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-2LoAhjKH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Zwc0ZncM.js"]}