---
title: "Get"
method: GET
path: "/api/v1/settings/onboarding"
tags: ["Onboarding Settings"]
---

# Get

`GET /api/v1/settings/onboarding`

Get retrieves the current onboarding progress for the tenant.

## Response `200`

Successful response

- C1ApiSettingsV1GetOnboardingSettingsResponse — The GetOnboardingSettingsResponse message.
  - `conversationId` string — The identifier of the onboarding conversation thread, if one is in progress.
  - `intents` string[], nullable — The intents field.
  - `mcpOnboardingGoal` string — The admin's free-form AIAM onboarding goal, captured at the Goals step.
  - `mcpOnboardingStatus` 'MCP_ONBOARDING_STATUS_UNSPECIFIED' | 'MCP_ONBOARDING_STATUS_NOT_STARTED' | 'MCP_ONBOARDING_STATUS_IN_PROGRESS' | 'MCP_ONBOARDING_STATUS_COMPLETE' | 'MCP_ONBOARDING_STATUS_DISMISSED' — The current status of the AIAM MCP onboarding briefing, tracked independently of `status`.
  - `mcpOnboardingTargets` C1ApiSettingsV1McpOnboardingTarget[], nullable — Per-target progress of the AIAM briefing: the servers/apps the admin chose to govern and how far each got.
    - `displayName` string — Snapshot of the human label at selection time.
    - `id` string — Identifies the target within the id space named by kind.
    - `kind` 'MCP_ONBOARDING_TARGET_KIND_UNSPECIFIED' | 'MCP_ONBOARDING_TARGET_KIND_APP' | 'MCP_ONBOARDING_TARGET_KIND_CATALOG_ENTRY' | 'MCP_ONBOARDING_TARGET_KIND_MCP_SERVER' — The kind field.
    - `mcpServerId` string — The registered MCP server a CATALOG_ENTRY target became, once registered.
    - `status` 'MCP_ONBOARDING_TARGET_STATUS_UNSPECIFIED' | 'MCP_ONBOARDING_TARGET_STATUS_PENDING' | 'MCP_ONBOARDING_TARGET_STATUS_DONE' | 'MCP_ONBOARDING_TARGET_STATUS_SKIPPED' — The status field.
  - `orgContext` C1ApiSettingsV1OnboardingOrgContext — The OnboardingOrgContext message.
    - `industry` string — The industry field.
    - `organizationSize` string — The organizationSize field.
  - `status` 'ONBOARDING_STATUS_UNSPECIFIED' | 'ONBOARDING_STATUS_NOT_STARTED' | 'ONBOARDING_STATUS_IN_PROGRESS' | 'ONBOARDING_STATUS_COMPLETE' | 'ONBOARDING_STATUS_DISMISSED' — The current status of the tenant onboarding process.

---

[API](https://skmtc.net/conductorone/apis/c1-api.md) · [All operations](https://skmtc.net/conductorone/apis/c1-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/conductorone/c1-api/revisions/f2cf3228f366/schema)