https://api.luminpdf.com/v1), using a workspace API key that the Workspace Owner creates in Lumin. Configview sends only GET requests. It never creates, changes or deletes anything in Lumin.
You will end up with 1 required secret (LUMIN_API_KEY) in Configview when setup is complete.
Scope of this integration today. Configview reads who is a member of your Lumin workspace (work email, name, role, joined date, last active time), the Spaces (name, member count, created date), the workspace totals, and the user the API key acts as. It never calls the document, signature request, template or agreement endpoints, so no document, PDF, signer or template content is read.
Read this first: the key acts as its creator
- Lumin API keys have no scopes. A key acts as the user who created it, so create it as the Workspace Owner (or a dedicated owner account) to get a complete member list.
- Keys are long-lived: they work until someone deletes them. A workspace can hold at most 4 keys. Rotate by creating a new key, pasting it into
LUMIN_API_KEYand deleting the old one.
What the Lumin API does not tell Configview
The API has no audit log, webhook list, API key list, 2FA or SSO status, pending invites or Space member lists. Configview cannot answer who did what, which keys exist besides its own, or who sits in each Space. Only member counts per Space are known.What you need
- A Lumin workspace and the Workspace Owner to create the key
- Developer settings access in Lumin (API keys can be created from the workspace settings)
Step 1: Open the Lumin page in Configview
https://{companyname}.configview.com/admin/integrations/lumin
Step 2: Create the API key
- Signed in to Lumin as the Workspace Owner, open Settings > Developer settings > API keys
- Create a key named
Configview - Copy the key now
- In Configview paste it into
LUMIN_API_KEYunder Credentials and click the save icon
Step 3: Connect and verify
- Click Connect. Configview creates its tables and schedules every collector at your default run time:
- Click Verify now. The health check reads the secret, calls
GET /v1/user/info, thenGET /v1/workspaces/info.
Data Tables
Each table has arun_at column and keeps only the newest run. No raw API objects are stored.
Rate limits
Lumin publishes no rate limit for its API. Configview paces itself at 60 requests per minute, reads 50 rows per page (the maximum) and waits as long as theRetry-After header says after a 429. A workspace needs only a handful of requests per run.
Known gaps and things to check on the first run
These come from the published OpenAPI reference; no live tenant has been tested yet.- Epoch units. The reference calls
joined_atandlast_active_atunix epochs, but its example shows milliseconds. Configview reads values above 1e11 as milliseconds. If dates look like 1970 or the far future, check this first. - total_count. It is a string in the members example; Configview parses it either way.
- WorkspaceInfo fields. The
ownerfield is assumed to be the owner’s email, as documented. - Last active. A missing or zero
last_active_atis stored as empty and shown as “never active”. - Plan limits. Spaces are limited to 2 on Free plans. API access on lower plans is not confirmed.
- Space names are chosen by users; they are stored as labels only.
Things worth knowing
Inactive members. Members not active for 90 days (or never) may have left the company but still hold access to shared Spaces. Owners and admins who are inactive are flagged separately.What isn’t collected
- Documents, PDFs, signature requests, signers, templates and agreements
- Space contents and Space member lists
- The API key value and raw API objects