> ## Documentation Index
> Fetch the complete documentation index at: https://docs.grantiva.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Comments

> List and add comments on feature requests

## List comments

```
GET /api/v1/feedback/features/:featureId/comments
```

### Headers

| Header        | Required | Description             |
| ------------- | -------- | ----------------------- |
| `X-Bundle-ID` | Yes      | App bundle identifier   |
| `X-Team-ID`   | Yes      | Apple Developer Team ID |

### Response

```json theme={null}
[
  {
    "id": "uuid",
    "featureRequestId": "uuid",
    "authorType": "user",
    "body": "Great idea! I'd love this feature.",
    "createdAt": "2025-03-10T12:00:00Z"
  }
]
```

***

## Add a comment

```
POST /api/v1/feedback/features/:featureId/comments
```

### Body

```json theme={null}
{
  "authorId": "user_123",
  "body": "Great idea! I'd love this feature."
}
```

| Field             | Type     | Required | Description                                                                                                                                |
| ----------------- | -------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `authorId`        | `string` | Yes      | User or device identifier                                                                                                                  |
| `body`            | `string` | Yes      | Comment text (1–2,000 characters)                                                                                                          |
| `pushToken`       | `string` | No       | Hex APNs token — subscribes this device to the thread channel for admin-reply pushes. See [Push](/push/overview#feedback-push-integration) |
| `pushEnvironment` | `string` | No       | `sandbox` or `production`                                                                                                                  |

### Response

Returns the created comment object.