Skip to main content
Available on Developer plan and above. Upgrade at app.imarobot.ai.

Install

Quick start

Generate a key pair

The SDK includes a CLI helper so you don’t need to touch OpenSSL:
  • Private key — keep secret. Used by your agent process to sign requests.
  • Public key — upload to ImaRobot during registerAgent(). Safe to commit.

API

new ImaRobotAgent(options)


client.registerAgent(options)

Returns: { agentId, name, status, expiresAt }

client.issueToken(agentId)

Issues a fresh token for an existing agent. The token embeds all scopes and expiry from registration.

client.revokeAgent(agentId, options?)

Revokes immediately. Subsequent verifications return TOKEN_REVOKED.

client.rotateAgent(agentId, options?)

Revoke + re-register in one call. Returns the new agent.

client.listAgents(options?)

TypeScript