> ## 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.

# Update the business

> Updates basic fields and opening hours. Sending hours replaces the whole week.



## OpenAPI

````yaml /api-reference/openapi.json patch /business
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:
  /business:
    patch:
      tags:
        - Business
      summary: Update the business
      description: >-
        Updates basic fields and opening hours. Sending hours replaces the whole
        week.
      operationId: updateBusiness
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BusinessUpdate'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                properties:
                  data:
                    $ref: '#/components/schemas/Business'
        '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 business: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:
    BusinessUpdate:
      type: object
      properties:
        name:
          type: string
          minLength: 1
          maxLength: 200
        timezone:
          type: string
          minLength: 1
          maxLength: 80
        locale:
          type: string
          enum:
            - en
            - fr
        website_url:
          anyOf:
            - type: string
              maxLength: 2000
              format: uri
            - type: 'null'
        hours:
          description: Replaces the whole week. Omit a day to close it.
          maxItems: 7
          type: array
          items:
            description: Opening hours for one day. Days that are not listed are closed.
            type: object
            properties:
              day:
                type: string
                enum:
                  - sunday
                  - monday
                  - tuesday
                  - wednesday
                  - thursday
                  - friday
                  - saturday
              open:
                description: Local time as 24-hour HH:MM.
                type: string
                pattern: ^(?:[01]\d|2[0-3]):[0-5]\d$|^24:00$
              close:
                description: Local time as 24-hour HH:MM.
                type: string
                pattern: ^(?:[01]\d|2[0-3]):[0-5]\d$|^24:00$
            required:
              - day
              - open
              - close
      additionalProperties: false
    Business:
      type: object
      properties:
        id:
          description: Stable identifier (UUID).
          type: string
          format: uuid
        name:
          type: string
        timezone:
          description: IANA time zone, for example America/Toronto.
          type: string
        locale:
          description: 'Default language for callers: en or fr.'
          type: string
        website_url:
          anyOf:
            - type: string
            - type: 'null'
        booking_mode:
          description: >-
            instant: appointments are booked directly. request: the receptionist
            takes a request and the team confirms it. off: no booking.
          type: string
          enum:
            - instant
            - request
            - 'off'
        hours:
          type: array
          items:
            description: Opening hours for one day. Days that are not listed are closed.
            type: object
            properties:
              day:
                type: string
                enum:
                  - sunday
                  - monday
                  - tuesday
                  - wednesday
                  - thursday
                  - friday
                  - saturday
              open:
                description: Local time as 24-hour HH:MM.
                type: string
                pattern: ^(?:[01]\d|2[0-3]):[0-5]\d$|^24:00$
              close:
                description: Local time as 24-hour HH:MM.
                type: string
                pattern: ^(?:[01]\d|2[0-3]):[0-5]\d$|^24:00$
            required:
              - day
              - open
              - close
            additionalProperties: false
        created_at:
          description: ISO 8601 timestamp in UTC.
          type: string
          format: date-time
        updated_at:
          description: ISO 8601 timestamp in UTC.
          type: string
          format: date-time
      required:
        - id
        - name
        - timezone
        - locale
        - website_url
        - booking_mode
        - hours
        - created_at
        - updated_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.

````