---
title: "Add Asset Comment"
method: POST
path: "/asset/{asset_id}/comments"
tags: ["accepts-api-key"]
---

# Add Asset Comment

`POST /asset/{asset_id}/comments`

## Request

- Base URL: `https://api.tellers.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tellers.ai/asset/{asset_id}/comments`
- Auth: none declared

Add a comment to an asset. Needs READ on the asset.

## Path parameters

- `asset_id` string, uuid, required

## Headers

- `x-api-key` string, nullable
- `authorization` string, nullable

## Request body

- AssetCommentCreateRequest
  - `text` string, required
  - `timecode_seconds` number, nullable

## Response `201`

Successful Response

- AssetComment: One comment on an asset.
  - `id` string, required
  - `author_id` string, required: The author's user id.
  - `author_email` string, nullable: The author's email; null once their account is gone.
  - `text` string, required
  - `created_at` string, required: ISO 8601, UTC.
  - `updated_at` string, nullable: ISO 8601, UTC; null until the author edits it.
  - `timecode_seconds` number, nullable: Where in the media the comment points, if anywhere.
  - `is_mine` boolean, required: Whether the caller wrote it.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tellers/apis/tellers-api.md) - [All operations](https://skmtc.dev/tellers/apis/tellers-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tellers/apis/tellers-api/revisions/fdaa0fa44a26?raw)