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.
Get started with Benetics API in minutes using your preferred integration method.
# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
"jentic": {
"url": "https://api.jentic.com/mcp",
"auth": "oauth"
}
}
# Then ask your agent:
"create a construction project task"
# → Jentic returns the GET /events tool with parameter schema, agent executes.What an agent can do with Benetics API 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
Trigger and download project export bundles
GET STARTED
Use for: I need to create a new construction project on Benetics, Upload a new plan revision to a project, List all open tasks on a project, Get the latest daily report submission for a site
Not supported: Does not handle accounting, payroll, or material procurement — use for construction project plans, site tasks, daily reports, and webhook events only.
Jentic publishes the only available OpenAPI document for Benetics API, keeping it validated and agent-ready.
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.
Subscribe webhooks to react to project, task, and document events
Patterns agents use Benetics API 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
46 endpoints — jentic publishes the only available openapi specification for benetics api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/projects
Create a new construction project
/projects/{project_id}/tasks
List tasks on a project
/projects/{project_id}/plans/{plan_id}/versions
Add a new plan revision
/projects/{project_id}/reports/{report_id}/submissions
List submissions for a daily report
/file-uploads
Upload a file artefact
/webhooks
Register a webhook subscription
/projects/{project_id}/exports
List export bundles for a project
/projects
Create a new construction project
/projects/{project_id}/tasks
List tasks on a project
/projects/{project_id}/plans/{plan_id}/versions
Add a new plan revision
/projects/{project_id}/reports/{report_id}/submissions
List submissions for a daily report
/file-uploads
Upload a file artefact
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.
Alternatives and complements available in the Jentic catalogue.
Asana API
General-purpose project and task management alongside Benetics' construction-specific workflows
Use Asana for cross-team project tracking; pair with Benetics when site-specific plans, reports, and submissions are required.
Monday.com API
Configurable work management platform that can model construction tasks but lacks plan revisioning
Choose Monday for flexible work boards across departments; pick Benetics when the agent needs construction-native plan versions and daily site reports.
Trello API
Lightweight kanban for task tracking without construction-specific resources
Use Trello for simple board-based task flows; choose Benetics when project plans, file uploads, and submissions are needed in one system.
Specific to using Benetics API 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.
/webhooks
Register a webhook subscription
/projects/{project_id}/exports
List export bundles for a project