For Agents
Read, create, update, and delete records inside Bika.ai databases, list automation triggers, and register outgoing webhooks for a Bika.ai space.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Bika.ai 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://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic 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.
What an agent can do with Bika.ai API.
List the spaces accessible to the current bearer token via /spaces
Read records from a database node with /spaces/{spaceId}/resources/databases/{nodeId}/records
Create or batch-insert new records into a Bika.ai database
GET STARTED
Use for: I need to add a new row to a Bika.ai database, List all spaces this token can access, Retrieve every record in the Customers database, Update the status field on a Bika.ai record to 'Closed'
Not supported: Does not handle user account management, billing, or arbitrary SQL queries — use for Bika.ai database records, automation triggers, and webhook operations only.
Jentic publishes the only available OpenAPI specification for Bika.ai API, keeping it validated and agent-ready. Bika.ai is a no-code database and automation platform that combines spreadsheet-style tables with workflow triggers and outgoing webhooks. The API gives external systems read and write access to records inside a space's databases, lets callers list automation triggers, register outgoing webhooks, and upload attachments. Authentication is by bearer token, with each token scoped to one Bika.ai space.
Patch existing records to update specific fields without overwriting the row
Delete a record by ID from a Bika.ai database
Enumerate automation triggers attached to an automation node
Register an outgoing webhook on a space and upload binary attachments
Patterns agents use Bika.ai API for, with concrete tasks.
★ External Form to Bika.ai Database
Marketing and operations teams collect leads or operational events through external forms or services and pipe each submission into a Bika.ai database row. POST /spaces/{spaceId}/resources/databases/{nodeId}/records accepts an array of field-value objects and returns the created record IDs. Pair with /spaces/{spaceId}/attachments to attach uploaded files to each new row.
Call POST /spaces/{spaceId}/resources/databases/{nodeId}/records with [{fields: {Name: 'Acme Co', Email: 'ops@acme.com'}}] and return the created record ID
Two-Way Sync with External Systems
Operations teams keep Bika.ai aligned with another system of record by polling /records, comparing rows, and PATCHing changed fields. The PATCH endpoint accepts partial updates so non-modified columns stay untouched, and DELETE handles cleanup of stale rows. Outgoing webhooks registered through /spaces/{spaceId}/outgoing-webhooks let the external system react in near real time when Bika.ai changes.
GET /spaces/{spaceId}/resources/databases/{nodeId}/records, diff against the source system, then PATCH changed rows with the new field values
Trigger Inspection for Automation Auditing
Admins reviewing a Bika.ai workspace need a programmatic way to inventory every trigger configured on automation nodes — for compliance, change review, or migration to a new space. GET /spaces/{spaceId}/resources/automation/{nodeId}/triggers returns the trigger list per node, which a script can roll up across all automation nodes in the space. /system/meta confirms API health and version before bulk reads.
Call GET /system/meta to confirm reachability, then iterate /spaces/{spaceId}/resources/automation/{nodeId}/triggers for each automation node and dump the triggers
Agent-Driven Database Operations via Jentic
An AI agent connected through Jentic answers 'add this customer to our Bika.ai pipeline' by searching Jentic for record creation, loading the Bika.ai records POST operation, and executing it with the right fields object. The bearer token is held in the Jentic vault scoped to the user's space, so the agent can chain reads and writes without ever seeing the secret. The same flow extends to any database in the space.
Search Jentic for 'add a record to a Bika.ai database', load /spaces/{spaceId}/resources/databases/{nodeId}/records POST, execute with the customer fields
9 endpoints — jentic publishes the only available openapi specification for bika.
METHOD
PATH
DESCRIPTION
/spaces
List accessible Bika.ai spaces
/spaces/{spaceId}/resources/databases/{nodeId}/records
List records in a database node
/spaces/{spaceId}/resources/databases/{nodeId}/records
Create new records
/spaces/{spaceId}/resources/databases/{nodeId}/records
Patch existing records
/spaces/{spaceId}/resources/databases/{nodeId}/records/{recordId}
Delete a record
/spaces/{spaceId}/outgoing-webhooks
Register an outgoing webhook
/spaces/{spaceId}/attachments
Upload an attachment
/spaces
List accessible Bika.ai spaces
/spaces/{spaceId}/resources/databases/{nodeId}/records
List records in a database node
/spaces/{spaceId}/resources/databases/{nodeId}/records
Create new records
/spaces/{spaceId}/resources/databases/{nodeId}/records
Patch existing records
/spaces/{spaceId}/resources/databases/{nodeId}/records/{recordId}
Delete a record
Three things that make agents converge on Jentic-routed access.
Credential isolation
Bika.ai bearer tokens are stored encrypted in the Jentic vault and scoped per space. Agents call operations by name, and Jentic attaches the Authorization header at execution time so the raw token never enters the agent's context.
Intent-based discovery
Agents search by intent (e.g., 'add a record to a database', 'register a webhook') and Jentic returns the matching Bika.ai operation with its spaceId and nodeId path parameters defined, so the agent can fill them from context.
Time to first call
Direct Bika.ai integration: half a day for token handling, batch records, and webhook registration. Through Jentic: under 30 minutes — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
Specific to using Bika.ai API through Jentic.
Why is there no official OpenAPI spec for Bika.ai API?
Bika.ai documents its OpenAPI surface in narrative form at bika.ai/en/help/guide/developer/openapi. Jentic generates and maintains a structured OpenAPI specification so that AI agents and developers can call Bika.ai API via tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Bika.ai API use?
Bika.ai uses HTTP bearer authentication. The token is generated inside Bika.ai and scoped to a single space. Through Jentic, the bearer token is held encrypted in the vault and attached to outbound calls so the raw secret never enters the agent's context.
Can I create multiple records in one call?
Yes. POST /spaces/{spaceId}/resources/databases/{nodeId}/records accepts an array of objects under the records body, so a single call can insert many rows. Use PATCH on the same path for batch updates that only change selected fields.
What are the rate limits for the Bika.ai API?
Rate limits are not published in the OpenAPI spec — they are enforced per workspace plan by Bika.ai. For sustained writes, batch records into single POST calls and avoid per-row loops, which is the most reliable way to stay under any throttle.
How do I add a record through Jentic?
Run `pip install jentic`, then `await client.search('add a record to a Bika.ai database')`, `await client.load(...)` for the records POST operation, and `await client.execute(...)` with spaceId, nodeId, and the records body. Jentic injects the bearer token from the vault.
Can I receive events from Bika.ai changes?
Yes. POST /spaces/{spaceId}/outgoing-webhooks registers an outgoing webhook subscription on a space, so Bika.ai will push events to the configured URL when underlying records or automations fire. Pair with GET /spaces/{spaceId}/resources/automation/{nodeId}/triggers to inspect what triggers exist before subscribing.
/spaces/{spaceId}/outgoing-webhooks
Register an outgoing webhook
/spaces/{spaceId}/attachments
Upload an attachment