Comments
Comments aid conversation and collaboration around workspace datasets. Comments can be made on datasets, or other comments to form threads.
Objects
Comment
Path | JSON Type | Format | Description |
---|---|---|---|
id |
string |
Version 4 UUID | The comment ID |
message |
string |
The comment message | |
likeCount |
number |
Unsigned integer | The number of likes the comment has received |
likedByProfiles |
object[] |
Array of Member s |
The workspace members that have liked the comment |
created |
string |
ISO 8601 timestamp | Timestamp denoting when the comment was created |
lastModified |
string |
ISO 8601 timestamp | Timestamp denoting when the comment was last modified |
from |
object |
Member |
The comment author |
commentCount |
number |
Unsigned integer | The number of replies the comment has received |
datasetId |
string |
Version 4 UUID | The ID of the dataset comment subject |
parentId |
string |
Version 4 UUID | The ID of the parent comment |
{
"id" : "6cf6affb-7925-472d-b96c-8e043fa25863",
"message" : "SIT-generated reply Pesho [2025-08-17T19:36:09.161715] to ",
"likeCount" : 0,
"likedByProfiles" : [ ],
"created" : "2025-08-17T18:36:09.192189",
"lastModified" : "2025-08-17T18:36:09.192189",
"from" : {
"id" : "auth0|5eb0327cbfd7490bff55feeb",
"name" : "[email protected]",
"handle" : "@sit+prod"
},
"commentCount" : 0,
"datasetId" : "b2d661c4-f02a-4d8f-a5d5-5222806b3116",
"_links" : {
"update comment" : {
"href" : "https://app.matatika.com/api/datasets/b2d661c4-f02a-4d8f-a5d5-5222806b3116/comments/6cf6affb-7925-472d-b96c-8e043fa25863",
"type" : "PUT"
},
"delete comment" : {
"href" : "https://app.matatika.com/api/comments/6cf6affb-7925-472d-b96c-8e043fa25863",
"type" : "DELETE"
},
"self" : {
"href" : "https://app.matatika.com/api/comments/6cf6affb-7925-472d-b96c-8e043fa25863"
},
"add like" : {
"href" : "https://app.matatika.com/api/comments/6cf6affb-7925-472d-b96c-8e043fa25863/like",
"type" : "PUT"
},
"new reply" : {
"href" : "https://app.matatika.com/api/comments/6cf6affb-7925-472d-b96c-8e043fa25863",
"type" : "POST"
}
}
}
Requests
- View all comments on a dataset
- View a comment
- View the edit history of a comment
- View all replies to a comment
- Initialise a comment on a dataset
- Initialise a reply to a comment
- Create a comment
- Update a comment
- Record a like of a comment
- Remove a like from a comment
- Delete a comment
View all comments on a dataset
GET
/api/datasets/{dataset-id}/comments
Returns all comments on the dataset {dataset-id}
.
Prerequisites
- Dataset
{dataset-id}
must exist
Request
Example Snippets
cURL
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/datasets/b2d661c4-f02a-4d8f-a5d5-5222806b3116/comments' -i -X GET \
-H 'Accept: application/json, application/javascript, text/javascript, text/json'
Python (requests
)
import requests
url = "https://app.matatika.com/api/datasets/b2d661c4-f02a-4d8f-a5d5-5222806b3116/comments"
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("GET", url, headers=headers)
print(response.text.encode('utf8'))
Response
200 OK
Comment collection with HAL links.
{
"_embedded" : {
"datasetComments" : [ {
"id" : "ca4bdcb6-5612-45f5-bed4-a7b29fbfb563",
"message" : "SIT-generated reply Pesho [2025-08-17T19:36:08.422780] to ",
"likeCount" : 0,
"likedByProfiles" : [ ],
"created" : "2025-08-17T18:36:08.457046",
"lastModified" : "2025-08-17T18:36:08.457046",
"from" : {
"id" : "auth0|5eb0327cbfd7490bff55feeb",
"name" : "[email protected]",
"handle" : "@sit+prod"
},
"commentCount" : 0,
"datasetId" : "b2d661c4-f02a-4d8f-a5d5-5222806b3116",
"_links" : {
"update comment" : {
"href" : "https://app.matatika.com/api/datasets/b2d661c4-f02a-4d8f-a5d5-5222806b3116/comments/ca4bdcb6-5612-45f5-bed4-a7b29fbfb563",
"type" : "PUT"
},
"delete comment" : {
"href" : "https://app.matatika.com/api/comments/ca4bdcb6-5612-45f5-bed4-a7b29fbfb563",
"type" : "DELETE"
},
"self" : {
"href" : "https://app.matatika.com/api/comments/ca4bdcb6-5612-45f5-bed4-a7b29fbfb563"
},
"add like" : {
"href" : "https://app.matatika.com/api/comments/ca4bdcb6-5612-45f5-bed4-a7b29fbfb563/like",
"type" : "PUT"
},
"new reply" : {
"href" : "https://app.matatika.com/api/comments/ca4bdcb6-5612-45f5-bed4-a7b29fbfb563",
"type" : "POST"
}
}
}, {
"id" : "27912388-e600-4e38-bd19-184c3df20638",
"message" : "SIT-generated reply Pesho [2025-08-17T19:36:08.323437] to ",
"likeCount" : 0,
"likedByProfiles" : [ ],
"created" : "2025-08-17T18:36:08.360363",
"lastModified" : "2025-08-17T18:36:08.360363",
"from" : {
"id" : "auth0|5eb0327cbfd7490bff55feeb",
"name" : "[email protected]",
"handle" : "@sit+prod"
},
"commentCount" : 0,
"datasetId" : "b2d661c4-f02a-4d8f-a5d5-5222806b3116",
"_links" : {
"update comment" : {
"href" : "https://app.matatika.com/api/datasets/b2d661c4-f02a-4d8f-a5d5-5222806b3116/comments/27912388-e600-4e38-bd19-184c3df20638",
"type" : "PUT"
},
"delete comment" : {
"href" : "https://app.matatika.com/api/comments/27912388-e600-4e38-bd19-184c3df20638",
"type" : "DELETE"
},
"self" : {
"href" : "https://app.matatika.com/api/comments/27912388-e600-4e38-bd19-184c3df20638"
},
"add like" : {
"href" : "https://app.matatika.com/api/comments/27912388-e600-4e38-bd19-184c3df20638/like",
"type" : "PUT"
},
"new reply" : {
"href" : "https://app.matatika.com/api/comments/27912388-e600-4e38-bd19-184c3df20638",
"type" : "POST"
}
}
}, {
"id" : "8867344a-8ddb-4019-adc4-781ba297d3d2",
"message" : "SIT-generated reply Pesho [2025-08-17T19:36:08.223331] to ",
"likeCount" : 0,
"likedByProfiles" : [ ],
"created" : "2025-08-17T18:36:08.255358",
"lastModified" : "2025-08-17T18:36:08.255358",
"from" : {
"id" : "auth0|5eb0327cbfd7490bff55feeb",
"name" : "[email protected]",
"handle" : "@sit+prod"
},
"commentCount" : 0,
"datasetId" : "b2d661c4-f02a-4d8f-a5d5-5222806b3116",
"_links" : {
"update comment" : {
"href" : "https://app.matatika.com/api/datasets/b2d661c4-f02a-4d8f-a5d5-5222806b3116/comments/8867344a-8ddb-4019-adc4-781ba297d3d2",
"type" : "PUT"
},
"delete comment" : {
"href" : "https://app.matatika.com/api/comments/8867344a-8ddb-4019-adc4-781ba297d3d2",
"type" : "DELETE"
},
"self" : {
"href" : "https://app.matatika.com/api/comments/8867344a-8ddb-4019-adc4-781ba297d3d2"
},
"add like" : {
"href" : "https://app.matatika.com/api/comments/8867344a-8ddb-4019-adc4-781ba297d3d2/like",
"type" : "PUT"
},
"new reply" : {
"href" : "https://app.matatika.com/api/comments/8867344a-8ddb-4019-adc4-781ba297d3d2",
"type" : "POST"
}
}
}, {
"id" : "2a44f389-57b5-4c07-9047-b7a2c4741a93",
"message" : "SIT-generated reply Pesho [2025-08-17T19:36:07.044465] to ",
"likeCount" : 0,
"likedByProfiles" : [ ],
"created" : "2025-08-17T18:36:07.109646",
"lastModified" : "2025-08-17T18:36:07.109647",
"from" : {
"id" : "auth0|5eb0327cbfd7490bff55feeb",
"name" : "[email protected]",
"handle" : "@sit+prod"
},
"commentCount" : 3,
"datasetId" : "b2d661c4-f02a-4d8f-a5d5-5222806b3116",
"_links" : {
"comments" : {
"href" : "https://app.matatika.com/api/datasets/b2d661c4-f02a-4d8f-a5d5-5222806b3116/comments?parentId=2a44f389-57b5-4c07-9047-b7a2c4741a93",
"type" : "GET"
},
"edit-history" : {
"href" : "https://app.matatika.com/api/comments/2a44f389-57b5-4c07-9047-b7a2c4741a93/history",
"type" : "GET"
},
"update comment" : {
"href" : "https://app.matatika.com/api/datasets/b2d661c4-f02a-4d8f-a5d5-5222806b3116/comments/2a44f389-57b5-4c07-9047-b7a2c4741a93",
"type" : "PUT"
},
"delete comment" : {
"href" : "https://app.matatika.com/api/comments/2a44f389-57b5-4c07-9047-b7a2c4741a93",
"type" : "DELETE"
},
"self" : {
"href" : "https://app.matatika.com/api/comments/2a44f389-57b5-4c07-9047-b7a2c4741a93"
},
"add like" : {
"href" : "https://app.matatika.com/api/comments/2a44f389-57b5-4c07-9047-b7a2c4741a93/like",
"type" : "PUT"
},
"new reply" : {
"href" : "https://app.matatika.com/api/comments/2a44f389-57b5-4c07-9047-b7a2c4741a93",
"type" : "POST"
}
}
} ]
},
"_links" : {
"self" : {
"href" : "https://app.matatika.com/api/datasets/b2d661c4-f02a-4d8f-a5d5-5222806b3116/comments?page=0&size=20"
}
},
"page" : {
"size" : 20,
"totalElements" : 4,
"totalPages" : 1,
"number" : 0
}
}
View a comment
GET
/api/comments/{comment-id}
Returns the comment {comment-id}
.
Prerequisites
- Comment
{comment-id}
must exist
Request
Example Snippets
cURL
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/comments/6cf6affb-7925-472d-b96c-8e043fa25863' -i -X GET \
-H 'Accept: application/json, application/javascript, text/javascript, text/json'
Python (requests
)
import requests
url = "https://app.matatika.com/api/comments/6cf6affb-7925-472d-b96c-8e043fa25863"
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("GET", url, headers=headers)
print(response.text.encode('utf8'))
Response
200 OK
Comment with HAL links.
{
"id" : "6cf6affb-7925-472d-b96c-8e043fa25863",
"message" : "SIT-generated reply Pesho [2025-08-17T19:36:09.161715] to ",
"likeCount" : 0,
"likedByProfiles" : [ ],
"created" : "2025-08-17T18:36:09.192189",
"lastModified" : "2025-08-17T18:36:09.192189",
"from" : {
"id" : "auth0|5eb0327cbfd7490bff55feeb",
"name" : "[email protected]",
"handle" : "@sit+prod"
},
"commentCount" : 0,
"datasetId" : "b2d661c4-f02a-4d8f-a5d5-5222806b3116",
"_links" : {
"update comment" : {
"href" : "https://app.matatika.com/api/datasets/b2d661c4-f02a-4d8f-a5d5-5222806b3116/comments/6cf6affb-7925-472d-b96c-8e043fa25863",
"type" : "PUT"
},
"delete comment" : {
"href" : "https://app.matatika.com/api/comments/6cf6affb-7925-472d-b96c-8e043fa25863",
"type" : "DELETE"
},
"self" : {
"href" : "https://app.matatika.com/api/comments/6cf6affb-7925-472d-b96c-8e043fa25863"
},
"add like" : {
"href" : "https://app.matatika.com/api/comments/6cf6affb-7925-472d-b96c-8e043fa25863/like",
"type" : "PUT"
},
"new reply" : {
"href" : "https://app.matatika.com/api/comments/6cf6affb-7925-472d-b96c-8e043fa25863",
"type" : "POST"
}
}
}
View the edit history of a comment
GET
/api/comments/{comment-id}/history
Returns the edit history of the comment {comment-id}
.
Prerequisites
- Comment
{comment-id}
must exist
Request
Example Snippets
cURL
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/comments/6cf6affb-7925-472d-b96c-8e043fa25863/history' -i -X GET \
-H 'Accept: application/json, application/javascript, text/javascript, text/json'
Python (requests
)
import requests
url = "https://app.matatika.com/api/comments/6cf6affb-7925-472d-b96c-8e043fa25863/history"
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("GET", url, headers=headers)
print(response.text.encode('utf8'))
Response
200 OK
[ {
"lastModified" : "2025-08-17T18:36:09.195",
"message" : "SIT-generated reply Pesho [2025-08-17T19:36:09.161715] to ",
"editVersion" : "318525"
}, {
"lastModified" : "2025-08-17T18:36:09.320",
"message" : "SIT-generated reply Pesho [2025-08-17T19:36:09.279403] to ",
"editVersion" : "318526"
} ]
View all replies to a comment
GET
/api/comments/{comment-id}
Returns all replies to the comment {comment-id}
.
Prerequisites
- Comment
{comment-id}
must exist
Request
Example Snippets
cURL
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/datasets/b2d661c4-f02a-4d8f-a5d5-5222806b3116/comments?parentId=2a44f389-57b5-4c07-9047-b7a2c4741a93' -i -X GET \
-H 'Accept: application/json, application/javascript, text/javascript, text/json'
Python (requests
)
import requests
url = "https://app.matatika.com/api/datasets/b2d661c4-f02a-4d8f-a5d5-5222806b3116/comments?parentId=2a44f389-57b5-4c07-9047-b7a2c4741a93"
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("GET", url, headers=headers)
print(response.text.encode('utf8'))
Response
200 OK
Comment with HAL links.
{
"_embedded" : {
"datasetComments" : [ {
"id" : "16595f81-2f1f-4b38-a085-653eae7d638a",
"message" : "SIT-generated reply Pesho [2025-08-17T19:36:07.694717] to ",
"likeCount" : 0,
"likedByProfiles" : [ ],
"created" : "2025-08-17T18:36:07.725662",
"lastModified" : "2025-08-17T18:36:07.725662",
"from" : {
"id" : "auth0|5eb0327cbfd7490bff55feeb",
"name" : "[email protected]",
"handle" : "@sit+prod"
},
"commentCount" : 0,
"datasetId" : "b2d661c4-f02a-4d8f-a5d5-5222806b3116",
"parentId" : "2a44f389-57b5-4c07-9047-b7a2c4741a93",
"_links" : {
"update comment" : {
"href" : "https://app.matatika.com/api/datasets/b2d661c4-f02a-4d8f-a5d5-5222806b3116/comments/16595f81-2f1f-4b38-a085-653eae7d638a",
"type" : "PUT"
},
"delete comment" : {
"href" : "https://app.matatika.com/api/comments/16595f81-2f1f-4b38-a085-653eae7d638a",
"type" : "DELETE"
},
"self" : {
"href" : "https://app.matatika.com/api/comments/16595f81-2f1f-4b38-a085-653eae7d638a"
},
"add like" : {
"href" : "https://app.matatika.com/api/comments/16595f81-2f1f-4b38-a085-653eae7d638a/like",
"type" : "PUT"
},
"new reply" : {
"href" : "https://app.matatika.com/api/comments/16595f81-2f1f-4b38-a085-653eae7d638a",
"type" : "POST"
}
}
}, {
"id" : "5f829713-ab72-45c8-9060-799767ea4433",
"message" : "SIT-generated reply Pesho [2025-08-17T19:36:07.598582] to ",
"likeCount" : 0,
"likedByProfiles" : [ ],
"created" : "2025-08-17T18:36:07.631589",
"lastModified" : "2025-08-17T18:36:07.631589",
"from" : {
"id" : "auth0|5eb0327cbfd7490bff55feeb",
"name" : "[email protected]",
"handle" : "@sit+prod"
},
"commentCount" : 0,
"datasetId" : "b2d661c4-f02a-4d8f-a5d5-5222806b3116",
"parentId" : "2a44f389-57b5-4c07-9047-b7a2c4741a93",
"_links" : {
"update comment" : {
"href" : "https://app.matatika.com/api/datasets/b2d661c4-f02a-4d8f-a5d5-5222806b3116/comments/5f829713-ab72-45c8-9060-799767ea4433",
"type" : "PUT"
},
"delete comment" : {
"href" : "https://app.matatika.com/api/comments/5f829713-ab72-45c8-9060-799767ea4433",
"type" : "DELETE"
},
"self" : {
"href" : "https://app.matatika.com/api/comments/5f829713-ab72-45c8-9060-799767ea4433"
},
"add like" : {
"href" : "https://app.matatika.com/api/comments/5f829713-ab72-45c8-9060-799767ea4433/like",
"type" : "PUT"
},
"new reply" : {
"href" : "https://app.matatika.com/api/comments/5f829713-ab72-45c8-9060-799767ea4433",
"type" : "POST"
}
}
}, {
"id" : "c5688b8f-6720-4505-afe2-e42256a3ac62",
"message" : "SIT-generated reply Pesho [2025-08-17T19:36:07.493503] to ",
"likeCount" : 0,
"likedByProfiles" : [ ],
"created" : "2025-08-17T18:36:07.536729",
"lastModified" : "2025-08-17T18:36:07.53673",
"from" : {
"id" : "auth0|5eb0327cbfd7490bff55feeb",
"name" : "[email protected]",
"handle" : "@sit+prod"
},
"commentCount" : 0,
"datasetId" : "b2d661c4-f02a-4d8f-a5d5-5222806b3116",
"parentId" : "2a44f389-57b5-4c07-9047-b7a2c4741a93",
"_links" : {
"edit-history" : {
"href" : "https://app.matatika.com/api/comments/c5688b8f-6720-4505-afe2-e42256a3ac62/history",
"type" : "GET"
},
"update comment" : {
"href" : "https://app.matatika.com/api/datasets/b2d661c4-f02a-4d8f-a5d5-5222806b3116/comments/c5688b8f-6720-4505-afe2-e42256a3ac62",
"type" : "PUT"
},
"delete comment" : {
"href" : "https://app.matatika.com/api/comments/c5688b8f-6720-4505-afe2-e42256a3ac62",
"type" : "DELETE"
},
"self" : {
"href" : "https://app.matatika.com/api/comments/c5688b8f-6720-4505-afe2-e42256a3ac62"
},
"add like" : {
"href" : "https://app.matatika.com/api/comments/c5688b8f-6720-4505-afe2-e42256a3ac62/like",
"type" : "PUT"
},
"new reply" : {
"href" : "https://app.matatika.com/api/comments/c5688b8f-6720-4505-afe2-e42256a3ac62",
"type" : "POST"
}
}
} ]
},
"_links" : {
"self" : {
"href" : "https://app.matatika.com/api/datasets/b2d661c4-f02a-4d8f-a5d5-5222806b3116/comments?parentId=2a44f389-57b5-4c07-9047-b7a2c4741a93&page=0&size=20"
}
},
"page" : {
"size" : 20,
"totalElements" : 3,
"totalPages" : 1,
"number" : 0
}
}
Initialise a comment on a dataset
POST
/api/datasets/{dataset-id}/comments
Initialises a new comment on the dataset {dataset-id}
.
Prerequisites
- Dataset
{dataset-id}
must exist
Request
Example Snippets
cURL
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/datasets/b2d661c4-f02a-4d8f-a5d5-5222806b3116/comments' -i -X POST \
-H 'Accept: application/json, application/javascript, text/javascript, text/json' \
-H 'Content-Type: application/json'
Python (requests
)
import requests
url = "https://app.matatika.com/api/datasets/b2d661c4-f02a-4d8f-a5d5-5222806b3116/comments"
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("POST", url, headers=headers)
print(response.text.encode('utf8'))
Response
200 OK
Comment with HAL links.
{
"id" : "ee86706f-0dc2-459f-9375-b097a5b98285",
"likeCount" : 0,
"likedByProfiles" : [ ],
"created" : "2025-08-17T18:36:09.009053198",
"lastModified" : "2025-08-17T18:36:09.009053498",
"from" : {
"id" : "auth0|5eb0327cbfd7490bff55feeb",
"name" : "[email protected]",
"handle" : "@sit+prod"
},
"commentCount" : 0,
"datasetId" : "b2d661c4-f02a-4d8f-a5d5-5222806b3116",
"_links" : {
"create comment" : {
"href" : "https://app.matatika.com/api/datasets/b2d661c4-f02a-4d8f-a5d5-5222806b3116/comments/ee86706f-0dc2-459f-9375-b097a5b98285",
"type" : "PUT"
}
}
}
Initialise a reply to a comment
POST
/api/comments/{comment-id}
Initialises a new reply comment to the comment {comment-id}
.
Prerequisites
- Comment
{comment-id}
must exist
Request
Example Snippets
cURL
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/comments/2a44f389-57b5-4c07-9047-b7a2c4741a93' -i -X POST \
-H 'Accept: application/json, application/javascript, text/javascript, text/json' \
-H 'Content-Type: application/json'
Python (requests
)
import requests
url = "https://app.matatika.com/api/comments/2a44f389-57b5-4c07-9047-b7a2c4741a93"
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("POST", url, headers=headers)
print(response.text.encode('utf8'))
Response
200 OK
Comment with HAL links.
{
"id" : "5da44344-d767-4299-901c-0829540782f1",
"likeCount" : 0,
"likedByProfiles" : [ ],
"created" : "2025-08-17T18:36:08.696943809",
"lastModified" : "2025-08-17T18:36:08.696944009",
"from" : {
"id" : "auth0|5eb0327cbfd7490bff55feeb",
"name" : "[email protected]",
"handle" : "@sit+prod"
},
"commentCount" : 0,
"datasetId" : "b2d661c4-f02a-4d8f-a5d5-5222806b3116",
"parentId" : "2a44f389-57b5-4c07-9047-b7a2c4741a93",
"_links" : {
"create comment" : {
"href" : "https://app.matatika.com/api/datasets/b2d661c4-f02a-4d8f-a5d5-5222806b3116/comments/5da44344-d767-4299-901c-0829540782f1",
"type" : "PUT"
}
}
}
Create a comment
PUT
/api/comments/{comment-id}
Creates the comment {comment-id}
.
Prerequisites
- The comment must have been initialised in order to create it
- The target dataset
{dataset-id}
or comment{comment-id}
must exist
Request
Body
Comment resource.
{
"message" : "SIT-generated reply Pesho [2025-08-17T19:36:08.535150] to ",
"datasetId" : "b2d661c4-f02a-4d8f-a5d5-5222806b3116"
}
Example Snippets
cURL
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/datasets/b2d661c4-f02a-4d8f-a5d5-5222806b3116/comments/3e10fc70-2e2c-49a0-94a6-4dac3b1cd404' -i -X PUT \
-H 'Accept: application/json, application/javascript, text/javascript, text/json' \
-H 'Content-Type: application/json' \
-d '{
"message" : "SIT-generated reply Pesho [2025-08-17T19:36:08.535150] to ",
"datasetId" : "b2d661c4-f02a-4d8f-a5d5-5222806b3116"
}'
Python (requests
)
import requests
url = "https://app.matatika.com/api/datasets/b2d661c4-f02a-4d8f-a5d5-5222806b3116/comments/3e10fc70-2e2c-49a0-94a6-4dac3b1cd404"
data = {
"message" : "SIT-generated reply Pesho [2025-08-17T19:36:08.535150] to ",
"datasetId" : "b2d661c4-f02a-4d8f-a5d5-5222806b3116"
}
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("PUT", url, headers=headers, data=data)
print(response.text.encode('utf8'))
Response
201 Created
Comment with HAL links.
{
"id" : "3e10fc70-2e2c-49a0-94a6-4dac3b1cd404",
"message" : "SIT-generated reply Pesho [2025-08-17T19:36:08.535150] to ",
"likeCount" : 0,
"likedByProfiles" : [ ],
"created" : "2025-08-17T18:36:08.621677743",
"lastModified" : "2025-08-17T18:36:08.621677943",
"from" : {
"id" : "auth0|5eb0327cbfd7490bff55feeb",
"name" : "[email protected]",
"handle" : "@sit+prod"
},
"commentCount" : 0,
"datasetId" : "b2d661c4-f02a-4d8f-a5d5-5222806b3116",
"_links" : {
"edit-history" : {
"href" : "https://app.matatika.com/api/comments/3e10fc70-2e2c-49a0-94a6-4dac3b1cd404/history",
"type" : "GET"
},
"update comment" : {
"href" : "https://app.matatika.com/api/datasets/b2d661c4-f02a-4d8f-a5d5-5222806b3116/comments/3e10fc70-2e2c-49a0-94a6-4dac3b1cd404",
"type" : "PUT"
},
"delete comment" : {
"href" : "https://app.matatika.com/api/comments/3e10fc70-2e2c-49a0-94a6-4dac3b1cd404",
"type" : "DELETE"
},
"self" : {
"href" : "https://app.matatika.com/api/comments/3e10fc70-2e2c-49a0-94a6-4dac3b1cd404"
},
"add like" : {
"href" : "https://app.matatika.com/api/comments/3e10fc70-2e2c-49a0-94a6-4dac3b1cd404/like",
"type" : "PUT"
},
"new reply" : {
"href" : "https://app.matatika.com/api/comments/3e10fc70-2e2c-49a0-94a6-4dac3b1cd404",
"type" : "POST"
}
}
}
Update a comment
PUT
/api/comments/{comment-id}
Updates the comment {comment-id}
.
Prerequisites
- Comment
{comment-id}
must exist
Request
Body
Comment resource.
{
"message" : "SIT-generated reply Pesho [2025-08-17T19:36:09.034898] to "
}
Example Snippets
cURL
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/comments/6cf6affb-7925-472d-b96c-8e043fa25863' -i -X GET \
-H 'Accept: application/json, application/javascript, text/javascript, text/json'
Python (requests
)
import requests
url = "https://app.matatika.com/api/comments/6cf6affb-7925-472d-b96c-8e043fa25863"
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("GET", url, headers=headers)
print(response.text.encode('utf8'))
Response
200 OK
Comment with HAL links.
{
"id" : "6cf6affb-7925-472d-b96c-8e043fa25863",
"message" : "SIT-generated reply Pesho [2025-08-17T19:36:09.161715] to ",
"likeCount" : 0,
"likedByProfiles" : [ ],
"created" : "2025-08-17T18:36:09.192189",
"lastModified" : "2025-08-17T18:36:09.192189",
"from" : {
"id" : "auth0|5eb0327cbfd7490bff55feeb",
"name" : "[email protected]",
"handle" : "@sit+prod"
},
"commentCount" : 0,
"datasetId" : "b2d661c4-f02a-4d8f-a5d5-5222806b3116",
"_links" : {
"update comment" : {
"href" : "https://app.matatika.com/api/datasets/b2d661c4-f02a-4d8f-a5d5-5222806b3116/comments/6cf6affb-7925-472d-b96c-8e043fa25863",
"type" : "PUT"
},
"delete comment" : {
"href" : "https://app.matatika.com/api/comments/6cf6affb-7925-472d-b96c-8e043fa25863",
"type" : "DELETE"
},
"self" : {
"href" : "https://app.matatika.com/api/comments/6cf6affb-7925-472d-b96c-8e043fa25863"
},
"add like" : {
"href" : "https://app.matatika.com/api/comments/6cf6affb-7925-472d-b96c-8e043fa25863/like",
"type" : "PUT"
},
"new reply" : {
"href" : "https://app.matatika.com/api/comments/6cf6affb-7925-472d-b96c-8e043fa25863",
"type" : "POST"
}
}
}
Record a like of a comment
PUT
/api/comments/{comment-id}/like
Records a like of the comment {comment-id}
from the authenticated user profile.
Prerequisites
- Comment
{comment-id}
must exist
Request
Example Snippets
cURL
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/comments/2a44f389-57b5-4c07-9047-b7a2c4741a93/like' -i -X PUT \
-H 'Accept: application/json, application/javascript, text/javascript, text/json' \
-H 'Content-Type: application/json'
Python (requests
)
import requests
url = "https://app.matatika.com/api/comments/2a44f389-57b5-4c07-9047-b7a2c4741a93/like"
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("PUT", url, headers=headers)
print(response.text.encode('utf8'))
Response
200 OK
No response body provided.
Remove a like from a comment
DELETE
/api/comments/{comment-id}/like
Removes a like of the comment {comment-id}
from the authenticated user profile.
Prerequisites
- Comment
{comment-id}
must exist
Request
Example Snippets
cURL
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/comments/2a44f389-57b5-4c07-9047-b7a2c4741a93/like' -i -X DELETE \
-H 'Accept: application/json, application/javascript, text/javascript, text/json'
Python (requests
)
import requests
url = "https://app.matatika.com/api/comments/2a44f389-57b5-4c07-9047-b7a2c4741a93/like"
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("DELETE", url, headers=headers)
print(response.text.encode('utf8'))
Response
204 No Content
No response body provided.
Delete a comment
DELETE
/api/comments/{comment-id}
Deletes the comment {comment-id}
.
Prerequisites
- Comment
{comment-id}
must exist
Request
Example Snippets
cURL
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/comments/198da0b4-ce53-4ec3-855d-0dd0b679bc17' -i -X DELETE \
-H 'Accept: application/json, application/javascript, text/javascript, text/json'
Python (requests
)
import requests
url = "https://app.matatika.com/api/comments/198da0b4-ce53-4ec3-855d-0dd0b679bc17"
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("DELETE", url, headers=headers)
print(response.text.encode('utf8'))
Response
204 No Content
No response body provided.