Know of an official OpenAPI document?
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Dalux Field 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%2Fdalux.com%2Fdalux" | 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%2Fdalux.com%2Fdalux" | 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 Dalux Field API.
Read projects, their metadata, users, and companies
Browse file areas, folders, files, and version sets
Retrieve file content and revision history
Read tasks, approvals, safety issues, and observations
Browse inspection plans, test plans, and their registrations
Upload files in chunks and retrieve project forms
Patterns agents use Dalux Field API for, with concrete tasks.
★ Construction document access
Field and office teams need the latest drawings and files from a project. The Dalux Field API browses file areas, folders, files, and version sets and retrieves file content, so a tool can surface the current document for a given project.
Browse a project's file areas and retrieve the latest revision of a named file
Safety and inspection tracking
Site managers track safety issues and inspection progress. The API reads tasks, approvals, safety issues, observations, and inspection and test plan registrations, so a dashboard can report open items per project.
List a project's safety issues and inspection plan registrations and summarize open items
Agent-driven field assistant
A field assistant can answer project questions and file documents. Through Jentic, an agent resolves a request about a project into reading its files and tasks and, when asked, uploading a document through the chunked upload flow.
Read a project's open tasks and files, then upload a new document to the right file area
59 endpoints — dalux field is a construction field-management platform, and this api (trybuildapi) exposes its project data.
METHOD
PATH
DESCRIPTION
/5.1/projects
Get all available projects
/5.0/projects/{projectId}
Get a specific project
/5.1/projects/{projectId}/file_areas
Get a project's file areas
/6.0/projects/{projectId}/file_areas/{fileAreaId}/files
Browse files in a file area
/5.1/projects/{projectId}/tasks
Retrieve tasks, approvals, and safety issues
What agents get from Jentic-routed access to this vendor.
Setup
Dalux wiring is one company API key plus 59 project operations with versioned path prefixes. With Jentic One you install once, import the operations you need from the API Directory, and keep the key in one place.
Permission scoping
Projects, file areas, and files are addressed by ids in the path, so you can scope an agent to specific projects and to read operations while keeping file uploads out of reach.
Credential isolation
Your Dalux API key is stored encrypted by your own Jentic One instance and injected when a call runs, so it never enters the agent's prompt, logs, or context.
Intent-based discovery
Agents find the right Dalux operation through Jentic's intent search, matching a request like listing a project's files to the matching endpoint.
Alternatives and complements available in the Jentic catalogue.
Specific to using Dalux Field API through Jentic.
How does the Dalux Field API authenticate?
Dalux expects a company-specific API key in the `X-API-KEY` header, tied to an API identity in your Dalux settings. Jentic One stores that key and injects it at execution time.
Can I limit what my agent is allowed to do with Dalux Field?
Yes. Projects, file areas, and files are addressed by ids in the path, and the surface is almost entirely read plus file upload, so you can scope an agent to reading documents on specific projects while withholding uploads.
Can the API upload files?
Yes, through a chunked upload flow: create an upload slot, send the parts, then finalize the upload so the file lands in the chosen file area.
Does Dalux Field cover drawings and documents?
Yes. File areas, folders, files, and version sets hold the project's documents and drawings, and the API can retrieve file content and revision history.
What is TryBuildAPI?
TryBuildAPI is the title of the Dalux Field OpenAPI spec; it is the same interface described here for reading Dalux Field project data and uploading files.
GET STARTED
/1.0/projects/{projectId}/file_areas/{fileAreaId}/upload
Create a file upload slot
/5.1/projects
Get all available projects
/5.0/projects/{projectId}
Get a specific project
/5.1/projects/{projectId}/file_areas
Get a project's file areas
/6.0/projects/{projectId}/file_areas/{fileAreaId}/files
Browse files in a file area
/5.1/projects/{projectId}/tasks
Retrieve tasks, approvals, and safety issues
/1.0/projects/{projectId}/file_areas/{fileAreaId}/upload
Create a file upload slot
For Agents
Lets an AI agent read Dalux Field construction projects, documents, version sets, tasks, inspections, and forms, and upload files, using a company API key.
Use for: I need to list all projects on the company profile, Browse the folders and files in a project's file area, Download a specific file revision, List the safety issues on a project
Not supported: Does not handle accounting, procurement, or scheduling data: use it to read Dalux Field projects, documents, and tasks and to upload files only.
Dalux Field is a construction field-management platform, and this API (TryBuildAPI) exposes its project data. With a company API key, an integration can read projects and their metadata, users and companies, work packages, file areas, folders, files and version sets, and the full task surface of approvals, safety issues, observations, inspection plans, test plans, and forms. It also supports chunked file uploads and a company directory of registered firms.
This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.
Base layer of spec validity and structural soundness.
Aggregated quality score from linter diagnostics, weighted by severity.
Percentage of `$ref` references that resolve successfully.
Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).
Structural correctness score based on schema issues using logarithmic dampening.
Clarity, completeness, and ingestion readiness for developers and tooling.
How richly the API is illustrated with examples.
Percentage of examples that conform to their schemas.
Percentage of operations with complete response definitions (success, client error, server error).
Health of API ingestion, bundling, and resolution within Jentic pipelines.
Semantic breadth, depth, and agent comprehension for AI systems.
Coverage of descriptions across API elements.
Coverage of RFC 9457 Problem Details for error responses.
Coverage, uniqueness, and casing consistency of operationIds for AI inference.
Coverage of summaries across operations/tags/info.
Functional utility, complexity comfort, and AI orchestration readiness.
Agent comfort level based on API operational and structural complexity.
Trust, risk posture, and security compliance.
Average quality of security schemes based on authentication method strength (weakest link for OAuth2).
Findability, semantic richness, and reasoning readiness.
Clarity and depth of descriptions across API elements.
Score it yourself
Every API in the directory is allowlisted, so you can re-score it with no key required.
npx @jentic/api-scorecard-cli score <openapi-url>