[{"data":1,"prerenderedAt":343},["ShallowReactive",2],{"page:\u002Fguides\u002Fpermissions":3},{"id":4,"title":5,"apiPage":6,"body":7,"description":334,"extension":335,"layout":336,"meta":337,"navigation":338,"path":339,"playground":336,"seo":340,"stem":341,"__hash__":342},"docs\u002Fguides\u002Fpermissions.md","Permissions",false,{"type":8,"value":9,"toc":324},"minimark",[10,14,18,23,32,253,257,260,276,279,282,296,300,310,314,317,321],[11,12,5],"h1",{"id":13},"permissions",[15,16,17],"p",{},"What a request can do depends on two things: the scopes of your API key or app connection, and your roles in the workspace and project.",[19,20,22],"h2",{"id":21},"scopes","Scopes",[15,24,25,26,31],{},"Each endpoint's reference page shows the scope it needs.\nA key or connection can call only the endpoints its scopes allow. With no scopes, it can call only ",[27,28,30],"a",{"href":29},"\u002Fapi-references\u002Fauth\u002Fping","Ping",".",[33,34,35,48],"table",{},[36,37,38],"thead",{},[39,40,41,45],"tr",{},[42,43,44],"th",{},"Scope",[42,46,47],{},"Allows",[49,50,51,63,73,83,93,103,113,123,133,143,153,163,173,183,193,203,213,233,243],"tbody",{},[39,52,53,60],{},[54,55,56],"td",{},[57,58,59],"code",{},"projects:read",[54,61,62],{},"Searching and reading projects",[39,64,65,70],{},[54,66,67],{},[57,68,69],{},"projects:write",[54,71,72],{},"Creating and updating projects, and scheduling or canceling their deletion",[39,74,75,80],{},[54,76,77],{},[57,78,79],{},"folders:read",[54,81,82],{},"Listing and reading folders",[39,84,85,90],{},[54,86,87],{},[57,88,89],{},"folders:write",[54,91,92],{},"Creating, updating, and deleting folders",[39,94,95,100],{},[54,96,97],{},[57,98,99],{},"files:read",[54,101,102],{},"Listing and reading files",[39,104,105,110],{},[54,106,107],{},[57,108,109],{},"files:write",[54,111,112],{},"Uploading, updating, tagging, and deleting files",[39,114,115,120],{},[54,116,117],{},[57,118,119],{},"files:download",[54,121,122],{},"Getting file download URLs",[39,124,125,130],{},[54,126,127],{},[57,128,129],{},"ai:generate",[54,131,132],{},"Listing AI models, generating files with AI, and uploading generation attachments",[39,134,135,140],{},[54,136,137],{},[57,138,139],{},"comments:read",[54,141,142],{},"Listing and reading comments, replies, and reactions",[39,144,145,150],{},[54,146,147],{},[57,148,149],{},"comments:write",[54,151,152],{},"Creating, updating, and deleting comments, reactions, and comment attachments",[39,154,155,160],{},[54,156,157],{},[57,158,159],{},"comments:download",[54,161,162],{},"Getting comment attachment download URLs",[39,164,165,170],{},[54,166,167],{},[57,168,169],{},"workspace-members:read",[54,171,172],{},"Listing workspace members",[39,174,175,180],{},[54,176,177],{},[57,178,179],{},"project-members:read",[54,181,182],{},"Listing project members",[39,184,185,190],{},[54,186,187],{},[57,188,189],{},"project-members:write",[54,191,192],{},"Adding, updating, and removing project members",[39,194,195,200],{},[54,196,197],{},[57,198,199],{},"access-links:read",[54,201,202],{},"Listing and reading access links",[39,204,205,210],{},[54,206,207],{},[57,208,209],{},"access-links:write",[54,211,212],{},"Creating, updating, and deleting access links",[39,214,215,220],{},[54,216,217],{},[57,218,219],{},"access-links:read.key",[54,221,222,223,226,227,229,230],{},"Seeing the ",[57,224,225],{},"accessKey"," of access links. Without it, ",[57,228,225],{}," is ",[57,231,232],{},"null",[39,234,235,240],{},[54,236,237],{},[57,238,239],{},"skills:read",[54,241,242],{},"Listing and reading skills and skill versions",[39,244,245,250],{},[54,246,247],{},[57,248,249],{},"skills:write",[54,251,252],{},"Creating, updating, and deleting skills, and publishing or deleting skill versions",[19,254,256],{"id":255},"roles","Roles",[15,258,259],{},"Requests act as you, so you can reach the same projects you can open in the YouViCo app:",[261,262,263,267,270,273],"ul",{},[264,265,266],"li",{},"Projects you have joined",[264,268,269],{},"Projects open to the whole workspace",[264,271,272],{},"Every project in the workspace, if you are a workspace owner or manager",[264,274,275],{},"Projects another workspace has connected to yours",[15,277,278],{},"Endpoints that need a project role list the allowed roles on their reference page.",[15,280,281],{},"Some actions are limited to the person who created the item:",[261,283,284,287,290,293],{},[264,285,286],{},"Editing or deleting a comment: its author",[264,288,289],{},"Completing a file upload: the person who started it",[264,291,292],{},"Completing a generation attachment upload: the person who started it",[264,294,295],{},"Completing, canceling, or deleting a comment attachment: the person who uploaded it",[19,297,299],{"id":298},"restricted-files","Restricted files",[15,301,302,303,229,306,309],{},"Restricted reviewers see only files shared with them (",[57,304,305],{},"allowRestricted",[57,307,308],{},"true",").\nThe same applies when you reach a project through your workspace role without joining it.",[19,311,313],{"id":312},"plan-features","Plan features",[15,315,316],{},"AI file generation and skills are available only on plans that include them.",[19,318,320],{"id":319},"archived-projects","Archived projects",[15,322,323],{},"Archived projects are read-only.\nYou can still get download URLs, remove project members, and delete access links.",{"title":325,"searchDepth":326,"depth":326,"links":327},"",4,[328,330,331,332,333],{"id":21,"depth":329,"text":22},2,{"id":255,"depth":329,"text":256},{"id":298,"depth":329,"text":299},{"id":312,"depth":329,"text":313},{"id":319,"depth":329,"text":320},"What an API key or connected app can do depends on its scopes and on your workspace and project roles. See every scope and what it allows.","md",null,{},true,"\u002Fguides\u002Fpermissions",{"title":5,"description":334},"guides\u002Fpermissions","LPybGWX4MBnoslPW1_82WW9r__CxmRUCASagP9yPFm0",1792305905519]