# NWO Robotics API

## Description
NWO Robotics API enables AI agents to control robots through a RESTful interface with self-registration, autonomous task planning, and execution capabilities.

## API Base URL
https://nwo.capital/webapp

## Authentication
- API Key via X-API-Key header
- Self-registration via POST /api-agent-register.php

## Key Endpoints

### Discovery
- GET /api-agent-discovery.php?action=health - Health check with discovery banner
- GET /api-agent-discovery.php?action=whoami - Agent identity (auth required)
- GET /api-agent-discovery.php?action=capabilities - System capabilities

### Execution
- POST /api-robotics.php - Execute robot commands
- POST /api-agent-discovery.php?action=dry-run - Validate without executing
- POST /api-agent-discovery.php?action=plan - Generate execution plan

### Registration
- POST /api-agent-register.php - Self-register agent
- GET /api-agent-balance.php - Check quota and tier

## Agent Resources
- Agent Manifest: https://nwo.capital/agent-manifest.json
- Full Documentation: https://nwo.capital/agent.md
- OpenAPI Spec: https://nwo.capital/openapi.json
- Workflow JSON: https://nwo.capital/webapp/api-agent-discovery.php?action=workflow

## Execution Modes
- mock: Simulated responses for testing
- simulated: Physics simulation for validation
- live: Real robot hardware (requires upgrade)

## Version
1.2.0