---
title: "Ensure Onboarding Session"
method: POST
path: "/api/v1/conversations/onboarding:ensure"
tags: ["Conversations"]
---

# Ensure Onboarding Session

`POST /api/v1/conversations/onboarding:ensure`

EnsureOnboardingSession returns the tenant's active onboarding conversation,
 or creates and starts it once. Retries converge on the stored conversation.

## Request body

- C1ApiConversationsV1EnsureOnboardingSessionRequest — Requests the active onboarding conversation for the caller's tenant.

## Response `200`

Returns the active onboarding conversation and whether this call created it.

- C1ApiConversationsV1EnsureOnboardingSessionResponse — Returns the active onboarding conversation and whether this call created it.
  - `conversationId` string — The active onboarding conversation ID.
  - `created` boolean — True only when this call created and started the conversation.

---

[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)