Skip to main content

API

API tokens are how anything outside Robomotion authenticates against your workspace. This page is where you create and revoke them.

API Tokens

Generating a token​

Generate Token asks for a name and a permission level.

Read reaches read-only endpoints — the GET half of the API: listing robots, reading jobs, fetching queue items.

Write reaches everything read does, plus the endpoints that change something — running a flow, inserting a queue item, updating a robot.

Token Name

Click Generate to create the token. After creation, the token will be visible for you to copy.

API Token

Copy it now

The token is shown once, at creation, and never again — only a name and a last-used timestamp are kept afterwards. If you lose it, delete the token and generate a new one.

Using the token​

Send it as a bearer token:

curl -X GET "https://api.robomotion.io/v1/robots.list" \
  -H "Authorization: Bearer $ROBOMOTION_TOKEN"

The API Playground lists every endpoint a token can reach, with a Run button and ready-made code in nine languages. Which endpoints each level reaches is set out in Permissions.

Revoking​

Tokens are listed with their permission, creation date and last use. Delete one and it stops working immediately — there is no grace period, so check Last Use before removing a token you did not create yourself.