Robot Control API

Command your robots through conversation, no controller needed

Operators check battery levels, send movement instructions, and assign tasks to robots by simply chatting with your AI agent. The agent translates natural language into precise API commands and returns real-time status. Robotics management becomes as simple as sending a message.

Chosen by 800+ global brands across industries

Robotic operations through natural language

Your AI agent bridges the gap between human operators and robotic systems, translating conversational requests into precise movement commands, task assignments, and status checks.

Check Robot Status

An operator asks 'How is the robot doing?' Your AI agent calls the status endpoint and returns battery level, internal temperature, and current state, whether idle, moving, working, charging, or in error. Real-time diagnostics without opening a control panel.

Send Movement Commands

Operator says 'Move the robot forward 3 meters.' The agent translates this into a structured move command with direction and distance parameters, sends it to the API, and confirms execution. Precise spatial control through plain conversation.

Assign Specific Tasks

A warehouse manager messages 'Start the cleaning cycle.' Your agent sends the task name to the perform-task endpoint and confirms the robot has accepted the assignment. Complex task dispatch reduced to a single chat message.

Initiate Safe Shutdown

End of shift arrives and an operator types 'Shut down the robot.' The agent calls the shutdown endpoint, confirms the command was accepted, and reports the robot is powering down. Controlled deactivation without physical access to the unit.

Monitor Battery Levels

Before assigning a task, the operator asks about remaining charge. The agent fetches current battery percentage from the status endpoint and advises whether the robot can complete the job or needs charging first. Proactive resource management.

Detect Error States

The agent periodically or on-demand checks robot status and flags when the state is 'error.' It reports the issue alongside battery and temperature readings so maintenance teams can diagnose problems remotely through the chat interface.

Robot Control API

Use Cases

Conversational robot management

From warehouse floors to manufacturing lines, see how AI-powered chat interfaces simplify robotic operations for teams without technical backgrounds.

Warehouse Floor Checks via Chat

A shift supervisor opens the chat and asks 'What is the robot's battery level and status?' Your AI Agent queries the status endpoint, retrieves 72% battery with idle state at normal temperature, and reports back. The supervisor decides to assign one more task before the charging cycle. No dashboard logins, no walking to the robot. Operational decisions made from a phone screen.

Remote Task Assignment for Cleaning Crews

The facilities manager sends a message saying 'Have the robot clean section B.' Your AI Agent issues the perform-task command with 'clean section B' as the task parameter and confirms acceptance. When the robot finishes, a follow-up status check shows idle state again. The manager coordinated robotic cleaning from their desk without touching a controller or opening specialized software.

End-of-Day Automated Shutdown Routine

At closing time, an operator messages 'Check status, then shut down if battery is above 20%.' Your AI Agent first queries battery level, confirms it is at 45%, then sends the shutdown command. The robot powers down safely. If battery had been critically low, the agent would have recommended charging instead. Conditional logic handled through conversation, not programming.

Try
Robot Control API

Robot Control API

FAQs

Frequently Asked Questions

What robot status information does the agent retrieve?

The status endpoint returns three data points: battery level as a percentage, internal temperature in degrees, and current operational state. The state can be idle, moving, working, charging, or error. Your agent formats this into a readable summary so operators know exactly what the robot is doing at any moment.

Can the agent send movement commands with specific distances?

Yes. The move endpoint accepts a direction (forward, backward, left, right) and a distance in meters as a float value. When an operator says 'Move forward 2.5 meters,' the agent translates that into the structured API request with direction: forward and distance: 2.5, then confirms execution.

What types of tasks can the agent assign to the robot?

The perform-task endpoint accepts any task name as a string parameter. Common examples include 'clean,' 'patrol,' or 'transport.' The available tasks depend on your robot's firmware and programming. The agent sends whatever task the operator describes, and the robot executes it if the command is recognized.

Is there a safety mechanism before shutdown commands?

You can configure your Tars agent to require confirmation before executing shutdown. For example, the agent can first check the robot's status and warn if a task is in progress. You can also restrict shutdown commands to specific authorized users through your agent's gambit permissions.

What happens if the robot is in an error state when a task is assigned?

The agent can be configured to check status before sending any command. If the state shows 'error,' the agent alerts the operator with the current temperature and battery data, recommends maintenance intervention, and holds the task until the error is resolved. No commands sent to a malfunctioning unit.

Can multiple operators control the same robot through the agent?

Yes, the API accepts commands from any authorized source. However, you should configure your agent to enforce queue-based or priority-based command handling to prevent conflicting instructions. Tars gambit logic can manage operator roles and command sequencing.

Does the agent support scheduling commands for later execution?

The Robot Control API processes commands immediately upon receipt. For scheduled operations, configure your Tars agent with time-based triggers that send commands at specified intervals. The agent can queue a shutdown at 6 PM or initiate a patrol every hour using its workflow automation.

How is this different from using the robot's native control panel?

Native control panels require physical access or specialized software. The Tars integration lets any team member issue commands through familiar messaging interfaces like WhatsApp or a web chat. The agent adds conversational intelligence, confirming commands, checking preconditions, and providing status context that raw API calls do not.

How to add Tools to your AI Agent

Supercharge your AI Agent with Tool Integrations

Don't limit your AI Agent to basic conversations. Watch how to configure and add powerful tools making your agent smarter and more functional.

Privacy & Security

We’ll never let you lose sleep over privacy and security concerns

At Tars, we take privacy and security very seriously. We are compliant with GDPR, ISO, SOC 2, and HIPAA.

GDPR
ISO
SOC 2
HIPAA

Still scrolling? We both know you're interested.

Let's chat about AI Agents the old-fashioned way. Get a demo tailored to your requirements.

Schedule a Demo