> ## 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. # Create a tracked prompt > Tracks a new prompt in a topic of this project, switched on. It counts against the prompt allowance: over the allowance the request returns 409 with reason prompt_limit_reached and the allowance in the message. Text already tracked returns 409; a highly similar prompt returns 409 with reason similar_prompt unless force is true. The prompt is classified and its search volume estimated in the background. Requires the prompts.write scope. ## OpenAPI ````yaml /openapi.json post /projects/{projectId}/visibility/prompts 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}/visibility/prompts: post: summary: Create a tracked prompt description: >- Tracks a new prompt in a topic of this project, switched on. It counts against the prompt allowance: over the allowance the request returns 409 with reason prompt_limit_reached and the allowance in the message. Text already tracked returns 409; a highly similar prompt returns 409 with reason similar_prompt unless force is true. The prompt is classified and its search volume estimated in the background. Requires the prompts.write scope. operationId: createPrompt parameters: - name: projectId in: path required: true schema: type: string format: uuid requestBody: required: true content: application/json: schema: type: object additionalProperties: false required: - topicId - promptText properties: topicId: type: string format: uuid description: A topic id from listTopics. promptText: type: string minLength: 10 maxLength: 1000 description: The exact question to track. force: type: boolean default: false description: >- Track the prompt even though a highly similar one is already tracked. responses: '201': description: The tracked prompt content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/TrackedPromptWrite' 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: TrackedPromptWrite: type: object additionalProperties: false required: - prompt properties: prompt: $ref: '#/components/schemas/TrackedPromptRecord' Meta: type: object properties: timestamp: type: string format: date-time projectId: type: string format: uuid TrackedPromptRecord: type: object additionalProperties: false required: - id - promptText - topicId - isActive - disabledReason - disabledAt - deletedAt - createdAt - updatedAt properties: id: type: string format: uuid promptText: type: string description: The exact tracked question. topicId: type: string format: uuid isActive: type: boolean description: The prompt's own switch. disabledReason: type: - string - 'null' enum: - manual - plan_limit - quota_exceeded - null disabledAt: type: - string - 'null' format: date-time deletedAt: type: - string - 'null' format: date-time description: >- When the prompt was deleted; null while it is tracked. Deleted prompts keep their history and can be restored. createdAt: type: string format: date-time updatedAt: type: string format: date-time 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.