Authentication

Learn how to make requests using the Reforge API.

Authentication and Permissions

Reforge access is scoped per robot. Depending on how your robot is onboarded, you will use either:

• robot_id only, or
• both robot_id and api_key.

If your robot was registered by an OEM

If you selected Use a registered robot in the Reforge app, your OEM integration handles API authentication in their controller flow. You typically only need to get and store your robot_id on the robot during setup:

1. Register from the OEM-provided link.
2. Get a Reforge robot_id.
3. Enter that robot_id in the OEM robot setup UI/controller.

If you are registering your own robot

If you selected Register a new robot, you need both credentials:

1. robot_id for robot identity.
2. api_key from app.reforgerobotics.com/api-keys for API authentication.

Use both in the calibration/identification command from Quickstart:

bash
python3 -m robot.run calibrate <robot_ip> --local_ip <local_ip> --sdk_token <robot_sdk_token> --robot_id <reforge_robot_id> --identify <reforge_api_key>

In this command:

• --robot_id is your Reforge robot ID.
• --identify is your Reforge API key.