Tools reference/Organisation

Organisation lifecycle

Agents can create and change organisations, workspaces and projects; deleting them is only done in the app. Creating a workspace or a project needs the key's Lifecycle capability and the person's own role, and changing one needs admin access to it.

The live list

Your AI tool can call searchTools with category: "organization" for the current list of these tools with every input. This page is the readable copy.

The tools

Every tool below keeps to the access of the key or sign-in that calls it, and to the person’s own role. A tool only sees the tools it may use.

  • createOrganisation

    Create a new organisation. Subject to plan-tier cap.

  • createProject

    Create a project under a workspace.

  • createWorkspace

    Create a workspace under an organisation.

  • getOrganisation

    Read an organisation by ID (members, plan tier, settings).

  • getProject

    Read a project.

  • getWorkspace

    Read a workspace.

  • updateOrganisation

    Update organisation name, description, settings (admin).

  • updateProject

    Update project metadata.

  • updateWorkspace

    Update workspace metadata.