Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Bimbala 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%2Fbimbala.com%2Fbimbala" | shStep 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%2Fbimbala.com%2Fbimbala" | 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 Bimbala API.
Create new resources on the Bimbala platform via POST /resources
List existing resources to drive dashboards or sync jobs
Retrieve a single resource by ID for detailed display
List the platform's user records
Look up an individual user by ID for membership or assignment workflows
GET STARTED
Patterns agents use Bimbala API for, with concrete tasks.
★ Resource Inventory Sync
Operations teams want a daily snapshot of what exists on the Bimbala platform exported to a BI tool or sheet. The Bimbala API exposes GET /resources for listing and GET /resources/{id} for detail enrichment, which is the supported pattern for a nightly sync. Setup is typically half a day for a one-way export.
Pull all resources via GET /resources, then for each resource fetch its detail via GET /resources/{id} and write the combined record to a Google Sheet.
Resource Creation from External Triggers
Teams want to create a new Bimbala resource when an external event fires - a form submission, a Slack command, or a CRM update. POST /resources is the supported entry point for that flow, and GET /resources/{id} provides immediate confirmation that the new record was persisted. Setup is half a day for a single trigger source.
On a webhook event, create a new resource via POST /resources with the supplied payload, then confirm the resource exists via GET /resources/{id}.
User Lookup for Internal Tools
Internal tools and helpdesks need to look up Bimbala users by ID when answering support requests. GET /users returns the full user list and GET /users/{id} returns a single user, so a lightweight directory-style lookup tool can be wired up in under a day. The two read-only endpoints keep the integration simple to maintain.
Given a user ID supplied by the helpdesk, retrieve the full user record via GET /users/{id} and display it in the support console.
AI Agent Bimbala Assistant via Jentic
An AI assistant for Bimbala-using teams can create resources and look up users from natural-language requests routed through Jentic. The bearer token is held in your Jentic One instance, so the assistant never sees the raw secret. Search-load-execute through Jentic gets the assistant live in under an hour.
Search Jentic for 'create a Bimbala resource', load the POST /resources schema, and execute it with the supplied resource payload.
5 endpoints — jentic publishes the only available openapi specification for bimbala api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/resources
Create a new resource
/resources
List all resources
/resources/{id}
Retrieve a resource by ID
/users
List all users
/users/{id}
Retrieve a user by ID
/resources
Create a new resource
/resources
List all resources
/resources/{id}
Retrieve a resource by ID
/users
List all users
/users/{id}
Retrieve a user by ID
What agents get from Jentic-routed access to this vendor.
Setup
Wiring the Bimbala API by hand means carrying its bearer token on every call and building each resource and user path yourself. Through Jentic you install once, import Bimbala from the API Directory, store the token once, and your agent calls it.
Permission scoping
Bimbala puts the resource id in the URL path (/resources/{id}, /users/{id}), so a rule can pin your agent to one resource: it can read that resource and user records and nothing else. You choose the operations it may call, so creating a resource is not included unless you add it.
Credential isolation
Your Bimbala 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 'create a Bimbala resource' or 'read a user record', and Jentic returns the matching Bimbala operation with its input schema so the agent calls the right endpoint without browsing the reference docs.
Alternatives and complements available in the Jentic catalogue.
Specific to using Bimbala API through Jentic.
Why is there no official OpenAPI spec for Bimbala API?
Bimbala does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Bimbala API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.
What authentication does the Bimbala API use?
The Bimbala API uses HTTP bearer token authentication. You supply the token in the Authorization header as Authorization: Bearer <token>. When called via Jentic, the bearer token is held in your Jentic One instance so the raw value never reaches the agent's context.
Can I create a new resource through the Bimbala API?
Yes. POST /resources accepts a JSON payload describing the new resource and creates it on the platform. GET /resources/{id} can then be used to confirm the new record exists and inspect server-assigned fields.
What are the rate limits for the Bimbala API?
The current spec does not declare explicit numeric rate limits. Treat 429 responses as the signal to back off, and call the Jentic SDK, which retries on 429 with exponential back-off so high-volume jobs do not have to handle this by hand.
How do I list all Bimbala resources through Jentic?
Search Jentic for 'list Bimbala resources', which surfaces GET /resources. Load the schema and execute. The Python flow is: pip install jentic, then await client.search, await client.load, await client.execute.
Can I look up Bimbala users by ID?
Yes. GET /users returns the list of users on the platform, and GET /users/{id} returns a single user record by ID. Both endpoints are read-only in the current spec.
Can I limit what my agent is allowed to do with the Bimbala API?
Yes. Because you run Jentic One yourself, your own rules decide which Bimbala operations and credentials the agent may use, and by default it can call none of them until you allow specific ones. Since Bimbala puts the resource ID in the URL path (GET /resources/{id}, GET /users/{id}), you can pin the agent to reading a single resource and user records while excluding everything else. Creating a resource via POST /resources is not available to the agent unless you explicitly add that operation, and your stored bearer token is injected at execution time rather than exposed to the agent.
Know of an official OpenAPI document? Contribute it →
For Agents
Manage Bimbala platform resources and look up user records via a small REST surface.
Use for: I want to create a new resource on Bimbala, List all resources I have access to, Get the details of a specific resource by ID, List all users on the Bimbala platform
Not supported: Does not handle billing, authentication management, or write operations on users - use for managing Bimbala resources and reading user records only.
Jentic publishes the only available OpenAPI specification for Bimbala API, keeping it validated and agent-ready. The Bimbala API is the programmatic interface to the Bimbala platform, exposing endpoints to manage resources and look up user records. The current spec covers five endpoints: list and create resources, retrieve a single resource by ID, and list and retrieve users. Authentication is by HTTP bearer token.