The dashboard organizes everything in two levels: organizations contain client apps, and client apps own recordings.
- An organization is the top-level grouping — a company, a team, a product line, whatever makes sense for you. Recordings are never created directly under an organization; they always belong to one of its client apps.
- A client app is one integration of the recording SDK — typically one app, or one build variant of an app. Each client app has its own API key, which is what your app uses to authenticate uploads (see API Keys).
Creating an organization#
From the dashboard, type a name into the "New organization name" field under Organizations and click Create organization. You immediately become its owner.
Creating a client app#
Select an organization, then create a client app the same way under Client apps. A fresh API key is generated and shown once, in a banner at the top — copy it now, since the raw key isn't displayed again after you navigate away (you can always view it later on the client app's row, or regenerate a new one — see API Keys).
Why the SDK only needs an API key#
A recording authenticates with exactly one credential: the client app's API key. Everything else a recording needs to be filed correctly — which client app, which organization, and which dashboard account owns it — is looked up server-side from that key alone (one client app per key, one organization/owner per client app), never sent or trusted from your app.
This is a deliberate simplification: an earlier version of the SDK also required a dashboard account ID (RECORDING_OWNER_ID) on every upload, self-attested and checked against the client app's own record. Since that value could only ever equal one fixed thing per client app anyway, it was pure redundant configuration — dropped, along with the server URL that used to sit next to it, so integrating the SDK is just "an API key," nothing more.
Deleting#
Deleting an organization cascades to all of its client apps, and deleting a client app cascades to all of its recordings — both are confirmed with a dialog before anything happens, and neither can be undone.
Next steps#
- API Keys — viewing and regenerating a client app's key.
- Inviting Collaborators — giving a teammate access to an organization you own.