openapi: 3.1.0
info:
  title: Olark JavaScript Box Chat API
  description: 'Olark exposes a browser-side JavaScript API for embedding and controlling

    the Olark live-chat widget. It is not a server REST API; this OpenAPI

    document describes the JavaScript API surface as documented at

    https://www.olark.com/api by treating each `olark(''api.<area>.<method>'')`

    invocation as a logical operation under a synthetic `/api/...` path so

    that the contract can be navigated alongside conventional REST APIs.

    Authentication is performed client-side via the Olark site identifier

    passed to `olark.identify(siteId)`.

    '
  version: 1.0.0
  contact:
    name: Olark
    url: https://www.olark.com/api
servers:
- url: https://www.olark.com/api
  description: Olark JavaScript API documentation host (logical base for this spec)
security:
- OlarkSiteId: []
tags:
- name: Chat
  description: Chat conversation and operator control
paths:
  /chat/sendMessageToVisitor:
    post:
      tags:
      - Chat
      summary: api.chat.sendMessageToVisitor
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                body:
                  type: string
      responses:
        '200':
          description: Message dispatched to visitor
  /chat/setOperatorGroup:
    post:
      tags:
      - Chat
      summary: api.chat.setOperatorGroup
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                group:
                  type: string
      responses:
        '200':
          description: Operator group set
  /chat/onBeginConversation:
    post:
      tags:
      - Chat
      summary: api.chat.onBeginConversation (event subscription)
      responses:
        '200':
          description: Callback registered
components:
  securitySchemes:
    OlarkSiteId:
      type: apiKey
      in: query
      name: site_id
      description: 'Olark identifies an installation via a public site identifier

        (e.g. `1234-456-78-9810`) passed client-side to `olark.identify()`.

        It is not a secret and is included here only to make the

        identification mechanism explicit in the OpenAPI contract.

        '