Skip to main content
Project linking lets a technical owner delegate selected management work to a Business Workspace without sharing an AvraAPI account, project secret, or payment gateway credential.

The connection flow

1

Technical owner creates a Connect Key

From the project dashboard, the technical owner creates a one-time Workspace Connect Key and selects which categories can be delegated.
2

Owner shares the key securely

Send the key only to the intended Workspace owner or authorized manager. It is time-limited and should be treated as sensitive until redeemed.
3

Business Workspace redeems the key

The receiving Workspace redeems the key. The project becomes connected to that Workspace and the selected permissions are stored with the project connection.
4

Workspace members operate within two boundaries

A member needs both the relevant Workspace role permission and the technical owner’s delegated project permission.

Delegated categories

Delegation does not give the Workspace authority to delete the client project or remove the technical owner’s access.

Disconnect or exit safely

The technical owner can return a connected project to their Personal Workspace. If the project has an active UPG slot, the exit flow requires explicit consent because it releases the slot back to the Business Workspace’s available capacity. On a successful exit:
  • the project returns to the technical owner’s Personal Workspace;
  • delegated permissions are cleared;
  • pending Connect Keys are revoked; and
  • active UPG project attachments are released.
Releasing a slot blocks new payment checkout immediately. It does not retroactively cancel a payment session that was already created; its signed completion context may still be completed safely.

When a Workspace is deactivated

Deactivating a Business Workspace does not delete customer projects. Internal projects return to the Workspace owner’s Personal Workspace, while delegated external projects return to each project’s technical owner. Delegation is removed and active UPG attachments are released.
Last modified on October 1, 2026