Skip to main content
POST
/
milestones
/
{id}
/
comments
Add a comment to a milestone
curl --request POST \
  --url https://slog.ai/milestones/{id}/comments \
  --header 'Content-Type: application/json' \
  --header 'slog-api-key: <api-key>' \
  --data '
{
  "content": "We need to finalize the scope before the end of next week."
}
'
{
  "comment": {
    "id": "cmnt_01jqcomment01",
    "content": "This is blocked by the auth service migration.",
    "authorId": "user_01jquser0001",
    "author": {
      "id": "user_01jquser0001",
      "name": "Alex Johnson",
      "email": "[email protected]",
      "avatarUrl": null,
      "humanId": null
    },
    "taskId": "task_01jqabcd1111",
    "projectId": null,
    "milestoneId": null,
    "createdAt": "2026-05-10T11:00:00.000Z",
    "updatedAt": "2026-05-10T11:00:00.000Z"
  }
}

Authorizations

​
slog-api-key
string
header
required

API key obtained from the Slog dashboard or returned by the signup/invite-redeem flows. Pass as the slog-api-key header.

Path Parameters

​
id
string
required

Resource ID (UPID) or, for tasks and projects, the human-readable reference such as ENG-42.

Body

application/json
​
content
string
required

Comment body in Markdown.

Example:

"This is blocked by the auth service migration."

​
taskId
string | null

Task ID if commenting on a task.

Example:

"task_01jqabcd1111"

​
projectId
string | null

Project ID if commenting on a project.

Example:

null

​
milestoneId
string | null

Milestone ID if commenting on a milestone.

Example:

null

Response

Comment created.

​
comment
object