Subscriptions
Subscriptions are a declaration of interest in a particular resource, allowing a user to receive notifications when certain events occur. The events that trigger notifications are controlled by the type of subscription.
Objects
Subscription
Path | JSON Type | Format | Description |
---|---|---|---|
id |
string |
Version 4 UUID | The subscription ID |
created |
string |
ISO 8601 timestamp | The instant the subscription was created at |
lastModified |
string |
ISO 8601 timestamp | The instant the subscription was last modified at |
type |
string |
Subscription Type | The type of subscription |
{
"id" : "16a4b67e-e5df-447f-b794-bd61d44ebce4",
"created" : "2025-06-19T10:16:06.474882",
"lastModified" : "2025-06-19T10:16:06.474882",
"type" : "ALL",
"_embedded" : {
"channel" : {
"name" : "matatika-limited",
"description" : "Matatika Limited",
"picture" : "https://cdn.auth0.com/avatars/ml.png?ssl=1"
},
"subscriberProfile" : {
"id" : "auth0|5eb0327cbfd7490bff55feeb",
"name" : "[email protected]",
"handle" : "@sit+prod"
}
},
"_links" : {
"self" : {
"href" : "https://app.matatika.com/api/subscriptions/16a4b67e-e5df-447f-b794-bd61d44ebce4"
},
"delete subscription" : {
"href" : "https://app.matatika.com/api/subscriptions/16a4b67e-e5df-447f-b794-bd61d44ebce4",
"type" : "DELETE"
},
"update subscription" : {
"href" : "https://app.matatika.com/api/subscriptions/16a4b67e-e5df-447f-b794-bd61d44ebce4",
"type" : "PUT"
},
"channel" : {
"href" : "https://app.matatika.com/api/channels/9b20cbd6-4ab3-4ee8-8ad2-335a10c46f06"
}
}
}
Formats
Subscription Type
string
Value | Description |
---|---|
ALL |
Triggers notifications for all resource events |
ALERTS |
Triggers notifications for resource alert events only |
NONE |
Does not trigger any notifications |
Requests
- View all subscriptions
- View all member subscriptions to a workspace
- View a subscription
- Subscribe to a workspace
- Subscribe to a channel
- Subscribe to a dataset
- Subscribe to a pipeline
- Update a subscription
- Remove a subscription
View all subscriptions
GET
/api/subscriptions
Returns all subscriptions for the authenticated user profile.
Request
Example Snippets
cURL
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com:443/api/subscriptions' -i -X GET \
-H 'Accept: application/json, application/javascript, text/javascript, text/json'
Python (requests
)
import requests
url = "https://app.matatika.com:443/api/subscriptions"
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("GET", url, headers=headers)
print(response.text.encode('utf8'))
Response
200 OK
Subscription collection with HAL links.
{
"_embedded" : {
"subscriptions" : [ {
"id" : "16a4b67e-e5df-447f-b794-bd61d44ebce4",
"created" : "2025-06-19T10:16:06.474882",
"lastModified" : "2025-06-19T10:16:06.67069",
"type" : "ALERTS",
"_embedded" : {
"channel" : {
"name" : "matatika-limited",
"description" : "Matatika Limited",
"picture" : "https://cdn.auth0.com/avatars/ml.png?ssl=1"
},
"subscriberProfile" : {
"id" : "auth0|5eb0327cbfd7490bff55feeb",
"name" : "[email protected]",
"handle" : "@sit+prod"
}
},
"_links" : {
"self" : {
"href" : "https://app.matatika.com/api/subscriptions/16a4b67e-e5df-447f-b794-bd61d44ebce4"
},
"delete subscription" : {
"href" : "https://app.matatika.com/api/subscriptions/16a4b67e-e5df-447f-b794-bd61d44ebce4",
"type" : "DELETE"
},
"update subscription" : {
"href" : "https://app.matatika.com/api/subscriptions/16a4b67e-e5df-447f-b794-bd61d44ebce4",
"type" : "PUT"
},
"channel" : {
"href" : "https://app.matatika.com/api/channels/9b20cbd6-4ab3-4ee8-8ad2-335a10c46f06"
}
}
}, {
"id" : "72d979f5-1e2c-4a0f-ade0-4d3e0f0c52e3",
"created" : "2025-06-19T10:16:12.588641",
"lastModified" : "2025-06-19T10:16:12.588641",
"type" : "ALL",
"_embedded" : {
"subscriberProfile" : {
"id" : "auth0|5eb0327cbfd7490bff55feeb",
"name" : "[email protected]",
"handle" : "@sit+prod"
},
"pipeline" : {
"id" : "2db48332-cf75-40f9-829a-126f96187bc1",
"name" : "SIT-generated pipeline",
"lastModified" : "2025-06-19T10:16:07.368497"
}
},
"_links" : {
"self" : {
"href" : "https://app.matatika.com/api/subscriptions/72d979f5-1e2c-4a0f-ade0-4d3e0f0c52e3"
},
"delete subscription" : {
"href" : "https://app.matatika.com/api/subscriptions/72d979f5-1e2c-4a0f-ade0-4d3e0f0c52e3",
"type" : "DELETE"
},
"update subscription" : {
"href" : "https://app.matatika.com/api/subscriptions/72d979f5-1e2c-4a0f-ade0-4d3e0f0c52e3",
"type" : "PUT"
},
"pipeline" : {
"href" : "https://app.matatika.com/api/pipelines/2db48332-cf75-40f9-829a-126f96187bc1"
}
}
}, {
"id" : "fe784b3d-492b-4e6f-937e-75df4244fcb2",
"created" : "2025-06-19T10:16:06.981868",
"lastModified" : "2025-06-19T10:16:06.981868",
"type" : "ALL",
"_embedded" : {
"subscriberProfile" : {
"id" : "auth0|5eb0327cbfd7490bff55feeb",
"name" : "[email protected]",
"handle" : "@sit+prod"
},
"dataset" : {
"id" : "c7f0d9c9-06a5-4fff-8d65-565b488a1fc1",
"published" : "2025-06-19T10:16:01.018871",
"alias" : "simple-bar-chart",
"workspaceId" : "96338b26-ddbc-449d-a326-f83e92a3d251",
"source" : "matatika-limited",
"title" : "How many people have visited our website?",
"description" : "# Some Markdown\n- point 1\n- point 2\n- point 3\n",
"questions" : "[''This is my question'', ''this is second question'']",
"visualisation" : "{\"google-chart\": {\"chartType\": \"BarChart\",\"options\": {\"title\": \"Website visitors\"}}}",
"query" : "SELECT to_char(date(report_date),'YYYYMM') as year_month, SUM(sessions) \n FROM\n \"google_analytics_website_overview\"\n WHERE\n \"google_analytics_website_overview\".\"report_date\" >= DATE(NOW()) - INTERVAL '365 DAY'\n GROUP BY year_month\n ORDER BY year_month ASC;",
"likeCount" : 0,
"likedByProfiles" : [ ],
"commentCount" : 0,
"viewCount" : 0,
"created" : "2025-06-19T10:16:01.01887",
"score" : 1.0
}
},
"_links" : {
"self" : {
"href" : "https://app.matatika.com/api/subscriptions/fe784b3d-492b-4e6f-937e-75df4244fcb2"
},
"delete subscription" : {
"href" : "https://app.matatika.com/api/subscriptions/fe784b3d-492b-4e6f-937e-75df4244fcb2",
"type" : "DELETE"
},
"update subscription" : {
"href" : "https://app.matatika.com/api/subscriptions/fe784b3d-492b-4e6f-937e-75df4244fcb2",
"type" : "PUT"
},
"dataset" : {
"href" : "https://app.matatika.com/api/datasets/c7f0d9c9-06a5-4fff-8d65-565b488a1fc1"
}
}
} ]
},
"_links" : {
"self" : {
"href" : "https://app.matatika.com/api/subscriptions?page=0&size=20"
}
},
"page" : {
"size" : 20,
"totalElements" : 3,
"totalPages" : 1,
"number" : 0
}
}
View all member subscriptions to a workspace
GET
/api/workspaces/{workspace-id}/members/subscriptions
Returns all member subscriptions to the workspace {workspace-id}
.
Prerequisites
- Workspace
{workspace-id}
must exist
Request
Example Snippets
cURL
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com:443/api/workspaces/96338b26-ddbc-449d-a326-f83e92a3d251/members/subscriptions' -i -X GET \
-H 'Accept: application/json, application/javascript, text/javascript, text/json'
Python (requests
)
import requests
url = "https://app.matatika.com:443/api/workspaces/96338b26-ddbc-449d-a326-f83e92a3d251/members/subscriptions"
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("GET", url, headers=headers)
print(response.text.encode('utf8'))
Response
200 OK
Subscription collection with HAL links.
{
"_embedded" : {
"subscriptions" : [ {
"id" : "af89700d-2b93-484c-9ad2-d2ce8b9d2204",
"created" : "2025-06-19T10:16:12.844471",
"lastModified" : "2025-06-19T10:16:12.844472",
"type" : "ALL",
"_embedded" : {
"subscriberWorkspace" : {
"id" : "96338b26-ddbc-449d-a326-f83e92a3d251",
"name" : "Test Workspace [2025-06-19T10:16:00.677312670]"
},
"workspace" : {
"id" : "96338b26-ddbc-449d-a326-f83e92a3d251",
"name" : "Test Workspace [2025-06-19T10:16:00.677312670]"
}
},
"_links" : {
"self" : {
"href" : "https://app.matatika.com/api/subscriptions/af89700d-2b93-484c-9ad2-d2ce8b9d2204"
},
"update subscription" : {
"href" : "https://app.matatika.com/api/subscriptions/af89700d-2b93-484c-9ad2-d2ce8b9d2204",
"type" : "PUT"
},
"delete subscription" : {
"href" : "https://app.matatika.com/api/subscriptions/af89700d-2b93-484c-9ad2-d2ce8b9d2204",
"type" : "DELETE"
},
"workspace" : {
"href" : "https://app.matatika.com/api/workspaces/96338b26-ddbc-449d-a326-f83e92a3d251"
}
}
} ]
},
"_links" : {
"self" : {
"href" : "https://app.matatika.com/api/workspaces/96338b26-ddbc-449d-a326-f83e92a3d251/members/subscriptions?page=0&size=20"
}
},
"page" : {
"size" : 20,
"totalElements" : 1,
"totalPages" : 1,
"number" : 0
}
}
View a subscription
GET
/api/subscriptions/{subscription-id}
Returns the subscription {subscription-id}
.
Prerequisites
- Subscription
{subscription-id}
must exist
Request
Example Snippets
cURL
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com:443/api/subscriptions/16a4b67e-e5df-447f-b794-bd61d44ebce4' -i -X GET \
-H 'Accept: application/json, application/javascript, text/javascript, text/json'
Python (requests
)
import requests
url = "https://app.matatika.com:443/api/subscriptions/16a4b67e-e5df-447f-b794-bd61d44ebce4"
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("GET", url, headers=headers)
print(response.text.encode('utf8'))
Response
200 OK
Subscription with HAL links.
{
"id" : "16a4b67e-e5df-447f-b794-bd61d44ebce4",
"created" : "2025-06-19T10:16:06.474882",
"lastModified" : "2025-06-19T10:16:06.474882",
"type" : "ALL",
"_embedded" : {
"channel" : {
"name" : "matatika-limited",
"description" : "Matatika Limited",
"picture" : "https://cdn.auth0.com/avatars/ml.png?ssl=1"
},
"subscriberProfile" : {
"id" : "auth0|5eb0327cbfd7490bff55feeb",
"name" : "[email protected]",
"handle" : "@sit+prod"
}
},
"_links" : {
"self" : {
"href" : "https://app.matatika.com/api/subscriptions/16a4b67e-e5df-447f-b794-bd61d44ebce4"
},
"delete subscription" : {
"href" : "https://app.matatika.com/api/subscriptions/16a4b67e-e5df-447f-b794-bd61d44ebce4",
"type" : "DELETE"
},
"update subscription" : {
"href" : "https://app.matatika.com/api/subscriptions/16a4b67e-e5df-447f-b794-bd61d44ebce4",
"type" : "PUT"
},
"channel" : {
"href" : "https://app.matatika.com/api/channels/9b20cbd6-4ab3-4ee8-8ad2-335a10c46f06"
}
}
}
Subscribe to a workspace
POST
/api/workspaces/{workspace-id}/subscriptions
Subscribes the authenticated user profile to the workspace {workspace-id}
.
By default, the subscription is configured for all workspace events (see Subscription Type for more information).
Prerequisites
- Workspace
{workspace-id}
must exist
Request
Query Parameters
Parameter | Required | Format | Default Value | Description |
---|---|---|---|---|
allMembers |
No | Boolean | false |
Whether or not to subscribe the workspace to workspace events, in order to enable workspace-wide notifications for all members by default (applicable for the workspace owner only) |
Example Snippets
cURL
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com:443/api/workspaces/96338b26-ddbc-449d-a326-f83e92a3d251/subscriptions?allMembers=true' -i -X POST \
-H 'Accept: application/json, application/javascript, text/javascript, text/json' \
-H 'Content-Type: application/json'
Python (requests
)
import requests
url = "https://app.matatika.com:443/api/workspaces/96338b26-ddbc-449d-a326-f83e92a3d251/subscriptions?allMembers=true"
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("POST", url, headers=headers)
print(response.text.encode('utf8'))
Response
200 OK
Subscription with HAL links.
{
"id" : "af89700d-2b93-484c-9ad2-d2ce8b9d2204",
"created" : "2025-06-19T10:16:12.844471313",
"lastModified" : "2025-06-19T10:16:12.844471613",
"type" : "ALL",
"_embedded" : {
"subscriberWorkspace" : {
"id" : "96338b26-ddbc-449d-a326-f83e92a3d251",
"name" : "Test Workspace [2025-06-19T10:16:00.677312670]"
},
"workspace" : {
"id" : "96338b26-ddbc-449d-a326-f83e92a3d251",
"name" : "Test Workspace [2025-06-19T10:16:00.677312670]"
}
},
"_links" : {
"self" : {
"href" : "https://app.matatika.com/api/subscriptions/af89700d-2b93-484c-9ad2-d2ce8b9d2204"
},
"update subscription" : {
"href" : "https://app.matatika.com/api/subscriptions/af89700d-2b93-484c-9ad2-d2ce8b9d2204",
"type" : "PUT"
},
"delete subscription" : {
"href" : "https://app.matatika.com/api/subscriptions/af89700d-2b93-484c-9ad2-d2ce8b9d2204",
"type" : "DELETE"
},
"workspace" : {
"href" : "https://app.matatika.com/api/workspaces/96338b26-ddbc-449d-a326-f83e92a3d251"
}
}
}
Subscribe to a channel
POST
/api/channels/{channel-id}/subscriptions
Subscribes the authenticated user profile to the channel {channel-id}
.
By default, the subscription is configured for all channel events (see Subscription Type for more information).
Prerequisites
- Channel
{channel-id}
must exist
Request
Query Parameters
Parameter | Required | Format | Default Value | Description |
---|---|---|---|---|
allMembers |
No | Boolean | false |
Whether or not to subscribe the workspace to channel events, enabling notifications for all members by default (applicable for the workspace owner only) |
Example Snippets
cURL
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com:443/api/channels/9b20cbd6-4ab3-4ee8-8ad2-335a10c46f06/subscriptions' -i -X POST \
-H 'Accept: application/json, application/javascript, text/javascript, text/json' \
-H 'Content-Type: application/json'
Python (requests
)
import requests
url = "https://app.matatika.com:443/api/channels/9b20cbd6-4ab3-4ee8-8ad2-335a10c46f06/subscriptions"
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("POST", url, headers=headers)
print(response.text.encode('utf8'))
Response
200 OK
Subscription with HAL links.
{
"id" : "16a4b67e-e5df-447f-b794-bd61d44ebce4",
"created" : "2025-06-19T10:16:06.474881512",
"lastModified" : "2025-06-19T10:16:06.474881712",
"type" : "ALL",
"_embedded" : {
"channel" : {
"name" : "matatika-limited",
"description" : "Matatika Limited",
"picture" : "https://cdn.auth0.com/avatars/ml.png?ssl=1"
},
"subscriberProfile" : {
"id" : "auth0|5eb0327cbfd7490bff55feeb",
"name" : "[email protected]",
"handle" : "@sit+prod"
}
},
"_links" : {
"self" : {
"href" : "https://app.matatika.com/api/subscriptions/16a4b67e-e5df-447f-b794-bd61d44ebce4"
},
"delete subscription" : {
"href" : "https://app.matatika.com/api/subscriptions/16a4b67e-e5df-447f-b794-bd61d44ebce4",
"type" : "DELETE"
},
"update subscription" : {
"href" : "https://app.matatika.com/api/subscriptions/16a4b67e-e5df-447f-b794-bd61d44ebce4",
"type" : "PUT"
},
"channel" : {
"href" : "https://app.matatika.com/api/channels/9b20cbd6-4ab3-4ee8-8ad2-335a10c46f06"
}
}
}
Subscribe to a dataset
POST
/api/datasets/{dataset-id}/subscriptions
Subscribes the authenticated user profile to the dataset {dataset-id}
.
By default, the subscription is configured for all dataset events (see Subscription Type for more information).
Prerequisites
- Dataset
{dataset-id}
must exist
Request
Query Parameters
Parameter | Required | Format | Default Value | Description |
---|---|---|---|---|
allMembers |
No | Boolean | false |
Whether or not to subscribe the workspace to dataset events, enabling notifications for all members by default (applicable for the workspace owner only) |
Example Snippets
cURL
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com:443/api/datasets/c7f0d9c9-06a5-4fff-8d65-565b488a1fc1/subscriptions' -i -X POST \
-H 'Accept: application/json, application/javascript, text/javascript, text/json' \
-H 'Content-Type: application/json'
Python (requests
)
import requests
url = "https://app.matatika.com:443/api/datasets/c7f0d9c9-06a5-4fff-8d65-565b488a1fc1/subscriptions"
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("POST", url, headers=headers)
print(response.text.encode('utf8'))
Response
200 OK
Subscription with HAL links.
{
"id" : "fe784b3d-492b-4e6f-937e-75df4244fcb2",
"created" : "2025-06-19T10:16:06.981867804",
"lastModified" : "2025-06-19T10:16:06.981868004",
"type" : "ALL",
"_embedded" : {
"subscriberProfile" : {
"id" : "auth0|5eb0327cbfd7490bff55feeb",
"name" : "[email protected]",
"handle" : "@sit+prod"
},
"dataset" : {
"id" : "c7f0d9c9-06a5-4fff-8d65-565b488a1fc1",
"published" : "2025-06-19T10:16:01.018871",
"alias" : "simple-bar-chart",
"workspaceId" : "96338b26-ddbc-449d-a326-f83e92a3d251",
"source" : "matatika-limited",
"title" : "How many people have visited our website?",
"description" : "# Some Markdown\n- point 1\n- point 2\n- point 3\n",
"questions" : "[''This is my question'', ''this is second question'']",
"visualisation" : "{\"google-chart\": {\"chartType\": \"BarChart\",\"options\": {\"title\": \"Website visitors\"}}}",
"query" : "SELECT to_char(date(report_date),'YYYYMM') as year_month, SUM(sessions) \n FROM\n \"google_analytics_website_overview\"\n WHERE\n \"google_analytics_website_overview\".\"report_date\" >= DATE(NOW()) - INTERVAL '365 DAY'\n GROUP BY year_month\n ORDER BY year_month ASC;",
"likeCount" : 0,
"likedByProfiles" : [ ],
"commentCount" : 0,
"viewCount" : 0,
"created" : "2025-06-19T10:16:01.01887",
"score" : 1.0
}
},
"_links" : {
"self" : {
"href" : "https://app.matatika.com/api/subscriptions/fe784b3d-492b-4e6f-937e-75df4244fcb2"
},
"delete subscription" : {
"href" : "https://app.matatika.com/api/subscriptions/fe784b3d-492b-4e6f-937e-75df4244fcb2",
"type" : "DELETE"
},
"update subscription" : {
"href" : "https://app.matatika.com/api/subscriptions/fe784b3d-492b-4e6f-937e-75df4244fcb2",
"type" : "PUT"
},
"dataset" : {
"href" : "https://app.matatika.com/api/datasets/c7f0d9c9-06a5-4fff-8d65-565b488a1fc1"
}
}
}
Subscribe to a pipeline
POST
/api/pipelines/{pipeline-id}/subscriptions
Subscribes the authenticated user profile to the pipeline {pipeline-id}
.
By default, the subscription is configured for all pipeline events (see Subscription Type for more information).
Prerequisites
- Pipeline
{pipeline-id}
must exist
Request
Query Parameters
Parameter | Required | Format | Default Value | Description |
---|---|---|---|---|
allMembers |
No | Boolean | false |
Whether or not to subscribe the workspace to pipeline events, enabling notifications for all members by default (applicable for the workspace owner only) |
Example Snippets
cURL
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com:443/api/pipelines/2db48332-cf75-40f9-829a-126f96187bc1/subscriptions' -i -X POST \
-H 'Accept: application/json, application/javascript, text/javascript, text/json' \
-H 'Content-Type: application/json'
Python (requests
)
import requests
url = "https://app.matatika.com:443/api/pipelines/2db48332-cf75-40f9-829a-126f96187bc1/subscriptions"
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("POST", url, headers=headers)
print(response.text.encode('utf8'))
Response
200 OK
Subscription with HAL links.
{
"id" : "72d979f5-1e2c-4a0f-ade0-4d3e0f0c52e3",
"created" : "2025-06-19T10:16:12.588640961",
"lastModified" : "2025-06-19T10:16:12.588641161",
"type" : "ALL",
"_embedded" : {
"subscriberProfile" : {
"id" : "auth0|5eb0327cbfd7490bff55feeb",
"name" : "[email protected]",
"handle" : "@sit+prod"
},
"pipeline" : {
"id" : "2db48332-cf75-40f9-829a-126f96187bc1",
"name" : "SIT-generated pipeline",
"lastModified" : "2025-06-19T10:16:07.368497"
}
},
"_links" : {
"self" : {
"href" : "https://app.matatika.com/api/subscriptions/72d979f5-1e2c-4a0f-ade0-4d3e0f0c52e3"
},
"delete subscription" : {
"href" : "https://app.matatika.com/api/subscriptions/72d979f5-1e2c-4a0f-ade0-4d3e0f0c52e3",
"type" : "DELETE"
},
"update subscription" : {
"href" : "https://app.matatika.com/api/subscriptions/72d979f5-1e2c-4a0f-ade0-4d3e0f0c52e3",
"type" : "PUT"
},
"pipeline" : {
"href" : "https://app.matatika.com/api/pipelines/2db48332-cf75-40f9-829a-126f96187bc1"
}
}
}
Update a subscription
PUT
/api/subscriptions/{subscription-id}
Updates the subscription {subscription-id}
.
Prerequisites
- Subscription
{subscription-id}
must exist
Request
Body
Path | JSON Type | Format | Description |
---|---|---|---|
type |
string |
Subscription Type | The type of subscription |
{
"type" : "ALERTS"
}
Example Snippets
cURL
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com:443/api/subscriptions/16a4b67e-e5df-447f-b794-bd61d44ebce4' -i -X PUT \
-H 'Accept: application/json, application/javascript, text/javascript, text/json' \
-H 'Content-Type: application/json' \
-d '{
"type" : "ALERTS"
}'
Python (requests
)
import requests
url = "https://app.matatika.com:443/api/subscriptions/16a4b67e-e5df-447f-b794-bd61d44ebce4"
data = {
"type" : "ALERTS"
}
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("PUT", url, headers=headers, data=data)
print(response.text.encode('utf8'))
Response
200 OK
Subscription with HAL links.
{
"id" : "16a4b67e-e5df-447f-b794-bd61d44ebce4",
"created" : "2025-06-19T10:16:06.474882",
"lastModified" : "2025-06-19T10:16:06.670690218",
"type" : "ALERTS",
"_embedded" : {
"channel" : {
"name" : "matatika-limited",
"description" : "Matatika Limited",
"picture" : "https://cdn.auth0.com/avatars/ml.png?ssl=1"
},
"subscriberProfile" : {
"id" : "auth0|5eb0327cbfd7490bff55feeb",
"name" : "[email protected]",
"handle" : "@sit+prod"
}
},
"_links" : {
"self" : {
"href" : "https://app.matatika.com/api/subscriptions/16a4b67e-e5df-447f-b794-bd61d44ebce4"
},
"delete subscription" : {
"href" : "https://app.matatika.com/api/subscriptions/16a4b67e-e5df-447f-b794-bd61d44ebce4",
"type" : "DELETE"
},
"update subscription" : {
"href" : "https://app.matatika.com/api/subscriptions/16a4b67e-e5df-447f-b794-bd61d44ebce4",
"type" : "PUT"
},
"channel" : {
"href" : "https://app.matatika.com/api/channels/9b20cbd6-4ab3-4ee8-8ad2-335a10c46f06"
}
}
}
Remove a subscription
DELETE
/api/subscriptions/{subscription-id}
Removes the subscription {subscription-id}
.
Prerequisites
- Subscription
{subscription-id}
must exist
Request
Example Snippets
cURL
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com:443/api/subscriptions/16a4b67e-e5df-447f-b794-bd61d44ebce4' -i -X DELETE \
-H 'Accept: application/json, application/javascript, text/javascript, text/json'
Python (requests
)
import requests
url = "https://app.matatika.com:443/api/subscriptions/16a4b67e-e5df-447f-b794-bd61d44ebce4"
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("DELETE", url, headers=headers)
print(response.text.encode('utf8'))
Response
204 No Content
No response body provided.