Agents API

Manage content agents, their automation assignments, and execution lifecycle.

Prefix: /api/agents

Endpoints

Agent CRUD

Method	Path	Description	Role
GET	/	List all agents for the current environment	Editor+
GET	/{id}	Get agent details	Editor+
POST	/	Create a new agent	Editor+
PUT	/{id}	Update agent configuration	Editor+
DELETE	/{id}	Delete an agent	Editor+

Assignments

Method	Path	Description	Role
POST	/{id}/assign-automation	Assign a search phrase or web source to an agent	Editor+
POST	/{id}/assign-planner	Assign an SEO campaign planner to an agent	Editor+
DELETE	/{id}/unassign	Remove all automation assignments from an agent	Editor+

Execution

Method	Path	Description	Role
POST	/{id}/run	Start agent execution (generates and publishes content)	Editor+
POST	/{id}/stop	Stop a running agent	Editor+
POST	/queue-all	Queue all eligible agents for execution	Editor+
POST	/stop-all	Stop all running agents	Editor+

Stats & Sync

Method	Path	Description	Role
GET	/stats	Get agent statistics (total, running, idle, errored)	Editor+
POST	/{id}/sync-avatar	Sync agent avatar from the publishing platform	Editor+