# Vertesia Agent Runs API

**Canonical:** https://apis.io/apis/vertesiahq/vertesiahq-agent-runs-api/  
**Provider:** Vertesia — https://apis.io/providers/vertesiahq/  
**Base URL:** https://api.us1.vertesia.io/api/v1  
**Documentation:** https://vertesiahq.com/docs

Vertesia Agent Runs API is one of 48 APIs that [Vertesia](https://apis.io/providers/vertesiahq/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Agent Runs. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Agent runs are long-running conversational workflow executions with stable IDs, message streams, artifacts, child workflow inspection, lifecycle controls, and searchable metadata.

## Operations (28)

| Method | Path | Summary |
|---|---|---|
| POST | `/agents` | Create an agent run |
| GET | `/agents` | List agent runs |
| GET | `/agents/search` | Search agent runs |
| GET | `/agents/{agentRunId}` | Retrieve an agent run |
| DELETE | `/agents/{agentRunId}` | Terminate an agent run |
| POST | `/agents/{agentRunId}/restart` | Restart an agent run |
| POST | `/agents/{agentRunId}/fork` | Fork an agent run |
| POST | `/agents/{agentRunId}/signal/{signalName}` | Signal an agent run |
| POST | `/agents/{agentRunId}/budget` | Add token budget to a paused run |
| GET | `/agents/{agentRunId}/query/{queryName}` | Query an agent run |
| GET | `/agents/{agentRunId}/updates` | List agent run updates |
| POST | `/agents/{agentRunId}/updates` | Post an agent run update |
| GET | `/agents/{agentRunId}/stream` | Stream an agent run |
| GET | `/agents/{agentRunId}/artifacts` | List agent run artifacts |
| GET | `/agents/{agentRunId}/artifact-content/{path}` | Read editable agent artifact content |
| PUT | `/agents/{agentRunId}/artifact-content/{path}` | Update editable agent artifact content |
| GET | `/agents/{agentRunId}/artifacts/{path}` | Get an agent run artifact |
| PUT | `/agents/{agentRunId}/artifacts/{path}` | Create an artifact upload URL |
| GET | `/agents/{agentRunId}/details` | Get agent run details |
| GET | `/agents/{agentRunId}/children` | List child agent runs |
| GET | `/agents/{agentRunId}/context` | Get process run context |
| GET | `/agents/{agentRunId}/history` | Get process run history |
| POST | `/agents/{agentRunId}/advance` | Advance a process run |
| POST | `/agents/{agentRunId}/retry-node` | Retry a process node |
| POST | `/agents/{agentRunId}/answer-task` | Answer a process task |
| GET | `/agents/{agentRunId}/children/{childWorkflowId}/details` | Get child agent run details |
| GET | `/agents/{agentRunId}/details/stream` | Stream agent run details |
| POST | `/agents/{agentRunId}/feedback` | Rate an agent run |

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/vertesiahq/refs/heads/main/openapi/vertesiahq-agent-runs-api-openapi.yml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vertesiahq/refs/heads/main/json-schema/vertesiahq-agent-run-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vertesiahq/refs/heads/main/json-schema/vertesiahq-update-app-payload-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vertesiahq/refs/heads/main/json-schema/vertesiahq-app-manifest-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vertesiahq/refs/heads/main/json-schema/vertesiahq-app-manifest-data-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vertesiahq/refs/heads/main/json-schema/vertesiahq-indexing-status-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vertesiahq/refs/heads/main/json-schema/vertesiahq-dashboard-schema.json

## Other Vertesia APIs (12)

- [Vertesia Access Control Entries API](https://apis.io/apis/vertesiahq/vertesiahq-access-control-entries-api/)
- [Vertesia Account API](https://apis.io/apis/vertesiahq/vertesiahq-account-api/)
- [Vertesia Accounts API](https://apis.io/apis/vertesiahq/vertesiahq-accounts-api/)
- [Vertesia API Keys API](https://apis.io/apis/vertesiahq/vertesiahq-api-keys-api/)
- [Vertesia Apps API](https://apis.io/apis/vertesiahq/vertesiahq-apps-api/)
- [Vertesia Audit Trail API](https://apis.io/apis/vertesiahq/vertesiahq-audit-trail-api/)
- [Vertesia Bulk Operations API](https://apis.io/apis/vertesiahq/vertesiahq-bulk-operations-api/)
- [Vertesia Collections API](https://apis.io/apis/vertesiahq/vertesiahq-collections-api/)
- [Vertesia Commands API](https://apis.io/apis/vertesiahq/vertesiahq-commands-api/)
- [Vertesia Content Object Types API](https://apis.io/apis/vertesiahq/vertesiahq-content-object-types-api/)
- [Vertesia Content Query API](https://apis.io/apis/vertesiahq/vertesiahq-content-query-api/)
- [Vertesia Costs API](https://apis.io/apis/vertesiahq/vertesiahq-costs-api/)

## Tags

Agent Runs

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/vertesiahq/vertesiahq-agent-runs-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/vertesiahq/.