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
| Change | Where Constellation records it | What you can read yourself |
|---|---|---|
| A recommendation followed or declined | Server logs: the workflow, run, recommendation, decision and the key that made it, written before anything is sent | Under 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 revoked | Server logs | Integrations, API and MCP: each key's scopes, when it was created, last used and expires |
| Calls made with each key | Usage counts | Settings, Usage, Key activity: which key made which calls in the last 30 days |
| The network config changed | Every version is kept, with created_by (the key that wrote it) and created_at | GET /topology/config?version= |
| A workflow saved | Every version is kept, with created_at | GET /predictions/workflows/{slug}?version=. See Predictions. |
| A workflow run stopped | Server logs | The run's status reads cancelled |
| A file uploaded | Server logs | GET /telemetry/files lists each file with received_at |
| A workspace created, an academic grant accepted, a startup code redeemed | Server logs | Settings |
| A sign-in linked or unlinked, a sign-in or the account deleted | The staff audit log | Settings, Linked sign-ins |
| A change Constellation staff make to your account: its plan, disabling or enabling it, a usage reset, a grant, revoking a key | The staff audit log, with who made it, when, why, and what it changed | Ask 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.