Benetics API

Name: Benetics API
Brand: Benetics API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentProductivityCollaborationbearer46 EndpointsREST

For Agents

Manage construction projects, plan revisions, site tasks, and daily reports on Benetics. Subscribe to webhooks to react to project activity in real time.

Install Jentic One Beta

Connect the Benetics API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Benetics 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 | sh

Step 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 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 Benetics API.

Create and update construction projects and their members

Upload plan drawings and manage versioned plan revisions

Track punch-list and site tasks scoped to a project

Retrieve daily report submissions captured by site teams

GET STARTED

Start building with Benetics API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI specification for Benetics API, keeping it validated and agent-ready. The Benetics API exposes a cloud construction efficiency platform: projects, plan drawings with versioned revisions, tasks, daily reports and submissions, members, file uploads, exports, and webhooks. Site teams and back-office tools use it to push plans, capture site reports, manage punch-list tasks, and stream activity to downstream systems via webhook subscriptions. The spec covers 46 endpoints across nine resources scoped to a single workspace.

Use Cases

Patterns agents use Benetics API for, with concrete tasks.

★ Plan Revision Distribution

Push the latest design drawings into Benetics so site supervisors always work from current plans. The plans and plan-versions endpoints store revisions against a project, and file uploads handle the underlying drawing artefacts. A small integration with a CAD or document management system can be wired up in around a day using POST /projects/{project_id}/plans and POST /projects/{project_id}/plans/{plan_id}/versions.

Upload a new plan PDF via POST /file-uploads, then POST /projects/{project_id}/plans/{plan_id}/versions referencing the uploaded file id

Daily Site Report Aggregation

Pull daily report submissions from active projects into a head-office dashboard or BI pipeline. The reports and submissions endpoints expose structured site data that can be aggregated by project or member. Building a nightly extract over GET /projects/{project_id}/reports and the submissions sub-resource is typically half a day of work.

Iterate every active project, GET /projects/{project_id}/reports, and for each report fetch /submissions to collect yesterday's site entries

Webhook-Driven Task Automation

Use webhook subscriptions to notify a project management or messaging tool whenever a task is created, completed, or reassigned. POST /webhooks registers a callback URL and event filter, and the webhook resource lifecycle is fully managed via the API. End-to-end setup including signature verification typically takes under a day.

POST /webhooks subscribing to task.updated events for a target project, then handle incoming events by posting a summary to a Slack channel

AI Agent for Site Operations

An AI agent uses Jentic to discover Benetics operations and automate routine site administration: opening tasks from RFI emails, posting plan revisions, or pulling end-of-day reports for a stand-up summary. The agent searches by intent, loads the operation schema from Jentic, and executes against Benetics without browsing the 46-endpoint reference. Through Jentic, integration takes under an hour.

Search Jentic for 'create project task on benetics' and execute the returned operation to open a task with title, description, and assignee

Key Endpoints

46 endpoints — jentic publishes the only available openapi specification for benetics api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

POST

/projects

Create a new construction project

GET

/projects/{project_id}/tasks

List tasks on a project

POST

/projects/{project_id}/plans/{plan_id}/versions

Add a new plan revision

GET

/projects/{project_id}/reports/{report_id}/submissions

List submissions for a daily report

POST

/file-uploads

Upload a file artefact

POST

/webhooks

GET

/projects/{project_id}/exports

List export bundles for a project

POST

/projects

Create a new construction project

GET

/projects/{project_id}/tasks

List tasks on a project

POST

/projects/{project_id}/plans/{plan_id}/versions

Add a new plan revision

GET

/projects/{project_id}/reports/{report_id}/submissions

List submissions for a daily report

POST

/file-uploads

Upload a file artefact

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Benetics bearer tokens are stored encrypted in the Jentic vault. Agents receive scoped execution rights — the Authorization header is injected at execution time and never appears in the agent's context window.

Intent-based discovery

Agents search Jentic by intent such as 'create a project task' or 'upload plan revision' and Jentic returns the matching Benetics operation with its parameter schema, removing the need to read the 46-endpoint reference manually.

Time to first call

Direct Benetics integration: 1 to 3 days to handle bearer auth, file uploads, and webhook signature verification. Through Jentic: under 1 hour — search, load schema, execute.

FAQs

Specific to using Benetics API through Jentic.

Why is there no official OpenAPI spec for Benetics API?

Benetics does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Benetics API via structured 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 Benetics API use?

The Benetics API uses HTTP Bearer authentication — clients send Authorization: Bearer <token> on every request. When called via Jentic, the token is stored encrypted in the Jentic vault and injected at execution time so the bearer secret never enters the agent context.

Can I manage plan revisions through the Benetics API?

Yes. POST /projects/{project_id}/plans creates a plan, and POST /projects/{project_id}/plans/{plan_id}/versions adds a new revision referencing a previously uploaded file id from POST /file-uploads. GET on the same paths lists existing plans and versions.

How do I subscribe to project events through Jentic?

Run pip install jentic and search for 'subscribe to benetics webhook'. Jentic returns the POST /webhooks operation, the agent loads the schema, and executes with the callback URL and event filter. Webhook subscriptions are then managed via GET, PATCH, and DELETE on /webhooks/{webhook_id}.

What rate limits apply to the Benetics API?

The OpenAPI specification does not document explicit rate limits. Treat 429 responses as a signal to back off and consult the live developer site at https://developer.benetics.io for current quotas before running bulk syncs.

Can I export a finished project via the API?

Yes. GET /projects/{project_id}/exports lists export bundles for a project, and GET /projects/{project_id}/exports/{export_id} returns a specific export so an integration can hand off the bundle to a long-term archive or document management system.

Benetics API

Connect the Benetics API to your agent

Capabilities

Start building with Benetics API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs