Per-Org Datasources summary
GET {baseURl}/v2/datasources
Summary of datasources for an organization.
Example
https://clarity-data-api.clarity.io/v2/datasources?org=myorgVD43
Headers
x-api-key
: the API key string.
Request
query parameter | description | |
---|---|---|
org |
string required |
The ID of the organization. Find it under the user profile section in Dashboard. Example "myorgVD43" |
Response
attribute | description | |
---|---|---|
subscribingOrg |
str | The org passed in as a parameter on the request. |
datasources |
array | List of datasources visible to the organization. |
Datasource
attribute | description | |
---|---|---|
datasourceId |
string | Unique identifier of the datasource. |
currentSubscriptionId |
string | Unique identifier of the subscription currently attached to the datasource. |
currentSourceId |
string | Unique identifier of the device or reference site currently installed into the datasource. |
sourceType |
string | Either "CLARITY_NODE" or "REFERENCE_SITE" . |
orgAnnotations |
object | Identifying information about the datasource as configured by the organization. |
Org Annotations
attribute | description | |
---|---|---|
name |
string | The name of the datasource. |
group |
string | The group of the datasource. |
tags |
array | List of strings representing the tags assigned to the datasource. |
Example 200 Response
{
"subscribingOrg": "demoABCD",
"datasources": [
{
"datasourceId": "DHARP5723",
"orgAnnotations": {
"group": null,
"name": "San Pablo - Rumrill",
"tags": [
"snoopy",
"linus"
]
},
"currentSubscriptionId": "SDM6PK5WG",
"currentSourceId": "RCRFVQH0",
"sourceType": "REFERENCE_SITE"
},
{
"datasourceId": "DNQPD5647",
"orgAnnotations": {
"group": "TEST_GROUP2",
"name": "My pet device.",
"tags": []
},
"currentSubscriptionId": "SMATQB6ER",
"currentSourceId": "A1234567",
"sourceType": "CLARITY_NODE"
}
]
}