Kokar Help CenterCapabilities
Everything a connected AI app can do in your workspace, and the permission each one needs.
When you approve a connection you choose which of two permissions to grant:
| Permission | Covers |
|---|---|
| View | Everything under Reading below. |
| Create and update | Everything under Writing below. |
Grant view only and every writing capability is refused, with a message saying it needs write access.
Reading
Finding your way around
| Capability | What it does |
|---|---|
| Get workspace hierarchy | Returns the tree β spaces, their folders and subfolders, and the projects in each. This is how the app learns what exists before doing anything else. |
| List members | The people in the workspace, with their roles. Used to work out who to assign a task to when you name someone. |
| Get docs hierarchy | The documents tree β folders, pages and sub-pages you have access to. |
Tasks
| Capability | What it does |
|---|---|
| List tasks | Open tasks, optionally just yours or just one project's. |
| Get task | The full detail of one task β description, status, priority, dates, project, assignees. |
| List overdue tasks | Open tasks past their due date, most overdue first, reckoned in your workspace's timezone. |
| Search tasks | Finds tasks by title, across the workspace or within one project β for when you refer to a task by name. |
| Get task comments | Reads a task's comment thread, with author names. |
Docs
| Capability | What it does |
|---|---|
| Search docs | Finds document pages by title, with the document each belongs to. |
| Read doc page | Reads a page's content, so the app can summarise or answer questions from it. |
Chat
| Capability | What it does |
|---|---|
| List conversations | Your channels and direct messages, most recently active first. |
Writing
Tasks
| Capability | What it does | Needs |
|---|---|---|
| Create task | Adds a task to a project, with description, status, priority, dates and assignees. | Create access to the project |
| Create subtask | Adds a subtask under an existing task, in the same project. | Create access to the project |
| Update task | Changes an existing task. Only the fields mentioned change; status is set by its name on the board, e.g. "In Progress". | Edit access β or being the assignee, for status and assignee changes on your own task |
| Move task | Moves a task to a different project; its status resets to the destination board's first status. Tasks with subtasks cannot be moved. | Edit on the source, create on the destination |
| Delete task | Sends a task to Trash, where it can be restored β same as deleting it in the app. | Full-edit access, unless you created the task |
| Add tag | Tags a task, creating the tag if it does not exist yet. | Edit access to the project |
| Add comment | Posts a comment on a task, under your name. | Comment access to the task's space |
Structure
| Capability | What it does | Needs |
|---|---|---|
| Create space | Adds a top-level space. | Permission to create spaces |
| Create folder | Adds a folder in a space, optionally nested inside another folder. | Create access to the space |
| Create project | Adds a project (task board) in a space, optionally inside a folder. | Create access to the space |
Docs and chat
| Capability | What it does | Needs |
|---|---|---|
| Create doc page | Creates a document page, optionally nested under another page. | Permission to create docs |
| Send chat message | Posts to a channel you belong to, as you. | Membership of the channel |
| Send direct message | Sends a 1:1 message to a member, starting the conversation if there isn't one. | Membership of the workspace |
Messages are sent as you
Chat messages and comments an AI app posts appear under your name, with no marking to say a machine wrote them. Read what it is about to send before you approve it.
What is deliberately not here
- No permission or billing changes. Roles, invitations, plans and payment details cannot be touched over a connection.
- No permanent deletion. Deleting sends things to Trash; emptying Trash is something you do in the app.
- No access to another workspace, and no way to ask for one.
- No reading of private locations you are not a member of β not even for the workspace owner's connection.
Frequently asked questions
Can a connected AI app see my whole workspace?
Only the parts you can see. It acts as you, so the same space, project and folder permissions apply, and private locations you are not a member of stay invisible.
Can it delete my work permanently?
No. Deleting a task moves it to Trash, exactly as deleting it in the app does, and you can restore it from there.
Can it move data between my workspaces?
No. A connection is bound to one workspace at approval time and has no way to name another.