# Comment on an issue

`POST /app/issues/{id}/comments`

A note of 1 to 5000 characters, under the key's or app's person.

Scope: `issues:write`.

## Parameters

- `id` (path, integer, required)

## Request body

- `body` (string): Required. The note.

## Example

```bash
curl -X POST "https://api.fortwatch.ai/app/issues/42/comments" \
  -H "Authorization: Bearer $FORTWATCH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "body": "string"
}'
```

## Response 201

Created.

- `id` (number, required)
- `body` (string, required)
- `authorName` (string, required)
- `userId` (object | null, required)
- `createdAt` (string (date-time), required)
- `editedAt` (string (date-time) | null, required)

```json
{
  "id": 42,
  "body": "string",
  "authorName": "string",
  "userId": {},
  "createdAt": "2026-10-16T12:00:00.000Z",
  "editedAt": "2026-10-16T12:00:00.000Z"
}
```

## Errors

- 400: The request is not valid: a field is missing or has the wrong shape (the message names it).
- 401: No valid credentials: the API key or access token is missing, revoked or expired (INVALID_API_KEY, INVALID_TOKEN).
- 403: Not allowed: the key or token lacks this scope (SCOPE_REQUIRED), the route is dashboard-only (SESSION_REQUIRED), or a plan limit applies.
- 404: Not found in your workspace.
- 429: Too many requests (RATE_LIMITED): wait the seconds Retry-After gives.