Jentic OSThe workplace. An in-house AI platform for every employeeJentic OneSafe access. Agents reach your systems without holding keysJentic AIRThe foundation. Gets your existing platforms ready for AI
Pricing

GET STARTED

API DirectoryBrowse 10,000+ APIs ready for AI agent integrationDocumentationGuides and API reference

TOOLS

API ScoringCheck your AI readiness using our scorecardArazzo UIVisualize Arazzo workflows as interactive documentationArazzo EditorBuild and edit multi-step API workflows visually

COMMUNITY

GitHubOpen source projects and examplesOpen StandardsBuilt on open specs. Never locked in.
All ResourcesEverything in one placeBlogLatest articles and insightsTech Talk NewsletterAPIs, AI agents, architecture and strategyWebinarsLive sessions and on-demand recordingsReports & WhitepapersOriginal research on enterprise AI
About UsOur mission and teamCareersJoin our teamContactGet in touch
Try it now
Jentic OSJentic OneJentic AIR
Pricing
API DirectoryDocumentationAPI ScoringArazzo UIArazzo EditorGitHubOpen Standards
All ResourcesBlogTech Talk NewsletterWebinarsReports & Whitepapers
About UsCareersContact
Try it now
JenticJentic
Products
  • Jentic OS
  • Jentic One
  • Jentic AIR
For Developers
  • API Directory
  • Documentation
  • GitHub
Company
  • About Jentic
  • Careers
  • Contact Us
  • Trust Centre
ISO/IEC 27001:2022 certification badge issued by Prescient SecurityISO/IEC 27001:2022 certification badge issued by Prescient Security

Information Security Management System

Certified to ISO/IEC 27001:2022 by Prescient Security

AICPA SOC for Service Organizations logoAICPA SOC for Service Organizations logo

SOC 2® Type 1 report

Audited by Prescient Assurance

Terms & Conditions•Privacy Policy•
© 2026 Jentic Technology Ltd. All rights reserved.
2 Grattan Court East, Dublin, D02 VX86, Ireland
Switch to light modeSwitch to dark mode
APIs / IOT / ClearBlade API
ClearBlade API logo

ClearBlade API

58
AI ReadinessFoundational (C+)58/100
See full scorecard
Community OpenAPI document · agent-readyIOTDevice ManagementapiKey220 EndpointsREST

Know of an official OpenAPI document? Contribute it →

For Agents

Provision ClearBlade systems, register and update devices, run data collection queries, execute code services, and inspect message history. Useful for industrial IoT fleet management and edge orchestration.

Use for: I need to register a new device in our ClearBlade system, Update the firmware metadata for a fleet of devices, Get audit logs for the production system, Rotate the authentication keys for a specific device

Not supported: Does not handle physical hardware manufacturing, cellular connectivity provisioning, or end-customer billing - use for ClearBlade IoT platform device, system, and code service operations only.

ClearBlade is an industrial IoT platform, and its REST API exposes the platform's full operational surface across systems, devices, collections, code services, message-passing, and developer administration. With over 220 endpoints, the API covers everything from provisioning a new system and registering devices to running data queries, sending MQTT messages, and rotating device keys. Operations are grouped under admin, codes, data, devices, edges, and message-history namespaces, reflecting the platform's multi-tenant edge-and-cloud architecture. It is designed for industrial operators, OEMs, and IoT solution builders who need full programmatic control over a fleet.

Jentic One on GithubView OpenAPI Document

Install Jentic One Beta

Connect the ClearBlade API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the ClearBlade API, 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%2Fclearblade.com%2Fclearblade" | sh
2

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%2Fclearblade.com%2Fclearblade" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic 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 ClearBlade API.

Provision and configure ClearBlade systems and developer accounts

Register, query, update, and delete devices in bulk or individually

Manage data collections including create, update, and delete operations

Trigger and inspect server-side code services and triggers

Rotate device authentication keys for security compliance

Pull audit logs and device activity history from a system

Inspect MQTT message history and topic activity

Use Cases

Patterns agents use ClearBlade API for, with concrete tasks.

★ Bulk device provisioning for a new deployment

When rolling out a new IoT deployment, operations teams need to register hundreds or thousands of devices into the ClearBlade system. POST /admin/devices/{systemKey}/{name} creates devices and POST /admin/devices/keys/{systemKey}/{deviceName} provisions their rotating authentication keys. Running these in batches against the platform avoids manually clicking through the console for each device and keeps the device registry as the canonical source.

For each row in the device manifest CSV, call POST /admin/devices/{systemKey}/{name} then POST /admin/devices/keys/{systemKey}/{deviceName} to create rotating keys

Audit log export for compliance reporting

Compliance teams in regulated industries need device and platform audit data exported into their SIEM. GET /admin/audit and GET /admin/audit/{systemKey} return the audit log for a system, with /count variants for pagination planning. Scheduling this nightly into a SIEM gives auditors a continuous record without needing console access to ClearBlade.

Each night, call GET /admin/audit/{systemKey} for the production system, paginate based on the /count endpoint, and forward the records to the Splunk HEC endpoint

Stale device cleanup

Fleets accumulate stale devices that no longer report telemetry. GET /admin/devices/{systemKey} with a query filter identifies devices that have not connected recently, and DELETE /admin/devices/{systemKey} removes them in bulk. Running this monthly keeps device counts and license usage aligned with the active fleet.

Find all devices in the production system with last_active older than 90 days using GET /admin/devices/{systemKey}, then call DELETE /admin/devices/{systemKey} with the matching query

Code service trigger inspection

When a code service misfires, debugging often starts with checking which triggers reference it and what audit entries describe its recent runs. The admin endpoints expose service-trigger relationships and the audit endpoints expose execution history. Pulling both together gives a clear view of which triggers fire which services and how often they error.

List the code services registered for system 'prod-system' and pull their recent audit entries via GET /admin/audit/{systemKey} to identify the failing trigger

AI agent integration via Jentic

An IoT operations agent uses Jentic to discover ClearBlade endpoints by intent and orchestrate fleet operations from natural-language requests. Because the API key auth is held in your Jentic One instance, the agent can be deployed to operations engineers without distributing platform credentials. The same agent can register devices, rotate keys, and query audit logs by re-running searches on different intents.

Receive 'rotate keys for device gateway-42' from chat, search Jentic for ClearBlade device key rotation, and execute POST /admin/devices/keys/{systemKey}/{deviceName} for that device

Key Endpoints

220 endpoints — clearblade is an industrial iot platform, and its rest api exposes the platform's full operational surface across systems, devices, collections, code services, message-passing, and developer administration.

METHOD

PATH

DESCRIPTION

POST

/admin/devices/{systemKey}/{name}

Create a device in a system

GET

/admin/devices/{systemKey}

Query devices in a system

POST

/admin/devices/keys/{systemKey}/{deviceName}

Create rotating keys for a device

GET

/admin/audit/{systemKey}

Get system audit information

POST

/admin/auth

Authenticate developer credentials

POST

/admin/collectionmanagement

Create a data collection

GET

/admin/allsystems

List all systems

DELETE

/admin/devices/{systemKey}

Delete devices using a query

POST

/admin/devices/{systemKey}/{name}

Create a device in a system

GET

/admin/devices/{systemKey}

Query devices in a system

POST

/admin/devices/keys/{systemKey}/{deviceName}

Create rotating keys for a device

GET

/admin/audit/{systemKey}

Get system audit information

POST

/admin/auth

Authenticate developer credentials

POST

/admin/collectionmanagement

Create a data collection

GET

/admin/allsystems

List all systems

DELETE

/admin/devices/{systemKey}

Delete devices using a query

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.

C

ClearBlade API

- Foundational (C+)
58/100
51
Foundational Compliance
66
Developer Experience & Jentic Compatibility
54
AI-Readiness & Agent Experience
43
Agent Usability
100
Security
100
AI Discoverability
Powered by JenticScoring Framework 1.0.0 | Scoring Engine 0.4.0
Show dimension breakdown
51

Foundational Compliance

Base layer of spec validity and structural soundness.

Grade: C-Signals: 4
85%

Lint Results

Aggregated quality score from linter diagnostics, weighted by severity.

100%

Resolution Completeness

Percentage of `$ref` references that resolve successfully.

0%

Specification Validity

Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).

21%

Structural Integrity

Structural correctness score based on schema issues using logarithmic dampening.

66

Developer Experience & Jentic Compatibility

Clarity, completeness, and ingestion readiness for developers and tooling.

Grade: BSignals: 4
21%

Example Density

How richly the API is illustrated with examples.

98%

Example Validity

Percentage of examples that conform to their schemas.

47%

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.

54

AI-Readiness & Agent Experience

Semantic breadth, depth, and agent comprehension for AI systems.

Grade: CSignals: 4
55%

Description Coverage

Coverage of descriptions across API elements.

0%

Error Standardization

Coverage of RFC 9457 Problem Details for error responses.

98%

OperationId Quality

Coverage, uniqueness, and casing consistency of operationIds for AI inference.

62%

Summary Coverage

Coverage of summaries across operations/tags/info.

43

Agent Usability

Functional utility, complexity comfort, and AI orchestration readiness.

Grade: D-Signals: 1
43%

Complexity Comfort

Agent comfort level based on API operational and structural complexity.

100

Security

Trust, risk posture, and security compliance.

Grade: A+Signals: 1
100%

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.

View full reportHow the score is calculatedMore about the dimensions

Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

Score your own APIScoring CLI agent skill
npx @jentic/api-scorecard-cli score <openapi-url>

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring the ClearBlade API by hand means managing its API key auth and threading the system key through calls to platform.clearblade.com across its large IoT operation set. Through Jentic you install once, import ClearBlade from the API Directory, store the key once, and your agent calls it.

Permission scoping

ClearBlade puts the system key in the URL path (/admin/devices/{systemKey}), so a rule can pin your agent to one system: it can register and list devices there and nothing else. You choose the operations it may call, so deleting devices is not included unless you add it.

Credential isolation

Your ClearBlade API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'register a device' or 'list devices for a system in ClearBlade', and Jentic returns the matching operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

Particle API

→

Connected device platform with strong cellular IoT story

Choose Particle when cellular-first connectivity matters; choose ClearBlade for industrial deployments needing edge-and-cloud topology

Complementary

Samsara API

→

Connected operations and fleet telematics platform

Pair Samsara with ClearBlade when fleet vehicle telematics are needed alongside generic industrial device management

Alternative

Adafruit IO API

→

Hobbyist and prototyping IoT platform

Use Adafruit IO for prototypes and educational projects; ClearBlade is the right choice for production industrial deployments

FAQs

Specific to using ClearBlade API through Jentic.

What authentication does the ClearBlade API use?

ClearBlade uses an API key passed in request headers, with developer-level authentication issued via POST /admin/auth and verified via POST /admin/checkauth. The OpenAPI spec does not declare the security scheme inline, so the auth header is configured at the request level. Through Jentic, both the platform credentials and per-system tokens are stored in the encrypted vault.

Can I register devices in bulk through the ClearBlade API?

Yes. POST /admin/devices/{systemKey}/{name} creates a single device, and the corresponding GET, PUT, and DELETE on /admin/devices/{systemKey} accept queries for bulk operations. For new deployments, you typically iterate through your device manifest and call the create endpoint for each entry.

How do I rotate device authentication keys?

Call POST /admin/devices/keys/{systemKey}/{deviceName} to create a new rotating key, and DELETE /admin/devices/keys/{systemKey}/{deviceName} to revoke an existing one. This is the standard pattern for periodic key rotation in regulated IoT deployments.

How do I export ClearBlade audit logs through Jentic?

Install the SDK with pip install jentic, search Jentic for 'get clearblade audit logs', load the schema, and execute against GET /admin/audit/{systemKey}. Use the matching /count endpoint to plan pagination, then forward records to your SIEM.

Does the ClearBlade API expose MQTT message history?

Yes. The platform stores MQTT topic and message history that can be queried through admin endpoints, alongside the data collection endpoints for telemetry storage. This gives you both the realtime broker view and the historical record without leaving the platform.

Are ClearBlade systems multi-tenant?

Yes. Each system has its own systemKey and admin operations are scoped to that key. Developers with access to multiple systems can iterate via GET /admin/allsystems and act on each system in turn, which is the standard fan-out pattern for managed-service operators.

Can I limit what my agent is allowed to do with the ClearBlade API?

Yes. Because Jentic One is self-hosted and you write the rules, you decide which ClearBlade operations and credentials your agent may use. Since the system key sits in the URL path (/admin/devices/{systemKey}), a rule can pin the agent to a single system so it can register and list devices there and nothing else. Destructive calls like DELETE /admin/devices/{systemKey} stay out of reach unless you explicitly grant them.

GET STARTED

Start building with ClearBlade API

Explore with Jentic One
View OpenAPI Document