{"version":"0.20.0","name":"kanvas_groups","description":"Organizations and teams: list, read, create, update (branding grants nothing), member.set (roles), access.read/access.set (a group's role on a session). Account-wide authority and proper roles required. Required: operation. Required fields by operation: list(none); read(groupId); create(kind,name,requestId); update(groupId,expectedRevision); member.set(groupId,expectedRevision,username,role); access.read(sessionId); access.set(sessionId,groupId,expectedRevision,role).","inputSchema":{"type":"object","properties":{"operation":{"type":"string","enum":["list","read","create","update","member.set","access.read","access.set"],"description":"Required operation; supply only the fields in its matching branch."},"groupId":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,128}$"},"kind":{"type":"string","enum":["organization","team"]},"name":{"type":"string","minLength":1,"maxLength":100},"description":{"type":"string","maxLength":1000},"organizationIds":{"maxItems":16,"type":"array","items":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,128}$"}},"requestId":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,128}$"},"expectedRevision":{"type":"integer","minimum":0,"maximum":9007199254740991},"defaults":{"type":"object","properties":{"theme":{"type":"string","enum":["system","light","dark"]},"style":{"type":"string","enum":["neutral","lime","ocean","iris","ember","rose","sage","sand"]},"accent":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"density":{"type":"string","enum":["comfortable","compact"]}},"additionalProperties":false},"branding":{"type":"object","properties":{"palette":{"default":[],"maxItems":8,"type":"array","items":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"}},"logo":{"anyOf":[{"type":"object","properties":{"mimeType":{"type":"string","enum":["image/png","image/jpeg","image/webp"]},"base64":{"type":"string","minLength":4,"maxLength":350000}},"required":["mimeType","base64"],"additionalProperties":false},{"type":"null"}]}},"additionalProperties":false},"username":{"type":"string","minLength":1,"maxLength":254},"role":{"type":["string","null"]},"sessionId":{"type":"string","pattern":"^[A-Za-z0-9_-]{1,128}$"}},"required":["operation"],"oneOf":[{"properties":{"operation":{"const":"list"}},"additionalProperties":false,"required":["operation"]},{"properties":{"operation":{"const":"read"},"groupId":{}},"required":["operation","groupId"],"additionalProperties":false},{"properties":{"operation":{"const":"create"},"kind":{},"name":{},"description":{"default":""},"organizationIds":{"default":[]},"requestId":{}},"required":["operation","kind","name","requestId"],"additionalProperties":false,"description":"Create an explicitly requested organization or cross-organization team; links alone grant no access."},{"properties":{"operation":{"const":"update"},"groupId":{},"expectedRevision":{},"name":{},"description":{},"organizationIds":{},"defaults":{},"branding":{}},"required":["operation","groupId","expectedRevision"],"additionalProperties":false,"description":"Administer one group at the current revision, including optional branding."},{"properties":{"operation":{"const":"member.set"},"groupId":{},"expectedRevision":{},"username":{},"role":{"anyOf":[{"type":"string","enum":["admin","member"]},{"type":"null"}]}},"required":["operation","groupId","expectedRevision","username","role"],"additionalProperties":false,"description":"Explicitly add/change a group member; role:null removes."},{"properties":{"operation":{"const":"access.read"},"sessionId":{}},"required":["operation","sessionId"],"additionalProperties":false},{"properties":{"operation":{"const":"access.set"},"sessionId":{},"groupId":{},"expectedRevision":{},"role":{"anyOf":[{"type":"string","enum":["editor","viewer"]},{"type":"null"}]}},"required":["operation","sessionId","groupId","expectedRevision","role"],"additionalProperties":false,"description":"Explicit owner grant/change/revocation of team/org session access."}],"examples":[{"operation":"list"},{"operation":"read","groupId":"group-id"},{"operation":"create","kind":"organization","name":"Example organization","requestId":"r2"},{"operation":"update","groupId":"group-id","expectedRevision":0,"defaults":{"accent":"#38bdf8"}},{"operation":"member.set","groupId":"group-id","expectedRevision":0,"username":"example_user","role":"member"},{"operation":"access.read","sessionId":"s"},{"operation":"access.set","sessionId":"s","groupId":"group-id","expectedRevision":0,"role":"viewer"}]},"annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true}}