ShydaSHYDAPLATFORM
API Reference — Vega Runtime

Vega Runtime API

Authoritative reference for the Vega Runtime control-plane and data-plane endpoints, including agent lifecycle, capability orchestration, and telemetry.

Overview

The Vega Runtime exposes a JSON-over-HTTP control plane for managing agents, dispatching capability invocations, and streaming execution events. All endpoints are versioned and authenticated via bearer tokens.

Base URL: https://runtime.shyda.dev/v1. All requests require anAuthorization: Bearer <token> header.

Agents

Create, inspect, and terminate embodied agent sessions.

bash
# List active agents
curl -H "Authorization: Bearer $TOKEN" \
  https://runtime.shyda.dev/v1/agents


# Create a new agent session
curl -X POST -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"profile":"default","robot_id":"r-01"}' \
  https://runtime.shyda.dev/v1/agents

Capability Invocations

Dispatch a capability call to a running agent and read back structured results.

bash
curl -X POST -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"capability":"pick_and_place","input":{"target":"cup-1"}}' \
  https://runtime.shyda.dev/v1/agents/{agent_id}/invoke