Comments

This API allows users to create comments associated with a specific record in a table. Comments enable collaboration and contextual communication directly within the record, allowing users to share notes and document important information related to the record.

Create a comment on a specific record

post

Create a comment on a specific record. Requires can_comment permission on the table.

Authorizations

organizationTokenbearerAuthJWT

AuthorizationstringRequired

Organization API token (tot_) — preferred authentication method. Pass the token directly without Bearer prefix.

Path parameters

tableIdstringRequired

Identifier of the table containing the record

recordIdstringRequired

Identifier of the record to comment on

Header parameters

AuthorizationstringRequired

Organization token (tot_) — preferred method, or legacy Bearer JWT token. Pass the tot_ token directly without Bearer prefix; use Bearer <jwt> for legacy JWT auth.

Example: Bearer eyJhbGciOiJub25lIn0.eyJ3b3Jrc3BhY2VJZCI6IjY0MDgxMTM1LWEyMGEtNGU4OS04OWY1LTkyM2QxMzUzMDVhNSIsImlhdCI6MTc1NjczNzU0MjgyNiwiZXhwIjoxNzU2NzQxMTQyODI2LCJjdXN0b206dGVhbUlkIjoiOWVmODYzMmEtNWM4YS00OWZkLWJkYTEtZDJkZDBkZDI2OWMwIn0.

Content-TypestringRequired

Content type of the request - application/json

Example: application/json;charset=UTF-8

Body

application/json;charset=UTF-8

contentstringRequired

Content of the comment

Responses

201

201

application/json;charset=UTF-8

400

Bad Request – invalid request parameters

application/json

401

Unauthorized – JWT token missing or invalid

application/json

403

Forbidden – insufficient permissions

application/json

404

Not Found – resource does not exist

application/json

500

Internal Server Error – unexpected server error

application/json

post

/tables/{tableId}/records/{recordId}/comments

HTTPcURLJavaScriptPython

POST /tables/{tableId}/records/{recordId}/comments HTTP/1.1
Host: api.transactionlink.io
Authorization: text
Content-Type: application/json;charset=UTF-8
Accept: */*
Content-Length: 29

{
  "content": "comment content"
}

{
  "id": "3ac88833-041a-4891-9507-c6345b8ec62f",
  "createdDateTime": "2025-09-01T14:39:02.850961Z",
  "recordId": "603b8878-708b-43c3-b2ca-7e6d3830309d",
  "content": "comment content"
}