Procedural Endpoints
Manage procedural workflows that agents learn and refine over time. Workflows represent step-by-step procedures, best practices, and operational runbooks that can be triggered programmatically.
Overview
Procedural memory stores learned workflows as structured step sequences. Agents can create workflows from successful task completions, and these workflows improve over time as they are triggered, evaluated, and refined.
| Method | Endpoint | Description |
|---|---|---|
POST | /v1/workflows | Create a new workflow |
GET | /v1/workflows | List workflows |
GET | /v1/workflows/:id | Get a specific workflow |
PUT | /v1/workflows/:id | Update a workflow |
DELETE | /v1/workflows/:id | Delete a workflow |
POST | /v1/workflows/:id/trigger | Trigger a workflow execution |
Create Workflow
List Workflows
Get Workflow
Update Workflow
Delete Workflow
Trigger Workflow
Execution tracking
Use the returned execution_id with the Execution endpoints to track progress, save checkpoints, and manage the workflow execution lifecycle.
Workflow Object
The following table describes the fields in a workflow object.
| Field | Type | Description |
|---|---|---|
id | string | Unique workflow identifier (prefixed with wf_) |
name | string | Human-readable workflow name |
description | string | Description of the workflow purpose |
version | integer | Current version number, incremented on step changes |
steps | array | Ordered list of workflow steps |
trigger_count | integer | Number of times the workflow has been triggered |
success_rate | number | null | Success rate (0-1) based on execution outcomes |
metadata | object | Arbitrary key-value metadata |
created_at | string | ISO 8601 creation timestamp |
updated_at | string | ISO 8601 last update timestamp |
