> ## 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. # Update a tracked prompt > Changes a prompt's text, moves it to another topic in this project, or switches it on or off. Switching it on counts against the prompt allowance and returns 409 with reason prompt_limit_reached when it is full; send isActive true on its own, without promptText or topicId. Pass expectedActive to refuse the change with 409 and reason prompt_changed if the prompt was switched since you read it. A prompt or topic outside this project returns 404. Requires the prompts.write scope. ## OpenAPI ````yaml /openapi.json patch /projects/{projectId}/visibility/prompts/{promptId} 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/{promptId}: patch: summary: Update a tracked prompt description: >- Changes a prompt's text, moves it to another topic in this project, or switches it on or off. Switching it on counts against the prompt allowance and returns 409 with reason prompt_limit_reached when it is full; send isActive true on its own, without promptText or topicId. Pass expectedActive to refuse the change with 409 and reason prompt_changed if the prompt was switched since you read it. A prompt or topic outside this project returns 404. Requires the prompts.write scope. operationId: updatePrompt parameters: - name: projectId in: path required: true schema: type: string format: uuid - name: promptId in: path required: true description: A prompt id from listPrompts. schema: type: string format: uuid requestBody: required: true content: application/json: schema: type: object additionalProperties: false minProperties: 1 properties: promptText: type: string minLength: 10 maxLength: 1000 description: The exact question to track. topicId: type: string format: uuid description: Move the prompt to this topic. isActive: type: boolean description: Switch the prompt on or off. expectedActive: type: boolean description: >- Refuse the change unless the prompt is still in this on/off state. force: type: boolean default: false description: >- Track the prompt even though a highly similar one is already tracked. responses: '200': description: The updated 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.