adminBillingClients
#Clients, alphabetically (PlatformAdmin only).
Arguments
- filter
- pagination
Cross-cutting operations that don't fit a single domain.
Clients, alphabetically (PlatformAdmin only).
Arguments
Single post by id, any status.
Arguments
Revision history for a post, newest first.
Arguments
Admin listing of posts in one tenant with optional filters. All
filters AND together. searchQuery matches title and slug
case-insensitively (ILIKE). sort orders the whole list before it
is paged; omitted, the most recently updated post comes first.
Arguments
Tags for the admin picker.
Arguments
The issuer new invoices default to (PlatformAdmin only).
Deprecation reason: Use adminDemoSimulatorWithValues; BET-205
Arguments
Arguments
One invoice with its line items and payments (PlatformAdmin only).
Arguments
A draft or replacement created to correct an issued invoice.
Arguments
Render an invoice to PDF, base64-encoded (PlatformAdmin only). A draft renders against the live parties so the author can preview their edits; an issued invoice renders from its own frozen snapshot.
Arguments
List platform invoices (PlatformAdmin only). sort orders the whole
list before it is paged; omitted, the newest issue date comes first.
Arguments
All changelog entries (drafts + published + archived). sort
orders the whole list before it is paged; omitted, the most recently
updated entry comes first.
Arguments
Single entry by ID (any status).
Arguments
Build a MigrationPlan for a source — read-only projection of
what runDataSyncSource would do given the current config.
Surfaced before the "Run sync now" button so the operator can
review the per-phase row + blob projections, missing required
answers, and warnings.
Arguments
One run by id (with full coverage report when completed).
Arguments
Recent runs for a source. Standard offset pagination via the
kernel's PaginationInput; clients send limit + page (or
an after cursor); response carries the standard pageInfo.
sort orders the whole history before it is paged (omitted:
newest first).
Arguments
One data-sync source by id (must belong to the calling tenant).
Arguments
Data-sync sources configured for the calling tenant. Standard
offset pagination via the kernel's PaginationInput; sort orders
the whole list before it is paged (omitted: newest first).
Requires tenant_admin or higher.
Arguments
Run discovery against a source — returns the open admin questions plus estimated row counts. Read-only on the source DB.
Arguments
Single published post by slug. Returns null for missing or non-public posts — drafts must never leak through this resolver.
Arguments
Reverse-chronological feed of published posts. Optional category filter (by slug). The website caches the response via Next.js ISR.
Arguments
Reverse-chronological feed of published entries. Optional product
filter. The website caches the response via Next.js ISR
(revalidate = 60).
Arguments
Single published entry by slug. Returns null for missing or non-public entries — drafts must never leak through this resolver.
Arguments
Recent releases for one source. Drafting screen calls this once the admin picks a source from the dropdown.
Arguments
Default
20Single artifact by key. Returns null if no artifact uses
that key — UI surfaces "unknown artifact" rather than erroring.
Arguments
The single in-flight dispatch (pending or in_progress) for
this artifact, if any. Returns null when the artifact has no
active release. The UI uses this to disable the "Cut release"
button while a release is queued.
Arguments
Recent dispatches for a single artifact. Used by the per-artifact detail screen to show the last N releases.
Arguments
Every artifact known to Release Hub, in the order they appear in
release_artifacts.toml. Cards on the dashboard are rendered
directly from this list.
Single dispatch by id. The dispatch detail / live status page polls this endpoint while a run is in progress.
Arguments
Active drafting prompt revision (prompt_name =
release_notes_drafting). Returns null when no admin has saved
one yet — the use case falls back to the shipped default.
All revisions for the drafting prompt, newest first. Powers the revision history view in admin settings.
All configured GitHub sources — populates the drafting picker and the settings list.
Single destination by id. Authorization: caller must satisfy
resolve_target_tenant against the destination's tenant.
Arguments
List destinations for the caller's tenant (tenant-owner) or for
the supplied tenant_id (PlatformAdmin only).
Arguments
Arguments
Arguments
Default
50Latest ten exports and the next generation date. No expensive source-table scans.
Arguments
Hide a client from the picker without touching their invoices.
Arguments
Arguments
Create a draft invoice (PlatformAdmin only).
Arguments
Create a correction draft from an issued invoice with no payments.
Arguments
Delete a draft outright (PlatformAdmin only). Drafts only. An issued invoice is voided instead, so the number series keeps no gaps for an auditor to ask about.
Arguments
Issue a draft: assign its number and freeze both parties onto it. One-way. Issued content stays fixed; an unpaid invoice can be replaced through a linked correction draft.
Arguments
Create or update a client (PlatformAdmin only).
Arguments
Create or update an issuer (PlatformAdmin only).
Arguments
Deprecation reason: Use adminSetDemoSimulatorStateWithValues; BET-205
Arguments
Arguments
Bring an archived client back into the picker.
Arguments
Replace a draft invoice's content (PlatformAdmin only).
Arguments
Void an issued invoice (PlatformAdmin only).
Arguments
Arguments
Archive an entry — hidden from the public feed and the default admin list. Revisions stay intact.
Arguments
Mark a queued or running sync run as cancelled. The
background task notices the status change between phase
commits and bails out at the next checkpoint. Idempotent on
already-terminal runs (returns the run as-is).
Arguments
Provision a new data-sync source for the calling tenant. Requires tenant_owner. Secrets are AES-GCM encrypted at rest; they're never returned over GraphQL afterwards.
Arguments
Create a destination. tenant_id in the input is honored only
when the caller is PlatformAdmin.
Arguments
Delete a source. Cascades to its data_sync_runs rows. When
purgeMappings = true (default false), also wipes every
data_sync_mappings row that this source's provider produced
for the tenant — a clean disconnect that lets a re-imported
source mint fresh UUIDs without bumping into the old mapping
table. The BetterSuite rows themselves stay intact.
Arguments
Default
falseArguments
Arguments
Cut a release for the given artifact. Persists a dispatch row
(which acquires the artifact's in-flight slot via a DB unique
index), POSTs workflow_dispatch to GitHub Actions, writes a
ReleaseDispatched audit row. The returned ReleaseDispatch
starts in status pending; the reconciler worker updates it to
in_progress once GitHub surfaces the run id, then to a
terminal status.
Errors:
* ArtifactNotFound — unknown artifactKey
* InvalidDispatchInputs — typed-confirm mismatch, unknown
input name, missing required input, invalid choice
* DispatchInFlight — another dispatch for this artifact is
still pending or in_progress
* RateLimited — recent successful dispatch is inside the
cooldown window (5 min by default)
* GithubApi — workflow_dispatch POST failed upstream
Arguments
Arguments
Read a .env-shaped file from the legacy backend host via
the source's already-saved SSH tunnel credentials. The raw
contents are returned to the client, which parses them with
the same routine the "paste .env" textarea uses. Requires
connection_mode = ssh_tunnel and saved SSH secrets.
Arguments
Audited, one-use migration exception. Never bypasses global resource budgets.
Arguments
Arguments
Promote a draft to published (or republish an archived entry). Idempotent.
Arguments
Queue an export run. v1 only the planning phase (dry_run = true)
produces real output; non-dry runs land on the run row as
failed with a "not implemented yet" message until the COPY+SSH
pipeline is wired.
Arguments
Arguments
Generate a portable backup, at most weekly. Repeated requests return the pending job.
Re-trigger a sync against the source of a previous (typically
failed) run. Mints a fresh run row — the original is left
intact for audit. Convenience over runDataSyncSource(sourceId)
so the UI's Retry button doesn't have to look up the source
id client-side.
Arguments
Trigger a sync run. Mutation returns immediately with a
SyncRun in queued status; the worker picks it up and
transitions through running → completed / failed.
Clients poll (or subscribe via the realtime service) for
progress.
Arguments
Default
falseArguments
Arguments
Create-or-update a changelog entry. New entries are inserted as
drafts; promote with publishChangelogEntry. Every call appends
a new revision row.
Arguments
Arguments
Arguments
Persist the parsed .env of the legacy app on the source
row. Server parses the raw blob (so the canonical key set
stays defined in Rust), stores it under
data_sync_sources.legacy_env_import. The provider config
resolves layered against this — operator answers win,
otherwise env-derived defaults flow through, otherwise
compiled defaults. Re-importing replaces the column without
touching config, so explicit operator overrides survive.
Arguments
Deprecation reason: Use tenantExportRunDownloadUrlResult; BET-205
Arguments
Mint a short-lived download URL for a successful tarball-mode
run's artifact. The URL points at the platform's
/api/tenant-export/runs/:id/artifact route, which validates
the embedded token and streams the .tar.gz.
Re-minting rotates the token; any previous URL stops working.
ttl_seconds is bounded between 60s and 7 days; default is
download_token_default_ttl from AppState (24h out of the box).
Arguments
Validate a source's connection without saving anything. The admin can hit this from the Configure page before committing credentials. Read-only on the source DB; nothing is written to the target.
Arguments
Validate just the SSH layer — open the bastion session, capture the host-key fingerprint, disconnect. No MySQL connection is attempted. Returns success + the discovered fingerprint so the operator can sanity-check the bastion auth before saving credentials or running a full discovery.
Arguments
Dial the destination without queueing a run. Returns
{ ok, message, capturedSshFingerprint? }. For database
destinations we open the SSH bastion tunnel (if configured) and
run SELECT 1 against the target. For tarball destinations we
touch the exports directory to confirm it's writable.
When the SSH bastion's host key is captured for the first time,
the fingerprint is BOTH persisted into the destination's config
(so subsequent runs validate it) AND returned in the response
so the UI can show it to the operator for explicit confirmation.
Arguments
Arguments
Flip a published entry back to draft. The original
published_at is preserved so republishing keeps the same feed
position.
Arguments
Update a source's config and (optionally) its stored secrets. Requires tenant_owner.
Arguments
Sparse update. The destination's tenant_id is fixed and not editable; transferring ownership isn't supported.
Arguments
Arguments
Deprecation reason: Use workspaceDataExportDownloadResult; BET-205
Arguments
Re-download an existing archive. Password confirmation never regenerates data.
Arguments
Subscribe to parking lot owner events (Parking service)
Receive the bookings at the owner's lots as they change — a driver
asking to book or for more time, paying, cancelling, a request or a
payment lapsing — and the owner's notification center.
**Requirements:**
- Must be authenticated
- Must have ParkSpotProvider role
- Must be using Parking app
Subscribe to service-marketplace customer events
**Requirements:**
- Must be authenticated
- Must have Customer role
- Must be using the Service app
Deprecation reason: Use serviceCustomerEventStream; BET-205
Subscribe to service-marketplace provider events
A separate channel from the customer's, not a filtered view of it: a
provider's lead traffic is commercially sensitive to other providers.
**Requirements:**
- Must be authenticated
- Must have ServiceProvider role
- Must be using the Service app
Deprecation reason: Use serviceProviderEventStream; BET-205
BetterSuite is built for teams who see on-demand as a business — not a feature.