Notifications

Notifications are alerts triggered by certain events pertaining to a resource. To receive notifications for a specific resource, a user must have a subscription to the resource.

Objects

Notification

Path	JSON Type	Format	Description
`id`	`string`	Version 4 UUID	The notification ID
`created`	`string`	ISO 8601 timestamp	The instant the notification was created at
`lastModified`	`string`	ISO 8601 timestamp	The instant the notification was last modified at
`actor`	`object`	`Member`	The member whose action raised this notification
`type`	`string`	Notification Type	The type of notification
`resolved`	`bool`		Whether or not the notification has been read

{
  "id" : "fdbce0ba-3847-496a-8ea0-b592514ed2be",
  "created" : "2025-11-02T06:23:34.693018",
  "lastModified" : "2025-11-02T06:23:34.693018",
  "type" : "DATASET_COMMENT",
  "actor" : {
    "id" : "auth0|5eb0327cbfd7490bff55feeb",
    "name" : "[email protected]",
    "handle" : "@sit+prod"
  },
  "resolved" : false,
  "_embedded" : {
    "subscriberProfile" : {
      "id" : "auth0|5eb0327cbfd7490bff55feeb",
      "name" : "[email protected]",
      "handle" : "@sit+prod"
    },
    "channel" : {
      "name" : "no-picture",
      "description" : "No picture",
      "picture" : "https://s.gravatar.com/avatar/8f4ad8fa0793181b761d030196e62053?s=480&r=pg&d=https%3A%2F%2Fcdn.auth0.com%2Favatars%2Fsu.png"
    },
    "datasetComment" : {
      "id" : "f02fb696-b243-4d60-934b-85da8a547965",
      "message" : "SIT-generated comment",
      "likeCount" : 0,
      "created" : "2025-11-02T06:23:34.195926",
      "lastModified" : "2025-11-02T06:23:34.195927",
      "from" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@sit+prod"
      },
      "commentCount" : 0,
      "datasetId" : "0de37705-2dad-47cf-ab7a-ebaf10f6d310"
    },
    "dataset" : {
      "id" : "0de37705-2dad-47cf-ab7a-ebaf10f6d310",
      "published" : "2025-11-02T06:23:28.172799",
      "alias" : "analytics-tables",
      "workspaceId" : "18ed5afa-5ea1-4a73-9702-57d6b98d671a",
      "source" : "no-picture",
      "title" : "What tables are in our #fantastic data warehouse?",
      "description" : "# Overview\nThis example is a standalone data set with no visualisation.\n\n## What tables are in my data warehouse\nOur query in this dataset selects all the tables in the same schema we have configured the workspace to use.\n```SHOW TABLES```\n\n## Notes\nThe query is database specific.  The #postgres query is\n\n```SELECT * FROM pg_tables where schemaname = 'wznajuj'```",
      "likeCount" : 0,
      "commentCount" : 0,
      "viewCount" : 0,
      "created" : "2025-11-02T06:23:28.172799",
      "score" : 1.0
    },
    "workspace" : {
      "id" : "18ed5afa-5ea1-4a73-9702-57d6b98d671a",
      "name" : "Test Workspace [2025-11-02T06:23:27.793394589]"
    }
  },
  "_links" : {
    "self" : {
      "href" : "https://app.matatika.com/api/notifications/fdbce0ba-3847-496a-8ea0-b592514ed2be"
    },
    "delete notification" : {
      "href" : "https://app.matatika.com/api/notifications/fdbce0ba-3847-496a-8ea0-b592514ed2be",
      "type" : "DELETE"
    },
    "channel" : {
      "href" : "https://app.matatika.com/api/channels/bf6d84b0-c84d-4e20-9fe9-25750920d171"
    },
    "datasetComment" : {
      "href" : "https://app.matatika.com/api/comments/f02fb696-b243-4d60-934b-85da8a547965"
    },
    "dataset" : {
      "href" : "https://app.matatika.com/api/datasets/0de37705-2dad-47cf-ab7a-ebaf10f6d310"
    },
    "data" : {
      "href" : "https://app.matatika.com/api/datasets/0de37705-2dad-47cf-ab7a-ebaf10f6d310/data"
    },
    "workspace" : {
      "href" : "https://app.matatika.com/api/workspaces/18ed5afa-5ea1-4a73-9702-57d6b98d671a"
    }
  }
}

Formats

Notification Type

string

Value	Description
`DATASET_ACTIVITY`	Any activity on the dataset
`DATASET_ANOMOLY`	A detected anomoly in the dataset data
`DATASET_COMMENT`	A comment on the dataset
`DATASET_LIKE`	A like recorded on the dataset
`DATASET_MESSAGE`	A message about the dataset
`JOB_STARTED`	A job started for a pipeline
`JOB_ENDED`	A job ended for a pipeline

View all notifications

GET

/api/notifications?all={all}&before={before}&since={since}

Returns all notifications for the authenticated user profile.

Request

Query Parameters

Parameter	Required	Format	Default Value	Description
`all`	No	Boolean	`false`	Whether or not to return both resolved and unresolved notifications
`before`	No	ISO 8601 timestamp	The instant at which the request was made	The instant to return any notifications created before
`since`	No	ISO 8601 timestamp	`2021-02-11T11:12`	The instant to return any notifications created since

Example Snippets

cURL

curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/notifications?before=2025-11-02T06%3A23%3A35.286930945&since=2021-01-01T00%3A00' -i -X GET

Python (requests)

import requests

url = "https://app.matatika.com/api/notifications?before=2025-11-02T06%3A23%3A35.286930945&since=2021-01-01T00%3A00"

headers = {
  'Authorization': ACCESS_TOKEN
}

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

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

Response

200 OK

Notification collection with HAL links.

{
  "_embedded" : {
    "notifications" : [ {
      "id" : "fdbce0ba-3847-496a-8ea0-b592514ed2be",
      "created" : "2025-11-02T06:23:34.693018",
      "lastModified" : "2025-11-02T06:23:34.693018",
      "type" : "DATASET_COMMENT",
      "actor" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@sit+prod"
      },
      "resolved" : false,
      "_embedded" : {
        "subscriberProfile" : {
          "id" : "auth0|5eb0327cbfd7490bff55feeb",
          "name" : "[email protected]",
          "handle" : "@sit+prod"
        },
        "channel" : {
          "name" : "no-picture",
          "description" : "No picture",
          "picture" : "https://s.gravatar.com/avatar/8f4ad8fa0793181b761d030196e62053?s=480&r=pg&d=https%3A%2F%2Fcdn.auth0.com%2Favatars%2Fsu.png"
        },
        "datasetComment" : {
          "id" : "f02fb696-b243-4d60-934b-85da8a547965",
          "message" : "SIT-generated comment",
          "likeCount" : 0,
          "created" : "2025-11-02T06:23:34.195926",
          "lastModified" : "2025-11-02T06:23:34.195927",
          "from" : {
            "id" : "auth0|5eb0327cbfd7490bff55feeb",
            "name" : "[email protected]",
            "handle" : "@sit+prod"
          },
          "commentCount" : 0,
          "datasetId" : "0de37705-2dad-47cf-ab7a-ebaf10f6d310"
        },
        "dataset" : {
          "id" : "0de37705-2dad-47cf-ab7a-ebaf10f6d310",
          "published" : "2025-11-02T06:23:28.172799",
          "alias" : "analytics-tables",
          "workspaceId" : "18ed5afa-5ea1-4a73-9702-57d6b98d671a",
          "source" : "no-picture",
          "title" : "What tables are in our #fantastic data warehouse?",
          "description" : "# Overview\nThis example is a standalone data set with no visualisation.\n\n## What tables are in my data warehouse\nOur query in this dataset selects all the tables in the same schema we have configured the workspace to use.\n```SHOW TABLES```\n\n## Notes\nThe query is database specific.  The #postgres query is\n\n```SELECT * FROM pg_tables where schemaname = 'wznajuj'```",
          "likeCount" : 0,
          "commentCount" : 0,
          "viewCount" : 0,
          "created" : "2025-11-02T06:23:28.172799",
          "score" : 1.0
        },
        "workspace" : {
          "id" : "18ed5afa-5ea1-4a73-9702-57d6b98d671a",
          "name" : "Test Workspace [2025-11-02T06:23:27.793394589]"
        }
      },
      "_links" : {
        "self" : {
          "href" : "https://app.matatika.com/api/notifications/fdbce0ba-3847-496a-8ea0-b592514ed2be"
        },
        "delete notification" : {
          "href" : "https://app.matatika.com/api/notifications/fdbce0ba-3847-496a-8ea0-b592514ed2be",
          "type" : "DELETE"
        },
        "channel" : {
          "href" : "https://app.matatika.com/api/channels/bf6d84b0-c84d-4e20-9fe9-25750920d171"
        },
        "datasetComment" : {
          "href" : "https://app.matatika.com/api/comments/f02fb696-b243-4d60-934b-85da8a547965"
        },
        "dataset" : {
          "href" : "https://app.matatika.com/api/datasets/0de37705-2dad-47cf-ab7a-ebaf10f6d310"
        },
        "data" : {
          "href" : "https://app.matatika.com/api/datasets/0de37705-2dad-47cf-ab7a-ebaf10f6d310/data"
        },
        "workspace" : {
          "href" : "https://app.matatika.com/api/workspaces/18ed5afa-5ea1-4a73-9702-57d6b98d671a"
        }
      }
    }, {
      "id" : "ed277b1e-7b8d-4ecb-bacf-a0f9639ac808",
      "created" : "2025-11-02T06:23:34.546216",
      "lastModified" : "2025-11-02T06:23:34.546216",
      "type" : "DATASET_COMMENT",
      "actor" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@sit+prod"
      },
      "resolved" : false,
      "_embedded" : {
        "subscriberProfile" : {
          "id" : "auth0|5eb0327cbfd7490bff55feeb",
          "name" : "[email protected]",
          "handle" : "@sit+prod"
        },
        "channel" : {
          "name" : "no-picture",
          "description" : "No picture",
          "picture" : "https://s.gravatar.com/avatar/8f4ad8fa0793181b761d030196e62053?s=480&r=pg&d=https%3A%2F%2Fcdn.auth0.com%2Favatars%2Fsu.png"
        },
        "datasetComment" : {
          "id" : "d6400606-92ef-47b6-83f0-0e8ea139996f",
          "message" : "SIT-generated comment",
          "likeCount" : 0,
          "created" : "2025-11-02T06:23:34.030873",
          "lastModified" : "2025-11-02T06:23:34.030873",
          "from" : {
            "id" : "auth0|5eb0327cbfd7490bff55feeb",
            "name" : "[email protected]",
            "handle" : "@sit+prod"
          },
          "commentCount" : 0,
          "datasetId" : "0de37705-2dad-47cf-ab7a-ebaf10f6d310"
        },
        "dataset" : {
          "id" : "0de37705-2dad-47cf-ab7a-ebaf10f6d310",
          "published" : "2025-11-02T06:23:28.172799",
          "alias" : "analytics-tables",
          "workspaceId" : "18ed5afa-5ea1-4a73-9702-57d6b98d671a",
          "source" : "no-picture",
          "title" : "What tables are in our #fantastic data warehouse?",
          "description" : "# Overview\nThis example is a standalone data set with no visualisation.\n\n## What tables are in my data warehouse\nOur query in this dataset selects all the tables in the same schema we have configured the workspace to use.\n```SHOW TABLES```\n\n## Notes\nThe query is database specific.  The #postgres query is\n\n```SELECT * FROM pg_tables where schemaname = 'wznajuj'```",
          "likeCount" : 0,
          "commentCount" : 0,
          "viewCount" : 0,
          "created" : "2025-11-02T06:23:28.172799",
          "score" : 1.0
        },
        "workspace" : {
          "id" : "18ed5afa-5ea1-4a73-9702-57d6b98d671a",
          "name" : "Test Workspace [2025-11-02T06:23:27.793394589]"
        }
      },
      "_links" : {
        "self" : {
          "href" : "https://app.matatika.com/api/notifications/ed277b1e-7b8d-4ecb-bacf-a0f9639ac808"
        },
        "delete notification" : {
          "href" : "https://app.matatika.com/api/notifications/ed277b1e-7b8d-4ecb-bacf-a0f9639ac808",
          "type" : "DELETE"
        },
        "channel" : {
          "href" : "https://app.matatika.com/api/channels/bf6d84b0-c84d-4e20-9fe9-25750920d171"
        },
        "datasetComment" : {
          "href" : "https://app.matatika.com/api/comments/d6400606-92ef-47b6-83f0-0e8ea139996f"
        },
        "dataset" : {
          "href" : "https://app.matatika.com/api/datasets/0de37705-2dad-47cf-ab7a-ebaf10f6d310"
        },
        "data" : {
          "href" : "https://app.matatika.com/api/datasets/0de37705-2dad-47cf-ab7a-ebaf10f6d310/data"
        },
        "workspace" : {
          "href" : "https://app.matatika.com/api/workspaces/18ed5afa-5ea1-4a73-9702-57d6b98d671a"
        }
      }
    }, {
      "id" : "9d023636-1bc0-4b78-a70b-509a4cbb9d4f",
      "created" : "2025-11-02T06:23:34.299147",
      "lastModified" : "2025-11-02T06:23:34.299147",
      "type" : "DATASET_COMMENT",
      "actor" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@sit+prod"
      },
      "resolved" : false,
      "_embedded" : {
        "subscriberProfile" : {
          "id" : "auth0|5eb0327cbfd7490bff55feeb",
          "name" : "[email protected]",
          "handle" : "@sit+prod"
        },
        "channel" : {
          "name" : "no-picture",
          "description" : "No picture",
          "picture" : "https://s.gravatar.com/avatar/8f4ad8fa0793181b761d030196e62053?s=480&r=pg&d=https%3A%2F%2Fcdn.auth0.com%2Favatars%2Fsu.png"
        },
        "datasetComment" : {
          "id" : "8c54efa0-ae00-40b3-8251-cb8a553b9864",
          "message" : "SIT-generated comment",
          "likeCount" : 0,
          "created" : "2025-11-02T06:23:33.825439",
          "lastModified" : "2025-11-02T06:23:33.825439",
          "from" : {
            "id" : "auth0|5eb0327cbfd7490bff55feeb",
            "name" : "[email protected]",
            "handle" : "@sit+prod"
          },
          "commentCount" : 0,
          "datasetId" : "0de37705-2dad-47cf-ab7a-ebaf10f6d310"
        },
        "dataset" : {
          "id" : "0de37705-2dad-47cf-ab7a-ebaf10f6d310",
          "published" : "2025-11-02T06:23:28.172799",
          "alias" : "analytics-tables",
          "workspaceId" : "18ed5afa-5ea1-4a73-9702-57d6b98d671a",
          "source" : "no-picture",
          "title" : "What tables are in our #fantastic data warehouse?",
          "description" : "# Overview\nThis example is a standalone data set with no visualisation.\n\n## What tables are in my data warehouse\nOur query in this dataset selects all the tables in the same schema we have configured the workspace to use.\n```SHOW TABLES```\n\n## Notes\nThe query is database specific.  The #postgres query is\n\n```SELECT * FROM pg_tables where schemaname = 'wznajuj'```",
          "likeCount" : 0,
          "commentCount" : 0,
          "viewCount" : 0,
          "created" : "2025-11-02T06:23:28.172799",
          "score" : 1.0
        },
        "workspace" : {
          "id" : "18ed5afa-5ea1-4a73-9702-57d6b98d671a",
          "name" : "Test Workspace [2025-11-02T06:23:27.793394589]"
        }
      },
      "_links" : {
        "self" : {
          "href" : "https://app.matatika.com/api/notifications/9d023636-1bc0-4b78-a70b-509a4cbb9d4f"
        },
        "delete notification" : {
          "href" : "https://app.matatika.com/api/notifications/9d023636-1bc0-4b78-a70b-509a4cbb9d4f",
          "type" : "DELETE"
        },
        "channel" : {
          "href" : "https://app.matatika.com/api/channels/bf6d84b0-c84d-4e20-9fe9-25750920d171"
        },
        "datasetComment" : {
          "href" : "https://app.matatika.com/api/comments/8c54efa0-ae00-40b3-8251-cb8a553b9864"
        },
        "dataset" : {
          "href" : "https://app.matatika.com/api/datasets/0de37705-2dad-47cf-ab7a-ebaf10f6d310"
        },
        "data" : {
          "href" : "https://app.matatika.com/api/datasets/0de37705-2dad-47cf-ab7a-ebaf10f6d310/data"
        },
        "workspace" : {
          "href" : "https://app.matatika.com/api/workspaces/18ed5afa-5ea1-4a73-9702-57d6b98d671a"
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://app.matatika.com/api/notifications?before=2025-11-02T06%3A23%3A35.286930945&since=2021-01-01T00%3A00&page=0&size=20"
    }
  },
  "page" : {
    "size" : 20,
    "totalElements" : 3,
    "totalPages" : 1,
    "number" : 0
  }
}

View all notifications for a workspace

GET

/api/workspaces/{workspaceId}/notifications?all={all}&before={before}&since={since}

Returns all notifications for the workspace {workspace-id}.

Prerequisites

Workspace {workspace-id} must exist

Request

Query Parameters

Parameter	Required	Format	Default Value	Description
`all`	No	Boolean		Whether or not to return both resolved and unresolved notifications
`before`	No	ISO 8601 timestamp	The instant at which the request was made	The instant to return any notifications created before
`since`	No	ISO 8601 timestamp	`2021-02-11T11:12`	The instant to return any notifications created since

Example Snippets

cURL

curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/workspaces/18ed5afa-5ea1-4a73-9702-57d6b98d671a/notifications?before=2025-11-02T06%3A23%3A35.421311023&since=2021-01-01T00%3A00' -i -X GET

Python (requests)

import requests

url = "https://app.matatika.com/api/workspaces/18ed5afa-5ea1-4a73-9702-57d6b98d671a/notifications?before=2025-11-02T06%3A23%3A35.421311023&since=2021-01-01T00%3A00"

headers = {
  'Authorization': ACCESS_TOKEN
}

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

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

Response

200 OK

Notification collection with HAL links.

{
  "_embedded" : {
    "notifications" : [ {
      "id" : "fdbce0ba-3847-496a-8ea0-b592514ed2be",
      "created" : "2025-11-02T06:23:34.693018",
      "lastModified" : "2025-11-02T06:23:34.693018",
      "type" : "DATASET_COMMENT",
      "actor" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@sit+prod"
      },
      "resolved" : false,
      "_embedded" : {
        "subscriberProfile" : {
          "id" : "auth0|5eb0327cbfd7490bff55feeb",
          "name" : "[email protected]",
          "handle" : "@sit+prod"
        },
        "channel" : {
          "name" : "no-picture",
          "description" : "No picture",
          "picture" : "https://s.gravatar.com/avatar/8f4ad8fa0793181b761d030196e62053?s=480&r=pg&d=https%3A%2F%2Fcdn.auth0.com%2Favatars%2Fsu.png"
        },
        "datasetComment" : {
          "id" : "f02fb696-b243-4d60-934b-85da8a547965",
          "message" : "SIT-generated comment",
          "likeCount" : 0,
          "created" : "2025-11-02T06:23:34.195926",
          "lastModified" : "2025-11-02T06:23:34.195927",
          "from" : {
            "id" : "auth0|5eb0327cbfd7490bff55feeb",
            "name" : "[email protected]",
            "handle" : "@sit+prod"
          },
          "commentCount" : 0,
          "datasetId" : "0de37705-2dad-47cf-ab7a-ebaf10f6d310"
        },
        "dataset" : {
          "id" : "0de37705-2dad-47cf-ab7a-ebaf10f6d310",
          "published" : "2025-11-02T06:23:28.172799",
          "alias" : "analytics-tables",
          "workspaceId" : "18ed5afa-5ea1-4a73-9702-57d6b98d671a",
          "source" : "no-picture",
          "title" : "What tables are in our #fantastic data warehouse?",
          "description" : "# Overview\nThis example is a standalone data set with no visualisation.\n\n## What tables are in my data warehouse\nOur query in this dataset selects all the tables in the same schema we have configured the workspace to use.\n```SHOW TABLES```\n\n## Notes\nThe query is database specific.  The #postgres query is\n\n```SELECT * FROM pg_tables where schemaname = 'wznajuj'```",
          "likeCount" : 0,
          "commentCount" : 0,
          "viewCount" : 0,
          "created" : "2025-11-02T06:23:28.172799",
          "score" : 1.0
        },
        "workspace" : {
          "id" : "18ed5afa-5ea1-4a73-9702-57d6b98d671a",
          "name" : "Test Workspace [2025-11-02T06:23:27.793394589]"
        }
      },
      "_links" : {
        "self" : {
          "href" : "https://app.matatika.com/api/notifications/fdbce0ba-3847-496a-8ea0-b592514ed2be"
        },
        "delete notification" : {
          "href" : "https://app.matatika.com/api/notifications/fdbce0ba-3847-496a-8ea0-b592514ed2be",
          "type" : "DELETE"
        },
        "channel" : {
          "href" : "https://app.matatika.com/api/channels/bf6d84b0-c84d-4e20-9fe9-25750920d171"
        },
        "datasetComment" : {
          "href" : "https://app.matatika.com/api/comments/f02fb696-b243-4d60-934b-85da8a547965"
        },
        "dataset" : {
          "href" : "https://app.matatika.com/api/datasets/0de37705-2dad-47cf-ab7a-ebaf10f6d310"
        },
        "data" : {
          "href" : "https://app.matatika.com/api/datasets/0de37705-2dad-47cf-ab7a-ebaf10f6d310/data"
        },
        "workspace" : {
          "href" : "https://app.matatika.com/api/workspaces/18ed5afa-5ea1-4a73-9702-57d6b98d671a"
        }
      }
    }, {
      "id" : "ed277b1e-7b8d-4ecb-bacf-a0f9639ac808",
      "created" : "2025-11-02T06:23:34.546216",
      "lastModified" : "2025-11-02T06:23:34.546216",
      "type" : "DATASET_COMMENT",
      "actor" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@sit+prod"
      },
      "resolved" : false,
      "_embedded" : {
        "subscriberProfile" : {
          "id" : "auth0|5eb0327cbfd7490bff55feeb",
          "name" : "[email protected]",
          "handle" : "@sit+prod"
        },
        "channel" : {
          "name" : "no-picture",
          "description" : "No picture",
          "picture" : "https://s.gravatar.com/avatar/8f4ad8fa0793181b761d030196e62053?s=480&r=pg&d=https%3A%2F%2Fcdn.auth0.com%2Favatars%2Fsu.png"
        },
        "datasetComment" : {
          "id" : "d6400606-92ef-47b6-83f0-0e8ea139996f",
          "message" : "SIT-generated comment",
          "likeCount" : 0,
          "created" : "2025-11-02T06:23:34.030873",
          "lastModified" : "2025-11-02T06:23:34.030873",
          "from" : {
            "id" : "auth0|5eb0327cbfd7490bff55feeb",
            "name" : "[email protected]",
            "handle" : "@sit+prod"
          },
          "commentCount" : 0,
          "datasetId" : "0de37705-2dad-47cf-ab7a-ebaf10f6d310"
        },
        "dataset" : {
          "id" : "0de37705-2dad-47cf-ab7a-ebaf10f6d310",
          "published" : "2025-11-02T06:23:28.172799",
          "alias" : "analytics-tables",
          "workspaceId" : "18ed5afa-5ea1-4a73-9702-57d6b98d671a",
          "source" : "no-picture",
          "title" : "What tables are in our #fantastic data warehouse?",
          "description" : "# Overview\nThis example is a standalone data set with no visualisation.\n\n## What tables are in my data warehouse\nOur query in this dataset selects all the tables in the same schema we have configured the workspace to use.\n```SHOW TABLES```\n\n## Notes\nThe query is database specific.  The #postgres query is\n\n```SELECT * FROM pg_tables where schemaname = 'wznajuj'```",
          "likeCount" : 0,
          "commentCount" : 0,
          "viewCount" : 0,
          "created" : "2025-11-02T06:23:28.172799",
          "score" : 1.0
        },
        "workspace" : {
          "id" : "18ed5afa-5ea1-4a73-9702-57d6b98d671a",
          "name" : "Test Workspace [2025-11-02T06:23:27.793394589]"
        }
      },
      "_links" : {
        "self" : {
          "href" : "https://app.matatika.com/api/notifications/ed277b1e-7b8d-4ecb-bacf-a0f9639ac808"
        },
        "delete notification" : {
          "href" : "https://app.matatika.com/api/notifications/ed277b1e-7b8d-4ecb-bacf-a0f9639ac808",
          "type" : "DELETE"
        },
        "channel" : {
          "href" : "https://app.matatika.com/api/channels/bf6d84b0-c84d-4e20-9fe9-25750920d171"
        },
        "datasetComment" : {
          "href" : "https://app.matatika.com/api/comments/d6400606-92ef-47b6-83f0-0e8ea139996f"
        },
        "dataset" : {
          "href" : "https://app.matatika.com/api/datasets/0de37705-2dad-47cf-ab7a-ebaf10f6d310"
        },
        "data" : {
          "href" : "https://app.matatika.com/api/datasets/0de37705-2dad-47cf-ab7a-ebaf10f6d310/data"
        },
        "workspace" : {
          "href" : "https://app.matatika.com/api/workspaces/18ed5afa-5ea1-4a73-9702-57d6b98d671a"
        }
      }
    }, {
      "id" : "9d023636-1bc0-4b78-a70b-509a4cbb9d4f",
      "created" : "2025-11-02T06:23:34.299147",
      "lastModified" : "2025-11-02T06:23:34.299147",
      "type" : "DATASET_COMMENT",
      "actor" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@sit+prod"
      },
      "resolved" : false,
      "_embedded" : {
        "subscriberProfile" : {
          "id" : "auth0|5eb0327cbfd7490bff55feeb",
          "name" : "[email protected]",
          "handle" : "@sit+prod"
        },
        "channel" : {
          "name" : "no-picture",
          "description" : "No picture",
          "picture" : "https://s.gravatar.com/avatar/8f4ad8fa0793181b761d030196e62053?s=480&r=pg&d=https%3A%2F%2Fcdn.auth0.com%2Favatars%2Fsu.png"
        },
        "datasetComment" : {
          "id" : "8c54efa0-ae00-40b3-8251-cb8a553b9864",
          "message" : "SIT-generated comment",
          "likeCount" : 0,
          "created" : "2025-11-02T06:23:33.825439",
          "lastModified" : "2025-11-02T06:23:33.825439",
          "from" : {
            "id" : "auth0|5eb0327cbfd7490bff55feeb",
            "name" : "[email protected]",
            "handle" : "@sit+prod"
          },
          "commentCount" : 0,
          "datasetId" : "0de37705-2dad-47cf-ab7a-ebaf10f6d310"
        },
        "dataset" : {
          "id" : "0de37705-2dad-47cf-ab7a-ebaf10f6d310",
          "published" : "2025-11-02T06:23:28.172799",
          "alias" : "analytics-tables",
          "workspaceId" : "18ed5afa-5ea1-4a73-9702-57d6b98d671a",
          "source" : "no-picture",
          "title" : "What tables are in our #fantastic data warehouse?",
          "description" : "# Overview\nThis example is a standalone data set with no visualisation.\n\n## What tables are in my data warehouse\nOur query in this dataset selects all the tables in the same schema we have configured the workspace to use.\n```SHOW TABLES```\n\n## Notes\nThe query is database specific.  The #postgres query is\n\n```SELECT * FROM pg_tables where schemaname = 'wznajuj'```",
          "likeCount" : 0,
          "commentCount" : 0,
          "viewCount" : 0,
          "created" : "2025-11-02T06:23:28.172799",
          "score" : 1.0
        },
        "workspace" : {
          "id" : "18ed5afa-5ea1-4a73-9702-57d6b98d671a",
          "name" : "Test Workspace [2025-11-02T06:23:27.793394589]"
        }
      },
      "_links" : {
        "self" : {
          "href" : "https://app.matatika.com/api/notifications/9d023636-1bc0-4b78-a70b-509a4cbb9d4f"
        },
        "delete notification" : {
          "href" : "https://app.matatika.com/api/notifications/9d023636-1bc0-4b78-a70b-509a4cbb9d4f",
          "type" : "DELETE"
        },
        "channel" : {
          "href" : "https://app.matatika.com/api/channels/bf6d84b0-c84d-4e20-9fe9-25750920d171"
        },
        "datasetComment" : {
          "href" : "https://app.matatika.com/api/comments/8c54efa0-ae00-40b3-8251-cb8a553b9864"
        },
        "dataset" : {
          "href" : "https://app.matatika.com/api/datasets/0de37705-2dad-47cf-ab7a-ebaf10f6d310"
        },
        "data" : {
          "href" : "https://app.matatika.com/api/datasets/0de37705-2dad-47cf-ab7a-ebaf10f6d310/data"
        },
        "workspace" : {
          "href" : "https://app.matatika.com/api/workspaces/18ed5afa-5ea1-4a73-9702-57d6b98d671a"
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://app.matatika.com/api/workspaces/18ed5afa-5ea1-4a73-9702-57d6b98d671a/notifications?before=2025-11-02T06%3A23%3A35.421311023&since=2021-01-01T00%3A00&page=0&size=20"
    }
  },
  "page" : {
    "size" : 20,
    "totalElements" : 3,
    "totalPages" : 1,
    "number" : 0
  }
}

View a notification

GET

/api/notifications/{notification-id}

Returns the notification {notification-id}.

Prerequisites

Notification {notification-id} must exist

Request

Example Snippets

cURL

curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/notifications/fdbce0ba-3847-496a-8ea0-b592514ed2be' -i -X GET

Python (requests)

import requests

url = "https://app.matatika.com/api/notifications/fdbce0ba-3847-496a-8ea0-b592514ed2be"

headers = {
  'Authorization': ACCESS_TOKEN
}

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

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

Response

200 OK

Notification with HAL links.

{
  "id" : "fdbce0ba-3847-496a-8ea0-b592514ed2be",
  "created" : "2025-11-02T06:23:34.693018",
  "lastModified" : "2025-11-02T06:23:34.693018",
  "type" : "DATASET_COMMENT",
  "actor" : {
    "id" : "auth0|5eb0327cbfd7490bff55feeb",
    "name" : "[email protected]",
    "handle" : "@sit+prod"
  },
  "resolved" : false,
  "_embedded" : {
    "subscriberProfile" : {
      "id" : "auth0|5eb0327cbfd7490bff55feeb",
      "name" : "[email protected]",
      "handle" : "@sit+prod"
    },
    "channel" : {
      "name" : "no-picture",
      "description" : "No picture",
      "picture" : "https://s.gravatar.com/avatar/8f4ad8fa0793181b761d030196e62053?s=480&r=pg&d=https%3A%2F%2Fcdn.auth0.com%2Favatars%2Fsu.png"
    },
    "datasetComment" : {
      "id" : "f02fb696-b243-4d60-934b-85da8a547965",
      "message" : "SIT-generated comment",
      "likeCount" : 0,
      "created" : "2025-11-02T06:23:34.195926",
      "lastModified" : "2025-11-02T06:23:34.195927",
      "from" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@sit+prod"
      },
      "commentCount" : 0,
      "datasetId" : "0de37705-2dad-47cf-ab7a-ebaf10f6d310"
    },
    "dataset" : {
      "id" : "0de37705-2dad-47cf-ab7a-ebaf10f6d310",
      "published" : "2025-11-02T06:23:28.172799",
      "alias" : "analytics-tables",
      "workspaceId" : "18ed5afa-5ea1-4a73-9702-57d6b98d671a",
      "source" : "no-picture",
      "title" : "What tables are in our #fantastic data warehouse?",
      "description" : "# Overview\nThis example is a standalone data set with no visualisation.\n\n## What tables are in my data warehouse\nOur query in this dataset selects all the tables in the same schema we have configured the workspace to use.\n```SHOW TABLES```\n\n## Notes\nThe query is database specific.  The #postgres query is\n\n```SELECT * FROM pg_tables where schemaname = 'wznajuj'```",
      "likeCount" : 0,
      "commentCount" : 0,
      "viewCount" : 0,
      "created" : "2025-11-02T06:23:28.172799",
      "score" : 1.0
    },
    "workspace" : {
      "id" : "18ed5afa-5ea1-4a73-9702-57d6b98d671a",
      "name" : "Test Workspace [2025-11-02T06:23:27.793394589]"
    }
  },
  "_links" : {
    "self" : {
      "href" : "https://app.matatika.com/api/notifications/fdbce0ba-3847-496a-8ea0-b592514ed2be"
    },
    "delete notification" : {
      "href" : "https://app.matatika.com/api/notifications/fdbce0ba-3847-496a-8ea0-b592514ed2be",
      "type" : "DELETE"
    },
    "channel" : {
      "href" : "https://app.matatika.com/api/channels/bf6d84b0-c84d-4e20-9fe9-25750920d171"
    },
    "datasetComment" : {
      "href" : "https://app.matatika.com/api/comments/f02fb696-b243-4d60-934b-85da8a547965"
    },
    "dataset" : {
      "href" : "https://app.matatika.com/api/datasets/0de37705-2dad-47cf-ab7a-ebaf10f6d310"
    },
    "data" : {
      "href" : "https://app.matatika.com/api/datasets/0de37705-2dad-47cf-ab7a-ebaf10f6d310/data"
    },
    "workspace" : {
      "href" : "https://app.matatika.com/api/workspaces/18ed5afa-5ea1-4a73-9702-57d6b98d671a"
    }
  }
}

Refresh notifications

PUT

/api/notifications?since={since}&markAsResolved={markAsResolved}

Returns new notifications for the authenticated user profile, optionally marking existing notifications as resolved up to the moment the request was made or the supplied since parameter.

Request

Query Parameters

Parameter	Required	Format	Default Value	Description
`since`	No	ISO 8601 timestamp	The instant at which the request was made	The instant to fetch any new notifications from
`markAsResolved`	No	Boolean	`true`	Whether or not to mark notifications created up to `since` as resolved

Example Snippets

cURL

curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/notifications?since=2025-11-02T06%3A23%3A38.817021' -i -X PUT \
    -H 'Content-Type: application/json'

Python (requests)

import requests

url = "https://app.matatika.com/api/notifications?since=2025-11-02T06%3A23%3A38.817021"

headers = {
  'Authorization': ACCESS_TOKEN
}

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

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

Response

200 OK

Notification collection with HAL links.

{
  "_embedded" : {
    "notifications" : [ {
      "id" : "c44596d3-f6f4-4cb3-aa4e-85ae0388fa8a",
      "created" : "2025-11-02T06:23:39.884805",
      "lastModified" : "2025-11-02T06:23:39.884805",
      "type" : "DATASET_COMMENT",
      "actor" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@sit+prod"
      },
      "resolved" : false,
      "_embedded" : {
        "subscriberProfile" : {
          "id" : "auth0|5eb0327cbfd7490bff55feeb",
          "name" : "[email protected]",
          "handle" : "@sit+prod"
        },
        "channel" : {
          "name" : "no-picture",
          "description" : "No picture",
          "picture" : "https://s.gravatar.com/avatar/8f4ad8fa0793181b761d030196e62053?s=480&r=pg&d=https%3A%2F%2Fcdn.auth0.com%2Favatars%2Fsu.png"
        },
        "datasetComment" : {
          "id" : "40aff8f8-2243-4470-9b3d-7b29cba1f7ee",
          "message" : "SIT-generated comment",
          "likeCount" : 0,
          "created" : "2025-11-02T06:23:39.186605",
          "lastModified" : "2025-11-02T06:23:39.186606",
          "from" : {
            "id" : "auth0|5eb0327cbfd7490bff55feeb",
            "name" : "[email protected]",
            "handle" : "@sit+prod"
          },
          "commentCount" : 0,
          "datasetId" : "0de37705-2dad-47cf-ab7a-ebaf10f6d310"
        },
        "dataset" : {
          "id" : "0de37705-2dad-47cf-ab7a-ebaf10f6d310",
          "published" : "2025-11-02T06:23:28.172799",
          "alias" : "analytics-tables",
          "workspaceId" : "18ed5afa-5ea1-4a73-9702-57d6b98d671a",
          "source" : "no-picture",
          "title" : "What tables are in our #fantastic data warehouse?",
          "description" : "# Overview\nThis example is a standalone data set with no visualisation.\n\n## What tables are in my data warehouse\nOur query in this dataset selects all the tables in the same schema we have configured the workspace to use.\n```SHOW TABLES```\n\n## Notes\nThe query is database specific.  The #postgres query is\n\n```SELECT * FROM pg_tables where schemaname = 'wznajuj'```",
          "likeCount" : 0,
          "commentCount" : 0,
          "viewCount" : 0,
          "created" : "2025-11-02T06:23:28.172799",
          "score" : 1.0
        },
        "workspace" : {
          "id" : "18ed5afa-5ea1-4a73-9702-57d6b98d671a",
          "name" : "Test Workspace [2025-11-02T06:23:27.793394589]"
        }
      },
      "_links" : {
        "self" : {
          "href" : "https://app.matatika.com/api/notifications/c44596d3-f6f4-4cb3-aa4e-85ae0388fa8a"
        },
        "delete notification" : {
          "href" : "https://app.matatika.com/api/notifications/c44596d3-f6f4-4cb3-aa4e-85ae0388fa8a",
          "type" : "DELETE"
        },
        "channel" : {
          "href" : "https://app.matatika.com/api/channels/bf6d84b0-c84d-4e20-9fe9-25750920d171"
        },
        "datasetComment" : {
          "href" : "https://app.matatika.com/api/comments/40aff8f8-2243-4470-9b3d-7b29cba1f7ee"
        },
        "dataset" : {
          "href" : "https://app.matatika.com/api/datasets/0de37705-2dad-47cf-ab7a-ebaf10f6d310"
        },
        "data" : {
          "href" : "https://app.matatika.com/api/datasets/0de37705-2dad-47cf-ab7a-ebaf10f6d310/data"
        },
        "workspace" : {
          "href" : "https://app.matatika.com/api/workspaces/18ed5afa-5ea1-4a73-9702-57d6b98d671a"
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://app.matatika.com/api/notifications?since=2025-11-02T06%3A23%3A38.817021&page=0&size=20"
    }
  },
  "page" : {
    "size" : 20,
    "totalElements" : 1,
    "totalPages" : 1,
    "number" : 0
  }
}

Delete a notification

DELETE

/api/notifications/{notification-id}

Deletes the notification {notification-id}.

Prerequisites

Notification {notification-id} must exist

Request

Example Snippets

cURL

curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com/api/notifications/fdbce0ba-3847-496a-8ea0-b592514ed2be' -i -X DELETE

Python (requests)

import requests

url = "https://app.matatika.com/api/notifications/fdbce0ba-3847-496a-8ea0-b592514ed2be"

headers = {
  'Authorization': ACCESS_TOKEN
}

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

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

Response

204 No Content

No response body provided.

Notifications

Objects

Notification

Formats

Notification Type

Requests

See Also

View all notifications

Request

Query Parameters

Example Snippets

Response

View all notifications for a workspace

Prerequisites

Request

Query Parameters

Example Snippets

Response

View a notification

Prerequisites

Request

Example Snippets

Response

Refresh notifications

Request

Query Parameters

Example Snippets

Response

Delete a notification

Prerequisites

Request

Example Snippets

Response