Install Jentic One Beta

Connect the Orca Scan REST API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Orca Scan REST 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.

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%2Forcascan.com%2Forcascan-api" | sh

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%2Forcascan.com%2Forcascan-api" | 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 Orca Scan REST API.

List sheets in an Orca Scan account

Read all rows on a specific scanning sheet

Create or update individual rows on a sheet

Manage the field schema attached to a sheet

Retrieve the change history for rows on a sheet

GET STARTED

Start building with Orca Scan REST API

Explore with Jentic One

View OpenAPI Document

Use Cases

Patterns agents use Orca Scan REST API for, with concrete tasks.

★ Stock Count Sync to ERP

Run a barcode-driven stock count on Orca Scan and push the resulting row data into an ERP at the end of the session. The /sheets/{sheetId}/rows endpoints return the scanned rows and the ERP integration can map each row's barcode and quantity fields directly into a stock-take entry.

GET /sheets/{sheetId}/rows after the stock count and POST each row into the ERP's stock-take import

Backend-Driven Sheet Population

Pre-populate Orca Scan sheets from a master product catalog so warehouse staff scan against an expected list rather than building it as they go. The row create endpoint accepts payloads against the sheet's defined fields, and the field endpoints let the integration align with the sheet schema before pushing data.

GET /sheets/{sheetId}/fields, then POST rows to /sheets/{sheetId}/rows mapped onto those fields

Real-Time Webhooks for Receiving Workflows

Trigger downstream workflows the moment a row is added or updated on an Orca Scan receiving sheet. The /hooks endpoints register webhooks tied to a sheet, and Orca Scan fires JSON payloads at the configured URL so a backend system can react without polling.

POST a hook for the receiving sheet, then handle incoming row-created events to trigger an inbound workflow

Audit Trail Export for Compliance

Pull the row-level change history out of Orca Scan to feed a compliance archive. The /sheets/{sheetId}/history endpoint exposes the same audit timeline the Orca Scan UI shows, so compliance teams can store the events in their own retention system.

GET /sheets/{sheetId}/history nightly and append the events to a compliance log

Agent-Driven Scan Sheet Operations via Jentic

An AI assistant for warehouse leads can list sheets, read rows, and add new rows on Orca Scan through Jentic. The agent maps natural-language intents like 'add this received pallet to the receiving sheet' to the right Orca Scan endpoint without holding the raw Bearer token.

Search Jentic for 'add a row to an Orca Scan sheet', load the POST /sheets/{sheetId}/rows operation, and execute

Key Endpoints

29 endpoints — the orca scan rest api exposes the sheets, rows, fields, and webhooks behind orca scan's barcode-driven inventory app.

METHOD

PATH

DESCRIPTION

GET

/sheets

List sheets

GET

/sheets/{sheetId}

Retrieve a sheet

GET

/sheets/{sheetId}/rows

List rows on a sheet

GET

/sheets/{sheetId}/rows/{rowId}

Retrieve a row

GET

/sheets/{sheetId}/history

Retrieve row history

GET

/sheets/{sheetId}/settings

Retrieve sheet settings

GET

/sheets

List sheets

GET

/sheets/{sheetId}

Retrieve a sheet

GET

/sheets/{sheetId}/rows

List rows on a sheet

GET

/sheets/{sheetId}/rows/{rowId}

Retrieve a row

GET

/sheets/{sheetId}/history

Retrieve row history

GET

/sheets/{sheetId}/settings

Retrieve sheet settings

Why Jentic?

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

Setup

Wiring the Orca Scan API by hand means setting up its bearer auth and mapping the sheet, row, field, and webhook routes yourself. Through Jentic you install once, import Orca Scan from the API Directory, store the token once, and your agent calls it.

Permission scoping

Orca Scan puts the sheet id in the URL path (/sheets/{sheetId}/rows, /sheets/{sheetId}/history), so a rule can pin your agent to one sheet: it can read its rows, history, and settings and nothing else. You choose the operations it may call, so row writes are not included unless you add them.

Credential isolation

Your Orca Scan bearer token 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 'list rows on an Orca Scan sheet' or 'read a sheet's history', and Jentic returns the matching sheet-scoped Orca Scan operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

FAQs

Specific to using Orca Scan REST API through Jentic.

What authentication does the Orca Scan REST API use?

HTTP Bearer authentication. The token is created in Orca Scan account settings and granted access to specific sheets. Through Jentic the Bearer token is stored encrypted in the vault and the agent only receives a scoped session, never the raw token.

Can I add rows to an Orca Scan sheet from a backend system?

Yes. POST to /sheets/{sheetId}/rows with a payload matching the sheet's field schema (exposed at /sheets/{sheetId}/fields). The new rows show up in the Orca Scan app and trigger any subscribed webhooks the same way scanned rows do.

How do I subscribe to row events on a sheet?

Register a webhook on the /hooks endpoints tied to a sheet id and event type. Orca Scan posts JSON payloads to the configured URL whenever rows are created or updated, so the integration does not need to poll /sheets/{sheetId}/rows.

Does the API expose a row-level audit trail?

Yes. GET /sheets/{sheetId}/history returns the same change history the Orca Scan UI shows, including who changed which row and when. This is the supported path for compliance and audit archives.

How do I list rows on a sheet through Jentic?

Install the SDK with pip install jentic, then search for 'list rows on an Orca Scan sheet'. Jentic returns the GET /sheets/{sheetId}/rows operation with its schema; load it, supply the sheet id, and execute. Run it through Jentic One, the self-hosted execution layer.

Can I limit what my agent is allowed to do with the Orca Scan REST API?

Yes. Because Orca Scan puts the sheet id in the URL path, such as /sheets/{sheetId}/rows and /sheets/{sheetId}/history, a rule in your self-hosted Jentic One can pin your agent to a single sheet so it reads only that sheet's rows, history, and settings. You decide which operations the agent may call, so row writes to /sheets/{sheetId}/rows and webhook registration on /hooks are excluded unless you add them. Your own rules also control which stored credential the agent uses, and the bearer token is injected at execution time rather than exposed to the agent.

Orca Scan REST API

Browse all Orcascan APIs

AI ReadinessAI-Aware (B)65/100

See full scorecard

Official vendor OpenAPI document · agent-readyE CommerceInventorybearer29 EndpointsREST

For Agents

Read and write rows on Orca Scan barcode sheets, manage fields and webhooks, and pull row history with a Bearer token.

Use for: List all sheets in the Orca Scan account, Read every row on a barcode-scanning sheet, Add a new row to an Orca Scan sheet, Update a row when stock is received from a supplier

Not supported: Does not handle barcode generation, scanner hardware provisioning, or label printing - use for sheet, row, field, and webhook operations only.

The Orca Scan REST API exposes the sheets, rows, fields, and webhooks behind Orca Scan's barcode-driven inventory app. It lets warehouse and inventory teams treat each scanning sheet as a structured table - adding rows from a backend system, reading the scan history, and reacting to changes through webhooks. The API uses Bearer authentication and is the integration layer that pulls Orca Scan data into ERPs, WMS systems, and analytics tools.

Jentic One on Github View OpenAPI Document

Show dimension breakdown

Foundational Compliance

Base layer of spec validity and structural soundness.

Grade: BSignals: 4

67%

Lint Results

Aggregated quality score from linter diagnostics, weighted by severity.

100%

Resolution Completeness

Percentage of `$ref` references that resolve successfully.

Specification Validity

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

100%

Structural Integrity

Structural correctness score based on schema issues using logarithmic dampening.

Developer Experience & Jentic Compatibility

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

Grade: B+Signals: 4

Example Density

How richly the API is illustrated with examples.

100%

Example Validity

Percentage of examples that conform to their schemas.

75%

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.

AI-Readiness & Agent Experience

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

Grade: DSignals: 4

21%

Description Coverage

Coverage of descriptions across API elements.

Error Standardization

Coverage of RFC 9457 Problem Details for error responses.

100%

OperationId Quality

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

64%

Summary Coverage

Coverage of summaries across operations/tags/info.

Agent Usability

Functional utility, complexity comfort, and AI orchestration readiness.

Grade: A+Signals: 1

94%

Complexity Comfort

Agent comfort level based on API operational and structural complexity.

Security

Trust, risk posture, and security compliance.

Grade: B-Signals: 1

60%

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.

Connect the Orca Scan REST API to your agent

Capabilities

Start building with Orca Scan REST API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs

Orca Scan REST API

Jentic AI Readiness Score

Orca Scan REST API

Foundational Compliance

Lint Results

Resolution Completeness

Specification Validity

Structural Integrity

Developer Experience & Jentic Compatibility

Example Density

Example Validity

Response Coverage

Tooling Readiness

AI-Readiness & Agent Experience

Description Coverage

Error Standardization

OperationId Quality

Summary Coverage

Agent Usability

Complexity Comfort

Security

Authentication Strength

AI Discoverability

Descriptive Richness