Workspace

Audit history

Open a workspace and select Audit to see its management history. Each record shows the action, the person or automation that initiated it, the time, and the result. The tab is available while a workspace is being prepared or stopped.

Select Audit in the dashboard sidebar for history across your workspaces. Filter by action, actor, outcome, or time. A namespace's detail page also links to the history of its workspaces. The namespace shown in a workspace's header and Overview opens that namespace directly.

What is recorded

  • Creation, start, stop, restart, pause, hibernate, restore, reinstall and deletion.
  • Resource and lifecycle policy changes, including expiry and idle settings.
  • SSH, runtime API access, networking, public ports and custom domains.
  • Managed workload actions, reported workload exits, archives, log clearing and workspace disk attachment changes.
  • Automatic wake, idle/expiry events and platform stops.

Account actions show the account name. API credential actions identify the credential; automated actions identify the system. Platform staff actions are labelled Platform administrator.

The history records management actions. It does not capture terminal keystrokes, command contents, environment values, passwords, keys, tokens or file contents.

Outcomes

OutcomeMeaning
CompletedThe operation completed successfully.
AcceptedWork was accepted for processing. A later event shows its completion.
FailedThe operation reported a failure. Inspect its details and current state before retrying.
UnconfirmedThe request was recorded, but its completion has not been confirmed.

The latest page refreshes while the tab is visible. Times are displayed in your local time zone; hover over a time to see UTC. Clearing workspace logs does not clear the audit history. Deleted workspaces remain in the account history. Actions from before audit collection was introduced cannot be reconstructed.

Read through the API

Use your Oblien API credentials.

curl 'https://api.oblien.com/workspace/WORKSPACE_ID/audit?limit=25' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

For all your workspaces, use GET /workspace/audit. Optional filters are:

ParameterValues
workspace_idRestrict the account history to one workspace, including a deleted workspace.
namespaceNamespace slug.
categoryworkspace, power, lifecycle, resources, network, access, storage, workloads, logs.
outcomerequested, accepted, succeeded, failed.
actor_typeuser, api_key, administrator, system.
from, toUTC ISO timestamps. from is inclusive; to is exclusive.
limit1–100 records; default 50.
beforeThe previous response's next_cursor, to read older records.

Responses contain events and next_cursor. A null cursor means there are no older results for those filters. Keep the cursor as a string. API timestamps are UTC. Namespace and workspace credentials can only read history within their assigned scope; billing credentials cannot read workspace audit history.

MCP clients can use the workspace_audit tool with the same account and scope rules.