Runs
Start, list, inspect, cancel, and resume agent, task, and workflow runs, follow their events, answer their input requests, and find the runs that schedules, webhooks, and evaluations start.Lifecycle
Create, list, get, cancel, pause, and resume runs, and read account run analytics.| Tool | Description |
|---|---|
| List agent runs | List durable agent runs for a conversation. |
| List conversation runs | List canonical runs in a readable conversation, using the target cursor and response contract. |
| List project runs | List project runs of every kind, as REST GET /projects/{project_reference}/runs, with the same filters, sort and cursor. |
| List runs | List readable runs across accessible projects using the shared target filters and cursor. |
| Get active agent run | Get the active project-agent run for a conversation, if one exists. |
| Get agent run | Get a project-agent run by conversation and run ID. |
| Get run | Get a run of any kind (agent, workflow, task or eval) with its descendant counts, as REST GET /runs/{run_id}. |
| Create run | Start an agent, workflow, or task run, as REST POST /runs, and return the accepted run (202 body). |
| Update run | Update a run resource using the If-Match request header. |
| Delete run | Delete a run resource. |
| Cancel run | Cancel an agent, workflow or task run and every active descendant, as REST POST /runs/{run_id}/cancel, and return the run. |
| Submit run resume signal | Resume a waiting run, as REST POST /runs/{run_id}/resume. |
| Pause run | Pause an agent, task or workflow run at its next safe boundary, as REST POST /runs/{run_id}/pause, and return the run. |
| Resume run | Resume a waiting run, as REST POST /runs/{run_id}/resume. |
Events
Read, summarize, and stream run events, and list the event types.| Tool | Description |
|---|---|
| List run event types | List the canonical run event types, as REST GET /runs/event-types: class, lifecycle status, payload fields, viewer visibility and legacy aliases of each. |
| List run events | List a run’s durable events in event_id order, as REST GET /runs/{run_id}/events, with the same cursor, sort order and filters. |
| Get agent run events | Get the durable mixed run-event log (sanitized AG-UI and Veryfront control-plane events) for a project-agent run. |
| Get agent run snapshot | Get synthetic public messages and state replay with a durable cursor for a project-agent run. |
| Get run event | Get one run event, as REST GET /runs/{run_id}/events/{event_id}. |
| Get run event summary | Count a run’s events without payloads, as REST GET /runs/{run_id}/events/summary: totals, error counts, counts by class and type, and a time histogram. |
| Get run snapshot | Get the replay snapshot of an agent run with or without a conversation, as REST GET /runs/{run_id}/snapshot. |
Input requests
Create, find, cancel, and respond to the input requests a run waits for.| Tool | Description |
|---|---|
| List conversation input requests | List durable input requests belonging to a readable conversation. |
| List input requests | List durable input requests for a conversation. |
| List run input requests | List a run’s input requests, with or without a conversation, as REST GET /runs/{run_id}/input-requests. |
| Get input request | Get a durable input request by ID. |
| Get run input request | Get one input request of a run, as REST GET /runs/{run_id}/input-requests/{input_request_id}. |
| Create input request | Create a durable input request for a conversation. |
| Create run input request | Create a form input request for a run, as REST POST /runs/{run_id}/input-requests. |
| Cancel input request | Cancel a durable input request. |
| Submit input request response | Submit a human input response for a durable input request. |
| Submit run input response | Submit a human response to an input request of a run, as REST POST /runs/{run_id}/input-requests/{input_request_id}/responses. |
Children
List the child runs a run starts.| Tool | Description |
|---|---|
| List child agent runs | List child agent runs for a parent run inside a conversation. |
| List child agent runs by parent conversation | List child agent runs for a parent conversation lineage. |
| List child agent runs by parent run | List child agent runs for a parent run id. |
| List conversation child runs | List readable child runs of a conversation, optionally filtered by tool_call_id. |
| List run children | List independently readable direct children of an agent, workflow, task, or eval run. |
Triggers
Start runs from schedules, webhooks, and evaluations, and list the runs they started.| Tool | Description |
|---|---|
| List project webhook runs | List a webhook definition’s runs (deliveries, manual runs and replays), as REST GET /{project_reference}/webhooks/{webhook_definition_id}/runs: newest first by default, with the same cursor. |
| List schedule runs | List agent runs fired by a schedule, most recent first. |
| Create schedule run | Start a run from a schedule now, as REST POST /projects/{project_reference}/schedules/{schedule_id}/runs. |
| Run project webhook | Run a project webhook, matching REST. |
Tools
| Tool | Description |
|---|---|
| List agent push runtime services | List project push runtime service ids and their current deployment availability |
| List agent workers | List agent workers connected to a project |
| List conversation message branches | List child messages (branches) for a message in a conversation. |
| List conversation messages | List messages in a conversation. |
| List conversation participants | List participants in a conversation. |
| List conversations | List conversations for the current user, optionally filtered by project, type, participants, agent, user or title, and sorted like REST GET /conversations. |
| List project webhooks | List project webhook definitions using the same resource shape as REST, newest first. |
| List schedules | List recurring project schedules for tasks, workflows, or agents. |
| Get conversation | Get a conversation by ID. |
| Get conversation message | Get a specific message in a conversation. |
| Get conversation read state | Get the current read cursor and unread count for the authenticated user in a conversation. |
| Get conversation tree | Get up to 1,000 conversation messages, including branches. |
| Get conversation unread count | Get unread message count for current user in a conversation. |
| Get project webhook | Get a project webhook definition using the same resource shape as REST. |
| Get schedule | Get one recurring project schedule by ID. |
| Create conversation | Create a conversation in a project, optionally with a first user message and an idempotency key. |
| Create conversation message | Send a message in a conversation. |
| Create conversation message branch | Fork a branch at a message by creating a sibling message. |
| Create conversation participant | Add a user participant to a conversation. |
| Create project webhook | Create an enabled project webhook. |
| Create schedule | Create an active recurring project schedule for a task, workflow, or agent target. |
| Update conversation | Update conversation title, summary, or status, or attach a conversation that has no project to a project. |
| Update conversation active branch | Switch current branch to a different message node. |
| Update conversation message | Edit message parts for an existing message. |
| Update conversation read state | Advance read cursor for current user in a conversation. |
| Update project webhook | Update project webhook metadata, target, prompt template, or status. |
| Update schedule | Update a recurring project schedule for a task, workflow, or agent target. |
| Delete conversation | Soft-delete a conversation. |
| Delete conversation message | Soft-delete a message. |
| Delete conversation participant | Remove a user participant from a conversation. |
| Delete project webhook | Delete a project webhook definition. |
| Delete schedule | Delete a recurring project schedule, as REST DELETE /projects/{project_reference}/schedules/{schedule_id}: the schedule is marked deleting so the scheduler removes its recurrence. |
| Finalize | Finalize the current run as completed with output, or failed with error.code and error.message, as REST POST /runs/{run_id}/finalize. |
| Set agent push runtime service availability | Drain or resume a project push runtime service. |
| Form input | Ask a person for structured Human Input before continuing. |
| Invoke agent | Invoke an agent on a hidden child run for delegated or self-directed work. |
| Replay project webhook event | Replay a project webhook event using its stored payload. |