> ## Documentation Index
> Fetch the complete documentation index at: https://superdoc-caio-pizzol-docs-ai-core-preset.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# comments.get

> Retrieve a single comment thread by ID.

## Summary

Retrieve a single comment thread by ID.

* Operation ID: `comments.get`
* API member path: `editor.doc.comments.get(...)`
* Mutates document: `no`
* Idempotency: `idempotent`
* Supports tracked mode: `no`
* Supports dry run: `no`
* Deterministic target resolution: `yes`

## Expected result

Returns a CommentInfo object with the comment text, author, date, and thread metadata.

## Input fields

| Field       | Type   | Required | Description |
| ----------- | ------ | -------- | ----------- |
| `commentId` | string | yes      |             |

### Example request

```json theme={null}
{
  "commentId": "comment-001"
}
```

## Output fields

| Field                      | Type                             | Required | Description                                         |
| -------------------------- | -------------------------------- | -------- | --------------------------------------------------- |
| `address`                  | CommentAddress                   | yes      | CommentAddress                                      |
| `address.entityId`         | string                           | yes      |                                                     |
| `address.entityType`       | `"comment"`                      | yes      | Constant: `"comment"`                               |
| `address.kind`             | `"entity"`                       | yes      | Constant: `"entity"`                                |
| `anchoredText`             | string                           | no       |                                                     |
| `commentId`                | string                           | yes      |                                                     |
| `createdTime`              | number                           | no       |                                                     |
| `creatorEmail`             | string                           | no       |                                                     |
| `creatorName`              | string                           | no       |                                                     |
| `deletedText`              | string \| null                   | no       |                                                     |
| `importedId`               | string                           | no       |                                                     |
| `isInternal`               | boolean                          | no       |                                                     |
| `parentCommentId`          | string                           | no       |                                                     |
| `status`                   | enum                             | yes      | `"open"`, `"resolved"`                              |
| `target`                   | TextTarget                       | no       | TextTarget                                          |
| `target.kind`              | `"text"`                         | no       | Constant: `"text"`                                  |
| `target.segments`          | TextSegment\[]                   | no       |                                                     |
| `target.story`             | StoryLocator                     | no       | StoryLocator                                        |
| `text`                     | string                           | no       |                                                     |
| `trackedChange`            | boolean                          | no       |                                                     |
| `trackedChangeAnchorKey`   | string \| null                   | no       |                                                     |
| `trackedChangeDisplayType` | string \| null                   | no       |                                                     |
| `trackedChangeLink`        | CommentTrackedChangeLink \| null | no       | One of: CommentTrackedChangeLink, null              |
| `trackedChangeStory`       | StoryLocator \| null             | no       | One of: StoryLocator, null                          |
| `trackedChangeText`        | string \| null                   | no       |                                                     |
| `trackedChangeType`        | enum                             | no       | `"insert"`, `"delete"`, `"replacement"`, `"format"` |

### Example response

```json theme={null}
{
  "address": {
    "entityId": "entity-789",
    "entityType": "comment",
    "kind": "entity"
  },
  "commentId": "comment-001",
  "importedId": "imp-001",
  "parentCommentId": "comment-000",
  "status": "open"
}
```

## Pre-apply throws

* `TARGET_NOT_FOUND`

## Non-applied failure codes

* None

## Raw schemas

<Accordion title="Raw input schema">
  ```json theme={null}
  {
    "additionalProperties": false,
    "properties": {
      "commentId": {
        "type": "string"
      }
    },
    "required": [
      "commentId"
    ],
    "type": "object"
  }
  ```
</Accordion>

<Accordion title="Raw output schema">
  ```json theme={null}
  {
    "additionalProperties": false,
    "properties": {
      "address": {
        "$ref": "#/$defs/CommentAddress"
      },
      "anchoredText": {
        "type": "string"
      },
      "commentId": {
        "type": "string"
      },
      "createdTime": {
        "type": "number"
      },
      "creatorEmail": {
        "type": "string"
      },
      "creatorName": {
        "type": "string"
      },
      "deletedText": {
        "type": [
          "string",
          "null"
        ]
      },
      "importedId": {
        "type": "string"
      },
      "isInternal": {
        "type": "boolean"
      },
      "parentCommentId": {
        "type": "string"
      },
      "status": {
        "enum": [
          "open",
          "resolved"
        ]
      },
      "target": {
        "$ref": "#/$defs/TextTarget"
      },
      "text": {
        "type": "string"
      },
      "trackedChange": {
        "type": "boolean"
      },
      "trackedChangeAnchorKey": {
        "type": [
          "string",
          "null"
        ]
      },
      "trackedChangeDisplayType": {
        "type": [
          "string",
          "null"
        ]
      },
      "trackedChangeLink": {
        "oneOf": [
          {
            "$ref": "#/$defs/CommentTrackedChangeLink"
          },
          {
            "type": "null"
          }
        ]
      },
      "trackedChangeStory": {
        "oneOf": [
          {
            "$ref": "#/$defs/StoryLocator"
          },
          {
            "type": "null"
          }
        ]
      },
      "trackedChangeText": {
        "type": [
          "string",
          "null"
        ]
      },
      "trackedChangeType": {
        "enum": [
          "insert",
          "delete",
          "replacement",
          "format"
        ]
      }
    },
    "required": [
      "address",
      "commentId",
      "status"
    ],
    "type": "object"
  }
  ```
</Accordion>