> ## Documentation Index > Fetch the complete documentation index at: https://docs.coderabbit.ai/llms.txt > Use this file to discover all available pages before exploring further. # Replace your Plan comment text > Only the original author may replace a comment. Supply the complete text; existing serialized mention tokens in that text are retained, and removed tokens remove mentions. Uses the current plan version and sha256. Does not change the thread status or plan approval. ## OpenAPI ````yaml /openapi.json put /v1/code/tasks/{task_id}/plan/comments/{comment_id} openapi: 3.0.3 info: title: CodeRabbit API spec version: 1.0.0 servers: - url: https://api.coderabbit.ai security: - ApiKeyAuth: [] paths: /v1/code/tasks/{task_id}/plan/comments/{comment_id}: put: tags: - Coding summary: Replace your Plan comment text description: >- Only the original author may replace a comment. Supply the complete text; existing serialized mention tokens in that text are retained, and removed tokens remove mentions. Uses the current plan version and sha256. Does not change the thread status or plan approval. operationId: replace_code_task_plan_comment parameters: - name: task_id in: path required: true schema: type: string minLength: 1 maxLength: 200 - name: comment_id in: path required: true schema: type: string minLength: 1 maxLength: 200 requestBody: required: true content: application/json: schema: type: object properties: org_id: type: string minLength: 1 version: type: integer minimum: 0 maximum: 9007199254740991 exclusiveMinimum: true sha256: type: string pattern: ^[0-9a-f]{64}$ text: type: string minLength: 1 maxLength: 65536 required: - version - sha256 - text responses: '200': description: OK content: application/json: schema: type: object properties: task_id: type: string version: type: integer minimum: 0 maximum: 9007199254740991 exclusiveMinimum: true sha256: type: string revision: type: integer minimum: 0 maximum: 9007199254740991 description: Revision of the native Plan comment document. threads: type: array items: type: object properties: id: type: string status: enum: - open - resolved type: string location: type: object properties: start_offset: type: integer minimum: 0 maximum: 9007199254740991 description: >- Inclusive UTF-16 offset in the rendered Markdown text. end_offset: type: integer minimum: 0 maximum: 9007199254740991 exclusiveMinimum: true description: >- Exclusive UTF-16 offset in the rendered Markdown text. quote: type: string required: - start_offset - end_offset - quote comments: type: array items: type: object properties: id: type: string text: type: string author: type: object properties: user_id: type: string display_name: type: string handle: anyOf: - type: string - type: string nullable: true enum: - null avatar_url: anyOf: - type: string - type: string nullable: true enum: - null required: - user_id - display_name - handle - avatar_url created_at: type: string updated_at: type: string required: - id - text - author - created_at - updated_at required: - id - status - location - comments required: - task_id - version - sha256 - revision - threads '400': description: '400' content: application/json: schema: type: object properties: error: type: object properties: code: enum: - invalid_request type: string message: type: string retry_after: type: integer minimum: 0 maximum: 9007199254740991 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false '401': description: '401' content: application/json: schema: type: object properties: error: type: object properties: code: enum: - unauthenticated type: string message: type: string retry_after: type: integer minimum: 0 maximum: 9007199254740991 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false '403': description: '403' content: application/json: schema: type: object properties: error: type: object properties: code: enum: - forbidden type: string message: type: string retry_after: type: integer minimum: 0 maximum: 9007199254740991 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false '404': description: '404' content: application/json: schema: type: object properties: error: type: object properties: code: enum: - not_found type: string message: type: string retry_after: type: integer minimum: 0 maximum: 9007199254740991 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false '409': description: '409' content: application/json: schema: type: object properties: error: type: object properties: code: enum: - head_changed - conflict type: string message: type: string retry_after: type: integer minimum: 0 maximum: 9007199254740991 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false '412': description: '412' content: application/json: schema: type: object properties: error: type: object properties: code: enum: - precondition_failed type: string message: type: string retry_after: type: integer minimum: 0 maximum: 9007199254740991 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false '413': description: '413' content: application/json: schema: type: object properties: error: type: object properties: code: enum: - payload_too_large type: string message: type: string retry_after: type: integer minimum: 0 maximum: 9007199254740991 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false '429': description: '429' content: application/json: schema: type: object properties: error: type: object properties: code: enum: - rate_limit_exceeded type: string message: type: string retry_after: type: integer minimum: 0 maximum: 9007199254740991 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false '500': description: '500' content: application/json: schema: type: object properties: error: type: object properties: code: enum: - internal_error type: string message: type: string retry_after: type: integer minimum: 0 maximum: 9007199254740991 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false '503': description: '503' content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - unavailable message: type: string retry_after: type: integer minimum: 0 maximum: 9007199254740991 exclusiveMinimum: true required: - code - message additionalProperties: false required: - error additionalProperties: false components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-coderabbitai-api-key description: >- API key for authentication. You can create an API key from the CodeRabbit dashboard. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.