Channels
Channels enable datasets to be categorised or grouped together. A single workspace can have multiple channels.
Objects
Channel
Path | JSON Type | Format | Description |
---|---|---|---|
id |
string |
Version 4 UUID | The channel ID |
creator |
object |
Member |
The channel creator |
workspace |
object |
Workspace |
The channel workspace |
created |
string |
ISO 8601 timestamp | The channel created at timestamp |
lastModified |
string |
ISO 8601 timestamp | The channel last modified timestamp |
name |
string |
The channel name | |
description |
string |
The channel description | |
picture |
string |
URL | The channel picture metadata |
{
"id" : "39de24cb-778c-4ec1-a01c-5b906dee1fe0",
"name" : "SITChannel",
"workspaceId" : "2993c88b-c673-473d-b82c-cf0d878a88fa",
"creator" : {
"id" : "auth0|5eb0327cbfd7490bff55feeb",
"name" : "[email protected]",
"handle" : "@sit+prod"
},
"scope" : "PROFILE",
"type" : "SOURCE",
"created" : "2025-06-19T10:15:23.419866",
"lastModified" : "2025-06-19T10:15:23.419866",
"description" : "SITChannel",
"picture" : "https://s.gravatar.com/avatar/8f4ad8fa0793181b761d030196e62053?s=480&r=pg&d=https%3A%2F%2Fcdn.auth0.com%2Favatars%2Fsu.png",
"datasetCount" : 0,
"containsDataset" : false,
"_links" : {
"self" : {
"href" : "https://app.matatika.com/api/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0"
},
"datasets" : {
"href" : "https://app.matatika.com/api/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0/datasets",
"type" : "GET"
},
"add subscription" : {
"href" : "https://app.matatika.com/api/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0/subscriptions"
},
"update channel" : {
"href" : "https://app.matatika.com/api/workspaces/2993c88b-c673-473d-b82c-cf0d878a88fa/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0"
},
"delete channel" : {
"href" : "https://app.matatika.com/api/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0"
},
"add workspace-scope" : {
"href" : "https://app.matatika.com/api/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0/scope/workspace"
}
}
}
Requests
- Initialise a channel
- View a channel
- View a channel in a workspace
- View all channels in a workspace
- Create or Update a channel in a workspace
- Delete a channel
- View all channels in your workspace news
- Add a dataset to a list channel
- Remove a dataset from a list channel
- Add workspace scope to a channel
- Withdraw workspace scope from a channel
See Also
Initialise a channel
POST
/api/channels/{channel-id}
Initialise a channel.
Request
Example Snippets
cURL
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com:443/api/workspaces/2993c88b-c673-473d-b82c-cf0d878a88fa/channels' -i -X POST \
-H 'Accept: application/json, application/javascript, text/javascript, text/json' \
-H 'Content-Type: application/json' \
-d '{ }'
Python (requests
)
import requests
url = "https://app.matatika.com:443/api/workspaces/2993c88b-c673-473d-b82c-cf0d878a88fa/channels"
data = { }
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("POST", url, headers=headers, data=data)
print(response.text.encode('utf8'))
Response
200 OK
Channel with HAL links.
{
"id" : "500124e3-9edc-4459-a33b-8c78eb3c6cdd",
"workspaceId" : "2993c88b-c673-473d-b82c-cf0d878a88fa",
"created" : "2025-06-19T10:15:29.727174993",
"lastModified" : "2025-06-19T10:15:29.727176393",
"datasetCount" : 0,
"containsDataset" : false,
"_links" : {
"create channel" : {
"href" : "https://app.matatika.com/api/workspaces/2993c88b-c673-473d-b82c-cf0d878a88fa/channels/500124e3-9edc-4459-a33b-8c78eb3c6cdd"
}
}
}
View a channel
GET
/api/channels/{channel-id}
Returns the channel {channel-id}
.
Prerequisites
- Channel
{channel-id}
must exist
Request
Example Snippets
cURL
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com:443/api/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0' -i -X GET \
-H 'Accept: application/json, application/javascript, text/javascript, text/json' \
-H 'Content-Type: text/plain; charset=ISO-8859-1' \
-d '{}'
Python (requests
)
import requests
url = "https://app.matatika.com:443/api/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0"
data = {}
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("GET", url, headers=headers, data=data)
print(response.text.encode('utf8'))
Response
200 OK
Channel with HAL links.
{
"id" : "39de24cb-778c-4ec1-a01c-5b906dee1fe0",
"name" : "SITChannel",
"workspaceId" : "2993c88b-c673-473d-b82c-cf0d878a88fa",
"creator" : {
"id" : "auth0|5eb0327cbfd7490bff55feeb",
"name" : "[email protected]",
"handle" : "@sit+prod"
},
"scope" : "PROFILE",
"type" : "SOURCE",
"created" : "2025-06-19T10:15:23.419866",
"lastModified" : "2025-06-19T10:15:23.419866",
"description" : "SITChannel",
"picture" : "https://s.gravatar.com/avatar/8f4ad8fa0793181b761d030196e62053?s=480&r=pg&d=https%3A%2F%2Fcdn.auth0.com%2Favatars%2Fsu.png",
"datasetCount" : 0,
"containsDataset" : false,
"_links" : {
"self" : {
"href" : "https://app.matatika.com/api/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0"
},
"datasets" : {
"href" : "https://app.matatika.com/api/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0/datasets",
"type" : "GET"
},
"add subscription" : {
"href" : "https://app.matatika.com/api/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0/subscriptions"
},
"update channel" : {
"href" : "https://app.matatika.com/api/workspaces/2993c88b-c673-473d-b82c-cf0d878a88fa/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0"
},
"delete channel" : {
"href" : "https://app.matatika.com/api/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0"
},
"add workspace-scope" : {
"href" : "https://app.matatika.com/api/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0/scope/workspace"
}
}
}
View a channel in a workspace
GET
/api/workspaces/{workspace-id}/channels/{channel-id}
Returns a channel in the workspace {workspace-id}
.
Prerequisites
- Workspace
{workspace-id}
must exist - The user must be a member of the workspace
{workspace-id}
Request
Example Snippets
cURL
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com:443/api/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0' -i -X GET \
-H 'Accept: application/json, application/javascript, text/javascript, text/json' \
-H 'Content-Type: text/plain; charset=ISO-8859-1' \
-d '{}'
Python (requests
)
import requests
url = "https://app.matatika.com:443/api/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0"
data = {}
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("GET", url, headers=headers, data=data)
print(response.text.encode('utf8'))
Response
200 OK
Channel with HAL links.
{
"id" : "39de24cb-778c-4ec1-a01c-5b906dee1fe0",
"name" : "SITChannel",
"workspaceId" : "2993c88b-c673-473d-b82c-cf0d878a88fa",
"creator" : {
"id" : "auth0|5eb0327cbfd7490bff55feeb",
"name" : "[email protected]",
"handle" : "@sit+prod"
},
"scope" : "PROFILE",
"type" : "SOURCE",
"created" : "2025-06-19T10:15:23.419866",
"lastModified" : "2025-06-19T10:15:23.419866",
"description" : "SITChannel",
"picture" : "https://s.gravatar.com/avatar/8f4ad8fa0793181b761d030196e62053?s=480&r=pg&d=https%3A%2F%2Fcdn.auth0.com%2Favatars%2Fsu.png",
"datasetCount" : 0,
"containsDataset" : false,
"_links" : {
"self" : {
"href" : "https://app.matatika.com/api/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0"
},
"datasets" : {
"href" : "https://app.matatika.com/api/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0/datasets",
"type" : "GET"
},
"add subscription" : {
"href" : "https://app.matatika.com/api/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0/subscriptions"
},
"update channel" : {
"href" : "https://app.matatika.com/api/workspaces/2993c88b-c673-473d-b82c-cf0d878a88fa/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0"
},
"delete channel" : {
"href" : "https://app.matatika.com/api/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0"
},
"add workspace-scope" : {
"href" : "https://app.matatika.com/api/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0/scope/workspace"
}
}
}
View all channels in a workspace
GET
/api/workspaces/{workspace-id}/channels/{channel-id}?type={type}&source={source}&containsDataset={datasetId}
Returns all channels in the workspace {workspace-id}
.
Request
Query Parameters
Parameter | Required | Format | Default Value | Description |
---|---|---|---|---|
type |
No | string | None | Return channels by types: list or source |
source |
No | string | None | Return channels by source: profile or workspace |
containsDataset |
No | string | None | Adds a containsDataset boolean field to all channels returning if it contains the dataset |
Prerequisites
- Workspace
{workspace-id}
must exist - The user must be a member of the workspace
{workspace-id}
Request
Example Snippets
cURL
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com:443/api/workspaces/2993c88b-c673-473d-b82c-cf0d878a88fa/channels' -i -X GET \
-H 'Accept: application/json, application/javascript, text/javascript, text/json' \
-H 'Content-Type: text/plain; charset=ISO-8859-1' \
-d '{}'
Python (requests
)
import requests
url = "https://app.matatika.com:443/api/workspaces/2993c88b-c673-473d-b82c-cf0d878a88fa/channels"
data = {}
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("GET", url, headers=headers, data=data)
print(response.text.encode('utf8'))
Response
200 OK
Channel collection with HAL links.
{
"_embedded" : {
"channels" : [ {
"id" : "39de24cb-778c-4ec1-a01c-5b906dee1fe0",
"name" : "SITChannel",
"workspaceId" : "2993c88b-c673-473d-b82c-cf0d878a88fa",
"creator" : {
"id" : "auth0|5eb0327cbfd7490bff55feeb",
"name" : "[email protected]",
"handle" : "@sit+prod"
},
"scope" : "PROFILE",
"type" : "SOURCE",
"created" : "2025-06-19T10:15:23.419866",
"lastModified" : "2025-06-19T10:15:23.419866",
"description" : "SITChannel",
"datasetCount" : 0,
"containsDataset" : false,
"_links" : {
"self" : {
"href" : "https://app.matatika.com/api/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0"
},
"datasets" : {
"href" : "https://app.matatika.com/api/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0/datasets",
"type" : "GET"
},
"add subscription" : {
"href" : "https://app.matatika.com/api/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0/subscriptions"
},
"update channel" : {
"href" : "https://app.matatika.com/api/workspaces/2993c88b-c673-473d-b82c-cf0d878a88fa/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0"
},
"delete channel" : {
"href" : "https://app.matatika.com/api/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0"
},
"add workspace-scope" : {
"href" : "https://app.matatika.com/api/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0/scope/workspace"
}
}
}, {
"id" : "27863e62-ce93-476d-9197-1879bc79ed94",
"name" : "SITChannelTwo",
"workspaceId" : "2993c88b-c673-473d-b82c-cf0d878a88fa",
"creator" : {
"id" : "auth0|5eb0327cbfd7490bff55feeb",
"name" : "[email protected]",
"handle" : "@sit+prod"
},
"scope" : "PROFILE",
"type" : "SOURCE",
"created" : "2025-06-19T10:15:23.529125",
"lastModified" : "2025-06-19T10:15:23.529126",
"description" : "SITChannelTwo",
"datasetCount" : 0,
"containsDataset" : false,
"_links" : {
"self" : {
"href" : "https://app.matatika.com/api/channels/27863e62-ce93-476d-9197-1879bc79ed94"
},
"datasets" : {
"href" : "https://app.matatika.com/api/channels/27863e62-ce93-476d-9197-1879bc79ed94/datasets",
"type" : "GET"
},
"add subscription" : {
"href" : "https://app.matatika.com/api/channels/27863e62-ce93-476d-9197-1879bc79ed94/subscriptions"
},
"update channel" : {
"href" : "https://app.matatika.com/api/workspaces/2993c88b-c673-473d-b82c-cf0d878a88fa/channels/27863e62-ce93-476d-9197-1879bc79ed94"
},
"delete channel" : {
"href" : "https://app.matatika.com/api/channels/27863e62-ce93-476d-9197-1879bc79ed94"
},
"add workspace-scope" : {
"href" : "https://app.matatika.com/api/channels/27863e62-ce93-476d-9197-1879bc79ed94/scope/workspace"
}
}
} ]
},
"_links" : {
"self" : {
"href" : "https://app.matatika.com/api/workspaces/2993c88b-c673-473d-b82c-cf0d878a88fa/channels?page=0&size=10&sort=name,asc"
}
},
"page" : {
"size" : 10,
"totalElements" : 2,
"totalPages" : 1,
"number" : 0
}
}
Create or Update a channel in a workspace
PUT
/api/workspaces/{workspace-id}/channels/{channel-id}
Creates or Updates a channel in the workspace {workspace-id}
.
This endpoint takes a {channel-id}
(UUID) and based on the supplied value and the channels that already exist in the workspace, will update or create a channel accordingly.
Prerequisites
- Workspace
{workspace-id}
must exist - The user must be a admin in the workspace
{workspace-id}
Request
Example Snippets
cURL
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com:443/api/workspaces/2993c88b-c673-473d-b82c-cf0d878a88fa/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0' -i -X PUT \
-H 'Accept: application/json, application/javascript, text/javascript, text/json' \
-H 'Content-Type: application/json' \
-d '{
"name" : "SITChannel",
"description" : "SITChannel"
}'
Python (requests
)
import requests
url = "https://app.matatika.com:443/api/workspaces/2993c88b-c673-473d-b82c-cf0d878a88fa/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0"
data = {
"name" : "SITChannel",
"description" : "SITChannel"
}
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("PUT", url, headers=headers, data=data)
print(response.text.encode('utf8'))
Response
200 OK / 201 Created
Channel with HAL links.
{
"id" : "39de24cb-778c-4ec1-a01c-5b906dee1fe0",
"name" : "SITChannel",
"workspaceId" : "2993c88b-c673-473d-b82c-cf0d878a88fa",
"creator" : {
"id" : "auth0|5eb0327cbfd7490bff55feeb",
"name" : "[email protected]",
"handle" : "@sit+prod"
},
"scope" : "PROFILE",
"type" : "SOURCE",
"created" : "2025-06-19T10:15:23.419866174",
"lastModified" : "2025-06-19T10:15:23.419866374",
"description" : "SITChannel",
"datasetCount" : 0,
"containsDataset" : false,
"_links" : {
"self" : {
"href" : "https://app.matatika.com/api/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0"
},
"datasets" : {
"href" : "https://app.matatika.com/api/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0/datasets",
"type" : "GET"
},
"add subscription" : {
"href" : "https://app.matatika.com/api/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0/subscriptions"
},
"update channel" : {
"href" : "https://app.matatika.com/api/workspaces/2993c88b-c673-473d-b82c-cf0d878a88fa/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0"
},
"delete channel" : {
"href" : "https://app.matatika.com/api/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0"
},
"add workspace-scope" : {
"href" : "https://app.matatika.com/api/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0/scope/workspace"
}
}
}
Delete a channel
DELETE
/api/channels/{channel-id}
Delete a channel.
Prerequisites
- The user must be a admin of the workspace the channel is in.
Request
Example Snippets
cURL
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com:443/api/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0' -i -X DELETE \
-H 'Accept: application/json, application/javascript, text/javascript, text/json' \
-H 'Content-Type: text/plain; charset=ISO-8859-1' \
-d '{}'
Python (requests
)
import requests
url = "https://app.matatika.com:443/api/channels/39de24cb-778c-4ec1-a01c-5b906dee1fe0"
data = {}
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("DELETE", url, headers=headers, data=data)
print(response.text.encode('utf8'))
Response
204 No Content
No response body provided.
View all channels in your workspace news
GET
/api/channels/{channel-id}
Returns all channels in your news for the workspace.
Request
Example Snippets
cURL
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com:443/api/workspaces/2993c88b-c673-473d-b82c-cf0d878a88fa/news/channels' -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/2993c88b-c673-473d-b82c-cf0d878a88fa/news/channels"
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("GET", url, headers=headers)
print(response.text.encode('utf8'))
Response
200 OK
Channels in your workspace news.
{
"_embedded" : {
"channels" : [ {
"id" : "bfc0553a-7c6a-4dc2-bc84-d36a2e2f8d4d",
"name" : "SITChannel",
"workspaceId" : "2993c88b-c673-473d-b82c-cf0d878a88fa",
"creator" : {
"id" : "auth0|5eb0327cbfd7490bff55feeb",
"name" : "[email protected]",
"handle" : "@sit+prod"
},
"scope" : "WORKSPACE",
"type" : "SOURCE",
"created" : "2025-06-19T10:15:24.203388",
"lastModified" : "2025-06-19T10:15:24.203388",
"description" : "SITChannel",
"picture" : "https://s.gravatar.com/avatar/8f4ad8fa0793181b761d030196e62053?s=480&r=pg&d=https%3A%2F%2Fcdn.auth0.com%2Favatars%2Fsu.png",
"datasetCount" : 0,
"containsDataset" : false,
"_links" : {
"search" : {
"href" : "https://app.matatika.com/api/workspaces/2993c88b-c673-473d-b82c-cf0d878a88fa/news?q=in:SITChannel"
}
}
} ]
},
"_links" : {
"self" : {
"href" : "https://app.matatika.com/api/channels"
}
}
}
Add a dataset to a list channel
PUT
/api/channels/{channel-id}/datasets/{dataset-id}
Adds a dataset to a channel with type list.
Request
Example Snippets
cURL
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com:443/api/channels/500124e3-9edc-4459-a33b-8c78eb3c6cdd/datasets/c9579008-2359-45ed-8a19-15c9e97992e6' -i -X PUT \
-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/500124e3-9edc-4459-a33b-8c78eb3c6cdd/datasets/c9579008-2359-45ed-8a19-15c9e97992e6"
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("PUT", url, headers=headers)
print(response.text.encode('utf8'))
Response
201 Created
No response body provided.
Remove a dataset from a list channel
DELETE
/api/channels/{channel-id}/datasets/{dataset-id}
Removes a dataset from a channel with type list.
Request
Example Snippets
cURL
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com:443/api/channels/500124e3-9edc-4459-a33b-8c78eb3c6cdd/datasets/c9579008-2359-45ed-8a19-15c9e97992e6' -i -X DELETE \
-H 'Accept: application/json, application/javascript, text/javascript, text/json'
Python (requests
)
import requests
url = "https://app.matatika.com:443/api/channels/500124e3-9edc-4459-a33b-8c78eb3c6cdd/datasets/c9579008-2359-45ed-8a19-15c9e97992e6"
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("DELETE", url, headers=headers)
print(response.text.encode('utf8'))
Response
204 No Content
No response body provided.
Add workspace scope to a channel
PUT
/api/channels/{channel-id}/scope/workspace
Add workspace scope to a channel.
Request
Example Snippets
cURL
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com:443/api/channels/500124e3-9edc-4459-a33b-8c78eb3c6cdd/scope/workspace' -i -X PUT \
-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/500124e3-9edc-4459-a33b-8c78eb3c6cdd/scope/workspace"
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("PUT", url, headers=headers)
print(response.text.encode('utf8'))
Response
200 OK
Channel with HAL links.
{
"id" : "500124e3-9edc-4459-a33b-8c78eb3c6cdd",
"name" : "mylist",
"workspaceId" : "2993c88b-c673-473d-b82c-cf0d878a88fa",
"creator" : {
"id" : "auth0|5eb0327cbfd7490bff55feeb",
"name" : "[email protected]",
"handle" : "@sit+prod"
},
"scope" : "WORKSPACE",
"type" : "LIST",
"created" : "2025-06-19T10:15:29.811475",
"lastModified" : "2025-06-19T10:15:29.811475",
"description" : "mylist channel",
"datasetCount" : 0,
"containsDataset" : false,
"_links" : {
"self" : {
"href" : "https://app.matatika.com/api/channels/500124e3-9edc-4459-a33b-8c78eb3c6cdd"
},
"datasets" : {
"href" : "https://app.matatika.com/api/channels/500124e3-9edc-4459-a33b-8c78eb3c6cdd/datasets",
"type" : "GET"
},
"add subscription" : {
"href" : "https://app.matatika.com/api/channels/500124e3-9edc-4459-a33b-8c78eb3c6cdd/subscriptions"
},
"update channel" : {
"href" : "https://app.matatika.com/api/workspaces/2993c88b-c673-473d-b82c-cf0d878a88fa/channels/500124e3-9edc-4459-a33b-8c78eb3c6cdd"
},
"delete channel" : {
"href" : "https://app.matatika.com/api/channels/500124e3-9edc-4459-a33b-8c78eb3c6cdd"
},
"withdraw workspace-scope" : {
"href" : "https://app.matatika.com/api/channels/500124e3-9edc-4459-a33b-8c78eb3c6cdd/scope/profile"
}
}
}
Withdraw workspace scope from a channel
PUT
/api/channels/{channel-id}/scope/profile
Withdraw workspace scope from a channel.
Request
Example Snippets
cURL
curl -H "Authorization: Bearer $ACCESS_TOKEN" 'https://app.matatika.com:443/api/channels/500124e3-9edc-4459-a33b-8c78eb3c6cdd/scope/profile' -i -X PUT \
-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/500124e3-9edc-4459-a33b-8c78eb3c6cdd/scope/profile"
headers = {
'Authorization': ACCESS_TOKEN
}
response = requests.request("PUT", url, headers=headers)
print(response.text.encode('utf8'))
Response
200 OK
Channel with HAL links.
{
"id" : "500124e3-9edc-4459-a33b-8c78eb3c6cdd",
"name" : "mylist",
"workspaceId" : "2993c88b-c673-473d-b82c-cf0d878a88fa",
"creator" : {
"id" : "auth0|5eb0327cbfd7490bff55feeb",
"name" : "[email protected]",
"handle" : "@sit+prod"
},
"scope" : "PROFILE",
"type" : "LIST",
"created" : "2025-06-19T10:15:29.811475",
"lastModified" : "2025-06-19T10:15:29.811475",
"description" : "mylist channel",
"datasetCount" : 0,
"containsDataset" : false,
"_links" : {
"self" : {
"href" : "https://app.matatika.com/api/channels/500124e3-9edc-4459-a33b-8c78eb3c6cdd"
},
"datasets" : {
"href" : "https://app.matatika.com/api/channels/500124e3-9edc-4459-a33b-8c78eb3c6cdd/datasets",
"type" : "GET"
},
"add subscription" : {
"href" : "https://app.matatika.com/api/channels/500124e3-9edc-4459-a33b-8c78eb3c6cdd/subscriptions"
},
"update channel" : {
"href" : "https://app.matatika.com/api/workspaces/2993c88b-c673-473d-b82c-cf0d878a88fa/channels/500124e3-9edc-4459-a33b-8c78eb3c6cdd"
},
"delete channel" : {
"href" : "https://app.matatika.com/api/channels/500124e3-9edc-4459-a33b-8c78eb3c6cdd"
},
"add workspace-scope" : {
"href" : "https://app.matatika.com/api/channels/500124e3-9edc-4459-a33b-8c78eb3c6cdd/scope/workspace"
}
}
}