> ## 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. # Start an Agent Picks test > Start a quoted paid test or re-test. Pass quote_token from the quote and max_credits, the most this test may reserve, in whole credits. The start re-quotes and reserves the fresh high estimate; settlement never charges more, and unused credits return when the test ends. A retry with the same quote token returns status existing and reserves nothing more. Refusals carry a reason: 400 quote_token_invalid (malformed, or quoted for another credential, project or purpose), quote_token_expired, unpriced_model (a saved model has lost its price since the quote; choose models again), and the quote refusals; 402 insufficient_credits with details.shortfall_credits; 403 forbidden, paused (DevTune support has paused the account) or agent_not_in_plan; 409 estimate_changed (the setup or baseline changed since the quote; quote again), over_max_credits, test_in_progress (another test is active), test_finished (this quote already ran to an end), test_exists or project_deleting. Each start 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. Not available in MCP code mode. A body that is not valid JSON, or an empty body, is refused with 400 bad_request and no reason. ## OpenAPI ````yaml /openapi.json post /projects/{projectId}/agent-picks/tests 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/tests: post: summary: Start an Agent Picks test description: >- Start a quoted paid test or re-test. Pass quote_token from the quote and max_credits, the most this test may reserve, in whole credits. The start re-quotes and reserves the fresh high estimate; settlement never charges more, and unused credits return when the test ends. A retry with the same quote token returns status existing and reserves nothing more. Refusals carry a reason: 400 quote_token_invalid (malformed, or quoted for another credential, project or purpose), quote_token_expired, unpriced_model (a saved model has lost its price since the quote; choose models again), and the quote refusals; 402 insufficient_credits with details.shortfall_credits; 403 forbidden, paused (DevTune support has paused the account) or agent_not_in_plan; 409 estimate_changed (the setup or baseline changed since the quote; quote again), over_max_credits, test_in_progress (another test is active), test_finished (this quote already ran to an end), test_exists or project_deleting. Each start 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. Not available in MCP code mode. A body that is not valid JSON, or an empty body, is refused with 400 bad_request and no reason. operationId: startAgentPicksTest parameters: - name: projectId in: path required: true schema: type: string format: uuid requestBody: required: true content: application/json: schema: type: object additionalProperties: false properties: quote_token: type: string maxLength: 4096 max_credits: type: integer minimum: 1 required: - quote_token - max_credits responses: '200': description: Started test content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/AgentPicksStartedTestData' meta: $ref: '#/components/schemas/Meta' required: - data - meta '400': $ref: '#/components/responses/BadRequestError' '401': $ref: '#/components/responses/UnauthorizedError' '402': description: Not enough credits; details.shortfall_credits says how many more. content: application/json: schema: $ref: '#/components/schemas/Error' '403': $ref: '#/components/responses/ForbiddenError' '404': $ref: '#/components/responses/NotFoundError' '409': $ref: '#/components/responses/ConflictError' '429': $ref: '#/components/responses/RateLimitExceededError' components: schemas: AgentPicksStartedTestData: type: object required: - status - test_id properties: status: type: string enum: - queued - existing description: >- existing when a retry with the same quote token found the test it already queued; nothing more is reserved. test_id: type: string format: uuid 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' ConflictError: description: Request conflicts with current resource state 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.