Skip to main content Link Menu Expand (external link) Document Search Copy Copied

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 Members 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" : "a6d5a36f-1128-4008-b1af-cfee0f1de45f",
  "message" : "SIT-generated reply Pesho [2025-01-30T17:04:53.889293] to ",
  "likeCount" : 0,
  "likedByProfiles" : [ ],
  "created" : "2025-01-30T17:04:53.986284",
  "lastModified" : "2025-01-30T17:04:53.986284",
  "from" : {
    "id" : "auth0|5eb0327cbfd7490bff55feeb",
    "name" : "[email protected]",
    "handle" : "@sit+prod"
  },
  "commentCount" : 0,
  "datasetId" : "925dc0b2-ac62-4d02-ad99-920b93c79554",
  "_links" : {
    "update comment" : {
      "href" : "https://app.matatika.com/api/datasets/925dc0b2-ac62-4d02-ad99-920b93c79554/comments/a6d5a36f-1128-4008-b1af-cfee0f1de45f",
      "type" : "PUT"
    },
    "delete comment" : {
      "href" : "https://app.matatika.com/api/comments/a6d5a36f-1128-4008-b1af-cfee0f1de45f",
      "type" : "DELETE"
    },
    "self" : {
      "href" : "https://app.matatika.com/api/comments/a6d5a36f-1128-4008-b1af-cfee0f1de45f"
    },
    "add like" : {
      "href" : "https://app.matatika.com/api/comments/a6d5a36f-1128-4008-b1af-cfee0f1de45f/like",
      "type" : "PUT"
    },
    "new reply" : {
      "href" : "https://app.matatika.com/api/comments/a6d5a36f-1128-4008-b1af-cfee0f1de45f",
      "type" : "POST"
    }
  }
}

Requests

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/925dc0b2-ac62-4d02-ad99-920b93c79554/comments' -i -X GET \
    -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/925dc0b2-ac62-4d02-ad99-920b93c79554/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" : "1e8ea977-a079-4a36-8654-67f2b2ff710b",
      "message" : "SIT-generated reply Pesho [2025-01-30T17:04:51.223139] to ",
      "likeCount" : 0,
      "likedByProfiles" : [ ],
      "created" : "2025-01-30T17:04:51.476009",
      "lastModified" : "2025-01-30T17:04:51.476009",
      "from" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@sit+prod"
      },
      "commentCount" : 0,
      "datasetId" : "925dc0b2-ac62-4d02-ad99-920b93c79554",
      "_links" : {
        "update comment" : {
          "href" : "https://app.matatika.com/api/datasets/925dc0b2-ac62-4d02-ad99-920b93c79554/comments/1e8ea977-a079-4a36-8654-67f2b2ff710b",
          "type" : "PUT"
        },
        "delete comment" : {
          "href" : "https://app.matatika.com/api/comments/1e8ea977-a079-4a36-8654-67f2b2ff710b",
          "type" : "DELETE"
        },
        "self" : {
          "href" : "https://app.matatika.com/api/comments/1e8ea977-a079-4a36-8654-67f2b2ff710b"
        },
        "add like" : {
          "href" : "https://app.matatika.com/api/comments/1e8ea977-a079-4a36-8654-67f2b2ff710b/like",
          "type" : "PUT"
        },
        "new reply" : {
          "href" : "https://app.matatika.com/api/comments/1e8ea977-a079-4a36-8654-67f2b2ff710b",
          "type" : "POST"
        }
      }
    }, {
      "id" : "c19676f2-64d3-4c04-b80a-98a9d8d4716e",
      "message" : "SIT-generated reply Pesho [2025-01-30T17:04:50.750478] to ",
      "likeCount" : 0,
      "likedByProfiles" : [ ],
      "created" : "2025-01-30T17:04:51.025051",
      "lastModified" : "2025-01-30T17:04:51.025052",
      "from" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@sit+prod"
      },
      "commentCount" : 0,
      "datasetId" : "925dc0b2-ac62-4d02-ad99-920b93c79554",
      "_links" : {
        "edit-history" : {
          "href" : "https://app.matatika.com/api/comments/c19676f2-64d3-4c04-b80a-98a9d8d4716e/history",
          "type" : "GET"
        },
        "update comment" : {
          "href" : "https://app.matatika.com/api/datasets/925dc0b2-ac62-4d02-ad99-920b93c79554/comments/c19676f2-64d3-4c04-b80a-98a9d8d4716e",
          "type" : "PUT"
        },
        "delete comment" : {
          "href" : "https://app.matatika.com/api/comments/c19676f2-64d3-4c04-b80a-98a9d8d4716e",
          "type" : "DELETE"
        },
        "self" : {
          "href" : "https://app.matatika.com/api/comments/c19676f2-64d3-4c04-b80a-98a9d8d4716e"
        },
        "add like" : {
          "href" : "https://app.matatika.com/api/comments/c19676f2-64d3-4c04-b80a-98a9d8d4716e/like",
          "type" : "PUT"
        },
        "new reply" : {
          "href" : "https://app.matatika.com/api/comments/c19676f2-64d3-4c04-b80a-98a9d8d4716e",
          "type" : "POST"
        }
      }
    }, {
      "id" : "f3f7f6bf-f071-43fc-9fe5-ebaebaf9a6df",
      "message" : "SIT-generated reply Pesho [2025-01-30T17:04:50.107807] to ",
      "likeCount" : 0,
      "likedByProfiles" : [ ],
      "created" : "2025-01-30T17:04:50.368817",
      "lastModified" : "2025-01-30T17:04:50.368817",
      "from" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@sit+prod"
      },
      "commentCount" : 0,
      "datasetId" : "925dc0b2-ac62-4d02-ad99-920b93c79554",
      "_links" : {
        "update comment" : {
          "href" : "https://app.matatika.com/api/datasets/925dc0b2-ac62-4d02-ad99-920b93c79554/comments/f3f7f6bf-f071-43fc-9fe5-ebaebaf9a6df",
          "type" : "PUT"
        },
        "delete comment" : {
          "href" : "https://app.matatika.com/api/comments/f3f7f6bf-f071-43fc-9fe5-ebaebaf9a6df",
          "type" : "DELETE"
        },
        "self" : {
          "href" : "https://app.matatika.com/api/comments/f3f7f6bf-f071-43fc-9fe5-ebaebaf9a6df"
        },
        "add like" : {
          "href" : "https://app.matatika.com/api/comments/f3f7f6bf-f071-43fc-9fe5-ebaebaf9a6df/like",
          "type" : "PUT"
        },
        "new reply" : {
          "href" : "https://app.matatika.com/api/comments/f3f7f6bf-f071-43fc-9fe5-ebaebaf9a6df",
          "type" : "POST"
        }
      }
    }, {
      "id" : "f5fa5f4d-3737-4e3b-8d42-69b71e235f9c",
      "message" : "SIT-generated reply Pesho [2025-01-30T17:04:45.857891] to ",
      "likeCount" : 0,
      "likedByProfiles" : [ ],
      "created" : "2025-01-30T17:04:45.952841",
      "lastModified" : "2025-01-30T17:04:45.952842",
      "from" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@sit+prod"
      },
      "commentCount" : 3,
      "datasetId" : "925dc0b2-ac62-4d02-ad99-920b93c79554",
      "_links" : {
        "comments" : {
          "href" : "https://app.matatika.com/api/datasets/925dc0b2-ac62-4d02-ad99-920b93c79554/comments?parentId=f5fa5f4d-3737-4e3b-8d42-69b71e235f9c",
          "type" : "GET"
        },
        "edit-history" : {
          "href" : "https://app.matatika.com/api/comments/f5fa5f4d-3737-4e3b-8d42-69b71e235f9c/history",
          "type" : "GET"
        },
        "update comment" : {
          "href" : "https://app.matatika.com/api/datasets/925dc0b2-ac62-4d02-ad99-920b93c79554/comments/f5fa5f4d-3737-4e3b-8d42-69b71e235f9c",
          "type" : "PUT"
        },
        "delete comment" : {
          "href" : "https://app.matatika.com/api/comments/f5fa5f4d-3737-4e3b-8d42-69b71e235f9c",
          "type" : "DELETE"
        },
        "self" : {
          "href" : "https://app.matatika.com/api/comments/f5fa5f4d-3737-4e3b-8d42-69b71e235f9c"
        },
        "add like" : {
          "href" : "https://app.matatika.com/api/comments/f5fa5f4d-3737-4e3b-8d42-69b71e235f9c/like",
          "type" : "PUT"
        },
        "new reply" : {
          "href" : "https://app.matatika.com/api/comments/f5fa5f4d-3737-4e3b-8d42-69b71e235f9c",
          "type" : "POST"
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://app.matatika.com/api/datasets/925dc0b2-ac62-4d02-ad99-920b93c79554/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/a6d5a36f-1128-4008-b1af-cfee0f1de45f' -i -X GET \
    -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/a6d5a36f-1128-4008-b1af-cfee0f1de45f"

headers = {
  'Authorization': ACCESS_TOKEN
}

response = requests.request("GET", url, headers=headers)

print(response.text.encode('utf8'))

Response

200 OK

Comment with HAL links.

{
  "id" : "a6d5a36f-1128-4008-b1af-cfee0f1de45f",
  "message" : "SIT-generated reply Pesho [2025-01-30T17:04:53.889293] to ",
  "likeCount" : 0,
  "likedByProfiles" : [ ],
  "created" : "2025-01-30T17:04:53.986284",
  "lastModified" : "2025-01-30T17:04:53.986284",
  "from" : {
    "id" : "auth0|5eb0327cbfd7490bff55feeb",
    "name" : "[email protected]",
    "handle" : "@sit+prod"
  },
  "commentCount" : 0,
  "datasetId" : "925dc0b2-ac62-4d02-ad99-920b93c79554",
  "_links" : {
    "update comment" : {
      "href" : "https://app.matatika.com/api/datasets/925dc0b2-ac62-4d02-ad99-920b93c79554/comments/a6d5a36f-1128-4008-b1af-cfee0f1de45f",
      "type" : "PUT"
    },
    "delete comment" : {
      "href" : "https://app.matatika.com/api/comments/a6d5a36f-1128-4008-b1af-cfee0f1de45f",
      "type" : "DELETE"
    },
    "self" : {
      "href" : "https://app.matatika.com/api/comments/a6d5a36f-1128-4008-b1af-cfee0f1de45f"
    },
    "add like" : {
      "href" : "https://app.matatika.com/api/comments/a6d5a36f-1128-4008-b1af-cfee0f1de45f/like",
      "type" : "PUT"
    },
    "new reply" : {
      "href" : "https://app.matatika.com/api/comments/a6d5a36f-1128-4008-b1af-cfee0f1de45f",
      "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/a6d5a36f-1128-4008-b1af-cfee0f1de45f/history' -i -X GET \
    -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/a6d5a36f-1128-4008-b1af-cfee0f1de45f/history"

headers = {
  'Authorization': ACCESS_TOKEN
}

response = requests.request("GET", url, headers=headers)

print(response.text.encode('utf8'))

Response

200 OK

[ {
  "lastModified" : "2025-01-30T17:04:53.989",
  "message" : "SIT-generated reply Pesho [2025-01-30T17:04:53.889293] to ",
  "editVersion" : "199386"
}, {
  "lastModified" : "2025-01-30T17:04:54.342",
  "message" : "SIT-generated reply Pesho [2025-01-30T17:04:54.249784] to ",
  "editVersion" : "199387"
} ]

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/925dc0b2-ac62-4d02-ad99-920b93c79554/comments?parentId=f5fa5f4d-3737-4e3b-8d42-69b71e235f9c' -i -X GET \
    -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/925dc0b2-ac62-4d02-ad99-920b93c79554/comments?parentId=f5fa5f4d-3737-4e3b-8d42-69b71e235f9c"

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" : "4111f378-5d74-4b6f-aa90-0a1fbcf1f13e",
      "message" : "SIT-generated reply Pesho [2025-01-30T17:04:47.455773] to ",
      "likeCount" : 0,
      "likedByProfiles" : [ ],
      "created" : "2025-01-30T17:04:47.71238",
      "lastModified" : "2025-01-30T17:04:47.712381",
      "from" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@sit+prod"
      },
      "commentCount" : 0,
      "datasetId" : "925dc0b2-ac62-4d02-ad99-920b93c79554",
      "parentId" : "f5fa5f4d-3737-4e3b-8d42-69b71e235f9c",
      "_links" : {
        "edit-history" : {
          "href" : "https://app.matatika.com/api/comments/4111f378-5d74-4b6f-aa90-0a1fbcf1f13e/history",
          "type" : "GET"
        },
        "update comment" : {
          "href" : "https://app.matatika.com/api/datasets/925dc0b2-ac62-4d02-ad99-920b93c79554/comments/4111f378-5d74-4b6f-aa90-0a1fbcf1f13e",
          "type" : "PUT"
        },
        "delete comment" : {
          "href" : "https://app.matatika.com/api/comments/4111f378-5d74-4b6f-aa90-0a1fbcf1f13e",
          "type" : "DELETE"
        },
        "self" : {
          "href" : "https://app.matatika.com/api/comments/4111f378-5d74-4b6f-aa90-0a1fbcf1f13e"
        },
        "add like" : {
          "href" : "https://app.matatika.com/api/comments/4111f378-5d74-4b6f-aa90-0a1fbcf1f13e/like",
          "type" : "PUT"
        },
        "new reply" : {
          "href" : "https://app.matatika.com/api/comments/4111f378-5d74-4b6f-aa90-0a1fbcf1f13e",
          "type" : "POST"
        }
      }
    }, {
      "id" : "d0fa9157-cc43-4f98-b358-6a3427fd65ac",
      "message" : "SIT-generated reply Pesho [2025-01-30T17:04:47.166058] to ",
      "likeCount" : 0,
      "likedByProfiles" : [ ],
      "created" : "2025-01-30T17:04:47.25774",
      "lastModified" : "2025-01-30T17:04:47.257741",
      "from" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@sit+prod"
      },
      "commentCount" : 0,
      "datasetId" : "925dc0b2-ac62-4d02-ad99-920b93c79554",
      "parentId" : "f5fa5f4d-3737-4e3b-8d42-69b71e235f9c",
      "_links" : {
        "edit-history" : {
          "href" : "https://app.matatika.com/api/comments/d0fa9157-cc43-4f98-b358-6a3427fd65ac/history",
          "type" : "GET"
        },
        "update comment" : {
          "href" : "https://app.matatika.com/api/datasets/925dc0b2-ac62-4d02-ad99-920b93c79554/comments/d0fa9157-cc43-4f98-b358-6a3427fd65ac",
          "type" : "PUT"
        },
        "delete comment" : {
          "href" : "https://app.matatika.com/api/comments/d0fa9157-cc43-4f98-b358-6a3427fd65ac",
          "type" : "DELETE"
        },
        "self" : {
          "href" : "https://app.matatika.com/api/comments/d0fa9157-cc43-4f98-b358-6a3427fd65ac"
        },
        "add like" : {
          "href" : "https://app.matatika.com/api/comments/d0fa9157-cc43-4f98-b358-6a3427fd65ac/like",
          "type" : "PUT"
        },
        "new reply" : {
          "href" : "https://app.matatika.com/api/comments/d0fa9157-cc43-4f98-b358-6a3427fd65ac",
          "type" : "POST"
        }
      }
    }, {
      "id" : "68bf8cfc-8a5e-432f-a40a-f626d51a39fb",
      "message" : "SIT-generated reply Pesho [2025-01-30T17:04:46.831126] to ",
      "likeCount" : 0,
      "likedByProfiles" : [ ],
      "created" : "2025-01-30T17:04:46.952191",
      "lastModified" : "2025-01-30T17:04:46.952192",
      "from" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@sit+prod"
      },
      "commentCount" : 0,
      "datasetId" : "925dc0b2-ac62-4d02-ad99-920b93c79554",
      "parentId" : "f5fa5f4d-3737-4e3b-8d42-69b71e235f9c",
      "_links" : {
        "edit-history" : {
          "href" : "https://app.matatika.com/api/comments/68bf8cfc-8a5e-432f-a40a-f626d51a39fb/history",
          "type" : "GET"
        },
        "update comment" : {
          "href" : "https://app.matatika.com/api/datasets/925dc0b2-ac62-4d02-ad99-920b93c79554/comments/68bf8cfc-8a5e-432f-a40a-f626d51a39fb",
          "type" : "PUT"
        },
        "delete comment" : {
          "href" : "https://app.matatika.com/api/comments/68bf8cfc-8a5e-432f-a40a-f626d51a39fb",
          "type" : "DELETE"
        },
        "self" : {
          "href" : "https://app.matatika.com/api/comments/68bf8cfc-8a5e-432f-a40a-f626d51a39fb"
        },
        "add like" : {
          "href" : "https://app.matatika.com/api/comments/68bf8cfc-8a5e-432f-a40a-f626d51a39fb/like",
          "type" : "PUT"
        },
        "new reply" : {
          "href" : "https://app.matatika.com/api/comments/68bf8cfc-8a5e-432f-a40a-f626d51a39fb",
          "type" : "POST"
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://app.matatika.com/api/datasets/925dc0b2-ac62-4d02-ad99-920b93c79554/comments?parentId=f5fa5f4d-3737-4e3b-8d42-69b71e235f9c&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/925dc0b2-ac62-4d02-ad99-920b93c79554/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/925dc0b2-ac62-4d02-ad99-920b93c79554/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" : "4493b398-15fb-4e6d-bd16-de08d92ead82",
  "likeCount" : 0,
  "likedByProfiles" : [ ],
  "created" : "2025-01-30T17:04:53.479053166",
  "lastModified" : "2025-01-30T17:04:53.479053766",
  "from" : {
    "id" : "auth0|5eb0327cbfd7490bff55feeb",
    "name" : "[email protected]",
    "handle" : "@sit+prod"
  },
  "commentCount" : 0,
  "datasetId" : "925dc0b2-ac62-4d02-ad99-920b93c79554",
  "_links" : {
    "create comment" : {
      "href" : "https://app.matatika.com/api/datasets/925dc0b2-ac62-4d02-ad99-920b93c79554/comments/4493b398-15fb-4e6d-bd16-de08d92ead82",
      "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/f5fa5f4d-3737-4e3b-8d42-69b71e235f9c' -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/f5fa5f4d-3737-4e3b-8d42-69b71e235f9c"

headers = {
  'Authorization': ACCESS_TOKEN
}

response = requests.request("POST", url, headers=headers)

print(response.text.encode('utf8'))

Response

200 OK

Comment with HAL links.

{
  "id" : "d8b28991-b89a-40dc-8472-2e8d4c07739f",
  "likeCount" : 0,
  "likedByProfiles" : [ ],
  "created" : "2025-01-30T17:04:52.633417303",
  "lastModified" : "2025-01-30T17:04:52.633417603",
  "from" : {
    "id" : "auth0|5eb0327cbfd7490bff55feeb",
    "name" : "[email protected]",
    "handle" : "@sit+prod"
  },
  "commentCount" : 0,
  "datasetId" : "925dc0b2-ac62-4d02-ad99-920b93c79554",
  "parentId" : "f5fa5f4d-3737-4e3b-8d42-69b71e235f9c",
  "_links" : {
    "create comment" : {
      "href" : "https://app.matatika.com/api/datasets/925dc0b2-ac62-4d02-ad99-920b93c79554/comments/d8b28991-b89a-40dc-8472-2e8d4c07739f",
      "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-01-30T17:04:51.884036] to ",
  "datasetId" : "925dc0b2-ac62-4d02-ad99-920b93c79554"
}

Example Snippets

cURL

curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/datasets/925dc0b2-ac62-4d02-ad99-920b93c79554/comments/0d001941-4b5b-468c-b046-c6df9a82a319' -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-01-30T17:04:51.884036] to ",
  "datasetId" : "925dc0b2-ac62-4d02-ad99-920b93c79554"
}'

Python (requests)

import requests

url = "https://app.matatika.com/api/datasets/925dc0b2-ac62-4d02-ad99-920b93c79554/comments/0d001941-4b5b-468c-b046-c6df9a82a319"

data = {
  "message" : "SIT-generated reply Pesho [2025-01-30T17:04:51.884036] to ",
  "datasetId" : "925dc0b2-ac62-4d02-ad99-920b93c79554"
}
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" : "0d001941-4b5b-468c-b046-c6df9a82a319",
  "message" : "SIT-generated reply Pesho [2025-01-30T17:04:51.884036] to ",
  "likeCount" : 0,
  "likedByProfiles" : [ ],
  "created" : "2025-01-30T17:04:52.457130204",
  "lastModified" : "2025-01-30T17:04:52.457130604",
  "from" : {
    "id" : "auth0|5eb0327cbfd7490bff55feeb",
    "name" : "[email protected]",
    "handle" : "@sit+prod"
  },
  "commentCount" : 0,
  "datasetId" : "925dc0b2-ac62-4d02-ad99-920b93c79554",
  "_links" : {
    "edit-history" : {
      "href" : "https://app.matatika.com/api/comments/0d001941-4b5b-468c-b046-c6df9a82a319/history",
      "type" : "GET"
    },
    "update comment" : {
      "href" : "https://app.matatika.com/api/datasets/925dc0b2-ac62-4d02-ad99-920b93c79554/comments/0d001941-4b5b-468c-b046-c6df9a82a319",
      "type" : "PUT"
    },
    "delete comment" : {
      "href" : "https://app.matatika.com/api/comments/0d001941-4b5b-468c-b046-c6df9a82a319",
      "type" : "DELETE"
    },
    "self" : {
      "href" : "https://app.matatika.com/api/comments/0d001941-4b5b-468c-b046-c6df9a82a319"
    },
    "add like" : {
      "href" : "https://app.matatika.com/api/comments/0d001941-4b5b-468c-b046-c6df9a82a319/like",
      "type" : "PUT"
    },
    "new reply" : {
      "href" : "https://app.matatika.com/api/comments/0d001941-4b5b-468c-b046-c6df9a82a319",
      "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-01-30T17:04:53.552108] to "
}

Example Snippets

cURL

curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/comments/a6d5a36f-1128-4008-b1af-cfee0f1de45f' -i -X GET \
    -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/a6d5a36f-1128-4008-b1af-cfee0f1de45f"

headers = {
  'Authorization': ACCESS_TOKEN
}

response = requests.request("GET", url, headers=headers)

print(response.text.encode('utf8'))

Response

200 OK

Comment with HAL links.

{
  "id" : "a6d5a36f-1128-4008-b1af-cfee0f1de45f",
  "message" : "SIT-generated reply Pesho [2025-01-30T17:04:53.889293] to ",
  "likeCount" : 0,
  "likedByProfiles" : [ ],
  "created" : "2025-01-30T17:04:53.986284",
  "lastModified" : "2025-01-30T17:04:53.986284",
  "from" : {
    "id" : "auth0|5eb0327cbfd7490bff55feeb",
    "name" : "[email protected]",
    "handle" : "@sit+prod"
  },
  "commentCount" : 0,
  "datasetId" : "925dc0b2-ac62-4d02-ad99-920b93c79554",
  "_links" : {
    "update comment" : {
      "href" : "https://app.matatika.com/api/datasets/925dc0b2-ac62-4d02-ad99-920b93c79554/comments/a6d5a36f-1128-4008-b1af-cfee0f1de45f",
      "type" : "PUT"
    },
    "delete comment" : {
      "href" : "https://app.matatika.com/api/comments/a6d5a36f-1128-4008-b1af-cfee0f1de45f",
      "type" : "DELETE"
    },
    "self" : {
      "href" : "https://app.matatika.com/api/comments/a6d5a36f-1128-4008-b1af-cfee0f1de45f"
    },
    "add like" : {
      "href" : "https://app.matatika.com/api/comments/a6d5a36f-1128-4008-b1af-cfee0f1de45f/like",
      "type" : "PUT"
    },
    "new reply" : {
      "href" : "https://app.matatika.com/api/comments/a6d5a36f-1128-4008-b1af-cfee0f1de45f",
      "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/f5fa5f4d-3737-4e3b-8d42-69b71e235f9c/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/f5fa5f4d-3737-4e3b-8d42-69b71e235f9c/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/f5fa5f4d-3737-4e3b-8d42-69b71e235f9c/like' -i -X DELETE \
    -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/f5fa5f4d-3737-4e3b-8d42-69b71e235f9c/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/20b39c14-eeb2-4a31-ab1c-ce2f07308d7b' -i -X DELETE \
    -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/20b39c14-eeb2-4a31-ab1c-ce2f07308d7b"

headers = {
  'Authorization': ACCESS_TOKEN
}

response = requests.request("DELETE", url, headers=headers)

print(response.text.encode('utf8'))

Response

204 No Content

No response body provided.