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

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" : "53fe3b03-ed58-4bc3-a2ae-e12a30a2fd4f",
  "created" : "2026-01-25T08:20:12.225782",
  "lastModified" : "2026-01-25T08:20:12.225782",
  "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" : "aa16b0fa-c7b7-4a48-ad2f-5be58091d24a",
      "message" : "SIT-generated comment",
      "likeCount" : 0,
      "created" : "2026-01-25T08:20:11.867434",
      "lastModified" : "2026-01-25T08:20:11.867434",
      "from" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@sit+prod"
      },
      "commentCount" : 0,
      "datasetId" : "bcd6beb6-8008-4bc4-82b2-4722251ffcba"
    },
    "dataset" : {
      "id" : "bcd6beb6-8008-4bc4-82b2-4722251ffcba",
      "published" : "2026-01-25T08:20:06.015327",
      "alias" : "analytics-tables",
      "workspaceId" : "85451d95-3510-4782-9f62-056441af2e35",
      "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 = 'gblpzvr'```",
      "likeCount" : 0,
      "commentCount" : 0,
      "viewCount" : 0,
      "created" : "2026-01-25T08:20:06.015326",
      "score" : 1.0
    },
    "workspace" : {
      "id" : "85451d95-3510-4782-9f62-056441af2e35",
      "name" : "Test Workspace [2026-01-25T08:20:05.551278834]"
    }
  },
  "_links" : {
    "self" : {
      "href" : "https://app.matatika.com/api/notifications/53fe3b03-ed58-4bc3-a2ae-e12a30a2fd4f"
    },
    "delete notification" : {
      "href" : "https://app.matatika.com/api/notifications/53fe3b03-ed58-4bc3-a2ae-e12a30a2fd4f",
      "type" : "DELETE"
    },
    "channel" : {
      "href" : "https://app.matatika.com/api/channels/23043860-c8eb-47fe-a625-28e3fc4cefb0"
    },
    "datasetComment" : {
      "href" : "https://app.matatika.com/api/comments/aa16b0fa-c7b7-4a48-ad2f-5be58091d24a"
    },
    "dataset" : {
      "href" : "https://app.matatika.com/api/datasets/bcd6beb6-8008-4bc4-82b2-4722251ffcba"
    },
    "data" : {
      "href" : "https://app.matatika.com/api/datasets/bcd6beb6-8008-4bc4-82b2-4722251ffcba/data"
    },
    "workspace" : {
      "href" : "https://app.matatika.com/api/workspaces/85451d95-3510-4782-9f62-056441af2e35"
    }
  }
}

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

Requests

See Also

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=2026-01-25T08%3A20%3A12.940330897&since=2021-01-01T00%3A00' -i -X GET

Python (requests)

import requests

url = "https://app.matatika.com/api/notifications?before=2026-01-25T08%3A20%3A12.940330897&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" : "53fe3b03-ed58-4bc3-a2ae-e12a30a2fd4f",
      "created" : "2026-01-25T08:20:12.225782",
      "lastModified" : "2026-01-25T08:20:12.225782",
      "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" : "aa16b0fa-c7b7-4a48-ad2f-5be58091d24a",
          "message" : "SIT-generated comment",
          "likeCount" : 0,
          "created" : "2026-01-25T08:20:11.867434",
          "lastModified" : "2026-01-25T08:20:11.867434",
          "from" : {
            "id" : "auth0|5eb0327cbfd7490bff55feeb",
            "name" : "[email protected]",
            "handle" : "@sit+prod"
          },
          "commentCount" : 0,
          "datasetId" : "bcd6beb6-8008-4bc4-82b2-4722251ffcba"
        },
        "dataset" : {
          "id" : "bcd6beb6-8008-4bc4-82b2-4722251ffcba",
          "published" : "2026-01-25T08:20:06.015327",
          "alias" : "analytics-tables",
          "workspaceId" : "85451d95-3510-4782-9f62-056441af2e35",
          "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 = 'gblpzvr'```",
          "likeCount" : 0,
          "commentCount" : 0,
          "viewCount" : 0,
          "created" : "2026-01-25T08:20:06.015326",
          "score" : 1.0
        },
        "workspace" : {
          "id" : "85451d95-3510-4782-9f62-056441af2e35",
          "name" : "Test Workspace [2026-01-25T08:20:05.551278834]"
        }
      },
      "_links" : {
        "self" : {
          "href" : "https://app.matatika.com/api/notifications/53fe3b03-ed58-4bc3-a2ae-e12a30a2fd4f"
        },
        "delete notification" : {
          "href" : "https://app.matatika.com/api/notifications/53fe3b03-ed58-4bc3-a2ae-e12a30a2fd4f",
          "type" : "DELETE"
        },
        "channel" : {
          "href" : "https://app.matatika.com/api/channels/23043860-c8eb-47fe-a625-28e3fc4cefb0"
        },
        "datasetComment" : {
          "href" : "https://app.matatika.com/api/comments/aa16b0fa-c7b7-4a48-ad2f-5be58091d24a"
        },
        "dataset" : {
          "href" : "https://app.matatika.com/api/datasets/bcd6beb6-8008-4bc4-82b2-4722251ffcba"
        },
        "data" : {
          "href" : "https://app.matatika.com/api/datasets/bcd6beb6-8008-4bc4-82b2-4722251ffcba/data"
        },
        "workspace" : {
          "href" : "https://app.matatika.com/api/workspaces/85451d95-3510-4782-9f62-056441af2e35"
        }
      }
    }, {
      "id" : "6730ed6e-72cc-422c-b8d9-9e720305afde",
      "created" : "2026-01-25T08:20:11.997452",
      "lastModified" : "2026-01-25T08:20:11.997453",
      "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" : "32b30e69-add0-4741-9bfe-a8bb37e6cb52",
          "message" : "SIT-generated comment",
          "likeCount" : 0,
          "created" : "2026-01-25T08:20:11.750775",
          "lastModified" : "2026-01-25T08:20:11.750775",
          "from" : {
            "id" : "auth0|5eb0327cbfd7490bff55feeb",
            "name" : "[email protected]",
            "handle" : "@sit+prod"
          },
          "commentCount" : 0,
          "datasetId" : "bcd6beb6-8008-4bc4-82b2-4722251ffcba"
        },
        "dataset" : {
          "id" : "bcd6beb6-8008-4bc4-82b2-4722251ffcba",
          "published" : "2026-01-25T08:20:06.015327",
          "alias" : "analytics-tables",
          "workspaceId" : "85451d95-3510-4782-9f62-056441af2e35",
          "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 = 'gblpzvr'```",
          "likeCount" : 0,
          "commentCount" : 0,
          "viewCount" : 0,
          "created" : "2026-01-25T08:20:06.015326",
          "score" : 1.0
        },
        "workspace" : {
          "id" : "85451d95-3510-4782-9f62-056441af2e35",
          "name" : "Test Workspace [2026-01-25T08:20:05.551278834]"
        }
      },
      "_links" : {
        "self" : {
          "href" : "https://app.matatika.com/api/notifications/6730ed6e-72cc-422c-b8d9-9e720305afde"
        },
        "delete notification" : {
          "href" : "https://app.matatika.com/api/notifications/6730ed6e-72cc-422c-b8d9-9e720305afde",
          "type" : "DELETE"
        },
        "channel" : {
          "href" : "https://app.matatika.com/api/channels/23043860-c8eb-47fe-a625-28e3fc4cefb0"
        },
        "datasetComment" : {
          "href" : "https://app.matatika.com/api/comments/32b30e69-add0-4741-9bfe-a8bb37e6cb52"
        },
        "dataset" : {
          "href" : "https://app.matatika.com/api/datasets/bcd6beb6-8008-4bc4-82b2-4722251ffcba"
        },
        "data" : {
          "href" : "https://app.matatika.com/api/datasets/bcd6beb6-8008-4bc4-82b2-4722251ffcba/data"
        },
        "workspace" : {
          "href" : "https://app.matatika.com/api/workspaces/85451d95-3510-4782-9f62-056441af2e35"
        }
      }
    }, {
      "id" : "447232ed-f0d8-422b-affd-cdfe04fe2e61",
      "created" : "2026-01-25T08:20:11.941864",
      "lastModified" : "2026-01-25T08:20:11.941865",
      "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" : "80ada05c-4bb7-4159-bee2-261031b0d82b",
          "message" : "SIT-generated comment",
          "likeCount" : 0,
          "created" : "2026-01-25T08:20:11.589951",
          "lastModified" : "2026-01-25T08:20:11.589952",
          "from" : {
            "id" : "auth0|5eb0327cbfd7490bff55feeb",
            "name" : "[email protected]",
            "handle" : "@sit+prod"
          },
          "commentCount" : 0,
          "datasetId" : "bcd6beb6-8008-4bc4-82b2-4722251ffcba"
        },
        "dataset" : {
          "id" : "bcd6beb6-8008-4bc4-82b2-4722251ffcba",
          "published" : "2026-01-25T08:20:06.015327",
          "alias" : "analytics-tables",
          "workspaceId" : "85451d95-3510-4782-9f62-056441af2e35",
          "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 = 'gblpzvr'```",
          "likeCount" : 0,
          "commentCount" : 0,
          "viewCount" : 0,
          "created" : "2026-01-25T08:20:06.015326",
          "score" : 1.0
        },
        "workspace" : {
          "id" : "85451d95-3510-4782-9f62-056441af2e35",
          "name" : "Test Workspace [2026-01-25T08:20:05.551278834]"
        }
      },
      "_links" : {
        "self" : {
          "href" : "https://app.matatika.com/api/notifications/447232ed-f0d8-422b-affd-cdfe04fe2e61"
        },
        "delete notification" : {
          "href" : "https://app.matatika.com/api/notifications/447232ed-f0d8-422b-affd-cdfe04fe2e61",
          "type" : "DELETE"
        },
        "channel" : {
          "href" : "https://app.matatika.com/api/channels/23043860-c8eb-47fe-a625-28e3fc4cefb0"
        },
        "datasetComment" : {
          "href" : "https://app.matatika.com/api/comments/80ada05c-4bb7-4159-bee2-261031b0d82b"
        },
        "dataset" : {
          "href" : "https://app.matatika.com/api/datasets/bcd6beb6-8008-4bc4-82b2-4722251ffcba"
        },
        "data" : {
          "href" : "https://app.matatika.com/api/datasets/bcd6beb6-8008-4bc4-82b2-4722251ffcba/data"
        },
        "workspace" : {
          "href" : "https://app.matatika.com/api/workspaces/85451d95-3510-4782-9f62-056441af2e35"
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://app.matatika.com/api/notifications?before=2026-01-25T08%3A20%3A12.940330897&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/85451d95-3510-4782-9f62-056441af2e35/notifications?before=2026-01-25T08%3A20%3A13.064310119&since=2021-01-01T00%3A00' -i -X GET

Python (requests)

import requests

url = "https://app.matatika.com/api/workspaces/85451d95-3510-4782-9f62-056441af2e35/notifications?before=2026-01-25T08%3A20%3A13.064310119&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" : "53fe3b03-ed58-4bc3-a2ae-e12a30a2fd4f",
      "created" : "2026-01-25T08:20:12.225782",
      "lastModified" : "2026-01-25T08:20:12.225782",
      "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" : "aa16b0fa-c7b7-4a48-ad2f-5be58091d24a",
          "message" : "SIT-generated comment",
          "likeCount" : 0,
          "created" : "2026-01-25T08:20:11.867434",
          "lastModified" : "2026-01-25T08:20:11.867434",
          "from" : {
            "id" : "auth0|5eb0327cbfd7490bff55feeb",
            "name" : "[email protected]",
            "handle" : "@sit+prod"
          },
          "commentCount" : 0,
          "datasetId" : "bcd6beb6-8008-4bc4-82b2-4722251ffcba"
        },
        "dataset" : {
          "id" : "bcd6beb6-8008-4bc4-82b2-4722251ffcba",
          "published" : "2026-01-25T08:20:06.015327",
          "alias" : "analytics-tables",
          "workspaceId" : "85451d95-3510-4782-9f62-056441af2e35",
          "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 = 'gblpzvr'```",
          "likeCount" : 0,
          "commentCount" : 0,
          "viewCount" : 0,
          "created" : "2026-01-25T08:20:06.015326",
          "score" : 1.0
        },
        "workspace" : {
          "id" : "85451d95-3510-4782-9f62-056441af2e35",
          "name" : "Test Workspace [2026-01-25T08:20:05.551278834]"
        }
      },
      "_links" : {
        "self" : {
          "href" : "https://app.matatika.com/api/notifications/53fe3b03-ed58-4bc3-a2ae-e12a30a2fd4f"
        },
        "delete notification" : {
          "href" : "https://app.matatika.com/api/notifications/53fe3b03-ed58-4bc3-a2ae-e12a30a2fd4f",
          "type" : "DELETE"
        },
        "channel" : {
          "href" : "https://app.matatika.com/api/channels/23043860-c8eb-47fe-a625-28e3fc4cefb0"
        },
        "datasetComment" : {
          "href" : "https://app.matatika.com/api/comments/aa16b0fa-c7b7-4a48-ad2f-5be58091d24a"
        },
        "dataset" : {
          "href" : "https://app.matatika.com/api/datasets/bcd6beb6-8008-4bc4-82b2-4722251ffcba"
        },
        "data" : {
          "href" : "https://app.matatika.com/api/datasets/bcd6beb6-8008-4bc4-82b2-4722251ffcba/data"
        },
        "workspace" : {
          "href" : "https://app.matatika.com/api/workspaces/85451d95-3510-4782-9f62-056441af2e35"
        }
      }
    }, {
      "id" : "6730ed6e-72cc-422c-b8d9-9e720305afde",
      "created" : "2026-01-25T08:20:11.997452",
      "lastModified" : "2026-01-25T08:20:11.997453",
      "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" : "32b30e69-add0-4741-9bfe-a8bb37e6cb52",
          "message" : "SIT-generated comment",
          "likeCount" : 0,
          "created" : "2026-01-25T08:20:11.750775",
          "lastModified" : "2026-01-25T08:20:11.750775",
          "from" : {
            "id" : "auth0|5eb0327cbfd7490bff55feeb",
            "name" : "[email protected]",
            "handle" : "@sit+prod"
          },
          "commentCount" : 0,
          "datasetId" : "bcd6beb6-8008-4bc4-82b2-4722251ffcba"
        },
        "dataset" : {
          "id" : "bcd6beb6-8008-4bc4-82b2-4722251ffcba",
          "published" : "2026-01-25T08:20:06.015327",
          "alias" : "analytics-tables",
          "workspaceId" : "85451d95-3510-4782-9f62-056441af2e35",
          "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 = 'gblpzvr'```",
          "likeCount" : 0,
          "commentCount" : 0,
          "viewCount" : 0,
          "created" : "2026-01-25T08:20:06.015326",
          "score" : 1.0
        },
        "workspace" : {
          "id" : "85451d95-3510-4782-9f62-056441af2e35",
          "name" : "Test Workspace [2026-01-25T08:20:05.551278834]"
        }
      },
      "_links" : {
        "self" : {
          "href" : "https://app.matatika.com/api/notifications/6730ed6e-72cc-422c-b8d9-9e720305afde"
        },
        "delete notification" : {
          "href" : "https://app.matatika.com/api/notifications/6730ed6e-72cc-422c-b8d9-9e720305afde",
          "type" : "DELETE"
        },
        "channel" : {
          "href" : "https://app.matatika.com/api/channels/23043860-c8eb-47fe-a625-28e3fc4cefb0"
        },
        "datasetComment" : {
          "href" : "https://app.matatika.com/api/comments/32b30e69-add0-4741-9bfe-a8bb37e6cb52"
        },
        "dataset" : {
          "href" : "https://app.matatika.com/api/datasets/bcd6beb6-8008-4bc4-82b2-4722251ffcba"
        },
        "data" : {
          "href" : "https://app.matatika.com/api/datasets/bcd6beb6-8008-4bc4-82b2-4722251ffcba/data"
        },
        "workspace" : {
          "href" : "https://app.matatika.com/api/workspaces/85451d95-3510-4782-9f62-056441af2e35"
        }
      }
    }, {
      "id" : "447232ed-f0d8-422b-affd-cdfe04fe2e61",
      "created" : "2026-01-25T08:20:11.941864",
      "lastModified" : "2026-01-25T08:20:11.941865",
      "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" : "80ada05c-4bb7-4159-bee2-261031b0d82b",
          "message" : "SIT-generated comment",
          "likeCount" : 0,
          "created" : "2026-01-25T08:20:11.589951",
          "lastModified" : "2026-01-25T08:20:11.589952",
          "from" : {
            "id" : "auth0|5eb0327cbfd7490bff55feeb",
            "name" : "[email protected]",
            "handle" : "@sit+prod"
          },
          "commentCount" : 0,
          "datasetId" : "bcd6beb6-8008-4bc4-82b2-4722251ffcba"
        },
        "dataset" : {
          "id" : "bcd6beb6-8008-4bc4-82b2-4722251ffcba",
          "published" : "2026-01-25T08:20:06.015327",
          "alias" : "analytics-tables",
          "workspaceId" : "85451d95-3510-4782-9f62-056441af2e35",
          "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 = 'gblpzvr'```",
          "likeCount" : 0,
          "commentCount" : 0,
          "viewCount" : 0,
          "created" : "2026-01-25T08:20:06.015326",
          "score" : 1.0
        },
        "workspace" : {
          "id" : "85451d95-3510-4782-9f62-056441af2e35",
          "name" : "Test Workspace [2026-01-25T08:20:05.551278834]"
        }
      },
      "_links" : {
        "self" : {
          "href" : "https://app.matatika.com/api/notifications/447232ed-f0d8-422b-affd-cdfe04fe2e61"
        },
        "delete notification" : {
          "href" : "https://app.matatika.com/api/notifications/447232ed-f0d8-422b-affd-cdfe04fe2e61",
          "type" : "DELETE"
        },
        "channel" : {
          "href" : "https://app.matatika.com/api/channels/23043860-c8eb-47fe-a625-28e3fc4cefb0"
        },
        "datasetComment" : {
          "href" : "https://app.matatika.com/api/comments/80ada05c-4bb7-4159-bee2-261031b0d82b"
        },
        "dataset" : {
          "href" : "https://app.matatika.com/api/datasets/bcd6beb6-8008-4bc4-82b2-4722251ffcba"
        },
        "data" : {
          "href" : "https://app.matatika.com/api/datasets/bcd6beb6-8008-4bc4-82b2-4722251ffcba/data"
        },
        "workspace" : {
          "href" : "https://app.matatika.com/api/workspaces/85451d95-3510-4782-9f62-056441af2e35"
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://app.matatika.com/api/workspaces/85451d95-3510-4782-9f62-056441af2e35/notifications?before=2026-01-25T08%3A20%3A13.064310119&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/53fe3b03-ed58-4bc3-a2ae-e12a30a2fd4f' -i -X GET

Python (requests)

import requests

url = "https://app.matatika.com/api/notifications/53fe3b03-ed58-4bc3-a2ae-e12a30a2fd4f"

headers = {
  'Authorization': ACCESS_TOKEN
}

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

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

Response

200 OK

Notification with HAL links.

{
  "id" : "53fe3b03-ed58-4bc3-a2ae-e12a30a2fd4f",
  "created" : "2026-01-25T08:20:12.225782",
  "lastModified" : "2026-01-25T08:20:12.225782",
  "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" : "aa16b0fa-c7b7-4a48-ad2f-5be58091d24a",
      "message" : "SIT-generated comment",
      "likeCount" : 0,
      "created" : "2026-01-25T08:20:11.867434",
      "lastModified" : "2026-01-25T08:20:11.867434",
      "from" : {
        "id" : "auth0|5eb0327cbfd7490bff55feeb",
        "name" : "[email protected]",
        "handle" : "@sit+prod"
      },
      "commentCount" : 0,
      "datasetId" : "bcd6beb6-8008-4bc4-82b2-4722251ffcba"
    },
    "dataset" : {
      "id" : "bcd6beb6-8008-4bc4-82b2-4722251ffcba",
      "published" : "2026-01-25T08:20:06.015327",
      "alias" : "analytics-tables",
      "workspaceId" : "85451d95-3510-4782-9f62-056441af2e35",
      "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 = 'gblpzvr'```",
      "likeCount" : 0,
      "commentCount" : 0,
      "viewCount" : 0,
      "created" : "2026-01-25T08:20:06.015326",
      "score" : 1.0
    },
    "workspace" : {
      "id" : "85451d95-3510-4782-9f62-056441af2e35",
      "name" : "Test Workspace [2026-01-25T08:20:05.551278834]"
    }
  },
  "_links" : {
    "self" : {
      "href" : "https://app.matatika.com/api/notifications/53fe3b03-ed58-4bc3-a2ae-e12a30a2fd4f"
    },
    "delete notification" : {
      "href" : "https://app.matatika.com/api/notifications/53fe3b03-ed58-4bc3-a2ae-e12a30a2fd4f",
      "type" : "DELETE"
    },
    "channel" : {
      "href" : "https://app.matatika.com/api/channels/23043860-c8eb-47fe-a625-28e3fc4cefb0"
    },
    "datasetComment" : {
      "href" : "https://app.matatika.com/api/comments/aa16b0fa-c7b7-4a48-ad2f-5be58091d24a"
    },
    "dataset" : {
      "href" : "https://app.matatika.com/api/datasets/bcd6beb6-8008-4bc4-82b2-4722251ffcba"
    },
    "data" : {
      "href" : "https://app.matatika.com/api/datasets/bcd6beb6-8008-4bc4-82b2-4722251ffcba/data"
    },
    "workspace" : {
      "href" : "https://app.matatika.com/api/workspaces/85451d95-3510-4782-9f62-056441af2e35"
    }
  }
}

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=2026-01-25T08%3A20%3A16.002982' -i -X PUT \
    -H 'Content-Type: application/json'

Python (requests)

import requests

url = "https://app.matatika.com/api/notifications?since=2026-01-25T08%3A20%3A16.002982"

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" : "83c31fc0-a755-4d1b-a6c4-5fd10b72bc00",
      "created" : "2026-01-25T08:20:17.217884",
      "lastModified" : "2026-01-25T08:20:17.217885",
      "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" : "b5f2e53e-a201-4364-a376-6147d0356b45",
          "message" : "SIT-generated comment",
          "likeCount" : 0,
          "created" : "2026-01-25T08:20:16.753061",
          "lastModified" : "2026-01-25T08:20:16.753061",
          "from" : {
            "id" : "auth0|5eb0327cbfd7490bff55feeb",
            "name" : "[email protected]",
            "handle" : "@sit+prod"
          },
          "commentCount" : 0,
          "datasetId" : "bcd6beb6-8008-4bc4-82b2-4722251ffcba"
        },
        "dataset" : {
          "id" : "bcd6beb6-8008-4bc4-82b2-4722251ffcba",
          "published" : "2026-01-25T08:20:06.015327",
          "alias" : "analytics-tables",
          "workspaceId" : "85451d95-3510-4782-9f62-056441af2e35",
          "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 = 'gblpzvr'```",
          "likeCount" : 0,
          "commentCount" : 0,
          "viewCount" : 0,
          "created" : "2026-01-25T08:20:06.015326",
          "score" : 1.0
        },
        "workspace" : {
          "id" : "85451d95-3510-4782-9f62-056441af2e35",
          "name" : "Test Workspace [2026-01-25T08:20:05.551278834]"
        }
      },
      "_links" : {
        "self" : {
          "href" : "https://app.matatika.com/api/notifications/83c31fc0-a755-4d1b-a6c4-5fd10b72bc00"
        },
        "delete notification" : {
          "href" : "https://app.matatika.com/api/notifications/83c31fc0-a755-4d1b-a6c4-5fd10b72bc00",
          "type" : "DELETE"
        },
        "channel" : {
          "href" : "https://app.matatika.com/api/channels/23043860-c8eb-47fe-a625-28e3fc4cefb0"
        },
        "datasetComment" : {
          "href" : "https://app.matatika.com/api/comments/b5f2e53e-a201-4364-a376-6147d0356b45"
        },
        "dataset" : {
          "href" : "https://app.matatika.com/api/datasets/bcd6beb6-8008-4bc4-82b2-4722251ffcba"
        },
        "data" : {
          "href" : "https://app.matatika.com/api/datasets/bcd6beb6-8008-4bc4-82b2-4722251ffcba/data"
        },
        "workspace" : {
          "href" : "https://app.matatika.com/api/workspaces/85451d95-3510-4782-9f62-056441af2e35"
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://app.matatika.com/api/notifications?since=2026-01-25T08%3A20%3A16.002982&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/53fe3b03-ed58-4bc3-a2ae-e12a30a2fd4f' -i -X DELETE

Python (requests)

import requests

url = "https://app.matatika.com/api/notifications/53fe3b03-ed58-4bc3-a2ae-e12a30a2fd4f"

headers = {
  'Authorization': ACCESS_TOKEN
}

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

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

Response

204 No Content

No response body provided.