SautiDesk
SautiDesk API
Activities

List comments on an activity

GET
/v1/desk/activities/{id}/comments

Lists the private team comments on one activity, oldest first, with each author, mentions and attachments. Customers never see comments. Page with cursor and limit (100 by default and at most).

Requires: desk.read scope, Converse licence.

Authorization

bearerAuth
AuthorizationBearer <token>

A SautiDesk API key. An owner or admin makes it under Settings in SautiDesk for a named person and picks the scopes. The key is shown once. Send it as Authorization: Bearer <key>. It acts as that person and as nobody else.

In: header

Path Parameters

id*string

The activity's id (a UUID).

Query Parameters

cursor?string

next_cursor from the previous page. Leave it out for the first page.

limit?integer

Page size: 100 by default, 100 at most.

Response

OK

Example

{  "data": [    {      "id": "3f2b8c1e-5a4d-4e7b-9c10-2d6a8e4f1b37",      "ticket_id": "b1e8bf6f-7f06-4c91-96dd-a1eb7abe504b",      "parent_activity_id": "861eb1a7-8ac3-422a-9e01-4812b7382c79",      "author_user_id": "cacbaaf9-2b98-46a1-9b0e-04f92c823408",      "author_name": "Wanjiku Mwangi",      "body": "Hi Amina, your order has shipped.",      "mentions": [        "af55b8ed-074f-478d-9661-0c5ccc54d6d5"      ],      "created_at": "2026-10-14T08:30:00Z",      "edited_at": "2026-10-14T08:30:00Z",      "attachments": [        {          "id": null,          "filename": null,          "content_type": null,          "size": null,          "url": null        }      ]    }  ],  "next_cursor": "eyJvIjoyNX0",  "has_more": false,  "read_only": false}
FieldTypeDescription
datarequiredobject[]
idrequiredstring (uuid)
ticket_idrequiredstring (uuid)The id of the ticket this is about.
parent_activity_idrequiredstring (uuid)
author_user_idrequiredstring (uuid) | null
author_namerequiredstring
bodyrequiredstringThe message text.
mentionsrequiredstring (uuid)[]The ids of the teammates to notify about the comment.
created_atrequiredstring (date-time)
edited_atrequiredstring (date-time) | null
attachmentsrequiredobject[]
idrequiredstring (uuid)
filenamerequiredstring
content_typerequiredstring
sizerequiredinteger
urlrequiredstring
next_cursorrequiredstring | null
has_morerequiredboolean
read_onlyrequiredboolean
curl -X GET "https://api.sautidesk.com/v1/desk/activities/string/comments"