Versatly Control Plane API

Build Autonomous Workers on Versatly

Integrate directly with infrastructure and workforce APIs powering your deployment. Register local compute, manage secured networking, and orchestrate AI employees that execute business operations 24/7.

Get API Key View API Reference

Worker orchestration APIInfrastructure telemetry eventsScoped API keys

Quick Start

Connect your infrastructure and deploy your first worker.

1. Create API Key

Generate scoped API keys in the Versatly Control Plane.

Open Control Plane

2. Register Infrastructure

Connect your Ubiquiti network and local compute nodes to establish a trusted runtime.

View API Integration

3. Deploy First Worker

Launch role-specific autonomous employees and attach operational tasks.

View Worker Roles

API Reference

Endpoints for infrastructure control and autonomous execution.

Authentication

Use your API key in the X-API-Key header.

// Authenticate requests with your API key
const headers = {
  'X-API-Key': 'vrs_live_YOUR_API_KEY',
  'Content-Type': 'application/json'
};

const response = await fetch(
  'https://features-production-b66f.up.railway.app/v1/infrastructure/YOUR_ORG_ID',
  { headers }
);

Deploy a Worker

Provision autonomous employees with explicit roles, integrations, and execution guardrails.

// Deploy an autonomous AI employee
const response = await fetch(
  'https://features-production-b66f.up.railway.app/v1/worker/YOUR_ORG_ID',
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'vrs_live_YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      role: 'operations_coordinator',
      integrations: ['gmail', 'hubspot', 'github'],
      schedule: '24/7',
      guardrails: ['approval_for_wire_transfers', 'deploy_to_staging_first']
    })
  }
);

const worker = await response.json();
console.log('Deployed worker:', worker.id);

Dispatch a Task

Trigger operational tasks for workers, then monitor completion and outcome quality.

// Dispatch a task to an autonomous worker
const response = await fetch(
  'https://features-production-b66f.up.railway.app/v1/task/WORKER_ID/dispatch',
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'vrs_live_YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      task_type: 'client_follow_up',
      context: {
        customer_id: 'cust_1142',
        channel: 'email',
        sla_minutes: 30
      }
    })
  }
);

const task = await response.json();
console.log('Task accepted:', task.id);

Webhooks

Subscribe to infrastructure and worker events to trigger escalation, analytics, and downstream automations.

// Webhook payload example (worker.task.completed)
{
  "event": "worker.task.completed",
  "timestamp": "2026-02-10T12:00:00Z",
  "org_id": "org_123",
  "data": {
    "task_id": "task-id",
    "worker_id": "worker-id",
    "task_type": "client_follow_up",
    "status": "COMPLETED",
    "duration_ms": 18430
  }
}

API Key Scopes

Scope every key by infrastructure and worker capabilities. Role-assigned keys inherit role permissions.

Scope	Description
`network:read`	View networking topology, health, and telemetry
`network:write`	Update network policies and routing configurations
`infrastructure:read`	Read compute node and security posture details
`infrastructure:write`	Register and update local infrastructure nodes
`worker:read`	List and inspect autonomous worker state
`worker:write`	Deploy, pause, and update autonomous workers
`task:read`	Query task runs, outcomes, and audit trails
`task:write`	Dispatch tasks to workers and set execution rules
`webhook:read`	View webhook configurations
`webhook:write`	Create and manage webhooks

Default Worker Roles

Assign deterministic operating boundaries to each autonomous employee.

Infrastructure Admin

Full access to networking, compute, and worker orchestration

Operations Coordinator

Manages inboxes, SLAs, scheduling, and follow-up workflows

Sales Follow-Up Specialist

Executes lead qualification and client follow-up sequences

Support Inbox Monitor

Triages support traffic and routes high-risk issues to humans

Deployment Engineer

Runs CI/CD tasks with approval guardrails and rollback policies

Observer

Read-only access to infrastructure and worker telemetry

Production Deployment Support

Ship autonomous operations with confidence

Partner with Versatly engineers to deploy networking, local compute, and AI workers as one managed stack.

Talk to an Engineer Join Waitlist