> ## 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. # Draft Agent Picks tool signals > 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. ## OpenAPI ````yaml /openapi.json post /projects/{projectId}/agent-picks/tools/draft 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/tools/draft: post: summary: 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. operationId: draftAgentPicksTool parameters: - name: projectId in: path required: true schema: type: string format: uuid requestBody: required: true content: application/json: schema: type: object additionalProperties: false properties: tool_key: type: string maxLength: 63 name: type: string minLength: 1 maxLength: 100 domain: type: - string - 'null' maxLength: 253 job: type: string minLength: 8 maxLength: 300 required: - tool_key - name - job responses: '200': description: Tool draft content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/AgentPicksToolDraftData' 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' '409': $ref: '#/components/responses/ConflictError' '429': $ref: '#/components/responses/RateLimitExceededError' components: schemas: AgentPicksToolDraftData: type: object required: - draft_id - created_at - status - tool_key - signals - sources - rejected - error - failure properties: draft_id: type: string format: uuid created_at: type: string format: date-time status: type: string enum: - drafted - failed tool_key: type: string signals: type: object additionalProperties: true description: >- packages by ecosystem, configNames, importPatterns and brandDomains, as the job save takes them. sources: type: array items: type: object required: - kind - url - ok properties: kind: type: string enum: - registry - docs url: type: string ok: type: boolean rejected: type: array items: $ref: '#/components/schemas/AgentPicksDraftRejection' error: type: - string - 'null' failure: type: - string - 'null' Meta: type: object properties: timestamp: type: string format: date-time projectId: type: string format: uuid AgentPicksDraftRejection: type: object required: - field - value - reason properties: field: type: string value: type: string reason: type: string 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.