Agents

The Scrums.com API is planned and not yet publicly available. Endpoints and behaviour are subject to change before release.

Agents are AI-powered execution units configured within a workspace. Each agent is scoped, policy-governed, and connected to platform resources and integrations. Agents can be triggered manually, on schedule, or in response to platform events. They produce Artifacts and emit Events.

Base path

/v1/workspaces/{workspace_id}/agents

Endpoints

Method	Path	Description
`GET`	`/v1/workspaces/{workspace_id}/agents`	List agents in a workspace
`POST`	`/v1/workspaces/{workspace_id}/agents`	Create an agent
`GET`	`/v1/agents/{id}`	Get an agent
`PATCH`	`/v1/agents/{id}`	Update an agent
`DELETE`	`/v1/agents/{id}`	Delete an agent
`POST`	`/v1/agents/{id}/run`	Trigger an agent run
`POST`	`/v1/agents/{id}/stop`	Stop a running agent
`GET`	`/v1/agents/{id}/runs`	List agent run history

Attributes

Field	Type	Description
`id`	string	Unique identifier
`workspace_id`	string	Parent workspace reference
`name`	string	Agent name
`type`	string	Agent type or capability class
`status`	enum	`idle`, `running`, `error`, `disabled`
`policy_id`	string	Governing policy reference
`config`	object	Agent-specific configuration
`last_run_at`	datetime	Timestamp of last execution
`created_at`	datetime	ISO 8601 timestamp
`updated_at`	datetime	ISO 8601 timestamp

Relationships

Agents belong to Workspaces, are governed by Policies, and are routed through the Agent Gateway. They produce Artifacts and emit Events.

Last modified on April 15, 2026

Accounts API Keys

Overview

Organizations

Workspaces

Service Lines

Core Platform

Observability & Metrics

ODS

Talent Marketplace

AI Agent Gateway

Product Lines

CLI

Base path

Endpoints

Attributes

Relationships

​Base path

​Endpoints

​Attributes

​Relationships

Base path

Endpoints

Attributes

Relationships