Resource sharing

Operations of the Channel Gateway API. Paths are relative to your deployment's API host.

GET /api/channel-gateway-api/resources/{type}/{id}/shares

The shares of one resource (needs view)

Authentication: bearer token (Authorization: Bearer <token>)

ParameterInTypeRequiredDescription
idpathstringyes
typepathstringyes
StatusDescriptionBody
200application/json ResourceSharesDtoDataEnvelope

PUT /api/channel-gateway-api/resources/{type}/{id}/shares

Grant a subject exactly one share level (needs manage and the level)

Authentication: bearer token (Authorization: Bearer <token>)

ParameterInTypeRequiredDescription
idpathstringyes
typepathstringyes

Request body: application/json PutResourceShareDto

StatusDescriptionBody
204

DELETE /api/channel-gateway-api/resources/{type}/{id}/shares/{subjectKind}/{subjectId}

Remove a subject's share (needs manage and the level it held)

The path names the STORED subject: a human share is membership/<membership id>, so a share of a user who left can still be removed.

Authentication: bearer token (Authorization: Bearer <token>)

ParameterInTypeRequiredDescription
idpathstringyes
subjectIdpathstringyes
subjectKindpathstringyes
typepathstringyes
StatusDescriptionBody
204