# The comment object

## Attributes

- `object` (string, required):
- `id` (string, required): Id of the comment (for comment_ids).
- `revision` (integer, required): Revision of the film the comment belongs to.
- `at_s` (number, required): Time in the film in seconds, without the brand intro.
- `x` (nullable number, required): Horizontal position in the picture (0 = left, 1 = right), if given.
- `y` (nullable number, required): Vertical position in the picture (0 = top, 1 = bottom), if given.
- `scene` (nullable integer, required): Number of the scene at at_s, if known.
- `message` (string, required): Text of the comment.
- `author` (nullable object, required): Who wrote the comment: a user in mint or an API access of your company (name = name of the access, email = null). Personal data.
  - `kind` (enum, required): user: a mint user; api: an API access of your company. Values: `user`, `api`.
  - `name` (nullable string, required): Name of the user, or the name of the API access.
  - `email` (nullable string, required): E-mail address of the user (lower case), if known; always null for api.
- `status` (enum, required): open; in_progress while a new revision is being created from it; applied or not_applied afterwards; resolved if marked as done in mint. New values may be added within v1. Values: `open`, `in_progress`, `applied`, `not_applied`, `resolved`.
- `result` (nullable object, required): Outcome of applying the comment (null until it was applied).
  - `revision` (nullable integer): Revision that applied the comment.
  - `summary` (nullable string): What mint changed (text from mint, may be German).
  - `reason` (nullable string): Why mint did not apply it, if so (text from mint, may be German).
- `attachments` (array of objects, required):
  - `upload_id` (nullable string, required): Upload the attachment came from, if it was added through the API (POST /uploads); null for attachments added in mint.
  - `media_id` (string, required): Id of the attachment in the mint project (the same file always has the same id).
- `created_at` (string (date-time), required): Creation time (UTC).
- `updated_at` (string (date-time), required): Last change (UTC).

## Example

```json
{
  "object": "comment",
  "id": "cmt_9QwX2rLm7Tz",
  "revision": 2,
  "at_s": 42.5,
  "x": 0.62,
  "y": 0.31,
  "scene": 5,
  "message": "The chart should show 2026, not 2025.",
  "author": {
    "kind": "api",
    "name": "Learning platform",
    "email": null
  },
  "status": "open",
  "result": null,
  "attachments": [
    {
      "upload_id": "upl_3f9a1c7e5b2d4a6c8e0f1a3b5c7d9e1f",
      "media_id": "md_77120"
    }
  ],
  "created_at": "2026-11-11T15:02:19Z",
  "updated_at": "2026-11-11T15:02:19Z"
}
```