Add Share Permission

POST {{baseUrl}}/rest/api/3/filter/:id/permission

Add a share permissions to a filter. If you add a global share permission (one for all logged-in users or the public) it will overwrite all share permissions for the filter.

Be aware that this operation uses different objects for updating share permissions compared to Update filter.

Permissions required: Share dashboards and filters global permission and the user must own the filter.

Request Body

{"type"=>"<string>", "projectId"=>"<string>", "groupname"=>"<string>", "projectRoleId"=>"<string>"}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring

RESPONSES

status: Created

[{&quot;id&quot;:10000,&quot;type&quot;:&quot;global&quot;},{&quot;id&quot;:10010,&quot;type&quot;:&quot;project&quot;,&quot;project&quot;:{&quot;self&quot;:&quot;https://your-domain.atlassian.net/rest/api/3/project/EX&quot;,&quot;id&quot;:&quot;10000&quot;,&quot;key&quot;:&quot;EX&quot;,&quot;name&quot;:&quot;Example&quot;,&quot;avatarUrls&quot;:{&quot;48x48&quot;:&quot;https://your-domain.atlassian.net/secure/projectavatar?size=large\u0026pid=10000&quot;,&quot;24x24&quot;:&quot;https://your-domain.atlassian.net/secure/projectavatar?size=small\u0026pid=10000&quot;,&quot;16x16&quot;:&quot;https://your-domain.atlassian.net/secure/projectavatar?size=xsmall\u0026pid=10000&quot;,&quot;32x32&quot;:&quot;https://your-domain.atlassian.net/secure/projectavatar?size=medium\u0026pid=10000&quot;},&quot;projectCategory&quot;:{&quot;self&quot;:&quot;https://your-domain.atlassian.net/rest/api/3/projectCategory/10000&quot;,&quot;id&quot;:&quot;10000&quot;,&quot;name&quot;:&quot;FIRST&quot;,&quot;description&quot;:&quot;First Project Category&quot;},&quot;simplified&quot;:false,&quot;style&quot;:&quot;classic&quot;,&quot;insight&quot;:{&quot;totalIssueCount&quot;:100,&quot;lastIssueUpdateTime&quot;:&quot;2020-12-17T01:45:38.377+0000&quot;}}},{&quot;id&quot;:10010,&quot;type&quot;:&quot;project&quot;,&quot;project&quot;:{&quot;self&quot;:&quot;https://your-domain.atlassian.net/rest/api/3/project/MKY&quot;,&quot;id&quot;:&quot;10002&quot;,&quot;key&quot;:&quot;MKY&quot;,&quot;name&quot;:&quot;Example&quot;,&quot;avatarUrls&quot;:{&quot;48x48&quot;:&quot;https://your-domain.atlassian.net/secure/projectavatar?size=large\u0026pid=10002&quot;,&quot;24x24&quot;:&quot;https://your-domain.atlassian.net/secure/projectavatar?size=small\u0026pid=10002&quot;,&quot;16x16&quot;:&quot;https://your-domain.atlassian.net/secure/projectavatar?size=xsmall\u0026pid=10002&quot;,&quot;32x32&quot;:&quot;https://your-domain.atlassian.net/secure/projectavatar?size=medium\u0026pid=10002&quot;},&quot;projectCategory&quot;:{&quot;self&quot;:&quot;https://your-domain.atlassian.net/rest/api/3/projectCategory/10000&quot;,&quot;id&quot;:&quot;10000&quot;,&quot;name&quot;:&quot;FIRST&quot;,&quot;description&quot;:&quot;First Project Category&quot;},&quot;simplified&quot;:false,&quot;style&quot;:&quot;classic&quot;,&quot;insight&quot;:{&quot;totalIssueCount&quot;:100,&quot;lastIssueUpdateTime&quot;:&quot;2020-12-17T01:45:38.377+0000&quot;},&quot;deleted&quot;:true,&quot;retentionTillDate&quot;:&quot;2021-02-15T01:45:38.378+0000&quot;,&quot;deletedDate&quot;:&quot;2020-12-17T01:45:38.378+0000&quot;,&quot;deletedBy&quot;:{&quot;self&quot;:&quot;https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g&quot;,&quot;key&quot;:&quot;&quot;,&quot;accountId&quot;:&quot;5b10a2844c20165700ede21g&quot;,&quot;name&quot;:&quot;&quot;,&quot;avatarUrls&quot;:{&quot;48x48&quot;:&quot;https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=48\u0026s=48&quot;,&quot;24x24&quot;:&quot;https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=24\u0026s=24&quot;,&quot;16x16&quot;:&quot;https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=16\u0026s=16&quot;,&quot;32x32&quot;:&quot;https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=32\u0026s=32&quot;},&quot;displayName&quot;:&quot;Mia Krystof&quot;,&quot;active&quot;:false}},&quot;role&quot;:{&quot;self&quot;:&quot;https://your-domain.atlassian.net/rest/api/3/project/MKY/role/10360&quot;,&quot;name&quot;:&quot;Developers&quot;,&quot;id&quot;:10360,&quot;description&quot;:&quot;A project role that represents developers in a project&quot;,&quot;actors&quot;:[{&quot;id&quot;:10240,&quot;displayName&quot;:&quot;jira-developers&quot;,&quot;type&quot;:&quot;atlassian-group-role-actor&quot;,&quot;name&quot;:&quot;jira-developers&quot;,&quot;actorGroup&quot;:{&quot;name&quot;:&quot;jira-developers&quot;,&quot;displayName&quot;:&quot;jira-developers&quot;}},{&quot;id&quot;:10241,&quot;displayName&quot;:&quot;Mia Krystof&quot;,&quot;type&quot;:&quot;atlassian-user-role-actor&quot;,&quot;actorUser&quot;:{&quot;accountId&quot;:&quot;5b10a2844c20165700ede21g&quot;}}],&quot;scope&quot;:{&quot;type&quot;:&quot;PROJECT&quot;,&quot;project&quot;:{&quot;id&quot;:&quot;10000&quot;,&quot;key&quot;:&quot;KEY&quot;,&quot;name&quot;:&quot;Next Gen Project&quot;}}}},{&quot;id&quot;:10010,&quot;type&quot;:&quot;group&quot;,&quot;group&quot;:{&quot;name&quot;:&quot;jira-administrators&quot;,&quot;self&quot;:&quot;https://your-domain.atlassian.net/rest/api/3/group?groupname=jira-administrators&quot;}}]