agents

Workflow/agent CRUD, publishing, version management, and direct run entrypoints.

Source path: libraries/agent/src/controllers/agent.controller.ts

Module file: agent.module.ts

Introduction

The Agents submodule is the main administrative surface of the Agent library. It manages workflow records themselves, draft/published lifecycle, version snapshots, and direct execution entrypoints.

The same controller handles both long-lived configuration changes and action endpoints such as publish, run, and create-version. In other words, “agent” here means both the definition stored in the database and the executable automation entity that can later be triggered by a human, a webhook, or another system event.

HTTP Endpoints

15 endpoints

List agents/workflows.

Query: page, pageSize, search, status, type

Create an agent/workflow.

Delete agents in bulk.

Body

Field	Type	Required	Notes
ids	number[]	yes	—

Get one agent.

Params: id (int)

Update an agent.

Params: id (int)

Delete one agent.

Params: id (int)

Publish the current draft/version.

Params: id (int)

Run an agent immediately.

Params: id (int)

Create a run through the run collection endpoint.

Params: id (int)

List runs for one agent.

Params: id (int)

List versions for one agent.

Params: id (int)

Create a new version.

Params: id (int)

Get one version.

Params: id (int), versionId (int)

Update one version.

Params: id (int), versionId (int)

Publish a specific version.

Params: id (int), versionId (int)

MCP Tools

Named tools callable by AI models via the Model Context Protocol (MCP).

agent.workflow.list
List workflow/agent records
agent.workflow.get_graph
Read the latest draft graph for an agent
agent.workflow.set_graph
Replace the graph of the latest draft version
agent.workflow.node_catalog
Return the available workflow node catalog
agent.workflow.integration_profiles
List integration profiles usable by workflow nodes