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

# Add a knowledge entry

> Adds a text entry or an FAQ that the receptionist can use to answer callers.



## OpenAPI

````yaml /api-reference/openapi.json post /knowledge
openapi: 3.1.0
info:
  title: LobbyStack API
  version: v1
  description: >-
    Read calls, contacts, appointments and messages, book appointments, and
    subscribe to webhooks. Authenticate with an API key in the Authorization
    header. Each key allows 120 requests per minute by default.
servers:
  - url: https://app.lobbystack.com/api/v1
security:
  - bearerAuth: []
tags:
  - name: Business
  - name: Calls
  - name: Contacts
  - name: Appointments
  - name: Messages
  - name: Knowledge
  - name: Webhooks
paths:
  /knowledge:
    post:
      tags:
        - Knowledge
      summary: Add a knowledge entry
      description: >-
        Adds a text entry or an FAQ that the receptionist can use to answer
        callers.
      operationId: createKnowledgeEntry
      parameters:
        - name: Idempotency-Key
          in: header
          description: >-
            A unique value, up to 255 characters, that makes retries of this
            request safe for 24 hours.
          schema:
            type: string
            maxLength: 255
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/KnowledgeEntryCreate'
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                properties:
                  data:
                    $ref: '#/components/schemas/KnowledgeEntry'
        '400':
          description: The request is invalid (invalid_request).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: The API key is missing, invalid, or revoked (unauthorized).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: The API key lacks the knowledge:write scope (insufficient_scope).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '409':
          description: The request conflicts with the current state.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: >-
            Too many requests (rate_limited). Wait for the Retry-After header's
            number of seconds.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          headers:
            Retry-After:
              schema:
                type: integer
              description: Seconds to wait.
      security:
        - bearerAuth: []
components:
  schemas:
    KnowledgeEntryCreate:
      anyOf:
        - type: object
          properties:
            type:
              type: string
              const: text
            title:
              type: string
              minLength: 1
              maxLength: 300
            content:
              type: string
              minLength: 1
              maxLength: 20000
          required:
            - type
            - title
            - content
          additionalProperties: false
        - type: object
          properties:
            type:
              type: string
              const: faq
            question:
              type: string
              minLength: 1
              maxLength: 300
            answer:
              type: string
              minLength: 1
              maxLength: 20000
          required:
            - type
            - question
            - answer
          additionalProperties: false
    KnowledgeEntry:
      type: object
      properties:
        id:
          description: Stable identifier (UUID).
          type: string
          format: uuid
        type:
          type: string
          enum:
            - text
            - faq
        title:
          type: string
        content:
          type: string
        created_at:
          description: ISO 8601 timestamp in UTC.
          type: string
          format: date-time
      required:
        - id
        - type
        - title
        - content
        - created_at
      additionalProperties: false
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - invalid_request
                - unauthorized
                - forbidden
                - insufficient_scope
                - not_found
                - conflict
                - idempotency_key_reused
                - idempotency_request_in_progress
                - booking_disabled
                - booking_requires_confirmation
                - slot_unavailable
                - rate_limited
                - rate_limit_unavailable
                - method_not_allowed
                - internal_error
            message:
              type: string
            details:
              type: array
              items:
                type: object
                properties:
                  path:
                    type: string
                  message:
                    type: string
                required:
                  - path
                  - message
                additionalProperties: false
          required:
            - code
            - message
          additionalProperties: false
      required:
        - error
      additionalProperties: false
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        An API key from Settings > API keys. Scopes: business:read,
        business:write, calls:read, contacts:read, contacts:write,
        appointments:read, appointments:write, messages:read, knowledge:write,
        webhooks:manage.

````