Skip to main content
Embed StackOne request logs in your own product UI, an internal operations dashboard for your team, or a scoped log viewer for your customers. This guide covers the endpoint call order for each pattern.
This guide covers request logs only, the same data shown on the Request Logs dashboard page. For the full endpoint hierarchy, see Request Log Debugging. To export logs into Grafana, Datadog, or a data warehouse, see Observability & Log Sync.
The API follows the same drill-down hierarchy as the StackOne dashboard: list → detail → advanced / steps / defender.

​
Admin operations dashboard

Build an internal dashboard for your team to monitor integration health across all linked accounts.

​
Call order

  1. Summary metrics: Get Logs Stats Aggregate for error counts, latency percentiles, and request volume.
  2. Breakdown: Get Logs Stats Dimensions to group by connector, account, or status.
  3. Activity table: List Logs with time-range and connector filters.
  4. Row drill-down: Get Action Log using action_run_id from the selected row.
  5. Deeper inspection: On demand, call steps, advanced, or defender endpoints based on what the operator needs to see.

​
Customer-facing log viewer

Expose a scoped log viewer inside your product so each customer sees only their own integration activity.

​
Call order

  1. Resolve the linked account: Map the signed-in end-user to a StackOne account_id.
  2. List logs: List Logs with filter.account_ids set to that account.
  3. Show summary in the table: Display event_time, action_id, connector_key, status_code, duration_ms, and success from list results. Do not fetch advanced logs for every row.
  4. Detail on demand: Get Action Log when the user opens a specific entry.
Scope every list request to a single account_id. Your backend should hold the StackOne API key and enforce account scoping server-side. Never expose project-wide logs to end-users.

​
Key fields for the log table

Request Log Debugging

Debug failed action calls and trace execution steps

Observability & Log Sync

Sync logs to Grafana, Datadog, or custom pipelines

Request Logs (Dashboard)

View and filter logs in the StackOne dashboard

List Logs API

List request logs endpoint reference