> ## Documentation Index > Fetch the complete documentation index at: https://docs.devtune.ai/llms.txt > Use this file to discover all available pages before exploring further. # Save Agent Picks job > 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. ## OpenAPI ````yaml /openapi.json put /projects/{projectId}/agent-picks/job openapi: 3.1.0 info: title: DevTune API version: 2.0.0 description: >- API for programmatic access to your AI visibility data, webhook subscriptions, and automation workflows. Use this API to integrate DevTune data into CI/CD pipelines, BI tools, AI agents, and operational systems. servers: - url: https://devtune.ai/api/v2 description: Production security: - bearerAuth: [] paths: /projects/{projectId}/agent-picks/job: put: summary: 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. operationId: saveAgentPicksJob parameters: - name: projectId in: path required: true schema: type: string format: uuid requestBody: required: true content: application/json: schema: type: object additionalProperties: false properties: job: type: string minLength: 8 maxLength: 300 source_category_id: type: - string - 'null' format: uuid requests: type: object additionalProperties: false properties: add: type: string minLength: 8 maxLength: 300 recommend: type: string minLength: 8 maxLength: 300 hosted: type: - string - 'null' minLength: 8 maxLength: 300 required: - add - recommend building_blocks: type: object additionalProperties: true tools: type: array minItems: 1 maxItems: 7 items: type: object additionalProperties: false properties: tool_key: type: string maxLength: 63 display_name: type: string minLength: 1 maxLength: 100 brand_domain: type: - string - 'null' maxLength: 253 signals: type: object additionalProperties: true draft_id: type: - string - 'null' format: uuid required: - tool_key - display_name - signals own_tool_key: type: - string - 'null' maxLength: 63 competitor_tool_keys: type: array maxItems: 6 items: type: string maxLength: 63 environment_ids: type: array minItems: 1 maxItems: 100 items: type: string format: uuid agent_models: type: array minItems: 1 maxItems: 7 items: $ref: '#/components/schemas/AgentPicksAgentModel' required: - job - requests - building_blocks - tools - own_tool_key - environment_ids - agent_models responses: '200': description: Saved job content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/AgentPicksJobSavedData' meta: $ref: '#/components/schemas/Meta' required: - data - meta '400': $ref: '#/components/responses/BadRequestError' '401': $ref: '#/components/responses/UnauthorizedError' '403': $ref: '#/components/responses/ForbiddenError' '404': $ref: '#/components/responses/NotFoundError' '429': $ref: '#/components/responses/RateLimitExceededError' components: schemas: AgentPicksAgentModel: 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. 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. required: - agent - model AgentPicksJobSavedData: type: object required: - saved properties: saved: type: boolean enum: - true Meta: type: object properties: timestamp: type: string format: date-time projectId: type: string format: uuid Error: type: object properties: error: type: string message: type: string reason: type: string description: >- Why the request was refused, for an error with more than one cause, such as a refused content-draft start. 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. status: type: integer required: - error - message - status responses: BadRequestError: description: Bad request content: application/json: schema: $ref: '#/components/schemas/Error' UnauthorizedError: description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Error' ForbiddenError: description: Forbidden content: application/json: schema: $ref: '#/components/schemas/Error' NotFoundError: description: Not found content: application/json: schema: $ref: '#/components/schemas/Error' RateLimitExceededError: description: Rate limit exceeded headers: X-RateLimit-Limit: $ref: '#/components/headers/X-RateLimit-Limit' X-RateLimit-Remaining: $ref: '#/components/headers/X-RateLimit-Remaining' X-RateLimit-Reset: $ref: '#/components/headers/X-RateLimit-Reset' content: application/json: schema: $ref: '#/components/schemas/Error' 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 securitySchemes: 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. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.