---
title: "Comment on a detail"
method: POST
path: "/details/{detailId}/comments"
tags: ["Comments"]
---

# Comment on a detail

`POST /details/{detailId}/comments`

## Request

- Base URL: `https://api.teamo360.com/api/v1`
- URL: `https://api.teamo360.com/api/v1/details/{detailId}/comments`
- Auth: HTTP bearer

Plain-text body (may be empty when attachments are sent). Attachments: `attachments` is a list of public https URLs the server fetches and stores (SSRF-guarded, up to 10, at most 20 MB each because the fetch is buffered, and within the storage quota); larger files go through the upload flow: `attachment_ids` are ids returned by /files/commit for uploads started with type `comment_attachment` (up to the plan file-size ceiling, 500 MB). Responses include `attachments[]` and `editedAt`.

Requires the `data:write` token scope.

## Path parameters

- `detailId` string, required

## Request body

- object

## Response `200`

Success

## Other responses

- `400`: Malformed parameters or body
- `401`: Missing, invalid, expired, or legacy token
- `403`: Blocked by role, token scope, module grant, or org policy
- `404`: Entity missing or outside the principal’s access
- `429`: Rate limit exceeded - see Retry-After

---

[API](https://skmtc.dev/teamo360/apis/teamo-public-api.md) · [All operations](https://skmtc.dev/teamo360/apis/teamo-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/teamo360/apis/teamo-public-api/revisions/32528ecbc4f4?raw)