> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryopencomputer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Initialize Embed Session

> Initialize a voice or text session using an embed token and an allowed website origin. This can start real model work. Browser API keys are not required and must not be exposed. See [Website](/guides/website).



## OpenAPI

````yaml /api-reference/openapi.json post /api/v1/public/embed/init
openapi: 3.1.0
info:
  title: Athena API
  version: 1.0.0
  description: >-
    Hosted Athena customer API. Authenticate backend management and call-trigger
    requests with X-API-Key. Website embeds and artifact playback use their own
    scoped tokens. Provider availability, feature settings, and verification
    limits are described in the guides.
servers:
  - url: https://athena.tryopencomputer.com
    description: Hosted Athena API
security: []
paths:
  /api/v1/public/embed/init:
    post:
      tags:
        - Public
      summary: Initialize Embed Session
      description: >-
        Initialize a voice or text session using an embed token and an allowed
        website origin. This can start real model work. Browser API keys are not
        required and must not be exposed. See [Website](/guides/website).
      operationId: initialize_embed_session_api_v1_public_embed_init_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InitEmbedRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InitEmbedResponse'
        '404':
          description: Not found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    InitEmbedRequest:
      properties:
        token:
          type: string
          title: Token
        context_variables:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Context Variables
      type: object
      required:
        - token
      title: InitEmbedRequest
      description: Request model for initializing an embed session
    InitEmbedResponse:
      properties:
        session_token:
          type: string
          title: Session Token
        workflow_run_id:
          type: integer
          title: Workflow Run Id
        config:
          additionalProperties: true
          type: object
          title: Config
        widget_type:
          type: string
          title: Widget Type
          default: voice
        chat_session:
          anyOf:
            - $ref: '#/components/schemas/PublicEmbedChatSessionResponse'
            - type: 'null'
      type: object
      required:
        - session_token
        - workflow_run_id
        - config
      title: InitEmbedResponse
      description: Response model for embed initialization
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    PublicEmbedChatSessionResponse:
      properties:
        revision:
          type: integer
          title: Revision
        state:
          type: string
          title: State
        is_completed:
          type: boolean
          title: Is Completed
        turns:
          items:
            $ref: '#/components/schemas/PublicEmbedChatTurn'
          type: array
          title: Turns
      type: object
      required:
        - revision
        - state
        - is_completed
        - turns
      title: PublicEmbedChatSessionResponse
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    PublicEmbedChatTurn:
      properties:
        id:
          type: string
          title: Id
        status:
          type: string
          title: Status
        user_message:
          anyOf:
            - $ref: '#/components/schemas/PublicEmbedChatMessage'
            - type: 'null'
        assistant_message:
          anyOf:
            - $ref: '#/components/schemas/PublicEmbedChatMessage'
            - type: 'null'
        assistant_messages:
          anyOf:
            - items:
                $ref: '#/components/schemas/PublicEmbedChatMessage'
              type: array
            - type: 'null'
          title: Assistant Messages
      type: object
      required:
        - id
        - status
      title: PublicEmbedChatTurn
    PublicEmbedChatMessage:
      properties:
        text:
          type: string
          title: Text
        created_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Created At
      type: object
      required:
        - text
      title: PublicEmbedChatMessage

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.