Docs / Getting Started

Invite Developers and Collaborators

Who you can invite

Developer

Joins your billing account. Can create and manage workspaces, models, visualizations, and dashboards under it. Only the owner of the billing account can send this invitation.

User (viewer)

Joins one or more specific workspaces with read-only access. Can view dashboards and visualizations, cannot edit. The owner or any developer of the billing account can send this invitation, for workspaces under that billing account.

A new billing account itself is not granted by invitation — Looky Studio provisions it when a customer signs up.

What needs to exist before sending an invitation

  • Inviting a developer: just your billing account. The developer can start from an empty billing account and create their workspaces from scratch after accepting.
  • Inviting a user (viewer): at least one workspace in your billing account with at least one visualization or dashboard published. Otherwise the invitee signs in to an empty screen.

Operational onboarding flow for each new developer

  1. Create and send invitation with explicit scope in the message.
  2. After acceptance, ask the developer to run:
    looky login https://my.looky.studio <local_root>
    looky whoami
    
    cd <local_root>
    looky billing list
    looky billing use <billing_account_id>
  3. Have the developer enter one assigned workspace and run:
    cd <local_root>/<billing_account_id>/<workspace_slug>
    looky status
    looky validate
  4. Confirm they can read dashboards in UI before asking for writes.

Use the narrowest role that still allows the work. This avoids accidental cross-workspace changes and keeps ownership clear.