> ## Documentation Index
> Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Execution API

> Start and monitor agent, task, and workflow runs.

For API groups, see [Execution API](/docs/cloud/apis/execution).

## 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](/docs/cloud/mcp/tools/list-agent-runs) | List durable agent runs for a conversation. |
| [List conversation runs](/docs/cloud/mcp/tools/list-conversation-runs) | List canonical runs in a readable conversation, using the target cursor and response contract. |
| [List project runs](/docs/cloud/mcp/tools/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](/docs/cloud/mcp/tools/list-runs) | List readable runs across accessible projects using the shared target filters and cursor. |
| [Get active agent run](/docs/cloud/mcp/tools/get-active-agent-run) | Get the active project-agent run for a conversation, if one exists. |
| [Get agent run](/docs/cloud/mcp/tools/get-agent-run) | Get a project-agent run by conversation and run ID. |
| [Get run](/docs/cloud/mcp/tools/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](/docs/cloud/mcp/tools/create-run) | Start an agent, workflow, or task run, as REST POST /runs, and return the accepted run (202 body). |
| [Update run](/docs/cloud/mcp/tools/update-run) | Update a run resource using the If-Match request header. |
| [Delete run](/docs/cloud/mcp/tools/delete-run) | Delete a run resource. |
| [Cancel run](/docs/cloud/mcp/tools/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](/docs/cloud/mcp/tools/submit-run-resume-signal) | Resume a waiting run, as REST POST /runs/\{run\_id}/resume. |
| [Pause run](/docs/cloud/mcp/tools/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](/docs/cloud/mcp/tools/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](/docs/cloud/mcp/tools/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](/docs/cloud/mcp/tools/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](/docs/cloud/mcp/tools/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](/docs/cloud/mcp/tools/get-agent-run-snapshot) | Get synthetic public messages and state replay with a durable cursor for a project-agent run. |
| [Get run event](/docs/cloud/mcp/tools/get-run-event) | Get one run event, as REST GET /runs/\{run\_id}/events/\{event\_id}. |
| [Get run event summary](/docs/cloud/mcp/tools/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](/docs/cloud/mcp/tools/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](/docs/cloud/mcp/tools/list-conversation-input-requests) | List durable input requests belonging to a readable conversation. |
| [List input requests](/docs/cloud/mcp/tools/list-input-requests) | List durable input requests for a conversation. |
| [List run input requests](/docs/cloud/mcp/tools/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](/docs/cloud/mcp/tools/get-input-request) | Get a durable input request by ID. |
| [Get run input request](/docs/cloud/mcp/tools/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](/docs/cloud/mcp/tools/create-input-request) | Create a durable input request for a conversation. |
| [Create run input request](/docs/cloud/mcp/tools/create-run-input-request) | Create a form input request for a run, as REST POST /runs/\{run\_id}/input-requests. |
| [Cancel input request](/docs/cloud/mcp/tools/cancel-input-request) | Cancel a durable input request. |
| [Submit input request response](/docs/cloud/mcp/tools/submit-input-request-response) | Submit a human input response for a durable input request. |
| [Submit run input response](/docs/cloud/mcp/tools/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](/docs/cloud/mcp/tools/list-child-agent-runs) | List child agent runs for a parent run inside a conversation. |
| [List child agent runs by parent conversation](/docs/cloud/mcp/tools/list-child-agent-runs-by-parent-conversation) | List child agent runs for a parent conversation lineage. |
| [List child agent runs by parent run](/docs/cloud/mcp/tools/list-child-agent-runs-by-parent-run) | List child agent runs for a parent run id. |
| [List conversation child runs](/docs/cloud/mcp/tools/list-conversation-child-runs) | List readable child runs of a conversation, optionally filtered by tool\_call\_id. |
| [List run children](/docs/cloud/mcp/tools/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](/docs/cloud/mcp/tools/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](/docs/cloud/mcp/tools/list-schedule-runs) | List agent runs fired by a schedule, most recent first. |
| [Create schedule run](/docs/cloud/mcp/tools/create-schedule-run) | Start a run from a schedule now, as REST POST /projects/\{project\_reference}/schedules/\{schedule\_id}/runs. |
| [Run project webhook](/docs/cloud/mcp/tools/run-project-webhook) | Run a project webhook, matching REST. |

## Tools

| Tool | Description |
| - | - |
| [List agent push runtime services](/docs/cloud/mcp/tools/list-agent-push-runtime-services) | List project push runtime service ids and their current deployment availability |
| [List agent workers](/docs/cloud/mcp/tools/list-agent-workers) | List agent workers connected to a project |
| [List conversation message branches](/docs/cloud/mcp/tools/list-conversation-message-branches) | List child messages (branches) for a message in a conversation. |
| [List conversation messages](/docs/cloud/mcp/tools/list-conversation-messages) | List messages in a conversation. |
| [List conversation participants](/docs/cloud/mcp/tools/list-conversation-participants) | List participants in a conversation. |
| [List conversations](/docs/cloud/mcp/tools/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](/docs/cloud/mcp/tools/list-project-webhooks) | List project webhook definitions using the same resource shape as REST, newest first. |
| [List schedules](/docs/cloud/mcp/tools/list-schedules) | List recurring project schedules for tasks, workflows, or agents. |
| [Get conversation](/docs/cloud/mcp/tools/get-conversation) | Get a conversation by ID. |
| [Get conversation message](/docs/cloud/mcp/tools/get-conversation-message) | Get a specific message in a conversation. |
| [Get conversation read state](/docs/cloud/mcp/tools/get-conversation-read-state) | Get the current read cursor and unread count for the authenticated user in a conversation. |
| [Get conversation tree](/docs/cloud/mcp/tools/get-conversation-tree) | Get up to 1,000 conversation messages, including branches. |
| [Get conversation unread count](/docs/cloud/mcp/tools/get-conversation-unread-count) | Get unread message count for current user in a conversation. |
| [Get project webhook](/docs/cloud/mcp/tools/get-project-webhook) | Get a project webhook definition using the same resource shape as REST. |
| [Get schedule](/docs/cloud/mcp/tools/get-schedule) | Get one recurring project schedule by ID. |
| [Create conversation](/docs/cloud/mcp/tools/create-conversation) | Create a conversation in a project, optionally with a first user message and an idempotency key. |
| [Create conversation message](/docs/cloud/mcp/tools/create-conversation-message) | Send a message in a conversation. |
| [Create conversation message branch](/docs/cloud/mcp/tools/create-conversation-message-branch) | Fork a branch at a message by creating a sibling message. |
| [Create conversation participant](/docs/cloud/mcp/tools/create-conversation-participant) | Add a user participant to a conversation. |
| [Create project webhook](/docs/cloud/mcp/tools/create-project-webhook) | Create an enabled project webhook. |
| [Create schedule](/docs/cloud/mcp/tools/create-schedule) | Create an active recurring project schedule for a task, workflow, or agent target. |
| [Update conversation](/docs/cloud/mcp/tools/update-conversation) | Update conversation title, summary, or status, or attach a conversation that has no project to a project. |
| [Update conversation active branch](/docs/cloud/mcp/tools/update-conversation-active-branch) | Switch current branch to a different message node. |
| [Update conversation message](/docs/cloud/mcp/tools/update-conversation-message) | Edit message parts for an existing message. |
| [Update conversation read state](/docs/cloud/mcp/tools/update-conversation-read-state) | Advance read cursor for current user in a conversation. |
| [Update project webhook](/docs/cloud/mcp/tools/update-project-webhook) | Update project webhook metadata, target, prompt template, or status. |
| [Update schedule](/docs/cloud/mcp/tools/update-schedule) | Update a recurring project schedule for a task, workflow, or agent target. |
| [Delete conversation](/docs/cloud/mcp/tools/delete-conversation) | Soft-delete a conversation. |
| [Delete conversation message](/docs/cloud/mcp/tools/delete-conversation-message) | Soft-delete a message. |
| [Delete conversation participant](/docs/cloud/mcp/tools/delete-conversation-participant) | Remove a user participant from a conversation. |
| [Delete project webhook](/docs/cloud/mcp/tools/delete-project-webhook) | Delete a project webhook definition. |
| [Delete schedule](/docs/cloud/mcp/tools/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](/docs/cloud/mcp/tools/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](/docs/cloud/mcp/tools/set-agent-push-runtime-service-availability) | Drain or resume a project push runtime service. |
| [Form input](/docs/cloud/mcp/tools/form-input) | Ask a person for structured Human Input before continuing. |
| [Invoke agent](/docs/cloud/mcp/tools/invoke-agent) | Invoke an agent on a hidden child run for delegated or self-directed work. |
| [Replay project webhook event](/docs/cloud/mcp/tools/replay-project-webhook-event) | Replay a project webhook event using its stored payload. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.