Checking authentication...

Comments

Manage comments on records

4 tools

Create Record Comment

Write

POST /v1/tools/tape/createRecordComment

Add a comment to a Tape record. Use silent: true to suppress notifications to record followers. Use hook: false to prevent webhook triggers. File attachments can be included by passing file_ids (upload files first).

Parameters

Name	Type	Required	Description
`record_id`	number	required	The record ID to comment on (from getRecord, filterRecords, etc.).
`value`	string	required	Comment text content.
`file_ids`	array	optional	Optional array of file IDs to attach to the comment (upload first).
`silent`	boolean	optional	If true, no notifications sent to record followers (default: false).
`hook`	boolean	optional	If false, webhooks will not be triggered (default: true).

Request

curl -X POST https://api.syncello.io/v1/tools/tape/createRecordComment \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "record_id": "123",
  "value": "example"
}'

Response

{
  "comment_id": 611002200,
  "created_on": "2026-07-01 15:20:00",
  "files": [],
  "ref": {
    "type": "record",
    "id": 314159001
  },
  "value": "Sent the signed quote to the client. Awaiting countersignature.",
  "user": {
    "mail": [
      "jane@example.com"
    ],
    "user_id": 4820193,
    "org_id": 44001,
    "name": "Jordan Lee",
    "type": "user"
  },
  "created_by": {
    "mail": [
      "jane@example.com"
    ],
    "user_id": 4820193,
    "org_id": 44001,
    "name": "Jordan Lee",
    "type": "user"
  }
}

Try It

Try it

Get Record Comment

Read Idempotent

POST /v1/tools/tape/getRecordComment

Get details of a specific Tape comment by comment_id, including author, content, timestamps, and attachments. Use tape_listRecordComments first to find comment_ids.

Parameters

Name	Type	Required	Description
`comment_id`	number	required	The comment ID to retrieve (from listRecordComments).

Request

curl -X POST https://api.syncello.io/v1/tools/tape/getRecordComment \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "comment_id": "123"
}'

Response

{
  "comment_id": 611002200,
  "created_on": "2026-07-01 15:20:00",
  "files": [],
  "ref": {
    "type": "record",
    "id": 314159001
  },
  "value": "Sent the signed quote to the client. Awaiting countersignature.",
  "user": {
    "mail": [
      "jane@example.com"
    ],
    "user_id": 4820193,
    "org_id": 44001,
    "name": "Jordan Lee",
    "type": "user"
  },
  "created_by": {
    "mail": [
      "jane@example.com"
    ],
    "user_id": 4820193,
    "org_id": 44001,
    "name": "Jordan Lee",
    "type": "user"
  }
}

Try It

Try it

List Record Comments

Read Idempotent

POST /v1/tools/tape/listRecordComments

List all comments on a Tape record with pagination. Returns comments with author info, timestamps, and content. Use cursor from the response for pagination to get more comments.

Parameters

Name	Type	Required	Description
`record_id`	number	required	The record ID to list comments for (from getRecord, filterRecords, etc.).
`limit`	number	optional	Max comments to return (default 30). Use with cursor for pagination.
`cursor`	string	optional	Pagination cursor from previous response for next page.

Request

curl -X POST https://api.syncello.io/v1/tools/tape/listRecordComments \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "record_id": "123"
}'

Response

{
  "cursor": "eyJhbGciOiJIUzI1NiJ9.eyJpZCI6NjExMDAyMjAwfQ",
  "comments": [
    {
      "comment_id": 611002200,
      "created_on": "2026-07-01 15:20:00",
      "files": [],
      "ref": {
        "type": "record",
        "id": 314159001
      },
      "value": "Sent the signed quote to the client. Awaiting countersignature.",
      "user": {
        "mail": [
          "jane@example.com"
        ],
        "user_id": 4820193,
        "org_id": 44001,
        "name": "Jordan Lee",
        "type": "user"
      },
      "created_by": {
        "mail": [
          "jane@example.com"
        ],
        "user_id": 4820193,
        "org_id": 44001,
        "name": "Jordan Lee",
        "type": "user"
      }
    }
  ],
  "total": 1
}

Try It

Try it

Delete Record Comment

Destructive

POST /v1/tools/tape/deleteRecordComment

Permanently delete a comment from a Tape record. This action CANNOT be undone. Use tape_listRecordComments first to verify the correct comment_id.

Parameters

Name	Type	Required	Description
`comment_id`	number	required	The comment ID to delete (from listRecordComments).
`silent`	boolean	optional	If true, no notifications sent (default: false).
`hook`	boolean	optional	If false, webhooks will not be triggered (default: true).

Request

curl -X POST https://api.syncello.io/v1/tools/tape/deleteRecordComment \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "comment_id": "123"
}'

Response

{}