iblai-api-agent-sandbox

iblai-api-agent-sandbox

Wire an agent to a Claw sandbox instance, manage the available instances, push config and run health/connectivity checks, and set the model the agent's workspace uses. Use when connecting an agent to a sandboxed workspace.

Auth & conventions

• Base URL: https://api.iblai.app
• Header: Authorization: Api-Token $IBLAI_API_KEY on every request.
• Prefix: paths shown as … are under https://api.iblai.app/dm/api/ai-mentor — the /dm gateway routes to the Data Manager service. (…/api/ai-agent/… is an accept-only alias for the same routes.)
• Path vars: {org} = $IBLAI_ORG, {username} = $IBLAI_USERNAME, {mentor} = the agent's unique id (a UUID, e.g. d17dc729-60fd-4363-81a0-f67d9318b03e). {id} on claw/instances/ and claw/model-providers/ is the integer primary key.
• Not connected yet? Run /iblai-api-login first to populate IBLAI_ORG, IBLAI_USERNAME, and IBLAI_API_KEY.

Reads

Instances

• GET …/orgs/{org}/claw/instances/ — list registered Claw instances.
• GET …/orgs/{org}/claw/instances/{id}/ — retrieve one instance (status, claw_version, last health/pairing).

Model providers

• GET …/orgs/{org}/claw/model-providers/ — list the org's model-provider blocks.
• GET …/orgs/{org}/claw/model-providers/{id}/ — retrieve one provider block.

Agent config

• GET …/orgs/{org}/mentors/{mentor}/claw-config/ — the agent's connected instance + push status (404 = not connected).
• GET …/orgs/{org}/mentors/{mentor}/agent-config/ — agent workspace config (includes current model).
• GET …/orgs/{org}/users/{username}/mentor-llms/?mentor_id={mentor} — available model options.

Writes

Instances

• POST …/orgs/{org}/claw/instances/ — register an instance:

  {
    "name": "string",
    "claw_type": "openclaw | ironclaw | nemoclaw",
    "server_url": "https://claw.example.com",
    "gateway_token": "string (write-only)",
    "connection_params": { "device_identity": {} },
    "auth_headers": {},
    "deployment_backend": "backend id (optional)"
  }
  

• PATCH …/claw/instances/{id}/ — edit (send only changed writable keys: name, claw_type, server_url, gateway_token, connection_params, auth_headers, deployment_backend).
• DELETE …/claw/instances/{id}/ — delete instance. Destructive — confirm with the user first.
• POST …/claw/instances/{id}/health-check/ — queue a health check (returns 202; poll the instance for last_health_status).
• POST …/claw/instances/{id}/test-connectivity/ — TLS reachability + health check.
• POST …/claw/instances/{id}/refresh-version/ — detect claw_version from the instance handshake.
• POST …/claw/instances/{id}/request-pairing/ — queue a device-pairing request (pending request expires ~5 min). Outward-facing — confirm with the user first.
• POST …/claw/instances/{id}/push-providers/ — push all enabled model providers to the instance. Outward-facing — confirm with the user first.
• POST …/claw/instances/{id}/security-audit/ — run a security audit (OpenClaw only). Outward-facing — confirm with the user first.