Get Insights bootstrap

Read the authenticated user and organization used to initialize Insights.

Outcome

Read the authenticated user and organization used to initialize Insights.

Before you start

Verify the exact identity, environment and approved organization with topolo whoami before discovering this action.
Inspect the credential-scoped action and canonical resource discovery. Examples use synthetic resources; replace their handles only with separately verified targets.
Validate the complete input and review the action plan. Mutation and organization-inventory actions require explicit confirmation; a successful shape check does not prove a runtime grant.
Bootstrap returns user and organization identity; workspace grants and selection are discovered separately.

Discover the target

topolo whoami --json
topolo apps get topolo-insights --json
topolo actions get app_topolo_insights.workspace.bootstrap --detail --json
topolo resources topolo-insights --json

Request

GET /api/bootstrap · permission workspace:read · read without mutation confirmation.

Inspect schemas and test this action in the signed action console. The complete field schema is also available through CLI/MCP action discovery.

Effects and scope

Returns Auth-verified user and organization; it does not return or create a workspace.
Organization identity remains platform-owned. organization.id is not a workspace id; successful bootstrap does not prove a workspace grant.

Interpret the response

Compare user and organization with the approved identity and environment.
Discover workspaces separately through credential-scoped resources. Do not substitute organization.id for workspace context.

Worked requests and responses

Actual exported Insights worker, all nine migrated D1 scripts and isolated local R2. Auth identity/grants/archive transport, queue delivery and Analytics Engine sink are synthetic; local queue processing is called explicitly. Notify and Nexus are disabled. No live website, provider, paid usage or deployed data erasure is tested. Successful and refused captures below are separate examples. A refused response is a boundary, not a successful task.

empty · success 1 · HTTP 200

Actual exported Insights worker, all nine migrated D1 scripts and isolated local R2. Auth identity/grants/archive transport, queue delivery and Analytics Engine sink are synthetic; local queue processing is called explicitly. Notify and Nexus are disabled. No live website, provider, paid usage or deployed data erasure is tested. Selected synthetic workspace: ws_insights_empty. Fixture handles authorize no live request.

Input · payload.json:

{}

CLI:

topolo actions validate app_topolo_insights.workspace.bootstrap --data @payload.json --json
topolo actions plan app_topolo_insights.workspace.bootstrap --data @payload.json --json
topolo actions call app_topolo_insights.workspace.bootstrap --data @payload.json --detail --json

MCP tool and arguments:

{
  "tool": "topolo_read_action",
  "arguments": {
    "actionId": "app_topolo_insights.workspace.bootstrap",
    "input": {}
  }
}

Captured raw Worker result

{
  "user": {
    "id": "usr_insights_fixture",
    "email": "operator@example.com",
    "orgId": "org_insights_fixture",
    "orgSlug": "fixture",
    "role": "admin",
    "permissions": [
      "*"
    ]
  },
  "organization": {
    "id": "org_insights_fixture",
    "slug": "fixture",
    "name": "Synthetic Insights organization"
  }
}

HTTP 200. Compare user and organization with the approved identity and environment. Discover workspaces separately through credential-scoped resources. Do not substitute organization.id for workspace context.

CLI/MCP adds its transport envelope; CLI --detail retains the full action result.

permission-refusals · refusal 2 · HTTP 403

Actual exported Insights worker, all nine migrated D1 scripts and isolated local R2. Auth identity/grants/archive transport, queue delivery and Analytics Engine sink are synthetic; local queue processing is called explicitly. Notify and Nexus are disabled. No live website, provider, paid usage or deployed data erasure is tested. Selected synthetic workspace: ws_insights_merge. Fixture handles authorize no live request.

Input · payload.json:

{}

CLI:

topolo actions validate app_topolo_insights.workspace.bootstrap --data @payload.json --json
topolo actions plan app_topolo_insights.workspace.bootstrap --data @payload.json --json

Captured raw Worker result

{
  "success": false,
  "error": {
    "code": "action_permission_required",
    "message": "Action \"workspace.bootstrap\" requires permission \"workspace:read\".",
    "action": "workspace.bootstrap"
  }
}

HTTP 403. The credential lacks the declared action permission. Inspect credential-scoped discovery in the same approved context; workspace role does not replace the permission.

CLI/MCP adds its transport envelope; CLI --detail retains the full action result.

Verify the outcome

Compare user and organization with the approved identity and environment.
Discover workspaces separately through credential-scoped resources. Do not substitute organization.id for workspace context.

Errors and recovery

action_permission_required (HTTP 403): The credential lacks the declared action permission. Inspect credential-scoped discovery in the same approved context; workspace role does not replace the permission.

Only observed refusals are listed. This does not promise that external dependencies or every invalid payload have been exhaustively exercised.

Recovery boundary

This action does not change Insights records. Resolve the reported identity, permission, workspace or source problem in the approved context, then repeat the same read. A read result is not permission to modify its resources.

app_topolo_insights.sources.list: List the selected workspace’s registered analytics sources.