Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Fulcrum 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%2Ffulcrumapp.com%2Ffulcrumapp-fulcrum" | 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%2Ffulcrumapp.com%2Ffulcrumapp-fulcrum" | 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 Fulcrum API.
Create and update Fulcrum forms that drive mobile field data collection
Submit new field records against an existing form
Retrieve a single record with all captured field values
List users in the Fulcrum organisation for assignment and audit
Download photo media captured against a record at full size or large preview
GET STARTED
Patterns agents use Fulcrum API for, with concrete tasks.
★ Field Inspection Submission
When a back-office system needs to seed a Fulcrum field crew with inspection records, an integration calls POST /records with the form_id, geometry, and form_values payload. Crews then complete the records on the mobile app and the office can pull them back via GET /records/{id} for downstream reporting.
Create a Fulcrum record on form_id abc123 with a point geometry and form_values for a site inspection
Form Lifecycle Management
Operations teams keep field forms in sync with policy. The forms endpoints support GET /forms to list current templates, PUT /forms/{id} to roll out updated questions, and DELETE /forms/{id} to retire deprecated workflows. Schema changes propagate to the Fulcrum mobile clients on next sync.
Update form abc123 with a new required field and verify the response shows the updated schema
Photo Retrieval for Reports
Inspection photos captured on the Fulcrum mobile app can be pulled by access_key via GET /photos/{access_key} for full size or GET /photos/{access_key}/large for a downsized variant. This lets a reporting service build PDF or HTML reports that embed the original field imagery.
Download the large variant of a photo by access_key for inclusion in an inspection report
Agent-Driven Field Operations
An AI agent receives a request to brief on yesterday's inspections, lists records via GET /records filtered by date, retrieves the highest-priority record in detail, and downloads the most relevant photo via /photos. Through Jentic the X-ApiToken stays in the vault.
Search Jentic for 'list fulcrum records', load GET /records, execute filtered by created_after, and summarise the top three
13 endpoints — jentic publishes the only available openapi specification for fulcrum api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/forms
List forms in the organisation
/forms
Create a new form
/forms/{id}
Update an existing form
/records
Submit a new record against a form
/records/{id}
Retrieve a record with field values
/users
List users in the organisation
/photos/{access_key}/large
Download a large preview of a captured photo
/forms
List forms in the organisation
/forms
Create a new form
/forms/{id}
Update an existing form
/records
Submit a new record against a form
/records/{id}
Retrieve a record with field values
/users
List users in the organisation
/photos/{access_key}/large
Download a large preview of a captured photo
What agents get from Jentic-routed access to this vendor.
Setup
Wiring Fulcrum by hand means sending an X-ApiToken header on every call to api.fulcrumapp.com and learning the forms, records, users, and photos routes yourself. Through Jentic you install once, import Fulcrum from the API Directory, store the token once, and your agent calls it.
Permission scoping
Fulcrum submits forms and records through the request body on routes like /forms and /records, so you limit the agent to the operations it needs, such as listing forms or submitting a record. You choose which operations it may call, so updating a form is not included unless you add it.
Credential isolation
Your Fulcrum token is stored once, encrypted, by your own Jentic One instance and injected into the X-ApiToken header at execution time. It never enters the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'submit a Fulcrum record' or 'list Fulcrum forms', and Jentic returns the matching POST /records or GET /forms operation with its input schema so the agent calls the right endpoint without reading the field-collection docs.
Alternatives and complements available in the Jentic catalogue.
Specific to using Fulcrum API through Jentic.
Why is there no official OpenAPI spec for Fulcrum API?
Fulcrum does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Fulcrum 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 Fulcrum API use?
Fulcrum uses an API token sent as the X-ApiToken header. The token is generated in the Fulcrum web app under integrations. Jentic stores the token encrypted in your Jentic One instance and injects it into the X-ApiToken header at execution time.
Can I create a record on an existing Fulcrum form?
Yes. POST /records with form_id and a form_values object that conforms to the form schema. Optional latitude, longitude, and altitude fields attach geospatial context. The response includes the created record id.
What are the rate limits for the Fulcrum API?
Fulcrum applies per-account throttling that varies with plan. As a guideline keep concurrent calls under five and back off on any 429 responses; bulk syncs should run sequentially rather than in parallel.
How do I download a record's photo through Jentic?
Search Jentic for 'download a fulcrum photo', load the GET /photos/{access_key} schema (or /photos/{access_key}/large for a smaller variant), and execute with the access_key from the record's photos array.
Which Fulcrum API should I pick - fulcrum or fulcrum-api?
This Fulcrum spec covers the core 13 endpoints for forms, records, users, and photos. Use the fulcrum-api spec when you need the wider 61-endpoint surface including projects, choice lists, memberships, and webhooks.
Can I limit what my agent is allowed to do with the Fulcrum API?
Yes. Jentic One is self-hosted, so your own rules decide which Fulcrum operations and credentials the agent can use. You can allow just the calls it needs, such as listing forms with GET /forms or submitting a record with POST /records, while excluding others. Because you pick the operations, an action like updating a form with PUT /forms/{id} is not available unless you explicitly add it.
Know of an official OpenAPI document? Contribute it →
For Agents
Manage Fulcrum forms and field-collection records, list users, and pull photos captured in the mobile app.
Use for: Create a new Fulcrum form for site inspections, Submit a field record against an inspection form, Retrieve a Fulcrum record by ID, List all users in the Fulcrum organisation
Not supported: Does not handle billing, project hierarchy, or webhook subscriptions - use for the core forms, records, users, and photos workflow only.
Jentic publishes the only available OpenAPI specification for Fulcrum API, keeping it validated and agent-ready. Fulcrum is a mobile data collection platform used for field inspections, asset surveys, and geospatial data capture. This streamlined edition of the API exposes 13 endpoints centred on apps (forms), records, users, and photo retrieval, ideal for read-and-write integrations that do not need the full object surface. Authentication uses an X-ApiToken header.