Connectors

A connector keeps a workspace up to date from a tool you already use. Each connector is one source, one login and the one workspace it keeps in sync. Aplas only reads from the source; it never changes anything there.

LeanIX is the source you can connect today. Confluence is listed in setup as Coming soon.

Connectors sits in the studio nav, and every v2 organization has it on every plan. You can also reach it from Import data (Keeping a workspace in sync with LeanIX?) and from a new workspace's first screen (Coming from LeanIX?).

Who can do what

Before you start

You need two things from LeanIX:

• Your LeanIX address. Copy it from your browser's address bar while you're signed in to LeanIX — any page will do.
• An API token from a LeanIX technical user with the Viewer role. Viewer is enough because Aplas only reads.

To make the token:

1. In LeanIX, open Administration, then Technical Users.
2. Create a technical user named Aplas.
3. Give it the Viewer role.
4. Copy the API token LeanIX shows you. LeanIX shows it once.

LeanIX's own guide is Technical users.

Setting up a connector

Choose Connectors, then New. Setup takes three steps, and nothing is added to your workspace until the last one.

Step 1 — Where from? Choose LeanIX.

Step 2 — Log in to LeanIX. Paste Your LeanIX address and the LeanIX API token. If you know when the token ends, add it as the Token end date — Aplas reminds you two weeks before, so syncing doesn't stop. If your organization has more than one workspace, choose the one to keep in sync; with one workspace, everything comes into it.

Then Check login and continue. If LeanIX refuses, the reason shows under the field it concerns:

LeanIX refused this token. Check it's current and has the Viewer role, then paste it again.
That isn't a LeanIX address. Copy the address from your browser while you're in LeanIX.

Step 3 — What will come in. Aplas reads your LeanIX workspace and shows what a sync would do before anything is written:

• New — assets that will be created
• Already in your inventory — kept up to date — assets you already have, which the connector takes over instead of duplicating
• Not added — your plan is full — new assets past your plan's allowance (see Your plan's allowance)

Each LeanIX fact sheet type is listed with the asset type it becomes and a switch to bring it in or leave it out. Bring in N assets confirms and starts the first sync; Finish later keeps the connector as Not started so you can come back to it.

Where LeanIX lands

In a new workspace, each fact sheet type becomes its own asset type:

A LeanIX workspace uses either projects or transformations, so those types start switched off — switch on the one yours holds. The lifecycle becomes the asset's status, with each dated phase kept as a date field. An interface's data flow direction is kept as the integration's Direction. Fields and relations an asset type needs are added to the workspace on the first sync.

An asset already in your inventory is matched when it has the same type and the same name as a fact sheet, ignoring case, and is the only one that does. It is kept, and kept up to date — not copied.

What couldn't be placed

Anything the rules have no home for — a custom LeanIX field, a tag group, a relation, a type Aplas doesn't recognise — is listed under Left out for now, with a count. Each item defaults to Leave it out. You can give it a home instead: a new field built from the LeanIX field (a LeanIX list keeps its options and colours), an existing field, or a new asset type.

Where AI can suggest a home, the item shows AI suggested, the target, the reason and what it was based on. A suggestion does nothing until a person chooses Accept; choosing anything else withdraws it.

How a connector keeps in sync

A connector syncs every 15 minutes, and whenever someone chooses Sync now. The 15-minute syncs read what changed in LeanIX since the last one. Sync now, and a Daily check once a day, read everything.

An unchanged fact sheet writes nothing, so a quiet LeanIX workspace leaves no trail of empty changes.

LeanIX owns the fields it fills. In the asset panel they carry a lock, and the panel says Fields with a lock are kept in sync from LeanIX — change them there. Every other field on the asset is yours, and a sync never touches it. The panel also shows Synced from LeanIX · Open in LeanIX, which takes you to the fact sheet.

Relations you draw survive. A sync adds and removes only the relations it created itself.

When something changes in LeanIX:

If one sync would remove more than half of what the connector brought in, Aplas removes nothing and says so. That usually means the token lost access to part of LeanIX, not that your estate shrank.

Recent changes groups a connector's work by sync, under the connector's name — LeanIX synced 12 assets — rather than listing each asset.

Your plan's allowance

A sync follows the same plan rules as an import, whether it runs on its own or you choose Sync now. Updates to assets you already have always arrive. New assets beyond your plan's allowance wait under Not added — your plan is full, and come in on a later sync once the workspace has room — change the plan, or remove assets you no longer need.

Keeping an eye on it

Each connector's card says where it stands — for example Last sync 12 minutes ago · next in 3 minutes — with a status:

A connector needs attention when LeanIX refuses the token, when the token has expired or ends within two weeks, or when the last sync couldn't finish. A failed sync tries again at the next one.

History lists every sync — First sync, Automatic, Sync now or Daily check — and what it did. It also holds Changes from LeanIX (archived and no-longer-there fact sheets) and Needs your attention (new assets waiting for room in your plan, and anything not brought in).

Emails. Your organization's owners and admins are emailed when a connector stops syncing, and when its token's end date is two weeks away. The email links straight to the connector.

Changing or removing a connector

Settings holds the connector's name, the LeanIX address and the login. The token is never shown again — only its last four characters — and replacing it means pasting a new one, which is checked with LeanIX before it is saved. The workspace is fixed: to keep another workspace in sync, set up another connector.

Remove stops the connector and deletes its LeanIX login. The assets, fields and relations it brought in stay, and you can edit them freely.

Moving from v1

When your organization moves from v1 to v2, its LeanIX connector comes with it, token included, so nobody has to make a new one. It brings in the same fact sheet types it did in v1, keeps your assets as they are rather than duplicating them, and shows Carried over from v1 with its LeanIX token. Sync now to check it matches what's here. A connector that was disabled in v1 arrives paused.

GitHub, Confluence and ServiceNow connectors do not move across.

Security and AI

• The token is encrypted when you save it and is never shown again, to anyone. Aplas uses it only to read from LeanIX.
• AI is used at setup only, to suggest a home for what the rules couldn't place. It sees the names, types and a few example values of those items, and your workspace's asset types and fields. It never sees the token, the address or your owners' email addresses, and it never decides what a sync writes — a person accepts each suggestion.
• Suggestions draw on your organization's ordinary AI allowance and are processed with AWS Bedrock in your region. If an administrator has turned AI off under Configuration > Settings, setup lists the same items without suggestions, and you place them yourself.