Install Jentic One Beta

Connect the Ninox API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Ninox 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%2Fninoxdb.de%2Fninoxdb" | 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%2Fninoxdb.de%2Fninoxdb" | 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 Ninox API.

Inspect a single team or table through GET /teams/{teamId} and /tables/{tableId}

List the field metadata for a Ninox table through /tables/{tableId}/fields

Page through, create, update, and delete records through /records routes

Upload an attachment to a record through POST /records/{recordId}/files/{fileName}

Download a record attachment through GET /records/{recordId}/files/{fileName}

GET STARTED

Start building with Ninox API

Explore with Jentic One

View OpenAPI Document

Use Cases

Patterns agents use Ninox API for, with concrete tasks.

★ Document attachments on records

Many internal tools store contracts, receipts, or scans alongside the structured row. POST /teams/{teamId}/databases/{databaseId}/tables/{tableId}/records/{recordId}/files/{fileName} uploads an attachment, and the matching GET endpoint downloads it. The schema model on /fields lets the agent confirm the table has a file-typed column before pushing the upload.

POST a contract.pdf attachment to /teams/{teamId}/databases/{databaseId}/tables/{tableId}/records/{recordId}/files/contract.pdf and verify the response confirms the upload.

Schema-aware record sync

Before pushing rows from another system, an integration can call GET /tables/{tableId}/fields to learn the current Ninox schema, mapping its source columns onto the matching Ninox fields. Then POST /records inserts new rows and PUT /records/{recordId} updates existing ones with confidence that the field names will match.

Call GET /tables/{tableId}/fields to retrieve the column list, then POST /records with a fields object whose keys match the returned field names.

Internal CRUD app back-end

A custom internal app running over Ninox uses the records endpoints as its CRUD layer. List with GET /records, create with POST /records, read a single row with GET /records/{recordId}, update with PUT, and delete with DELETE. The team and database IDs in the URL keep tenants isolated.

Call PUT /teams/{teamId}/databases/{databaseId}/tables/{tableId}/records/{recordId} with fields {Status: 'Closed'} and confirm a 200 response.

AI agent operating a Ninox-backed app

An AI agent running an internal-ops workflow can read, write, and attach files on Ninox without manual screen-clicking. Through Jentic, the agent searches by intent and Jentic returns the right Ninox endpoint with the bearer token attached server-side. File uploads stay scoped to the right record because the URL embeds the recordId and fileName.

Search Jentic for 'upload a file to a ninox record', load POST /teams/{teamId}/databases/{databaseId}/tables/{tableId}/records/{recordId}/files/{fileName}, and execute it for an invoice PDF.

Key Endpoints

14 endpoints — this page describes a curated, agent-optimized jentic openapi specification for ninox api (ninoxdb.

METHOD

PATH

DESCRIPTION

GET

/teams/{teamId}/databases/{databaseId}/tables/{tableId}/fields

List the field schema for a table

GET

/teams/{teamId}/databases/{databaseId}/tables/{tableId}/records

List records in a table

POST

/teams/{teamId}/databases/{databaseId}/tables/{tableId}/records

Create a new record

PUT

/teams/{teamId}/databases/{databaseId}/tables/{tableId}/records/{recordId}

Update fields on a record

DELETE

/teams/{teamId}/databases/{databaseId}/tables/{tableId}/records/{recordId}

Delete a record

POST

/teams/{teamId}/databases/{databaseId}/tables/{tableId}/records/{recordId}/files/{fileName}

Upload a file attachment to a record

GET

/teams/{teamId}/databases/{databaseId}/tables/{tableId}/records/{recordId}/files/{fileName}

Download a file attachment from a record

GET

/teams/{teamId}/databases/{databaseId}/tables/{tableId}/fields

List the field schema for a table

GET

/teams/{teamId}/databases/{databaseId}/tables/{tableId}/records

List records in a table

POST

/teams/{teamId}/databases/{databaseId}/tables/{tableId}/records

Create a new record

PUT

/teams/{teamId}/databases/{databaseId}/tables/{tableId}/records/{recordId}

Update fields on a record

DELETE

/teams/{teamId}/databases/{databaseId}/tables/{tableId}/records/{recordId}

Delete a record

POST

/teams/{teamId}/databases/{databaseId}/tables/{tableId}/records/{recordId}/files/{fileName}

Upload a file attachment to a record

GET

/teams/{teamId}/databases/{databaseId}/tables/{tableId}/records/{recordId}/files/{fileName}

Download a file attachment from a record

Why Jentic?

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

Setup

Wiring Ninox by hand means handling its bearer auth and threading team, database, and table ids through every path (https://api.ninox.com/v1) yourself. Through Jentic you install once, import the Ninox API from the API Directory, store the token once, and your agent calls it.

Permission scoping

Ninox puts the team and database ids in the URL path (/teams/{teamId}/databases/{databaseId}/...), so a rule can pin your agent to one database: it can read table fields and create records for that database and nothing else. You choose the operations it may call, so destructive ones like deleting a record are not included unless you add them.

Credential isolation

Your Ninox 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 'read a table's fields' or 'attach a file to a record', and Jentic returns the matching Ninox operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

FAQs

Specific to using Ninox API through Jentic.

Which OpenAPI specification does this Ninox API page describe?

A curated, agent-optimized Jentic specification covering 14 Ninox operations across teams, databases, tables, records, and record file attachments. Ninox also publishes its own OpenAPI documentation at https://go.ninox.com/api/docs-json, titled Ninox Public API, which describes a different generation of the API built around workspace and module resources, carries 23 operations, and declares no server URL. The Jentic variant describes the teams-and-databases surface served under this listing's base URL, and Jentic keeps it validated and agent-ready. Get started with Jentic One, the self-hosted execution layer.

What authentication does the Ninox API use?

Ninox uses HTTP bearer tokens. Issue a token from your Ninox account settings and send it as Authorization: Bearer <token>. Through Jentic, the token is held encrypted in the vault and attached server-side.

Can I attach a file to a Ninox record?

Yes. POST /teams/{teamId}/databases/{databaseId}/tables/{tableId}/records/{recordId}/files/{fileName} uploads the binary attachment to the record. The matching GET endpoint downloads it back.

What are the rate limits for the Ninox API?

Ninox enforces per-account rate limits but does not publish exact numbers in this spec. Bulk syncs should batch writes and back off on HTTP 429 responses.

How do I update a Ninox record through Jentic?

Run pip install jentic, search Jentic for 'update a ninox record', and load PUT /teams/{teamId}/databases/{databaseId}/tables/{tableId}/records/{recordId}. Provide a fields object whose keys match the Ninox table column names.

How is this spec different from the ninox.com Ninox API listing?

Both target the same api.ninox.com/v1 base URL. The ninoxdb.de spec exposes 14 endpoints - it adds GET routes for individual team/table inspection, table fields, and record file uploads/downloads, beyond the 9 covered by the ninox.com listing.

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

Yes. Because you run Jentic One yourself, your own rules decide which Ninox operations and which token the agent may use. Since the team and database IDs sit in the URL path, a rule can pin the agent to a single database, letting it read table fields and create records there and nothing else. You choose the operations it may call, so a destructive route like DELETE on a record stays off unless you explicitly add it.

Ninoxdb De Ninox API

Name: Ninox API
Brand: Ninox API
Availability: InStock

Agent-ready OpenAPI document · curated by JenticStorageDatabasebearer14 EndpointsREST

Know of an official OpenAPI document? Contribute it →

For Agents

Read and write records, manage tables, and upload file attachments on Ninox through 14 endpoints under api.ninox.com/v1.

Use for: List the teams accessible to my Ninox API key, Inspect the schema fields of a Ninox table, Create a record in a Ninox table, Upload a PDF attachment to a Ninox record

Not supported: Does not handle Ninox formula scripting, view configuration, or user permissions - use for Ninox records, table schema reads, and record file attachments only.

This page describes a curated, agent-optimized Jentic OpenAPI specification for Ninox API (ninoxdb.de variant), covering 14 operations and kept validated and agent-ready. Ninox also publishes its own OpenAPI document, which describes a different generation of the API built around workspace and module resources, carries 23 operations, and declares no server URL, so the two specs share no paths and Jentic keeps this teams-and-databases variant alongside it. Ninox is a low-code database platform popular with European teams under the ninoxdb.de domain. This spec covers the same REST surface as the ninox.com listing but adds GET endpoints for individual teams, individual tables, and table fields, plus file download and upload routes for record attachments. The team-database-table-record hierarchy is unchanged, and authentication is the same bearer token issued from the Ninox account settings.

Jentic One on Github View OpenAPI Document

Connect the Ninox API to your agent

Capabilities

Start building with Ninox API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs

Ninoxdb De Ninox API