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" : "019c3188-315d-40e3-910f-57d95300660b",
  "created" : "2026-02-06T22:41:02.254565",
  "lastModified" : "2026-02-06T22:41:02.254565",
  "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/019c3188-315d-40e3-910f-57d95300660b"
    },
    "delete subscription" : {
      "href" : "https://app.matatika.com/api/subscriptions/019c3188-315d-40e3-910f-57d95300660b",
      "type" : "DELETE"
    },
    "update subscription" : {
      "href" : "https://app.matatika.com/api/subscriptions/019c3188-315d-40e3-910f-57d95300660b",
      "type" : "PUT"
    },
    "channel" : {
      "href" : "https://app.matatika.com/api/channels/db237f21-33b7-4de5-a9dd-25a5dc6680af"
    }
  }
}

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/api/subscriptions' -i -X GET

Python (requests)

import requests

url = "https://app.matatika.com/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" : "6b777274-fd27-446d-8dc4-d8c95d13d815",
      "created" : "2026-02-06T22:41:02.548879",
      "lastModified" : "2026-02-06T22:41:02.54888",
      "type" : "ALL",
      "_embedded" : {
        "subscriberProfile" : {
          "id" : "auth0|5eb0327cbfd7490bff55feeb",
          "name" : "[email protected]",
          "handle" : "@sit+prod"
        },
        "dataset" : {
          "id" : "78d6322f-cd23-440d-9481-6e884be2d28d",
          "published" : "2026-02-06T22:40:56.937952",
          "alias" : "simple-bar-chart",
          "workspaceId" : "f3609cb6-8be1-48b2-8ea8-7c14db46eb43",
          "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" : "2026-02-06T22:40:56.937952",
          "score" : 1.0
        }
      },
      "_links" : {
        "self" : {
          "href" : "https://app.matatika.com/api/subscriptions/6b777274-fd27-446d-8dc4-d8c95d13d815"
        },
        "delete subscription" : {
          "href" : "https://app.matatika.com/api/subscriptions/6b777274-fd27-446d-8dc4-d8c95d13d815",
          "type" : "DELETE"
        },
        "update subscription" : {
          "href" : "https://app.matatika.com/api/subscriptions/6b777274-fd27-446d-8dc4-d8c95d13d815",
          "type" : "PUT"
        },
        "dataset" : {
          "href" : "https://app.matatika.com/api/datasets/78d6322f-cd23-440d-9481-6e884be2d28d"
        }
      }
    }, {
      "id" : "019c3188-315d-40e3-910f-57d95300660b",
      "created" : "2026-02-06T22:41:02.254565",
      "lastModified" : "2026-02-06T22:41:02.344385",
      "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/019c3188-315d-40e3-910f-57d95300660b"
        },
        "delete subscription" : {
          "href" : "https://app.matatika.com/api/subscriptions/019c3188-315d-40e3-910f-57d95300660b",
          "type" : "DELETE"
        },
        "update subscription" : {
          "href" : "https://app.matatika.com/api/subscriptions/019c3188-315d-40e3-910f-57d95300660b",
          "type" : "PUT"
        },
        "channel" : {
          "href" : "https://app.matatika.com/api/channels/db237f21-33b7-4de5-a9dd-25a5dc6680af"
        }
      }
    }, {
      "id" : "1a5f2764-7bf4-46f1-b3f9-3ed384d726de",
      "created" : "2026-02-06T22:41:08.104709",
      "lastModified" : "2026-02-06T22:41:08.104725",
      "type" : "ALL",
      "_embedded" : {
        "subscriberProfile" : {
          "id" : "auth0|5eb0327cbfd7490bff55feeb",
          "name" : "[email protected]",
          "handle" : "@sit+prod"
        },
        "pipeline" : {
          "id" : "4873e42a-82a1-43b2-8045-21198d6cdfd1",
          "label" : "SIT-generated-pipeline",
          "name" : "sit-generated-pipeline",
          "lastModified" : "2026-02-06T22:41:02.847568"
        }
      },
      "_links" : {
        "self" : {
          "href" : "https://app.matatika.com/api/subscriptions/1a5f2764-7bf4-46f1-b3f9-3ed384d726de"
        },
        "delete subscription" : {
          "href" : "https://app.matatika.com/api/subscriptions/1a5f2764-7bf4-46f1-b3f9-3ed384d726de",
          "type" : "DELETE"
        },
        "update subscription" : {
          "href" : "https://app.matatika.com/api/subscriptions/1a5f2764-7bf4-46f1-b3f9-3ed384d726de",
          "type" : "PUT"
        },
        "pipeline" : {
          "href" : "https://app.matatika.com/api/pipelines/4873e42a-82a1-43b2-8045-21198d6cdfd1"
        }
      }
    } ]
  },
  "_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/api/workspaces/f3609cb6-8be1-48b2-8ea8-7c14db46eb43/members/subscriptions' -i -X GET

Python (requests)

import requests

url = "https://app.matatika.com/api/workspaces/f3609cb6-8be1-48b2-8ea8-7c14db46eb43/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" : "7959dade-1606-4ece-9a46-a9c8ccd7bab6",
      "created" : "2026-02-06T22:41:08.236019",
      "lastModified" : "2026-02-06T22:41:08.236019",
      "type" : "ALL",
      "_embedded" : {
        "subscriberWorkspace" : {
          "id" : "f3609cb6-8be1-48b2-8ea8-7c14db46eb43",
          "name" : "Test Workspace [2026-02-06T22:40:56.542251661]"
        },
        "workspace" : {
          "id" : "f3609cb6-8be1-48b2-8ea8-7c14db46eb43",
          "name" : "Test Workspace [2026-02-06T22:40:56.542251661]"
        }
      },
      "_links" : {
        "self" : {
          "href" : "https://app.matatika.com/api/subscriptions/7959dade-1606-4ece-9a46-a9c8ccd7bab6"
        },
        "update subscription" : {
          "href" : "https://app.matatika.com/api/subscriptions/7959dade-1606-4ece-9a46-a9c8ccd7bab6",
          "type" : "PUT"
        },
        "delete subscription" : {
          "href" : "https://app.matatika.com/api/subscriptions/7959dade-1606-4ece-9a46-a9c8ccd7bab6",
          "type" : "DELETE"
        },
        "workspace" : {
          "href" : "https://app.matatika.com/api/workspaces/f3609cb6-8be1-48b2-8ea8-7c14db46eb43"
        }
      }
    } ]
  },
  "_links" : {
    "self" : {
      "href" : "https://app.matatika.com/api/workspaces/f3609cb6-8be1-48b2-8ea8-7c14db46eb43/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/api/subscriptions/019c3188-315d-40e3-910f-57d95300660b' -i -X GET

Python (requests)

import requests

url = "https://app.matatika.com/api/subscriptions/019c3188-315d-40e3-910f-57d95300660b"

headers = {
  'Authorization': ACCESS_TOKEN
}

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

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

Response

200 OK

Subscription with HAL links.

{
  "id" : "019c3188-315d-40e3-910f-57d95300660b",
  "created" : "2026-02-06T22:41:02.254565",
  "lastModified" : "2026-02-06T22:41:02.254565",
  "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/019c3188-315d-40e3-910f-57d95300660b"
    },
    "delete subscription" : {
      "href" : "https://app.matatika.com/api/subscriptions/019c3188-315d-40e3-910f-57d95300660b",
      "type" : "DELETE"
    },
    "update subscription" : {
      "href" : "https://app.matatika.com/api/subscriptions/019c3188-315d-40e3-910f-57d95300660b",
      "type" : "PUT"
    },
    "channel" : {
      "href" : "https://app.matatika.com/api/channels/db237f21-33b7-4de5-a9dd-25a5dc6680af"
    }
  }
}

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/api/workspaces/f3609cb6-8be1-48b2-8ea8-7c14db46eb43/subscriptions?allMembers=true' -i -X POST \
    -H 'Content-Type: application/json'

Python (requests)

import requests

url = "https://app.matatika.com/api/workspaces/f3609cb6-8be1-48b2-8ea8-7c14db46eb43/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" : "7959dade-1606-4ece-9a46-a9c8ccd7bab6",
  "created" : "2026-02-06T22:41:08.236018625",
  "lastModified" : "2026-02-06T22:41:08.236019125",
  "type" : "ALL",
  "_embedded" : {
    "subscriberWorkspace" : {
      "id" : "f3609cb6-8be1-48b2-8ea8-7c14db46eb43",
      "name" : "Test Workspace [2026-02-06T22:40:56.542251661]"
    },
    "workspace" : {
      "id" : "f3609cb6-8be1-48b2-8ea8-7c14db46eb43",
      "name" : "Test Workspace [2026-02-06T22:40:56.542251661]"
    }
  },
  "_links" : {
    "self" : {
      "href" : "https://app.matatika.com/api/subscriptions/7959dade-1606-4ece-9a46-a9c8ccd7bab6"
    },
    "update subscription" : {
      "href" : "https://app.matatika.com/api/subscriptions/7959dade-1606-4ece-9a46-a9c8ccd7bab6",
      "type" : "PUT"
    },
    "delete subscription" : {
      "href" : "https://app.matatika.com/api/subscriptions/7959dade-1606-4ece-9a46-a9c8ccd7bab6",
      "type" : "DELETE"
    },
    "workspace" : {
      "href" : "https://app.matatika.com/api/workspaces/f3609cb6-8be1-48b2-8ea8-7c14db46eb43"
    }
  }
}

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/api/channels/db237f21-33b7-4de5-a9dd-25a5dc6680af/subscriptions' -i -X POST \
    -H 'Content-Type: application/json'

Python (requests)

import requests

url = "https://app.matatika.com/api/channels/db237f21-33b7-4de5-a9dd-25a5dc6680af/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" : "019c3188-315d-40e3-910f-57d95300660b",
  "created" : "2026-02-06T22:41:02.254564512",
  "lastModified" : "2026-02-06T22:41:02.254565012",
  "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/019c3188-315d-40e3-910f-57d95300660b"
    },
    "delete subscription" : {
      "href" : "https://app.matatika.com/api/subscriptions/019c3188-315d-40e3-910f-57d95300660b",
      "type" : "DELETE"
    },
    "update subscription" : {
      "href" : "https://app.matatika.com/api/subscriptions/019c3188-315d-40e3-910f-57d95300660b",
      "type" : "PUT"
    },
    "channel" : {
      "href" : "https://app.matatika.com/api/channels/db237f21-33b7-4de5-a9dd-25a5dc6680af"
    }
  }
}

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/api/datasets/78d6322f-cd23-440d-9481-6e884be2d28d/subscriptions' -i -X POST \
    -H 'Content-Type: application/json'

Python (requests)

import requests

url = "https://app.matatika.com/api/datasets/78d6322f-cd23-440d-9481-6e884be2d28d/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" : "6b777274-fd27-446d-8dc4-d8c95d13d815",
  "created" : "2026-02-06T22:41:02.548879356",
  "lastModified" : "2026-02-06T22:41:02.548880356",
  "type" : "ALL",
  "_embedded" : {
    "subscriberProfile" : {
      "id" : "auth0|5eb0327cbfd7490bff55feeb",
      "name" : "[email protected]",
      "handle" : "@sit+prod"
    },
    "dataset" : {
      "id" : "78d6322f-cd23-440d-9481-6e884be2d28d",
      "published" : "2026-02-06T22:40:56.937952",
      "alias" : "simple-bar-chart",
      "workspaceId" : "f3609cb6-8be1-48b2-8ea8-7c14db46eb43",
      "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" : "2026-02-06T22:40:56.937952",
      "score" : 1.0
    }
  },
  "_links" : {
    "self" : {
      "href" : "https://app.matatika.com/api/subscriptions/6b777274-fd27-446d-8dc4-d8c95d13d815"
    },
    "delete subscription" : {
      "href" : "https://app.matatika.com/api/subscriptions/6b777274-fd27-446d-8dc4-d8c95d13d815",
      "type" : "DELETE"
    },
    "update subscription" : {
      "href" : "https://app.matatika.com/api/subscriptions/6b777274-fd27-446d-8dc4-d8c95d13d815",
      "type" : "PUT"
    },
    "dataset" : {
      "href" : "https://app.matatika.com/api/datasets/78d6322f-cd23-440d-9481-6e884be2d28d"
    }
  }
}

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/api/pipelines/4873e42a-82a1-43b2-8045-21198d6cdfd1/subscriptions' -i -X POST \
    -H 'Content-Type: application/json'

Python (requests)

import requests

url = "https://app.matatika.com/api/pipelines/4873e42a-82a1-43b2-8045-21198d6cdfd1/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" : "1a5f2764-7bf4-46f1-b3f9-3ed384d726de",
  "created" : "2026-02-06T22:41:08.104708859",
  "lastModified" : "2026-02-06T22:41:08.104725159",
  "type" : "ALL",
  "_embedded" : {
    "subscriberProfile" : {
      "id" : "auth0|5eb0327cbfd7490bff55feeb",
      "name" : "[email protected]",
      "handle" : "@sit+prod"
    },
    "pipeline" : {
      "id" : "4873e42a-82a1-43b2-8045-21198d6cdfd1",
      "label" : "SIT-generated-pipeline",
      "name" : "sit-generated-pipeline",
      "lastModified" : "2026-02-06T22:41:02.847568"
    }
  },
  "_links" : {
    "self" : {
      "href" : "https://app.matatika.com/api/subscriptions/1a5f2764-7bf4-46f1-b3f9-3ed384d726de"
    },
    "delete subscription" : {
      "href" : "https://app.matatika.com/api/subscriptions/1a5f2764-7bf4-46f1-b3f9-3ed384d726de",
      "type" : "DELETE"
    },
    "update subscription" : {
      "href" : "https://app.matatika.com/api/subscriptions/1a5f2764-7bf4-46f1-b3f9-3ed384d726de",
      "type" : "PUT"
    },
    "pipeline" : {
      "href" : "https://app.matatika.com/api/pipelines/4873e42a-82a1-43b2-8045-21198d6cdfd1"
    }
  }
}

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/api/subscriptions/019c3188-315d-40e3-910f-57d95300660b' -i -X PUT \
    -H 'Content-Type: application/json' \
    -d '{
  "type" : "ALERTS"
}'

Python (requests)

import requests

url = "https://app.matatika.com/api/subscriptions/019c3188-315d-40e3-910f-57d95300660b"

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" : "019c3188-315d-40e3-910f-57d95300660b",
  "created" : "2026-02-06T22:41:02.254565",
  "lastModified" : "2026-02-06T22:41:02.344384831",
  "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/019c3188-315d-40e3-910f-57d95300660b"
    },
    "delete subscription" : {
      "href" : "https://app.matatika.com/api/subscriptions/019c3188-315d-40e3-910f-57d95300660b",
      "type" : "DELETE"
    },
    "update subscription" : {
      "href" : "https://app.matatika.com/api/subscriptions/019c3188-315d-40e3-910f-57d95300660b",
      "type" : "PUT"
    },
    "channel" : {
      "href" : "https://app.matatika.com/api/channels/db237f21-33b7-4de5-a9dd-25a5dc6680af"
    }
  }
}

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/api/subscriptions/019c3188-315d-40e3-910f-57d95300660b' -i -X DELETE

Python (requests)

import requests

url = "https://app.matatika.com/api/subscriptions/019c3188-315d-40e3-910f-57d95300660b"

headers = {
  'Authorization': ACCESS_TOKEN
}

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

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

Response

204 No Content

No response body provided.

Subscriptions

Objects

Subscription

Formats

Subscription Type

Requests

View all subscriptions

Request

Example Snippets

Response

View all member subscriptions to a workspace

Prerequisites

Request

Example Snippets

Response

View a subscription

Prerequisites

Request

Example Snippets

Response

Subscribe to a workspace

Prerequisites

Request

Query Parameters

Example Snippets

Response

Subscribe to a channel

Prerequisites

Request

Query Parameters

Example Snippets

Response

Subscribe to a dataset

Prerequisites

Request

Query Parameters

Example Snippets

Response

Subscribe to a pipeline

Prerequisites

Request

Query Parameters

Example Snippets

Response

Update a subscription

Prerequisites

Request

Body

Example Snippets

Response

Remove a subscription

Prerequisites

Request

Example Snippets

Response