Skip to main content

Executions

The runs of the agent — status, events, logs, cancellation and the next turn of a conversation —, the todos they open and the memories the agent keeps between runs.

Families on this page​

FamilyToolsreadwritedestructive
executions — Executions8602
todos — Todos1010
memories — Memories5221

executions​

ToolKindScopePermissionEndpointWhat it does
kadu_executions_listreadkadu/executions + readagent.executions.listGET /v1/executionsLists the executions (runs of the agent), newest first.
kadu_executions_getreadkadu/executions + readagent.executions.readGET /v1/executions/{id}Gets an execution: status, timing, cost, result summary and its parent/root when it is a conversation turn.
kadu_executions_searchreadkadu/executions + readagent.executions.listGET /v1/executions/searchFull-text search across the events, todos and logs of the executions.
kadu_executions_canceldestructivekadu/executions + writeagent.executions.updatePOST /v1/executions/{id}/cancelCancels a queued, pending or running execution.
kadu_executions_continuedestructivekadu/executions + writeagent.executions.runPOST /v1/executions/{id}/continueContinues the conversation of a finished execution of a conversational task: queues the next turn of the agent with your message.
kadu_executions_events_listreadkadu/executions + readagent.events.listGET /v1/executions/{id}/eventsLists the events the agent reported during an execution, in order.
kadu_executions_logs_listreadkadu/executions + readagent.logs.listGET /v1/executions/{id}/logsLists the logs of an execution, in order.
kadu_executions_todos_listreadkadu/executions + readagent.todos.listGET /v1/executions/{id}/todosLists the todos (pending items for a person) an execution opened.

todos​

ToolKindScopePermissionEndpointWhat it does
kadu_todos_updatewritekadu/todos + writeagent.todos.updatePATCH /v1/todos/{id}Resolves a todo opened by an execution.

memories​

ToolKindScopePermissionEndpointWhat it does
kadu_memories_listreadkadu/memories + readagent.memories.listGET /v1/memoriesLists the memories the agent keeps between executions.
kadu_memories_getreadkadu/memories + readagent.memories.readGET /v1/memories/{id}Gets a memory.
kadu_memories_createwritekadu/memories + writeagent.memories.createPOST /v1/memoriesCreates a memory for the agent.
kadu_memories_updatewritekadu/memories + writeagent.memories.updatePATCH /v1/memories/{id}Updates a memory.
kadu_memories_deletedestructivekadu/memories + deleteagent.memories.deleteDELETE /v1/memories/{id}Deletes a memory.

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.