> ## Documentation Index
> Fetch the complete documentation index at: https://conductorone-docs-hidden-info-by-role.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Ensure Onboarding Session

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



## OpenAPI

````yaml https://spec.speakeasy.com/conductor-one/conductorone/my-source-with-code-samples post /api/v1/conversations/onboarding:ensure
openapi: 3.1.0
info:
  description: The C1 API is a HTTP API for managing C1 resources.
  title: C1 API
  version: 0.1.0-alpha
servers:
  - description: The C1 API server for the current tenant.
    url: https://{tenantDomain}.conductor.one
    variables:
      tenantDomain:
        default: example
        description: The domain of the tenant to use for this request.
security:
  - bearerAuth: []
    oauth: []
paths:
  /api/v1/conversations/onboarding:ensure:
    post:
      tags:
        - Conversations
      summary: Ensure Onboarding Session
      description: >-
        EnsureOnboardingSession returns the tenant's active onboarding
        conversation,
         or creates and starts it once. Retries converge on the stored conversation.
      operationId: c1.api.conversations.v1.UIConversationsService.EnsureOnboardingSession
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/c1.api.conversations.v1.EnsureOnboardingSessionRequest
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/c1.api.conversations.v1.EnsureOnboardingSessionResponse
          description: >-
            Returns the active onboarding conversation and whether this call
            created it.
components:
  schemas:
    c1.api.conversations.v1.EnsureOnboardingSessionRequest:
      description: Requests the active onboarding conversation for the caller's tenant.
      title: Ensure Onboarding Session Request
      type: object
      x-speakeasy-name-override: EnsureOnboardingSessionRequest
    c1.api.conversations.v1.EnsureOnboardingSessionResponse:
      description: >-
        Returns the active onboarding conversation and whether this call created
        it.
      properties:
        conversationId:
          description: The active onboarding conversation ID.
          type: string
        created:
          description: True only when this call created and started the conversation.
          type: boolean
      title: Ensure Onboarding Session Response
      type: object
      x-speakeasy-name-override: EnsureOnboardingSessionResponse
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http
    oauth:
      description: >-
        This API uses OAuth2 with the Client Credential flow.

        Client Credentials must be sent in the BODY, not the headers.

        For an example of how to implement this, refer to the
        [c1TokenSource.Token()](https://github.com/ConductorOne/conductorone-sdk-go/blob/3375fe7c0126d17e7ec4e711693dee7b791023aa/token_source.go#L101-L187)
        function.
      flows:
        clientCredentials:
          scopes: {}
          tokenUrl: /auth/v1/token
      type: oauth2

````