canonical: https://jentic.com/apis/softbankrobotics.com/softbankrobotics

# Softbankrobotics Aldebaran Robotics API

SoftBank Robotics developer API for humanoid robots and automation. The API exposes 3 endpoints secured with apiKey authentication.

## For AI agents

Programmatically list robots, send command. Covers 3 operations with apiKey authentication.

## Scope

Does not handle payments, communications, or crm - use for finance and accounting only.

## Capabilities

- List robots
- Send command
- Get robot status
- Query and filter Aldebaran Robotics API records by parameters
- Monitor Aldebaran Robotics API operational status and events

## Use cases

### Finance and Accounting Operations

Use the Aldebaran Robotics API to perform finance operations programmatically. The API provides 3 endpoints covering core functionality including list robots, send command, get robot status.

Example prompt: Call GET /robots to list robots

### Automated Commands Management

Automate commands operations by combining multiple Aldebaran Robotics API endpoints. Agents can send command and then get robot status in a single workflow.

Example prompt: Call POST /commands to send command, then verify the result

### AI Agent Integration via Jentic

AI agents discover and call Aldebaran Robotics API endpoints through Jentic without managing credentials directly. An agent searches for the required operation by intent, receives the matching endpoint schema, and executes the call with Jentic-managed authentication. This eliminates the need to read API documentation or handle apiKey tokens manually.

Example prompt: Search Jentic for 'list robots', load the operation schema, and execute with Jentic-managed credentials

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | /robots | List robots |
| POST | /commands | Send command |
| GET | /status | Get robot status |

## Key resources

- **Commands** — Operations related to Commands
- **Robots** — Operations related to Robots
- **Status** — Operations related to Status

## Why Jentic

- **Setup:** Wiring the Aldebaran Robotics API by hand means passing your API key in the Authorization header, pointing at the api.softbankrobotics.com host, and coordinating robot listing, commands, and status yourself. Through Jentic you install once, import the Aldebaran Robotics API from the API Directory, store the API key once, and your agent calls it.
- **Permission scoping:** The Aldebaran Robotics API takes its command target in the request body rather than a resource id in the URL path, so limit the agent to the operations it needs, such as listing robots or reading status. You choose that set, so sending commands is only included if you add it.
- **Credential handling:** Your Aldebaran Robotics API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'list available robots' or 'check robot status', and Jentic returns the matching Aldebaran Robotics API operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Plaid** — Alternative finance API
- **Xero** — Alternative finance API

## FAQ

### What authentication does the Aldebaran Robotics API use?

The Aldebaran Robotics API uses an API key passed in the `Authorization` header. Through Jentic, these credentials are stored encrypted in your Jentic One instance and injected at execution time, so raw secrets never enter the agent context.

### Can I list robots with the Aldebaran Robotics API?

Yes. Use the GET /robots endpoint. The API returns structured JSON responses that agents can parse and act on directly.

### What are the rate limits for the Aldebaran Robotics API?

Rate limits are not specified in the OpenAPI spec. Check the vendor documentation for current limits. Through Jentic, rate limiting is handled automatically with retry logic built into the execution layer.

### How do I list robots through Jentic?

Install the Jentic SDK with pip install jentic, authenticate through Jentic One, the self-hosted execution layer, then search for 'list robots'. Jentic returns the matching Aldebaran Robotics API operation with its input schema. Load the schema and execute the call - credentials are injected automatically.

### How many endpoints does the Aldebaran Robotics API have?

The Aldebaran Robotics API exposes 3 endpoints covering commands, robots, status operations.

### Can I limit what my agent is allowed to do with the Aldebaran Robotics API?

Yes. Because you run Jentic One yourself, your own rules decide which Aldebaran Robotics API operations and credentials the agent may use, so you can grant only GET /robots to list robots and GET /status to read robot status while excluding POST /commands. Since the command target is passed in the request body rather than a resource id in the URL path, sending commands is included only if you deliberately add that operation to the agent's allowed set. This lets an operator keep the agent read-only until it needs to act.