List visual shares
Returns sharing entries for a visual, grouped by scope type. Only includes direct shares — inherited shares from dashboard sharing are not listed here.
Tenant users only see shares relevant to their own tenant.
Authorization
BearerAuth AuthorizationBearer <token>
A project-scoped or dashboard-scoped access token. Generate one via the Token API using your project ID and project secret.
In: header
Path Parameters
visualId*string
Visual identifier.
Response Body
application/json
application/json
application/json
application/json
curl -X get "https://semaphor.cloud/api/management/v1/visuals/string/shares"{
"tenantWide": [
{
"id": "string",
"type": "string",
"role": "VIEWER",
"scope": "string",
"grantedAt": "2019-08-24T14:15:22Z",
"grantedBy": {}
}
],
"specificTenantUsers": [
{
"id": "string",
"type": "string",
"role": "VIEWER",
"scope": "string",
"grantedAt": "2019-08-24T14:15:22Z",
"grantedBy": {}
}
],
"specificOrgUsers": [
{
"id": "string",
"type": "string",
"role": "VIEWER",
"scope": "string",
"grantedAt": "2019-08-24T14:15:22Z",
"grantedBy": {}
}
],
"orgWide": [
{
"id": "string",
"type": "string",
"role": "VIEWER",
"scope": "string",
"grantedAt": "2019-08-24T14:15:22Z",
"grantedBy": {}
}
],
"orgUsersOnly": [
{
"id": "string",
"type": "string",
"role": "VIEWER",
"scope": "string",
"grantedAt": "2019-08-24T14:15:22Z",
"grantedBy": {}
}
],
"allTenantsOnly": [
{
"id": "string",
"type": "string",
"role": "VIEWER",
"scope": "string",
"grantedAt": "2019-08-24T14:15:22Z",
"grantedBy": {}
}
],
"specificGroups": [
{
"id": "string",
"type": "string",
"role": "VIEWER",
"scope": "string",
"grantedAt": "2019-08-24T14:15:22Z",
"grantedBy": {}
}
]
}{
"error": "string",
"code": "string",
"details": {},
"success": true
}{
"error": "string",
"code": "string",
"details": {},
"success": true
}{
"error": "string",
"code": "string",
"details": {},
"success": true
}