Agent-ready OpenAPI document · curated by JenticDeveloper ToolsCi Cdhmac57 EndpointsREST
Know of an official OpenAPI document? Contribute it →
For Agents
Run ROS simulation jobs, generate synthetic worlds, and deploy robotics applications to device fleets in the cloud.
Use for: I need to launch a ROS simulation job for a navigation test scenario, Cancel a running simulation job that has exceeded its time budget, Generate a batch of 50 synthetic warehouse worlds for perception training, Deploy a new version of robot software to all robots in a fleet
Not supported: Does not train ML models, build simulator binaries, or run general-purpose IoT fleets - use for ROS robot simulation, synthetic world generation, and robot-application deployment only.
Jentic publishes the only available OpenAPI specification for AWS RoboMaker, keeping it validated and agent-ready. AWS RoboMaker is a managed service for building, simulating, and deploying robotics applications at scale. It runs ROS-based simulation jobs in the cloud, generates synthetic worlds for training, manages over-the-air deployment of robot software to fleets, and tracks simulation batches so engineering teams can iterate on perception and navigation models without standing up their own GPU infrastructure.
Install Jentic One Beta
Connect the AWS RoboMaker to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the AWS RoboMaker, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Famazonaws.com%2Faws-robomaker" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Famazonaws.com%2Faws-robomaker" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with AWS RoboMaker API.
Launch and cancel ROS-based simulation jobs against custom robot and simulation applications
Run batched simulation jobs to parallelise scenario testing with CreateSimulationJobBatch and CancelSimulationJobBatch
Generate synthetic worlds and export them to S3 with CreateWorldGenerationJob and CreateWorldExportJob
Register and inventory robots, fleets, robot applications, and simulation applications
Deploy robot software over-the-air with CreateDeploymentJob and track per-robot deployment status
Stream simulation logs and metrics by inspecting DescribeSimulationJob output and tagging assets for traceability
Use Cases
Patterns agents use AWS RoboMaker API for, with concrete tasks.
★ Cloud-scale robot simulation testing
Robotics teams use AWS RoboMaker to run ROS simulation jobs in parallel against new perception and navigation code without provisioning local GPU clusters. CreateSimulationJob spins up a Gazebo or other simulator with the team's robot application and a chosen world; CreateSimulationJobBatch fans the same scenario across many parameter variations so regression tests finish in minutes, not hours.
Call CreateSimulationJobBatch with 30 simulation requests covering varied lighting and obstacle layouts for the same robot application, then poll DescribeSimulationJobBatch until all complete.
Synthetic world generation for ML training
Perception teams use CreateWorldGenerationJob to produce thousands of procedurally varied indoor environments, then export them with CreateWorldExportJob to S3 for downstream training of object-detection and SLAM models. RoboMaker handles the variation parameters and storage, freeing engineers from running their own world-generation pipeline.
Submit CreateWorldGenerationJob with a worldCount of 500 against a residential template, then call CreateWorldExportJob to push the resulting worlds to s3://my-training-data/worlds/.
Over-the-air robot fleet deployment
Operations teams use the deployment APIs to push new robot software versions to fleets in production. CreateDeploymentJob targets a fleet, applies a deployment configuration, and tracks per-robot rollout status, so a release engineer can confirm the version is live on every device without writing custom orchestration. RegisterRobot and DeregisterRobot keep the fleet inventory current.
Call CreateDeploymentJob targeting fleet arn:aws:robomaker:::fleet/prod-warehouse with a new robot application version, then poll DescribeDeploymentJob until all robots report SUCCEEDED.
Agent-driven simulation workflow through Jentic
AI agents that orchestrate end-to-end robot release pipelines use Jentic to call CreateSimulationJob, DescribeSimulationJob, and CreateDeploymentJob without holding raw AWS credentials. Jentic stores the agent's keys in your Jentic One instance, signs each request with SigV4, and returns the structured response so the agent can branch on simulation outcome before triggering deployment.
Search Jentic for 'launch a RoboMaker simulation job', load CreateSimulationJob, execute against the navigation_test simulation application, and on SUCCEEDED status trigger CreateDeploymentJob to the staging fleet.
Key Endpoints
57 endpoints — jentic publishes the only available openapi specification for aws robomaker, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
POST
/createSimulationJob
Launch a ROS simulation job
POST
/createSimulationJobBatch
Launch a batch of simulation jobs
POST
/cancelSimulationJob
Cancel a running simulation job
POST
/createWorldGenerationJob
Generate synthetic worlds for training and simulation
POST
/createWorldExportJob
Export generated worlds to S3
POST
/createDeploymentJob
Deploy a robot application version to a fleet
POST
/createFleet
Create a fleet for grouping robots
POST
/createRobot
Register a robot
POST
/createSimulationJob
Launch a ROS simulation job
POST
/createSimulationJobBatch
Launch a batch of simulation jobs
POST
/cancelSimulationJob
Cancel a running simulation job
POST
/createWorldGenerationJob
Generate synthetic worlds for training and simulation
POST
/createWorldExportJob
Export generated worlds to S3
POST
/createDeploymentJob
Deploy a robot application version to a fleet
POST
/createFleet
Create a fleet for grouping robots
POST
/createRobot
Register a robot
Jentic AI Readiness Score
This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.
A
AWS RoboMaker
- AI-Aware (B-)61/100
99
Foundational Compliance63
Developer Experience & Jentic Compatibility39
AI-Readiness & Agent Experience93
Agent Usability50
Security100
AI DiscoverabilityPowered by JenticScoring Framework 1.0.0 | Scoring Engine 0.4.0
Show dimension breakdown
99
Foundational Compliance
Base layer of spec validity and structural soundness.
Grade: A+Signals: 4
95%
Lint Results
Aggregated quality score from linter diagnostics, weighted by severity.
100%
Resolution Completeness
Percentage of `$ref` references that resolve successfully.
100%
Specification Validity
Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).
100%
Structural Integrity
Structural correctness score based on schema issues using logarithmic dampening.
63
Developer Experience & Jentic Compatibility
Clarity, completeness, and ingestion readiness for developers and tooling.
Grade: B-Signals: 4
0%
Example Density
How richly the API is illustrated with examples.
100%
Example Validity
Percentage of examples that conform to their schemas.
50%
Response Coverage
Percentage of operations with complete response definitions (success, client error, server error).
100%
Tooling Readiness
Health of API ingestion, bundling, and resolution within Jentic pipelines.
39
AI-Readiness & Agent Experience
Semantic breadth, depth, and agent comprehension for AI systems.
Grade: FSignals: 4
54%
Description Coverage
Coverage of descriptions across API elements.
0%
Error Standardization
Coverage of RFC 9457 Problem Details for error responses.
100%
OperationId Quality
Coverage, uniqueness, and casing consistency of operationIds for AI inference.
0%
Summary Coverage
Coverage of summaries across operations/tags/info.
93
Agent Usability
Functional utility, complexity comfort, and AI orchestration readiness.
Grade: A+Signals: 1
93%
Complexity Comfort
Agent comfort level based on API operational and structural complexity.
50
Security
Trust, risk posture, and security compliance.
Grade: C-Signals: 1
50%
Authentication Strength
Average quality of security schemes based on authentication method strength (weakest link for OAuth2).
100
AI Discoverability
Findability, semantic richness, and reasoning readiness.
Grade: A+Signals: 1
100%
Descriptive Richness
Clarity and depth of descriptions across API elements.
Score it yourself
Every API in the directory is allowlisted, so you can re-score it with no key required.
npx @jentic/api-scorecard-cli score <openapi-url>Why Jentic?
What agents get from Jentic-routed access to this vendor.
Setup
Wiring RoboMaker by hand means computing SigV4 HMAC signatures per request, routing to the correct regional robomaker host, plumbing IAM roles, and packaging simulation and robot applications yourself. Through Jentic you install once, import AWS RoboMaker from the API Directory, store your AWS access keys once, and your agent calls it with signing done per request.
Permission scoping
Job, fleet, and robot definitions travel in the request body rather than the URL path, so you limit the agent to the operations it needs, such as CreateSimulationJob and CreateWorldGenerationJob. Operations like CancelSimulationJob or deleting a fleet are included only when you grant them.
Credential isolation
Your AWS access keys are stored once, encrypted, by your own Jentic One instance and used to produce a SigV4 signature per request. The raw secret access key never enters the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'launch a robot simulation job', and Jentic returns CreateSimulationJob with its input schema so the agent supplies the right roleArn, maxDuration, and simulation application settings without browsing the reference docs.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using AWS RoboMaker API through Jentic.
Why is there no official OpenAPI spec for AWS RoboMaker?
AWS does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call AWS RoboMaker via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.
What authentication does the AWS RoboMaker API use?
AWS RoboMaker uses AWS Signature Version 4 HMAC signing with an access key ID and secret access key, optionally with a session token. Through Jentic, those credentials live in your Jentic One instance and the agent never handles raw secrets - Jentic signs each request server-side.
Can I run my own custom simulator with AWS RoboMaker, or only Gazebo?
RoboMaker accepts a SimulationApplication that you build and upload (typically a containerised ROS + simulator bundle), so you are not restricted to Gazebo. The simulation application is registered via CreateSimulationApplication and referenced from CreateSimulationJob - but note AWS announced RoboMaker is on a deprecation path, so check current service status before adopting it for new workloads.
What are the rate limits for the AWS RoboMaker API?
AWS does not publish a fixed RPS in the spec; standard AWS API throttling applies. Long-running operations such as CreateSimulationJob also have concurrency limits per account and region - overage returns LimitExceededException, so production agents should poll capacity and queue jobs accordingly.
How do I launch a simulation job with the AWS RoboMaker API through Jentic?
Search Jentic for 'launch a RoboMaker simulation job', load the CreateSimulationJob operation schema, and call POST /createSimulationJob with your robotApplications, simulationApplications, and IAM role ARN. Then poll DescribeSimulationJob until status reaches Completed. Install the SDK first with pip install jentic.
Can the AWS RoboMaker API train ML models, or only run simulations?
RoboMaker itself runs simulations and generates synthetic worlds - it does not train models. The typical pipeline is: generate worlds with CreateWorldGenerationJob, export to S3 with CreateWorldExportJob, then train with Amazon SageMaker on that data. RoboMaker is the simulation and data-generation layer, not the training layer.
Can I limit what my agent is allowed to do with the AWS RoboMaker API?
Yes. Because you run Jentic One yourself, your own rules decide which RoboMaker operations and which AWS credentials the agent may use. Since job, fleet, and robot definitions travel in the request body rather than the URL path, you can allow only the operations the agent needs, such as CreateSimulationJob and CreateWorldGenerationJob, while withholding operations like CancelSimulationJob or fleet deletion. Those operations are callable only when you explicitly grant them.
GET STARTED