Skip to main content

The audit log: who changed what, and when

There is no audit log you can open yet. Constellation keeps the record itself, in a staff audit log and in its server logs, and much of it you can already read in the Platform and the API. When you need the full record for a period, ask for it.

What is recorded today​

ChangeWhere Constellation records itWhat you can read yourself
A recommendation followed or declinedServer logs: the workflow, run, recommendation, decision and the key that made it, written before anything is sentUnder Past on Passes, each decided recommendation with its decision, the key that decided it and when. In the API, by and at on GET /predictions/actions.
An API key created or revokedServer logsIntegrations, API and MCP: each key's scopes, when it was created, last used and expires
Calls made with each keyUsage countsSettings, Usage, Key activity: which key made which calls in the last 30 days
The network config changedEvery version is kept, with created_by (the key that wrote it) and created_atGET /topology/config?version=
A workflow savedEvery version is kept, with created_atGET /predictions/workflows/{slug}?version=. See Predictions.
A workflow run stoppedServer logsThe run's status reads cancelled
A file uploadedServer logsGET /telemetry/files lists each file with received_at
A workspace created, an academic grant accepted, a startup code redeemedServer logsSettings
A sign-in linked or unlinked, a sign-in or the account deletedThe staff audit logSettings, Linked sign-ins
A change Constellation staff make to your account: its plan, disabling or enabling it, a usage reset, a grant, revoking a keyThe staff audit log, with who made it, when, why, and what it changedAsk for it

The staff audit log is append-only, and a staff change that cannot be recorded is not made.

Ask for a record​

Write to contact@constellation.space from your account's email. Enterprise customers can also ask their Constellation contact. Include:

  • The account: its email, or for Enterprise your organization.
  • The period, as UTC dates and times.
  • What you need: key changes, recommendation decisions, staff changes, or all of them.

Do not include API keys or other secrets.

Not available yet​

A customer audit log, in Settings or through the API, is not available yet, and neither is the full audit trail the Operator + Act price card names. Until it is, the record above is kept for you and read on request. Who can sign in and what each key may do is in Roles and single sign-on.