> ## 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 setup > Create or replace the setup for a published public category: category_id, the project’s own tool_key (or null), up to six competitor_tool_keys from the category’s tools, not including tool_key, environment_ids and the ordered agent_models to test. An id outside the published catalogue is refused with 400 invalid_setup. Pi and OpenCode need Agent Picks Pro or Enterprise: 403 agent_not_in_plan. For a custom job, save the job instead. 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/setup 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/setup: put: summary: Save Agent Picks setup description: >- Create or replace the setup for a published public category: category_id, the project’s own tool_key (or null), up to six competitor_tool_keys from the category’s tools, not including tool_key, environment_ids and the ordered agent_models to test. An id outside the published catalogue is refused with 400 invalid_setup. Pi and OpenCode need Agent Picks Pro or Enterprise: 403 agent_not_in_plan. For a custom job, save the job instead. 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: saveAgentPicksSetup parameters: - name: projectId in: path required: true schema: type: string format: uuid requestBody: required: true content: application/json: schema: type: object additionalProperties: false properties: category_id: type: string format: uuid 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: - category_id - tool_key - environment_ids - agent_models responses: '200': description: Saved setup content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/AgentPicksSetupData' 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 AgentPicksSetupData: type: object required: - category_id - tool_key - competitor_tool_keys - environment_ids - enabled_agent_models properties: category_id: type: string format: uuid tool_key: type: - string - 'null' competitor_tool_keys: type: array items: type: string environment_ids: type: array items: type: string format: uuid enabled_agent_models: type: array items: $ref: '#/components/schemas/AgentPicksAgentModel' 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.