Skip to main content
POST
/
deal-folder
/
files
/
{file}
/
comments
Add a comment to a file slot
curl --request POST \
  --url http://localhost/mogl/mogl-backend/api/deal-folder/files/{file}/comments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "comment": "Looks great — ship it!",
  "active_version_id": 11
}
'
{
  "status": "success",
  "message": "Comment added.",
  "data": {
    "id": 300,
    "deal_folder_file_id": 5,
    "user_id": 42,
    "active_version_id": 11,
    "comment": "Looks great, please tweak the intro.",
    "partner_read_at": null,
    "athlete_read_at": "2026-04-02T09:30:00Z",
    "created_at": "2026-04-01T13:00:00Z",
    "updated_at": "2026-04-01T13:00:00Z"
  }
}

Authorizations

​
Authorization
string
header
required

JWT Bearer token authentication. Use the /api/login endpoint to obtain a token.

Path Parameters

​
file
integer
required

DealFolderFile ID (slot ID).

Example:

5

Body

application/json
​
comment
string
required
Maximum string length: 2000
Example:

"Looks great — ship it!"

​
active_version_id
integer
required

ID of the file version this comment is anchored to.

Example:

11

Response

Comment added

​
status
string
Example:

"success"

​
message
string
Example:

"Comment added."

​
data
object

A comment on a Deal Folder file slot.