> For the complete documentation index, see [llms.txt](https://changelog.visilean.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://changelog.visilean.com/changelog/release-6.0-2026/visilean-api-portal-securely-connect-visilean-to-your-tools-ai-and-workflows.md).

# VisiLean API Portal: Securely connect VisiLean to your tools, AI, and workflows !

Construction teams rarely run on a single system. Progress is reported in VisiLean, then retyped into the ERP. Constraint data is exported, cleaned, and pasted into Power BI every week. Anyone who wants a quick answer about what's running late has to open the plan and filter their way to it. The API Portal closes these gaps by giving your systems, and AI assistants like Claude, a secure and controlled route into your live VisiLean projects.

#### Why This Matters

Every manual handoff between systems is a chance for data to drift. Double entry costs planners hours each week, management reports lag behind site reality, and nobody is quite sure which figure is current. Integrations built without proper controls bring a different risk: shared credentials, no record of what changed, and no clean way to switch a connection off. Your team needs connected data, but it needs it under your own control.

#### What's New?

* **Scoped API keys:** Create keys limited to exactly what each integration needs, with read or write access across projects, tasks, locations, zones, trades, constraints, and custom fields. Set an expiry of 1 to 365 days. You can rotate a key with a 24-hour grace period or revoke it instantly.
* **OAuth2 credentials:** Set up server-to-server connections that run with nobody logged in, such as a nightly ERP sync.
* **Sandbox and live data:** Sandbox keys only ever see demo data, so developers can build and test without any risk to a real project.
* **API Reference, Playground, and samples:** Every request is documented with a "Try it" panel on sandbox data. You also get a free-form request tester, copy-paste examples in cURL, Python, Node.js, and Java, and a ready-made Postman collection.
* **MCP connector for AI assistants:** Connect Claude, Claude Code, or Cursor using your normal VisiLean login. The connection is read-only by default. With your approval, the assistant can also create and update tasks, constraints, locations, zones, and trades, across 39 actions in total.
* **Webhooks (Beta):** VisiLean messages your system when a task is created, updated, deleted, changes status, or receives a comment. Failed messages are retried automatically, and every delivery is recorded in a delivery log.
* **Monitoring and governance:** You get personal and organisation-wide usage analytics, live rate-limit tracking, and a view of every key and OAuth client in your workspace. An audit log records every change made through the API and keeps it for two years.

#### How It Helps: Three Example Use Case Scenarios

A Project Manager connects Claude ahead of the Monday coordination meeting and asks which tasks on Tower B are behind this week and which constraints are still open on level 3. The answers come straight from the live plan, with no exports or filters, and the connection stays read-only throughout. The PM walks into the meeting with the list already in hand.

A Process Manager creates a sandbox key so the ERP team can build and test their integration against practice data. Once it's proven, they issue a live key scoped to read tasks only. Every night the ERP pulls the latest progress automatically, and the Rate Limits page confirms the job is running comfortably within its allowance.

A Planner spots an unexpected date change on a critical task. Project history shows which colleague's integration made the change, and the Audit Logs confirm the key, time, and IP address. The question is settled in minutes, and the right person is contacted directly.

{% hint style="info" %}

#### Key Considerations & Caution Points

**Off by default:** The API Portal is switched off for every company until VisiLean enables it. Contact VisiLean support to have it switched on for your workspace.

**Process Manager access:** Only Process Managers can open the portal website. Once the portal is enabled, any team member can connect an AI assistant, which can only do what that person is already allowed to do in VisiLean.

**Changes appear as a person:** Changes made through the API are recorded in project history under the login used. For an AI assistant, that is the person who connected it. For an OAuth2 integration, it is the person who created the OAuth client.

**Keys are shown once:** A full API key is displayed only at the moment it is created. If a key is lost, rotate it or create a new one.

**One OAuth client per workspace:** Each workspace can currently have one set of OAuth2 credentials.\
\
**Webhooks are in Beta.** They currently fire only for changes made through the API or an AI assistant, not for changes made in the VisiLean app. Messages missed while a webhook is failing are not resent after it is reactivated.
{% endhint %}

{% hint style="warning" %}
We're actively gathering feedback to enhance the feature in future updates.
{% endhint %}

<br>
