Create Share Permissions for a Feed

Creates an access permission on the specified feed.

Authorizations: Administrator

Requests

POST /apis/sections/:sectionId/shares
{
  "id": "a78758cc-48da-47ad-bc6e-6c8564badb7e",
  "shareType": "USER",
  "permission": "EDIT",
  "name": "viewer"
}

Note

Either id or name must be present. If both are provided, id is used. See (4.1) User Resources and (4.1) Group Resources.

Response

Success

{
  "data": {
    "id": "a78758cc-48da-47ad-bc6e-6c8564badb7e",
    "shareType": "USER",
    "permission": "EDIT",
    "name": "viewer",
    "email": null
  }
}

Error

Code	Payload	Description
`400`	`{"code":"010001", "name":"InputValidation",` `"message":<Error message>, "httpStatusCode":400}`	Supplied data was insufficient or incorrect.
`403`	`{"code": "030003", "name":"CannotShare",` `"message":"Cannot share", "httpStatusCode":403}`	User is not allowed to share to this permission ID. Ex.: User has the WATCH access permission, but is trying to share to the OWN level.
`404`	`{"code":"040002", "name":"AssetNotFound",` `"message":"Video not found", "httpStatusCode":404}`	Video with UUID `Id` not found.
`404`	`{"code":"040004", "name":"UserNotFound",` `"message":"User not found", "httpStatusCode":404}`	User with provided `id` or `name` was not found.
`404`	`{"code":"040005", "name":"GroupNotFound",` `"message":"Group not found", "httpStatusCode":404}`	Group with provided `id` or `name` was not found.
`404`	`{"code":"040025", "name":"SharePermissionNotFound",` `"message":"Share permission not found",` `"httpStatusCode":404}`	The access permission to share with was not found.
`409`	`{"code":"060001", "name":"UserHasNoRoles",` `"message":"User has no roles assigned",` `"httpStatusCode":409}`	Make sure a role is assigned to the user or to at least one of the user's groups.
`409`	`{"code":"060002", "name":"GroupHasNoRoles",` `"message":"Group has no roles assigned",` `"httpStatusCode":409}`	Make sure a role is assigned to the group.