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" : "80fbe5b8-5aa0-4102-8001-7d5c72553541",
"created" : "2026-08-07T13:29:00.271184",
"lastModified" : "2026-08-07T13:29:00.271186",
"type" : "DATASET_COMMENT",
"actor" : {
"id" : "auth0|6a21dc7aa1db2e036a222942",
"name" : "sit+prod@meltano.com",
"handle" : "@sit+prod"
},
"resolved" : false,
"_embedded" : {
"subscriberProfile" : {
"id" : "auth0|6a21dc7aa1db2e036a222942",
"name" : "sit+prod@meltano.com",
"handle" : "@sit+prod"
},
"channel" : {
"name" : "no-picture",
"description" : "No picture",
"picture" : "https://s.gravatar.com/avatar/357b18eea0ae8abd799a31e2ca1ad3e5?s=480&r=pg&d=https%3A%2F%2Fcdn.auth0.com%2Favatars%2Fsi.png"
},
"datasetComment" : {
"id" : "072eab0b-bc84-4f68-8fb5-0d478d1e2dc8",
"message" : "SIT-generated comment",
"likeCount" : 0,
"created" : "2026-08-07T13:28:58.757322",
"lastModified" : "2026-08-07T13:28:58.757322",
"from" : {
"id" : "auth0|6a21dc7aa1db2e036a222942",
"name" : "sit+prod@meltano.com",
"handle" : "@sit+prod"
},
"commentCount" : 0,
"datasetId" : "c45c50cc-1e1d-4fc3-a354-e9b32a0680f1"
},
"dataset" : {
"id" : "c45c50cc-1e1d-4fc3-a354-e9b32a0680f1",
"published" : "2026-08-07T13:28:52.767593",
"alias" : "analytics-tables",
"workspaceId" : "ca80c936-e80b-4656-87d4-3c0e34f5edf6",
"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 = 'kozmlnt'```",
"likeCount" : 0,
"commentCount" : 0,
"viewCount" : 0,
"created" : "2026-08-07T13:28:52.784822",
"score" : 1.0
},
"workspace" : {
"id" : "ca80c936-e80b-4656-87d4-3c0e34f5edf6",
"name" : "Test Workspace [2026-08-07T13:28:52.077256923]"
}
},
"_links" : {
"self" : {
"href" : "https://app.meltano.com/api/notifications/80fbe5b8-5aa0-4102-8001-7d5c72553541"
},
"delete notification" : {
"href" : "https://app.meltano.com/api/notifications/80fbe5b8-5aa0-4102-8001-7d5c72553541",
"type" : "DELETE"
},
"channel" : {
"href" : "https://app.meltano.com/api/channels/94312fd5-1516-4a66-8dc7-3a82b99fa05d"
},
"datasetComment" : {
"href" : "https://app.meltano.com/api/comments/072eab0b-bc84-4f68-8fb5-0d478d1e2dc8"
},
"dataset" : {
"href" : "https://app.meltano.com/api/datasets/c45c50cc-1e1d-4fc3-a354-e9b32a0680f1"
},
"data" : {
"href" : "https://app.meltano.com/api/datasets/c45c50cc-1e1d-4fc3-a354-e9b32a0680f1/data"
},
"workspace" : {
"href" : "https://app.meltano.com/api/workspaces/ca80c936-e80b-4656-87d4-3c0e34f5edf6"
}
}
}
Formats
Notification Type
string
| Value | Description |
|---|---|
DATASET_ACTIVITY | Any activity on the dataset |
DATASET_ANOMALY | A detected anomaly 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
View all notifications
GET /api/notifications?all={all}&before={before}&since={since}
Returns all notifications for the authenticated user profile.
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 |
Examples
- cURL
- Python (requests)
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.meltano.com:443/api/notifications?before=2026-08-07T13%3A29%3A00.920516912&since=2021-01-01T00%3A00' -i -X GET
import requests
url = "https://app.meltano.com:443/api/notifications?before=2026-08-07T13%3A29%3A00.920516912&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" : "80fbe5b8-5aa0-4102-8001-7d5c72553541",
"created" : "2026-08-07T13:29:00.271184",
"lastModified" : "2026-08-07T13:29:00.271186",
"type" : "DATASET_COMMENT",
"actor" : {
"id" : "auth0|6a21dc7aa1db2e036a222942",
"name" : "sit+prod@meltano.com",
"handle" : "@sit+prod"
},
"resolved" : false,
"_embedded" : {
"subscriberProfile" : {
"id" : "auth0|6a21dc7aa1db2e036a222942",
"name" : "sit+prod@meltano.com",
"handle" : "@sit+prod"
},
"channel" : {
"name" : "no-picture",
"description" : "No picture",
"picture" : "https://s.gravatar.com/avatar/357b18eea0ae8abd799a31e2ca1ad3e5?s=480&r=pg&d=https%3A%2F%2Fcdn.auth0.com%2Favatars%2Fsi.png"
},
"datasetComment" : {
"id" : "072eab0b-bc84-4f68-8fb5-0d478d1e2dc8",
"message" : "SIT-generated comment",
"likeCount" : 0,
"created" : "2026-08-07T13:28:58.757322",
"lastModified" : "2026-08-07T13:28:58.757322",
"from" : {
"id" : "auth0|6a21dc7aa1db2e036a222942",
"name" : "sit+prod@meltano.com",
"handle" : "@sit+prod"
},
"commentCount" : 0,
"datasetId" : "c45c50cc-1e1d-4fc3-a354-e9b32a0680f1"
},
"dataset" : {
"id" : "c45c50cc-1e1d-4fc3-a354-e9b32a0680f1",
"published" : "2026-08-07T13:28:52.767593",
"alias" : "analytics-tables",
"workspaceId" : "ca80c936-e80b-4656-87d4-3c0e34f5edf6",
"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 = 'kozmlnt'```",
"likeCount" : 0,
"commentCount" : 0,
"viewCount" : 0,
"created" : "2026-08-07T13:28:52.784822",
"score" : 1.0
},
"workspace" : {
"id" : "ca80c936-e80b-4656-87d4-3c0e34f5edf6",
"name" : "Test Workspace [2026-08-07T13:28:52.077256923]"
}
},
"_links" : {
"self" : {
"href" : "https://app.meltano.com/api/notifications/80fbe5b8-5aa0-4102-8001-7d5c72553541"
},
"delete notification" : {
"href" : "https://app.meltano.com/api/notifications/80fbe5b8-5aa0-4102-8001-7d5c72553541",
"type" : "DELETE"
},
"channel" : {
"href" : "https://app.meltano.com/api/channels/94312fd5-1516-4a66-8dc7-3a82b99fa05d"
},
"datasetComment" : {
"href" : "https://app.meltano.com/api/comments/072eab0b-bc84-4f68-8fb5-0d478d1e2dc8"
},
"dataset" : {
"href" : "https://app.meltano.com/api/datasets/c45c50cc-1e1d-4fc3-a354-e9b32a0680f1"
},
"data" : {
"href" : "https://app.meltano.com/api/datasets/c45c50cc-1e1d-4fc3-a354-e9b32a0680f1/data"
},
"workspace" : {
"href" : "https://app.meltano.com/api/workspaces/ca80c936-e80b-4656-87d4-3c0e34f5edf6"
}
}
}, {
"id" : "9bbd4cf5-2718-4883-8ee4-8d1cf2c00416",
"created" : "2026-08-07T13:29:00.176083",
"lastModified" : "2026-08-07T13:29:00.176084",
"type" : "DATASET_COMMENT",
"actor" : {
"id" : "auth0|6a21dc7aa1db2e036a222942",
"name" : "sit+prod@meltano.com",
"handle" : "@sit+prod"
},
"resolved" : false,
"_embedded" : {
"subscriberProfile" : {
"id" : "auth0|6a21dc7aa1db2e036a222942",
"name" : "sit+prod@meltano.com",
"handle" : "@sit+prod"
},
"channel" : {
"name" : "no-picture",
"description" : "No picture",
"picture" : "https://s.gravatar.com/avatar/357b18eea0ae8abd799a31e2ca1ad3e5?s=480&r=pg&d=https%3A%2F%2Fcdn.auth0.com%2Favatars%2Fsi.png"
},
"datasetComment" : {
"id" : "4b23d10f-e6fd-460e-936e-00b5dfa8ff8f",
"message" : "SIT-generated comment",
"likeCount" : 0,
"created" : "2026-08-07T13:28:58.618472",
"lastModified" : "2026-08-07T13:28:58.618472",
"from" : {
"id" : "auth0|6a21dc7aa1db2e036a222942",
"name" : "sit+prod@meltano.com",
"handle" : "@sit+prod"
},
"commentCount" : 0,
"datasetId" : "c45c50cc-1e1d-4fc3-a354-e9b32a0680f1"
},
"dataset" : {
"id" : "c45c50cc-1e1d-4fc3-a354-e9b32a0680f1",
"published" : "2026-08-07T13:28:52.767593",
"alias" : "analytics-tables",
"workspaceId" : "ca80c936-e80b-4656-87d4-3c0e34f5edf6",
"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 = 'kozmlnt'```",
"likeCount" : 0,
"commentCount" : 0,
"viewCount" : 0,
"created" : "2026-08-07T13:28:52.784822",
"score" : 1.0
},
"workspace" : {
"id" : "ca80c936-e80b-4656-87d4-3c0e34f5edf6",
"name" : "Test Workspace [2026-08-07T13:28:52.077256923]"
}
},
"_links" : {
"self" : {
"href" : "https://app.meltano.com/api/notifications/9bbd4cf5-2718-4883-8ee4-8d1cf2c00416"
},
"delete notification" : {
"href" : "https://app.meltano.com/api/notifications/9bbd4cf5-2718-4883-8ee4-8d1cf2c00416",
"type" : "DELETE"
},
"channel" : {
"href" : "https://app.meltano.com/api/channels/94312fd5-1516-4a66-8dc7-3a82b99fa05d"
},
"datasetComment" : {
"href" : "https://app.meltano.com/api/comments/4b23d10f-e6fd-460e-936e-00b5dfa8ff8f"
},
"dataset" : {
"href" : "https://app.meltano.com/api/datasets/c45c50cc-1e1d-4fc3-a354-e9b32a0680f1"
},
"data" : {
"href" : "https://app.meltano.com/api/datasets/c45c50cc-1e1d-4fc3-a354-e9b32a0680f1/data"
},
"workspace" : {
"href" : "https://app.meltano.com/api/workspaces/ca80c936-e80b-4656-87d4-3c0e34f5edf6"
}
}
}, {
"id" : "5e57d52c-5e1b-40d2-b0de-616a7291968d",
"created" : "2026-08-07T13:29:00.071408",
"lastModified" : "2026-08-07T13:29:00.07141",
"type" : "DATASET_COMMENT",
"actor" : {
"id" : "auth0|6a21dc7aa1db2e036a222942",
"name" : "sit+prod@meltano.com",
"handle" : "@sit+prod"
},
"resolved" : false,
"_embedded" : {
"subscriberProfile" : {
"id" : "auth0|6a21dc7aa1db2e036a222942",
"name" : "sit+prod@meltano.com",
"handle" : "@sit+prod"
},
"channel" : {
"name" : "no-picture",
"description" : "No picture",
"picture" : "https://s.gravatar.com/avatar/357b18eea0ae8abd799a31e2ca1ad3e5?s=480&r=pg&d=https%3A%2F%2Fcdn.auth0.com%2Favatars%2Fsi.png"
},
"datasetComment" : {
"id" : "cfda9d76-7697-4bc7-bcad-34dc96312ca1",
"message" : "SIT-generated comment",
"likeCount" : 0,
"created" : "2026-08-07T13:28:58.453373",
"lastModified" : "2026-08-07T13:28:58.453374",
"from" : {
"id" : "auth0|6a21dc7aa1db2e036a222942",
"name" : "sit+prod@meltano.com",
"handle" : "@sit+prod"
},
"commentCount" : 0,
"datasetId" : "c45c50cc-1e1d-4fc3-a354-e9b32a0680f1"
},
"dataset" : {
"id" : "c45c50cc-1e1d-4fc3-a354-e9b32a0680f1",
"published" : "2026-08-07T13:28:52.767593",
"alias" : "analytics-tables",
"workspaceId" : "ca80c936-e80b-4656-87d4-3c0e34f5edf6",
"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 = 'kozmlnt'```",
"likeCount" : 0,
"commentCount" : 0,
"viewCount" : 0,
"created" : "2026-08-07T13:28:52.784822",
"score" : 1.0
},
"workspace" : {
"id" : "ca80c936-e80b-4656-87d4-3c0e34f5edf6",
"name" : "Test Workspace [2026-08-07T13:28:52.077256923]"
}
},
"_links" : {
"self" : {
"href" : "https://app.meltano.com/api/notifications/5e57d52c-5e1b-40d2-b0de-616a7291968d"
},
"delete notification" : {
"href" : "https://app.meltano.com/api/notifications/5e57d52c-5e1b-40d2-b0de-616a7291968d",
"type" : "DELETE"
},
"channel" : {
"href" : "https://app.meltano.com/api/channels/94312fd5-1516-4a66-8dc7-3a82b99fa05d"
},
"datasetComment" : {
"href" : "https://app.meltano.com/api/comments/cfda9d76-7697-4bc7-bcad-34dc96312ca1"
},
"dataset" : {
"href" : "https://app.meltano.com/api/datasets/c45c50cc-1e1d-4fc3-a354-e9b32a0680f1"
},
"data" : {
"href" : "https://app.meltano.com/api/datasets/c45c50cc-1e1d-4fc3-a354-e9b32a0680f1/data"
},
"workspace" : {
"href" : "https://app.meltano.com/api/workspaces/ca80c936-e80b-4656-87d4-3c0e34f5edf6"
}
}
} ]
},
"_links" : {
"self" : {
"href" : "https://app.meltano.com/api/notifications?before=2026-08-07T13%3A29%3A00.920516912&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
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 |
Examples
- cURL
- Python (requests)
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.meltano.com:443/api/workspaces/ca80c936-e80b-4656-87d4-3c0e34f5edf6/notifications?before=2026-08-07T13%3A29%3A01.032160834&since=2021-01-01T00%3A00' -i -X GET
import requests
url = "https://app.meltano.com:443/api/workspaces/ca80c936-e80b-4656-87d4-3c0e34f5edf6/notifications?before=2026-08-07T13%3A29%3A01.032160834&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" : "80fbe5b8-5aa0-4102-8001-7d5c72553541",
"created" : "2026-08-07T13:29:00.271184",
"lastModified" : "2026-08-07T13:29:00.271186",
"type" : "DATASET_COMMENT",
"actor" : {
"id" : "auth0|6a21dc7aa1db2e036a222942",
"name" : "sit+prod@meltano.com",
"handle" : "@sit+prod"
},
"resolved" : false,
"_embedded" : {
"subscriberProfile" : {
"id" : "auth0|6a21dc7aa1db2e036a222942",
"name" : "sit+prod@meltano.com",
"handle" : "@sit+prod"
},
"channel" : {
"name" : "no-picture",
"description" : "No picture",
"picture" : "https://s.gravatar.com/avatar/357b18eea0ae8abd799a31e2ca1ad3e5?s=480&r=pg&d=https%3A%2F%2Fcdn.auth0.com%2Favatars%2Fsi.png"
},
"datasetComment" : {
"id" : "072eab0b-bc84-4f68-8fb5-0d478d1e2dc8",
"message" : "SIT-generated comment",
"likeCount" : 0,
"created" : "2026-08-07T13:28:58.757322",
"lastModified" : "2026-08-07T13:28:58.757322",
"from" : {
"id" : "auth0|6a21dc7aa1db2e036a222942",
"name" : "sit+prod@meltano.com",
"handle" : "@sit+prod"
},
"commentCount" : 0,
"datasetId" : "c45c50cc-1e1d-4fc3-a354-e9b32a0680f1"
},
"dataset" : {
"id" : "c45c50cc-1e1d-4fc3-a354-e9b32a0680f1",
"published" : "2026-08-07T13:28:52.767593",
"alias" : "analytics-tables",
"workspaceId" : "ca80c936-e80b-4656-87d4-3c0e34f5edf6",
"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 = 'kozmlnt'```",
"likeCount" : 0,
"commentCount" : 0,
"viewCount" : 0,
"created" : "2026-08-07T13:28:52.784822",
"score" : 1.0
},
"workspace" : {
"id" : "ca80c936-e80b-4656-87d4-3c0e34f5edf6",
"name" : "Test Workspace [2026-08-07T13:28:52.077256923]"
}
},
"_links" : {
"self" : {
"href" : "https://app.meltano.com/api/notifications/80fbe5b8-5aa0-4102-8001-7d5c72553541"
},
"delete notification" : {
"href" : "https://app.meltano.com/api/notifications/80fbe5b8-5aa0-4102-8001-7d5c72553541",
"type" : "DELETE"
},
"channel" : {
"href" : "https://app.meltano.com/api/channels/94312fd5-1516-4a66-8dc7-3a82b99fa05d"
},
"datasetComment" : {
"href" : "https://app.meltano.com/api/comments/072eab0b-bc84-4f68-8fb5-0d478d1e2dc8"
},
"dataset" : {
"href" : "https://app.meltano.com/api/datasets/c45c50cc-1e1d-4fc3-a354-e9b32a0680f1"
},
"data" : {
"href" : "https://app.meltano.com/api/datasets/c45c50cc-1e1d-4fc3-a354-e9b32a0680f1/data"
},
"workspace" : {
"href" : "https://app.meltano.com/api/workspaces/ca80c936-e80b-4656-87d4-3c0e34f5edf6"
}
}
}, {
"id" : "9bbd4cf5-2718-4883-8ee4-8d1cf2c00416",
"created" : "2026-08-07T13:29:00.176083",
"lastModified" : "2026-08-07T13:29:00.176084",
"type" : "DATASET_COMMENT",
"actor" : {
"id" : "auth0|6a21dc7aa1db2e036a222942",
"name" : "sit+prod@meltano.com",
"handle" : "@sit+prod"
},
"resolved" : false,
"_embedded" : {
"subscriberProfile" : {
"id" : "auth0|6a21dc7aa1db2e036a222942",
"name" : "sit+prod@meltano.com",
"handle" : "@sit+prod"
},
"channel" : {
"name" : "no-picture",
"description" : "No picture",
"picture" : "https://s.gravatar.com/avatar/357b18eea0ae8abd799a31e2ca1ad3e5?s=480&r=pg&d=https%3A%2F%2Fcdn.auth0.com%2Favatars%2Fsi.png"
},
"datasetComment" : {
"id" : "4b23d10f-e6fd-460e-936e-00b5dfa8ff8f",
"message" : "SIT-generated comment",
"likeCount" : 0,
"created" : "2026-08-07T13:28:58.618472",
"lastModified" : "2026-08-07T13:28:58.618472",
"from" : {
"id" : "auth0|6a21dc7aa1db2e036a222942",
"name" : "sit+prod@meltano.com",
"handle" : "@sit+prod"
},
"commentCount" : 0,
"datasetId" : "c45c50cc-1e1d-4fc3-a354-e9b32a0680f1"
},
"dataset" : {
"id" : "c45c50cc-1e1d-4fc3-a354-e9b32a0680f1",
"published" : "2026-08-07T13:28:52.767593",
"alias" : "analytics-tables",
"workspaceId" : "ca80c936-e80b-4656-87d4-3c0e34f5edf6",
"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 = 'kozmlnt'```",
"likeCount" : 0,
"commentCount" : 0,
"viewCount" : 0,
"created" : "2026-08-07T13:28:52.784822",
"score" : 1.0
},
"workspace" : {
"id" : "ca80c936-e80b-4656-87d4-3c0e34f5edf6",
"name" : "Test Workspace [2026-08-07T13:28:52.077256923]"
}
},
"_links" : {
"self" : {
"href" : "https://app.meltano.com/api/notifications/9bbd4cf5-2718-4883-8ee4-8d1cf2c00416"
},
"delete notification" : {
"href" : "https://app.meltano.com/api/notifications/9bbd4cf5-2718-4883-8ee4-8d1cf2c00416",
"type" : "DELETE"
},
"channel" : {
"href" : "https://app.meltano.com/api/channels/94312fd5-1516-4a66-8dc7-3a82b99fa05d"
},
"datasetComment" : {
"href" : "https://app.meltano.com/api/comments/4b23d10f-e6fd-460e-936e-00b5dfa8ff8f"
},
"dataset" : {
"href" : "https://app.meltano.com/api/datasets/c45c50cc-1e1d-4fc3-a354-e9b32a0680f1"
},
"data" : {
"href" : "https://app.meltano.com/api/datasets/c45c50cc-1e1d-4fc3-a354-e9b32a0680f1/data"
},
"workspace" : {
"href" : "https://app.meltano.com/api/workspaces/ca80c936-e80b-4656-87d4-3c0e34f5edf6"
}
}
}, {
"id" : "5e57d52c-5e1b-40d2-b0de-616a7291968d",
"created" : "2026-08-07T13:29:00.071408",
"lastModified" : "2026-08-07T13:29:00.07141",
"type" : "DATASET_COMMENT",
"actor" : {
"id" : "auth0|6a21dc7aa1db2e036a222942",
"name" : "sit+prod@meltano.com",
"handle" : "@sit+prod"
},
"resolved" : false,
"_embedded" : {
"subscriberProfile" : {
"id" : "auth0|6a21dc7aa1db2e036a222942",
"name" : "sit+prod@meltano.com",
"handle" : "@sit+prod"
},
"channel" : {
"name" : "no-picture",
"description" : "No picture",
"picture" : "https://s.gravatar.com/avatar/357b18eea0ae8abd799a31e2ca1ad3e5?s=480&r=pg&d=https%3A%2F%2Fcdn.auth0.com%2Favatars%2Fsi.png"
},
"datasetComment" : {
"id" : "cfda9d76-7697-4bc7-bcad-34dc96312ca1",
"message" : "SIT-generated comment",
"likeCount" : 0,
"created" : "2026-08-07T13:28:58.453373",
"lastModified" : "2026-08-07T13:28:58.453374",
"from" : {
"id" : "auth0|6a21dc7aa1db2e036a222942",
"name" : "sit+prod@meltano.com",
"handle" : "@sit+prod"
},
"commentCount" : 0,
"datasetId" : "c45c50cc-1e1d-4fc3-a354-e9b32a0680f1"
},
"dataset" : {
"id" : "c45c50cc-1e1d-4fc3-a354-e9b32a0680f1",
"published" : "2026-08-07T13:28:52.767593",
"alias" : "analytics-tables",
"workspaceId" : "ca80c936-e80b-4656-87d4-3c0e34f5edf6",
"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 = 'kozmlnt'```",
"likeCount" : 0,
"commentCount" : 0,
"viewCount" : 0,
"created" : "2026-08-07T13:28:52.784822",
"score" : 1.0
},
"workspace" : {
"id" : "ca80c936-e80b-4656-87d4-3c0e34f5edf6",
"name" : "Test Workspace [2026-08-07T13:28:52.077256923]"
}
},
"_links" : {
"self" : {
"href" : "https://app.meltano.com/api/notifications/5e57d52c-5e1b-40d2-b0de-616a7291968d"
},
"delete notification" : {
"href" : "https://app.meltano.com/api/notifications/5e57d52c-5e1b-40d2-b0de-616a7291968d",
"type" : "DELETE"
},
"channel" : {
"href" : "https://app.meltano.com/api/channels/94312fd5-1516-4a66-8dc7-3a82b99fa05d"
},
"datasetComment" : {
"href" : "https://app.meltano.com/api/comments/cfda9d76-7697-4bc7-bcad-34dc96312ca1"
},
"dataset" : {
"href" : "https://app.meltano.com/api/datasets/c45c50cc-1e1d-4fc3-a354-e9b32a0680f1"
},
"data" : {
"href" : "https://app.meltano.com/api/datasets/c45c50cc-1e1d-4fc3-a354-e9b32a0680f1/data"
},
"workspace" : {
"href" : "https://app.meltano.com/api/workspaces/ca80c936-e80b-4656-87d4-3c0e34f5edf6"
}
}
} ]
},
"_links" : {
"self" : {
"href" : "https://app.meltano.com/api/workspaces/ca80c936-e80b-4656-87d4-3c0e34f5edf6/notifications?before=2026-08-07T13%3A29%3A01.032160834&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
Examples
- cURL
- Python (requests)
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.meltano.com:443/api/notifications/80fbe5b8-5aa0-4102-8001-7d5c72553541' -i -X GET
import requests
url = "https://app.meltano.com:443/api/notifications/80fbe5b8-5aa0-4102-8001-7d5c72553541"
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("GET", url, headers=headers)
print(response.text.encode('utf8'))
Response
200 OK
Notification with HAL links.
{
"id" : "80fbe5b8-5aa0-4102-8001-7d5c72553541",
"created" : "2026-08-07T13:29:00.271184",
"lastModified" : "2026-08-07T13:29:00.271186",
"type" : "DATASET_COMMENT",
"actor" : {
"id" : "auth0|6a21dc7aa1db2e036a222942",
"name" : "sit+prod@meltano.com",
"handle" : "@sit+prod"
},
"resolved" : false,
"_embedded" : {
"subscriberProfile" : {
"id" : "auth0|6a21dc7aa1db2e036a222942",
"name" : "sit+prod@meltano.com",
"handle" : "@sit+prod"
},
"channel" : {
"name" : "no-picture",
"description" : "No picture",
"picture" : "https://s.gravatar.com/avatar/357b18eea0ae8abd799a31e2ca1ad3e5?s=480&r=pg&d=https%3A%2F%2Fcdn.auth0.com%2Favatars%2Fsi.png"
},
"datasetComment" : {
"id" : "072eab0b-bc84-4f68-8fb5-0d478d1e2dc8",
"message" : "SIT-generated comment",
"likeCount" : 0,
"created" : "2026-08-07T13:28:58.757322",
"lastModified" : "2026-08-07T13:28:58.757322",
"from" : {
"id" : "auth0|6a21dc7aa1db2e036a222942",
"name" : "sit+prod@meltano.com",
"handle" : "@sit+prod"
},
"commentCount" : 0,
"datasetId" : "c45c50cc-1e1d-4fc3-a354-e9b32a0680f1"
},
"dataset" : {
"id" : "c45c50cc-1e1d-4fc3-a354-e9b32a0680f1",
"published" : "2026-08-07T13:28:52.767593",
"alias" : "analytics-tables",
"workspaceId" : "ca80c936-e80b-4656-87d4-3c0e34f5edf6",
"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 = 'kozmlnt'```",
"likeCount" : 0,
"commentCount" : 0,
"viewCount" : 0,
"created" : "2026-08-07T13:28:52.784822",
"score" : 1.0
},
"workspace" : {
"id" : "ca80c936-e80b-4656-87d4-3c0e34f5edf6",
"name" : "Test Workspace [2026-08-07T13:28:52.077256923]"
}
},
"_links" : {
"self" : {
"href" : "https://app.meltano.com/api/notifications/80fbe5b8-5aa0-4102-8001-7d5c72553541"
},
"delete notification" : {
"href" : "https://app.meltano.com/api/notifications/80fbe5b8-5aa0-4102-8001-7d5c72553541",
"type" : "DELETE"
},
"channel" : {
"href" : "https://app.meltano.com/api/channels/94312fd5-1516-4a66-8dc7-3a82b99fa05d"
},
"datasetComment" : {
"href" : "https://app.meltano.com/api/comments/072eab0b-bc84-4f68-8fb5-0d478d1e2dc8"
},
"dataset" : {
"href" : "https://app.meltano.com/api/datasets/c45c50cc-1e1d-4fc3-a354-e9b32a0680f1"
},
"data" : {
"href" : "https://app.meltano.com/api/datasets/c45c50cc-1e1d-4fc3-a354-e9b32a0680f1/data"
},
"workspace" : {
"href" : "https://app.meltano.com/api/workspaces/ca80c936-e80b-4656-87d4-3c0e34f5edf6"
}
}
}
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.
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 |
Examples
- cURL
- Python (requests)
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.meltano.com:443/api/notifications?since=2026-08-07T13%3A29%3A05.042466' -i -X PUT \
-H 'Content-Type: application/json'
import requests
url = "https://app.meltano.com:443/api/notifications?since=2026-08-07T13%3A29%3A05.042466"
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" : "f7a92551-ee46-4144-93c8-19708e3c68e3",
"created" : "2026-08-07T13:29:06.123427",
"lastModified" : "2026-08-07T13:29:06.123429",
"type" : "DATASET_COMMENT",
"actor" : {
"id" : "auth0|6a21dc7aa1db2e036a222942",
"name" : "sit+prod@meltano.com",
"handle" : "@sit+prod"
},
"resolved" : false,
"_embedded" : {
"subscriberProfile" : {
"id" : "auth0|6a21dc7aa1db2e036a222942",
"name" : "sit+prod@meltano.com",
"handle" : "@sit+prod"
},
"channel" : {
"name" : "no-picture",
"description" : "No picture",
"picture" : "https://s.gravatar.com/avatar/357b18eea0ae8abd799a31e2ca1ad3e5?s=480&r=pg&d=https%3A%2F%2Fcdn.auth0.com%2Favatars%2Fsi.png"
},
"datasetComment" : {
"id" : "56ab583e-78e0-4715-b811-27abd4a2446b",
"message" : "SIT-generated comment",
"likeCount" : 0,
"created" : "2026-08-07T13:29:05.782122",
"lastModified" : "2026-08-07T13:29:05.782123",
"from" : {
"id" : "auth0|6a21dc7aa1db2e036a222942",
"name" : "sit+prod@meltano.com",
"handle" : "@sit+prod"
},
"commentCount" : 0,
"datasetId" : "c45c50cc-1e1d-4fc3-a354-e9b32a0680f1"
},
"dataset" : {
"id" : "c45c50cc-1e1d-4fc3-a354-e9b32a0680f1",
"published" : "2026-08-07T13:28:52.767593",
"alias" : "analytics-tables",
"workspaceId" : "ca80c936-e80b-4656-87d4-3c0e34f5edf6",
"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 = 'kozmlnt'```",
"likeCount" : 0,
"commentCount" : 0,
"viewCount" : 0,
"created" : "2026-08-07T13:28:52.784822",
"score" : 1.0
},
"workspace" : {
"id" : "ca80c936-e80b-4656-87d4-3c0e34f5edf6",
"name" : "Test Workspace [2026-08-07T13:28:52.077256923]"
}
},
"_links" : {
"self" : {
"href" : "https://app.meltano.com/api/notifications/f7a92551-ee46-4144-93c8-19708e3c68e3"
},
"delete notification" : {
"href" : "https://app.meltano.com/api/notifications/f7a92551-ee46-4144-93c8-19708e3c68e3",
"type" : "DELETE"
},
"channel" : {
"href" : "https://app.meltano.com/api/channels/94312fd5-1516-4a66-8dc7-3a82b99fa05d"
},
"datasetComment" : {
"href" : "https://app.meltano.com/api/comments/56ab583e-78e0-4715-b811-27abd4a2446b"
},
"dataset" : {
"href" : "https://app.meltano.com/api/datasets/c45c50cc-1e1d-4fc3-a354-e9b32a0680f1"
},
"data" : {
"href" : "https://app.meltano.com/api/datasets/c45c50cc-1e1d-4fc3-a354-e9b32a0680f1/data"
},
"workspace" : {
"href" : "https://app.meltano.com/api/workspaces/ca80c936-e80b-4656-87d4-3c0e34f5edf6"
}
}
} ]
},
"_links" : {
"self" : {
"href" : "https://app.meltano.com/api/notifications?since=2026-08-07T13%3A29%3A05.042466&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
Examples
- cURL
- Python (requests)
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.meltano.com:443/api/notifications/80fbe5b8-5aa0-4102-8001-7d5c72553541' -i -X DELETE
import requests
url = "https://app.meltano.com:443/api/notifications/80fbe5b8-5aa0-4102-8001-7d5c72553541"
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("DELETE", url, headers=headers)
print(response.text.encode('utf8'))
Response
204 No Content
No response body provided.