Structure and tasks

Workspaces, activities and tasks — the tree that organizes what the agent does —, running a task, the pre-check and the HTTP trigger endpoint.

Families on this page

Family	Tools	read	write	destructive
workspaces — Workspaces	5	2	2	1
activities — Activities	5	2	2	1
tasks — Tasks	10	4	2	4

workspaces

Tool	Kind	Scope	Permission	Endpoint	What it does
kadu_workspaces_list	read	kadu/workspaces + read	agent.workspaces.list	GET /v1/workspaces	Lists the workspaces of the organization (the top level of Workspace > Activity > Task).
kadu_workspaces_get	read	kadu/workspaces + read	agent.workspaces.read	GET /v1/workspaces/{id}	Gets a workspace.
kadu_workspaces_create	write	kadu/workspaces + write	agent.workspaces.create	POST /v1/workspaces	Creates a workspace.
kadu_workspaces_update	write	kadu/workspaces + write	agent.workspaces.update	PATCH /v1/workspaces/{id}	Updates a workspace.
kadu_workspaces_delete	destructive	kadu/workspaces + delete	agent.workspaces.delete	DELETE /v1/workspaces/{id}	Deletes a workspace together with its activities and tasks.

activities

Tool	Kind	Scope	Permission	Endpoint	What it does
kadu_activities_list	read	kadu/activities + read	agent.activities.list	GET /v1/activities	Lists the activities (groups of tasks inside a workspace).
kadu_activities_get	read	kadu/activities + read	agent.activities.read	GET /v1/activities/{id}	Gets an activity.
kadu_activities_create	write	kadu/activities + write	agent.activities.create	POST /v1/activities	Creates an activity inside a workspace.
kadu_activities_update	write	kadu/activities + write	agent.activities.update	PATCH /v1/activities/{id}	Updates an activity.
kadu_activities_delete	destructive	kadu/activities + delete	agent.activities.delete	DELETE /v1/activities/{id}	Deletes an activity together with its tasks.

tasks

Tool	Kind	Scope	Permission	Endpoint	What it does
kadu_tasks_list	read	kadu/tasks + read	agent.tasks.list	GET /v1/tasks	Lists the tasks: each one runs a skill (<plugin>:<skill>) of the organization repository as the agent.
kadu_tasks_get	read	kadu/tasks + read	agent.tasks.read	GET /v1/tasks/{id}	Gets a task, with its parameters schema and whether it is conversational.
kadu_tasks_create	write	kadu/tasks + write	agent.tasks.create	POST /v1/tasks	Creates a task that runs a skill of the organization repository.
kadu_tasks_update	write	kadu/tasks + write	agent.tasks.update	PATCH /v1/tasks/{id}	Updates a task.
kadu_tasks_delete	destructive	kadu/tasks + delete	agent.tasks.delete	DELETE /v1/tasks/{id}	Deletes a task.
kadu_tasks_run	destructive	kadu/tasks + write	agent.executions.run	POST /v1/tasks/{id}/run	Runs a task: queues an execution of the financial agent in an environment.
kadu_tasks_readiness_get	read	kadu/tasks + read	agent.tasks.read	GET /v1/tasks/{id}/readiness	Pre-check of a run: whether the task can be run now in the environment (plan, cost limit, missing secrets, repository).
kadu_tasks_endpoint_get	read	kadu/tasks + read	agent.tasks.read	GET /v1/tasks/{id}/endpoint	Gets the task's HTTP trigger endpoint: URL, whether it is enabled and the auth type (credentials are never returned).
kadu_tasks_endpoint_update	destructive	kadu/tasks + write	agent.tasks.update	PUT /v1/tasks/{id}/endpoint	Configures the HTTP endpoint that lets a third party trigger the task, with its credentials.
kadu_tasks_endpoint_delete	destructive	kadu/tasks + delete	agent.tasks.update	DELETE /v1/tasks/{id}/endpoint	Disables the task's HTTP trigger endpoint (the configuration is kept).

---

The fields of each resource are in the API reference.

A tool you cannot run is not listed by tools/list at all. If one from this page is missing, see Authentication.