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

# Update an Event

> Update an existing timeline event.

Required authorization scope: `public.timeline_event:write`




## OpenAPI

````yaml /2025-09/openapi.json patch /2025-09/timeline/events/{event_id}
openapi: 3.1.1
info:
  title: Stora Public API
  version: 2025-09
  x-build-date: '2026-05-20'
  description: >-
    The Stora Public API gives you programmatic access to your self-storage
    business. Use it to build custom integrations, automate operational
    workflows, and sync data with the tools you already use.
  termsOfService: https://www.stora.co/terms-of-service
  contact:
    name: Stora Support
    url: https://www.stora.co/contact
servers:
  - url: https://public-api.stora.co
    description: Production
security: []
tags:
  - name: Contacts
    description: >-
      Contact is the end user of an operator’s storage business — an individual
      or company that inquires, books, signs agreements, and pays for storage.
  - name: Contract Templates
    description: >-
      Contract Template is a reusable contract blueprint. It contains the
      contract content with fillable fields and variables that Stora can
      pre‑fill at document generation time for a specific contact and tenancy.
  - name: Contracts
    description: >-
      Contract is a document generated from a contract template for a specific
      contact. It tracks the signing lifecycle, moving through statuses such as
      pending, signed, voided, declined, and deleted.
  - name: Coupons
    description: >-
      Coupon is a reusable promotion that reduces the price a contact pays by
      either a percentage or a fixed amount. It can be applied to eligible
      charges such as unit rent or product and may be limited by duration,
      number of uses, or scope.
  - name: Credit Notes
    description: >-
      Credit Note reduces or reverses part or all of a previously issued
      invoice. It references the original invoice and contact, along with the
      specified corrected amounts and taxes.
  - name: Deals
    description: >-
      Deal refers to the collection of information pertaining to a potential
      order including contact, site, unit types, protection.
  - name: Deals / Stages
    description: Deal Stage refers to the stages a deal transitions through.
  - name: Identity Verifications
    description: Identity Verification tracks the process of verifying a contacts identity.
  - name: Images
    description: >-
      Serves images associated with resources such as sites and unit types. The
      endpoint redirects to a temporary pre-signed storage URL where the image
      can be downloaded.
  - name: Invoices
    description: >-
      Invoice is a finalized billing document issued to a contact for their
      storage subscriptions and related charges. It itemizes line items like
      unit rent and protection, applies taxes and discounts, and tracks totals,
      balance due, and status over time.
  - name: Notes
    description: >-
      A note is a text annotation attached to a resource such as a contact,
      unit, subscription, or task. Notes capture observations, reminders, or
      context added by staff or integrations.
  - name: OAuth 2
    description: >-
      The Stora Public API supports two OAuth 2.0 flows. Use **Client
      Credentials** if you are an operator building your own integration. Use
      **Authorization Code** if you are a partner integrating on behalf of an
      operator.
  - name: Orders
    description: >-
      Order captures a contact’s intent to rent storage, including the selected
      site and unit type, move‑in date, pricing, and optional add‑ons like
      protection, products, and services. It tracks status over its lifecycle,
      and may lead to a subscription that bills on a recurring basis.
  - name: Orders / Line Items
    description: >-
      Order Line Items are the individual charges that make up an order. Each
      line item represents a product or service such as unit rent, protection,
      or a one‑off fee, and includes its quantity, unit price, and currency.
  - name: Product Categories
    description: >-
      Product Category groups related products and services into a logical
      classification used for pricing and display.
  - name: Products
    description: >-
      Product represents a sellable item or service offered by the operator. It
      defines attributes such as name, description, pricing model, currency, and
      category, which determine how it’s presented and billed.
  - name: Protection Levels
    description: >-
      Protection Level is an optional add‑on that protects a contact’s stored
      goods up to a chosen coverage amount. It’s priced and billed alongside
      storage, appears as its own product or line item, and follows the same tax
      and discount rules as other charges.
  - name: Sites
    description: >-
      Site is a single physical self‑storage location operated by the operator.
      It’s the container for everything specific to that location: units and
      unit types, pricing and taxes, access control, and reporting.
  - name: Staff
    description: >-
      Staff refers to a member of an organization who works on behalf of the
      operator.
  - name: Subscriptions
    description: >-
      Subscription is an ongoing billing agreement that charges a contact on a
      recurring schedule for storage and related services. It defines the
      billing period and active prices, accrues charges into invoices, and
      reflects proration, discounts, and taxes.
  - name: Tasks
    description: Tasks represent individual pieces of work or actions.
  - name: Tenancies
    description: >-
      Tenancy represents an ongoing storage agreement between a contact and an
      operator, tied to a site and one or more allocated units.
  - name: Timeline / Events
    description: >-
      An event represents a custom timeline entry created by an external
      integration, such as a CRM or messaging app.
  - name: Timeline / Sources
    description: >-
      A source represents the origin of a custom timeline event, such as an
      external CRM, or a custom integration.
  - name: Timeline / Templates
    description: >-
      A template defines the message format for a custom timeline event,
      including the Liquid template and available variables.
  - name: Unit Allocations
    description: >-
      Unit Allocation represents the assignment of a specific unit to a tenancy,
      tracking reservation and access details.
  - name: Unit Types
    description: >-
      Unit Type represents a standardized storage offering at a site, such as
      “50 sq ft indoor” or “20 ft container.” It defines core attributes used
      for pricing and availability, including size, features or access type, and
      display name.
  - name: Units
    description: >-
      Unit is a specific, bookable storage space at a site, for example “Unit
      A‑012” of a given unit type. It carries concrete attributes like
      identifier and status.
  - name: Webhook Endpoints
    description: >-
      Webhook endpoints are used to receive notifications when specific events
      occur in Stora. We will send a `POST` request to the endpoint with the
      event payload.
  - name: Webhooks
    description: >-
      Webhooks are HTTP callbacks that send real-time `POST` requests to your
      configured endpoints when specific events occur in Stora. When an event
      happens (such as an invoice being paid or a credit note being created),
      Stora will immediately send a webhook notification to all endpoints
      subscribed to that event type.
externalDocs:
  description: Stora Public API documentation website
  url: https://docs.stora.co/2025-09/
paths:
  /2025-09/timeline/events/{event_id}:
    parameters:
      - name: event_id
        in: path
        description: The ID of the timeline event to retrieve
        required: true
        schema:
          type: string
    patch:
      tags:
        - Timeline / Events
      summary: Update an Event
      description: |
        Update an existing timeline event.

        Required authorization scope: `public.timeline_event:write`
      operationId: timeline_event_update
      parameters:
        - name: expand
          explode: false
          in: query
          schema:
            type: array
            items:
              type: string
          description: >-
            This endpoint supports expandable responses. For more, see the
            [documentation
            page](https://docs.stora.co/2025-09/guides/responses#expanding-responses).
          required: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TimelineEventsUpdate'
            examples:
              update_event:
                summary: update event
                value:
                  source:
                    id: tsrc_126b43585fea94ad
                  template:
                    id: aetpl_6b92d7693eb7e8e9
                  contact:
                    id: con_9bc5a9d2d8302840
                  description: Deal closed — contract signed
                  external:
                    id: deal_98442
                    url: https://crm.example.com/deals/98442
                  variables:
                    deal_name: 10x10 Unit — 12 months
                    previous_state: Negotiation
                    new_state: Closed Won
      responses:
        '200':
          description: event updated
          content:
            application/json:
              examples:
                default:
                  value:
                    event:
                      id: aevt_33db60b5d4e7f7b3
                      contact:
                        id: con_9bc5a9d2d8302840
                      created_at: '2025-02-22T14:41:00Z'
                      creator:
                        id: app_99b90b9d208a137b
                      description: Deal closed — contract signed
                      external:
                        id: deal_98442
                        url: https://crm.example.com/deals/98442
                      invoice: null
                      site: null
                      source:
                        id: tsrc_126b43585fea94ad
                      subscription: null
                      template:
                        id: aetpl_6b92d7693eb7e8e9
                      tenancy: null
                      unit: null
                      unit_type: null
                      updated_at: '2025-02-22T14:41:00Z'
                      variables:
                        deal_name: 10x10 Unit — 12 months
                        previous_state: Negotiation
                        new_state: Closed Won
                    meta:
                      request_id: 01563646-58c1-4607-8fe0-cae3e92c4477
                      curies:
                        - name: bo
                          href: https://app.stora.test{rel}
                          templated: true
                          title: Backoffice
                        - name: sf
                          href: https://acme.stora.test{rel}
                          templated: true
                          title: Storefront
                  summary: event updated
              schema:
                $ref: '#/components/schemas/timeline_event_single'
      security:
        - Bearer:
            - public.timeline_event:write
        - OAuth2:
            - public.timeline_event:write
components:
  schemas:
    TimelineEventsUpdate:
      type: object
      required: []
      properties:
        source:
          type: object
          required:
            - id
          properties:
            id:
              type: string
              pattern: ^tsrc_
              description: The ID of the source
          additionalProperties: false
        template:
          type: object
          required:
            - id
          properties:
            id:
              type: string
              pattern: ^aetpl_
              description: The ID of the template
          additionalProperties: false
        contact:
          type:
            - object
            - 'null'
          required:
            - id
          properties:
            id:
              type:
                - string
                - 'null'
              pattern: ^con_
          additionalProperties: false
        site:
          type:
            - object
            - 'null'
          required:
            - id
          properties:
            id:
              type:
                - string
                - 'null'
              pattern: ^site_
          additionalProperties: false
        subscription:
          type:
            - object
            - 'null'
          required:
            - id
          properties:
            id:
              type:
                - string
                - 'null'
              pattern: ^sub_
          additionalProperties: false
        tenancy:
          type:
            - object
            - 'null'
          required:
            - id
          properties:
            id:
              type:
                - string
                - 'null'
              pattern: ^ten_
          additionalProperties: false
        unit:
          type:
            - object
            - 'null'
          required:
            - id
          properties:
            id:
              type:
                - string
                - 'null'
              pattern: ^unit_
          additionalProperties: false
        invoice:
          type:
            - object
            - 'null'
          required:
            - id
          properties:
            id:
              type:
                - string
                - 'null'
              pattern: ^inv_
          additionalProperties: false
        unit_type:
          type:
            - object
            - 'null'
          required:
            - id
          properties:
            id:
              type:
                - string
                - 'null'
              pattern: ^utype_
          additionalProperties: false
        description:
          type:
            - string
            - 'null'
        external:
          type:
            - object
            - 'null'
          required: []
          properties:
            id:
              type:
                - string
                - 'null'
            url:
              type:
                - string
                - 'null'
              format: uri
              pattern: ^https://
          additionalProperties: false
        variables:
          type:
            - object
            - 'null'
          additionalProperties:
            type: string
          maxProperties: 20
      additionalProperties: false
      description: Update Event Request
    timeline_event_single:
      type: object
      description: Single Timeline Event
      additionalProperties: false
      properties:
        event:
          $ref: '#/components/schemas/TimelineEvent'
        meta:
          $ref: '#/components/schemas/Meta'
    TimelineEvent:
      type: object
      description: Event
      additionalProperties: false
      properties:
        id:
          type: string
          pattern: ^aevt_
          description: Unique identifier for the event.
        description:
          type:
            - string
            - 'null'
          description: Free-text note displayed alongside the event in the timeline.
        external:
          type:
            - object
            - 'null'
          description: Metadata from the originating system.
          additionalProperties: false
          properties:
            id:
              type:
                - string
                - 'null'
              description: >-
                Identifier from the originating system (e.g., your internal
                record ID).
            url:
              type:
                - string
                - 'null'
              format: uri
              description: >-
                Link to the resource in the originating system. Displayed as a
                clickable link in the timeline.
        variables:
          type: object
          additionalProperties:
            type: string
          description: >-
            Key-value pairs used to render the template message. Keys must match
            the template's defined variables.
        source:
          $ref: '#/components/schemas/TimelineSource'
          description: >-
            Source associated with the event. **Expandable** (shows only ID when
            not expanded).
        template:
          $ref: '#/components/schemas/TimelineTemplate'
          description: >-
            Template associated with the event. **Expandable** (shows only ID
            when not expanded).
        contact:
          description: >-
            Contact associated with the event. **Expandable** (shows only ID
            when not expanded).
          oneOf:
            - $ref: '#/components/schemas/Contact'
            - type: 'null'
        site:
          description: >-
            Site associated with the event. **Expandable** (shows only ID when
            not expanded).
          oneOf:
            - $ref: '#/components/schemas/Site'
            - type: 'null'
        subscription:
          description: >-
            Subscription associated with the event. **Expandable** (shows only
            ID when not expanded).
          oneOf:
            - $ref: '#/components/schemas/Subscription'
            - type: 'null'
        tenancy:
          description: >-
            Tenancy associated with the event. **Expandable** (shows only ID
            when not expanded).
          oneOf:
            - $ref: '#/components/schemas/Tenancy'
            - type: 'null'
        unit:
          description: >-
            Unit associated with the event. **Expandable** (shows only ID when
            not expanded).
          oneOf:
            - $ref: '#/components/schemas/Unit'
            - type: 'null'
        invoice:
          description: >-
            Invoice associated with the event. **Expandable** (shows only ID
            when not expanded). Only persisted when the template uses the
            `invoice` variable.
          oneOf:
            - $ref: '#/components/schemas/Invoice'
            - type: 'null'
        unit_type:
          description: >-
            Unit type associated with the event. **Expandable** (shows only ID
            when not expanded). Only persisted when the template uses the
            `unit_type` variable.
          oneOf:
            - $ref: '#/components/schemas/UnitType'
            - type: 'null'
        creator:
          description: >-
            The access token or application that created this event.
            **Expandable** (shows only ID when not expanded).
          oneOf:
            - $ref: '#/components/schemas/AccessToken'
            - $ref: '#/components/schemas/Application'
        created_at:
          type: string
          format: date-time
          description: When the event occurred.
        updated_at:
          type: string
          format: date-time
          description: When the event was last updated.
    Meta:
      type: object
      properties:
        request_id:
          type: string
          description: Unique request identifier.
        curies:
          type: array
          description: CURIE definitions for resolving namespaced link relations.
          items:
            $ref: '#/components/schemas/Curie'
    TimelineSource:
      type: object
      description: Source
      additionalProperties: false
      properties:
        id:
          type: string
          pattern: ^tsrc_
          description: Unique identifier for the source.
        name:
          type: string
          description: Name of the source.
        website_url:
          type: string
          format: uri
          description: Website URL of the source.
        global:
          type: boolean
          description: Whether this is a global source (not owned by a specific operator).
        created_at:
          type: string
          format: date-time
          description: Creation date and time of the source.
        updated_at:
          type: string
          format: date-time
          description: Last update date and time of the source.
    TimelineTemplate:
      type: object
      description: Template
      additionalProperties: false
      properties:
        id:
          type: string
          pattern: ^aetpl_
          description: Unique identifier for the template.
        name:
          type: string
          description: Name of the template.
        message:
          type: string
          description: Default English Liquid message template that will be translated.
        variables:
          type: object
          description: >-
            Variables available to render the complete message. Variables are
            not enforced, as we do not want to block events that have incomplete
            data.
          additionalProperties: false
          properties:
            predefined:
              type: array
              items:
                type: string
                enum:
                  - contact
                  - site
                  - subscription
                  - tenancy
                  - unit
                  - invoice
                  - unit_type
              description: Predefined system variables (e.g. contact, site, unit).
            custom:
              type: array
              items:
                type: string
              description: User-defined custom variables.
        global:
          type: boolean
          description: Whether this template is available for all.
        created_at:
          type: string
          format: date-time
          description: Creation date and time of the template.
        updated_at:
          type: string
          format: date-time
          description: Last update date and time of the template.
    Contact:
      type: object
      description: Contact
      additionalProperties: false
      properties:
        id:
          type: string
          description: Unique identifier for the contact.
          pattern: ^con_
        address: 0990a489-89a0-4e27-bf51-e2b982cfb59b
        email:
          type: string
          description: Email address of the contact.
          format: email
        full_name:
          type: string
          description: Full name of the contact.
        marketing_source:
          type:
            - string
            - 'null'
          description: Source of marketing for the contact.
          enum:
            - used_before
            - recommendation
            - received_leaflet
            - seen_building_signs
            - seen_advert
            - facebook_marketplace
            - google_search
            - other_online_search
            - social_media
            - email
            - radio
            - other
            - null
        phone_number:
          type:
            - string
            - 'null'
          description: Phone number of the contact.
        source:
          type:
            - string
            - 'null'
          description: Source of the contact information.
          enum:
            - pre_open
            - incomplete_booking
            - registered_interest
            - price_interest
            - quotation_request
            - booking
            - popup
            - external_enquiry
            - phone
            - walkin
            - import
            - other
            - null
        tax_id:
          type:
            - string
            - 'null'
          description: Tax identification number of the contact.
        company_registration_number:
          type:
            - string
            - 'null'
          description: Company registration number of the contact.
        type:
          type:
            - string
            - 'null'
          description: Type of the contact (e.g., domestic, company).
          enum:
            - domestic
            - company
            - student
            - charity
            - local_authority
            - null
        use_case:
          type:
            - string
            - 'null'
          description: Use case for the contact.
          enum:
            - business_needs
            - moving_home
            - more_space
            - refurb
            - travelling
            - other
            - null
        metadata:
          $ref: '#/components/schemas/Metadata'
        stripe_customer_id:
          type:
            - string
            - 'null'
          description: Stripe Customer identifier associated with the contact.
        tenancies_count:
          description: Number of tenancies associated with the contact.
          type: integer
        created_at:
          type: string
          format: date-time
          description: Creation date and time of the contact.
        updated_at:
          type: string
          format: date-time
          description: Last update date and time of the contact.
        identity_check:
          type: object
          additionalProperties: false
          properties:
            required:
              type: boolean
              description: >-
                Whether the contact is required to complete identity
                verification based on the operator's checkin settings.
            status:
              type: string
              description: >-
                Status of the contact's latest identity verification.
                `not_attempted` is unique to this field (infers no identity
                verification resource yet exists for this contact).
              enum:
                - failed
                - processing
                - succeeded
                - cancelled
                - not_attempted
    Site:
      type: object
      description: Site
      additionalProperties: false
      properties:
        id:
          type: string
          description: Unique identifier for the site.
        name:
          type: string
          description: Name of the site.
        description:
          type:
            - string
            - 'null'
          description: Description of the site.
        created_at:
          type: string
          format: date-time
          description: Creation date and time of the site.
        updated_at:
          type: string
          format: date-time
          description: Last update date and time of the site.
        phone:
          type:
            - string
            - 'null'
          description: Phone number of the site.
        opened_at:
          type:
            - string
            - 'null'
          format: date-time
          description: Date and time when the site was/will be opened.
        directions:
          type:
            - object
            - 'null'
          description: Directions to the site.
          additionalProperties: false
          properties:
            google_maps_url:
              type:
                - string
                - 'null'
              description: URL to Google Maps for the site.
        images:
          type: object
          additionalProperties: false
          properties:
            default:
              type:
                - object
                - 'null'
              additionalProperties: false
              properties:
                original:
                  type: string
                  format: uri
                  description: Original unresized image.
                small:
                  type: string
                  format: uri
                  description: Resized to max 250x250px.
                medium:
                  type: string
                  format: uri
                  description: Resized to max 500x500px.
                large:
                  type: string
                  format: uri
                  description: Resized to max 1000x1000px.
        access_hours:
          type:
            - object
            - 'null'
          description: Access hours for the site.
          additionalProperties: false
          properties:
            monday:
              $ref: '#/components/schemas/SiteAccessHoursDay'
            tuesday:
              $ref: '#/components/schemas/SiteAccessHoursDay'
            wednesday:
              $ref: '#/components/schemas/SiteAccessHoursDay'
            thursday:
              $ref: '#/components/schemas/SiteAccessHoursDay'
            friday:
              $ref: '#/components/schemas/SiteAccessHoursDay'
            saturday:
              $ref: '#/components/schemas/SiteAccessHoursDay'
            sunday:
              $ref: '#/components/schemas/SiteAccessHoursDay'
        address:
          type:
            - object
            - 'null'
          description: Address of the site.
          additionalProperties: false
          properties:
            line_1:
              type:
                - string
                - 'null'
              description: First line of the address.
            line_2:
              type:
                - string
                - 'null'
              description: Second line of the address (optional).
            city:
              type:
                - string
                - 'null'
              description: City of the site.
            postal_code:
              type:
                - string
                - 'null'
              description: Postal code of the site.
    Subscription:
      type: object
      description: Subscription
      additionalProperties: false
      properties:
        id:
          type: string
          description: Unique identifier for the subscription.
          pattern: ^sub_
        starts_at:
          type:
            - string
            - 'null'
          format: date-time
          description: Date and time for start of the subscription period.
        ends_at:
          type:
            - string
            - 'null'
          format: date-time
          description: Date and time for end of the subscription period.
        created_at:
          type: string
          format: date-time
          description: Creation date and time of the subscription.
        updated_at:
          type: string
          format: date-time
          description: Last update date and time of the subscription.
        current_period:
          type: object
          description: Current subscription period.
          additionalProperties: false
          properties:
            starts_at:
              type:
                - string
                - 'null'
              format: date-time
              description: Date and time for start of the subscription period.
            ends_at:
              type:
                - string
                - 'null'
              format: date-time
              description: Date and time for end of the subscription period.
        stripe_subscription_id:
          type:
            - string
            - 'null'
          description: Id for the Stripe Subscription Id linked to the subscription.
        cancelled:
          type: boolean
          description: Indicates whether subscription is cancelled.
        cancellation_reason:
          type:
            - string
            - 'null'
          enum:
            - move_out_not_needed
            - move_out_seasonal
            - move_out_business
            - issue_cost
            - issue_location
            - issue_security
            - issue_quality
            - issue_accessibility
            - issue_cleanliness
            - issue_unsuitable
            - new_sub_date_change
            - new_sub_unit_type_change
            - new_sub_payment_method_change
            - new_sub_incorrect_cancellation
            - new_sub_billing_period_change
            - eviction
            - no_show
            - alternative_found
            - other
            - null
          description: Reason for subscription cancellation.
        stripe_subscription_schedule_id:
          type:
            - string
            - 'null'
          description: >-
            Id for Stripe Subscription Schedule associated with the
            subscription.
        contact:
          $ref: '#/components/schemas/Contact'
          description: >-
            Contact associated with the subscription. **Expandable** (shows only
            ID when not expanded).
        site:
          $ref: '#/components/schemas/Site'
          description: >-
            Site associated with the subscription. **Expandable** (shows only ID
            when not expanded).
        order:
          $ref: '#/components/schemas/Order'
          description: >-
            Order associated with the subscription. **Expandable** (shows only
            ID when not expanded).
        tenancy:
          $ref: '#/components/schemas/Tenancy'
          description: >-
            Tenancy associated with the subscription. **Expandable** (shows only
            ID when not expanded).
        billing_period:
          type: string
          enum:
            - monthly
            - weekly
            - every_four_weeks
            - every_three_months
            - every_six_months
            - yearly
            - one_time
        line_items:
          type: array
          description: List of line items in the subscription.
          items:
            $ref: '#/components/schemas/SubscriptionLineItem'
    Tenancy:
      type: object
      description: Tenancy
      additionalProperties: false
      properties:
        id:
          type: string
          description: Unique identifier for the tenancy.
        starts_at:
          type: string
          format: date-time
          description: Date and time for start of the tenancy period.
        ends_at:
          type:
            - string
            - 'null'
          format: date-time
          description: Date and time for end of the tenancy period.
        created_at:
          type: string
          format: date-time
          description: Creation date and time for the tenancy.
        updated_at:
          type: string
          format: date-time
          description: Last update date and time for the tenancy.
        subscription:
          $ref: '#/components/schemas/Subscription'
          description: >-
            Subscription associated with the tenancy. **Expandable** (shows only
            ID when not expanded).
        contact:
          $ref: '#/components/schemas/Contact'
          description: >-
            Contact associated with the tenancy. **Expandable** (shows only ID
            when not expanded).
        site:
          $ref: '#/components/schemas/Site'
          description: >-
            Site associated with the tenancy. **Expandable** (shows only ID when
            not expanded).
        order:
          description: >-
            Order associated with the tenancy. **Expandable** (shows only ID
            when not expanded).
          oneOf:
            - $ref: '#/components/schemas/Order'
            - type: 'null'
        unit_allocations:
          type:
            - array
            - 'null'
          description: >-
            Allocated units associated with the tenancy. **Expandable** (shows
            only ID when not expanded).
          items:
            $ref: '#/components/schemas/UnitAllocation'
    Unit:
      type: object
      description: Unit
      additionalProperties: false
      properties:
        id:
          type: string
          description: Unique identifier for the unit.
          pattern: ^unit_
        site:
          $ref: '#/components/schemas/Site'
          description: >-
            Site associated with the unit. **Expandable** (shows only ID when
            not expanded).
        unit_type:
          $ref: '#/components/schemas/UnitType'
          description: >-
            Unit type associated with the unit. **Expandable** (shows only ID
            when not expanded).
        reference_id:
          type: string
          description: Reference identifier for the unit.
        status:
          enum:
            - available
            - occupied
            - overlock
            - repossessed
            - reserved
            - unavailable
          description: Status of the unit.
          type: string
        unit_allocation:
          description: >-
            Current allocation for the unit. **Expandable** (shows only ID when
            not expanded).
          oneOf:
            - $ref: '#/components/schemas/UnitAllocation'
            - type: 'null'
        created_at:
          type: string
          format: date-time
          description: Creation date and time for the unit.
        updated_at:
          type: string
          format: date-time
          description: Last update date and time for the unit.
    Invoice:
      type: object
      description: Invoice
      additionalProperties: false
      properties:
        id:
          type: string
          description: Unique identifier for the invoice.
        number:
          type: string
          description: Identification number for the invoice.
        type:
          type: string
          enum:
            - subscription
            - ad_hoc
            - deposit
          description: Invoice's type.
        status:
          type: string
          enum:
            - draft
            - deleted
            - open
            - paid
            - uncollectible
            - void
          description: Status of the invoice.
        period_start:
          type:
            - string
            - 'null'
          format: date-time
          description: Date and time for start of invoice period.
        period_end:
          type:
            - string
            - 'null'
          format: date-time
          description: Date and time for end of invoice period.
        created_at:
          type:
            - string
            - 'null'
          format: date-time
          description: Creation date and time of the invoice.
        finalized_at:
          format: date-time
          type:
            - string
            - 'null'
          description: Date and time for when invoice was finalized.
        paid_at:
          format: date-time
          type:
            - string
            - 'null'
          description: Date and time for when invoice was paid.
        voided_at:
          format: date-time
          type:
            - string
            - 'null'
          description: Date and time for when invoice was cancelled without deletion.
        purchase_order_number:
          type:
            - string
            - 'null'
          description: Identification number for the purchase order.
        total:
          $ref: '#/components/schemas/Money'
          description: Gross cost of order after applying taxes and discounts.
        subtotal:
          $ref: '#/components/schemas/Money'
          description: Gross cost of order before applying taxes and discounts.
        tax:
          $ref: '#/components/schemas/Money'
          description: Total cost of taxes.
        amount_paid:
          $ref: '#/components/schemas/Money'
          description: Total amount towards invoice paid.
        amount_due:
          $ref: '#/components/schemas/Money'
        pre_payment_credit_notes_amount:
          $ref: '#/components/schemas/Money'
          description: Amount credited prior payment.
        post_payment_credit_notes_amount:
          $ref: '#/components/schemas/Money'
          description: Amount credited after payment.
        contact:
          $ref: '#/components/schemas/Contact'
          description: >-
            Contact associated with the invoice. **Expandable** (shows only ID
            when not expanded).
        site:
          $ref: '#/components/schemas/Site'
          description: >-
            Site associated with the invoice. **Expandable** (shows only ID when
            not expanded).
        tenancy:
          description: >-
            Tenancy associated with the invoice. **Expandable** (shows only ID
            when not expanded).
          oneOf:
            - $ref: '#/components/schemas/Tenancy'
            - type: 'null'
        subscription:
          description: >-
            Subscription associated with the invoice. **Expandable** (shows only
            ID when not expanded).
          oneOf:
            - $ref: '#/components/schemas/Subscription'
            - type: 'null'
        line_items:
          type: array
          items:
            $ref: '#/components/schemas/InvoiceLineItem'
    UnitType:
      type: object
      description: Unit Type
      additionalProperties: false
      properties:
        id:
          type: string
          pattern: ^utype_
          description: Unique identifier for the unit type.
        name:
          type: string
          description: Name of the unit type.
        status:
          enum:
            - bookable
            - hidden
            - lead_capture
          type: string
        slug:
          type: string
          description: >-
            URL-friendly identifier for the unit type, typically used in web
            addresses.
        size_description:
          type: string
          description: Description of the size of the unit type.
        selling_points:
          type: array
          items:
            type: string
          description: List of selling points for the unit type.
        stripe_product_id:
          type: string
          description: >-
            Stripe Product ID associated with the unit type, used for payment
            processing.
        require_insurance_coverage:
          type: boolean
          description: Indicates whether insurance coverage is required for this unit type.
        require_security_deposit:
          type: boolean
          description: Indicates whether a security deposit is required for this unit type.
        promotion:
          description: >-
            Promotional coupon associated with the unit type. **Expandable**
            (shows only ID when not expanded).
          oneOf:
            - $ref: '#/components/schemas/Coupon'
            - type: 'null'
        site:
          $ref: '#/components/schemas/Site'
          description: >-
            Site associated with the unit type. **Expandable** (shows only ID
            when not expanded).
        dynamic_pricing:
          type: boolean
          description: Indicates whether dynamic pricing is enabled for this unit type.
        dimensions:
          type: object
          description: Dimensions of the unit type.
          properties:
            length:
              type: number
              description: Length of the unit in feet.
            width:
              type: number
              description: Width of the unit in feet.
            height:
              type: number
              description: Height of the unit in feet.
            measurement_unit:
              enum:
                - ft
                - m
              type: string
        security_deposit:
          description: Security deposit amount for the unit type.
          oneOf:
            - $ref: '#/components/schemas/Money'
            - type: 'null'
        images:
          type: object
          additionalProperties: false
          properties:
            default:
              type:
                - object
                - 'null'
              additionalProperties: false
              properties:
                original:
                  type: string
                  format: uri
                  description: Original unresized image.
                small:
                  type: string
                  format: uri
                  description: Resized to max 250x250px.
                medium:
                  type: string
                  format: uri
                  description: Resized to max 500x500px.
                large:
                  type: string
                  format: uri
                  description: Resized to max 1000x1000px.
        created_at:
          type: string
          format: date-time
          description: Creation date and time for the unit type.
        updated_at:
          type: string
          format: date-time
          description: Last update date and time for the unit type.
        prices:
          type: array
          description: >-
            List of prices associated with the unit type, including different
            pricing options.
          items:
            $ref: '#/components/schemas/Price'
        _links:
          $ref: '#/components/schemas/Links'
    AccessToken:
      type: object
      description: Access Token
      additionalProperties: false
      properties:
        id:
          type: string
          pattern: ^tok_
          description: Unique identifier for the access token.
        name:
          type: string
          description: Name of the access token.
    Application:
      type: object
      description: Application
      additionalProperties: false
      properties:
        id:
          type: string
          pattern: ^app_
          description: Unique identifier for the application.
        name:
          type: string
          description: Name of the application.
    Curie:
      type: object
      description: CURIE definition for resolving namespaced link relations.
      additionalProperties: false
      properties:
        name:
          type: string
          description: CURIE prefix name
          enum:
            - bo
            - sf
        href:
          type: string
          description: URI template for resolving the CURIE.
        templated:
          type: boolean
          description: Whether the href is a URI template.
        title:
          type: string
          description: Human-readable title.
    Metadata:
      type: object
      description: >-
        Set of key-value pairs for storing additional information. [Learn more
        about metadata.](https://docs.stora.co/2025-09/guides/metadata)
      additionalProperties:
        type: string
    SiteAccessHoursDay:
      type: object
      description: Access Hours Day
      additionalProperties: false
      properties:
        status:
          enum:
            - set_hours
            - appointment
            - closed
          type: string
        open:
          type:
            - string
            - 'null'
          description: >-
            Opening time in HH:MM format. Has `null` for `appointment` or
            `closed` status.
        close:
          type:
            - string
            - 'null'
          description: >-
            Closing time in HH:MM format. Has `null` for `appointment` or
            `closed` status.
    Order:
      type: object
      description: Order
      additionalProperties: false
      properties:
        id:
          type: string
          description: Unique identifier for the order.
        billing_period:
          type:
            - string
            - 'null'
          enum:
            - monthly
            - weekly
            - every_four_weeks
            - every_three_months
            - every_six_months
            - yearly
            - one_time
            - null
        contact:
          description: >-
            Contact associated with the order. **Expandable** (shows only ID
            when not expanded).
          oneOf:
            - $ref: '#/components/schemas/Contact'
            - type: 'null'
        source:
          description: Source of the order.
          type:
            - string
            - 'null'
          enum:
            - backoffice
            - storefront
            - storefront_multi_step
            - import
            - public_api
            - unspecified
        site:
          $ref: '#/components/schemas/Site'
          description: >-
            Site associated with the order. **Expandable** (shows only ID when
            not expanded).
        tenancy:
          description: >-
            Tenancy associated with the order. **Expandable** (shows only ID
            when not expanded).
          oneOf:
            - $ref: '#/components/schemas/Tenancy'
            - type: 'null'
        subscription:
          description: >-
            Subscription associated with the order. **Expandable** (shows only
            ID when not expanded).
          oneOf:
            - $ref: '#/components/schemas/Subscription'
            - type: 'null'
        contract_template:
          description: >-
            Contract template associated with the order. **Expandable** (shows
            only ID when not expanded).
          oneOf:
            - $ref: '#/components/schemas/ContractTemplate'
            - type: 'null'
        coupon:
          description: >-
            Coupon associated with the order. **Expandable** (shows only ID when
            not expanded).
          oneOf:
            - $ref: '#/components/schemas/Coupon'
            - type: 'null'
        email_notifications:
          type: object
          description: Email notifications settings for the order.
          additionalProperties: false
          properties:
            booking_confirmation:
              type: boolean
              description: Whether to send the booking confirmation email.
            move_in_day:
              type: boolean
              description: Whether to send the move-in day email.
        metadata:
          $ref: '#/components/schemas/Metadata'
        line_items:
          type: array
          description: List of line items in the order.
          items:
            $ref: '#/components/schemas/OrderLineItem'
            description: >-
              Line item associated with the order. **Expandable** (shows only ID
              when not expanded).
        payment_method:
          type:
            - string
            - 'null'
          description: Payment method used for the order.
        payment_url:
          type:
            - string
            - 'null'
          format: uri
          description: >-
            URL for payment processing. Available only when the order is
            finalized.
        purchase_order_number:
          type:
            - string
            - 'null'
          description: Purchase order number associated with the order.
        starts_at:
          type:
            - string
            - 'null'
          description: >-
            Start date and time of the order. `now` indicates the order will
            start immediately after finalization.
        status:
          type: string
          description: Status of the order.
          enum:
            - draft
            - finalized
            - completed
            - abandoned
        created_at:
          type: string
          format: date-time
          description: Creation date and time of the order.
        updated_at:
          type: string
          format: date-time
          description: Last update date and time of the order.
        tax:
          $ref: '#/components/schemas/Money'
          description: Total cost of tax.
        subtotal:
          $ref: '#/components/schemas/Money'
          description: Gross cost of order before applying taxes and discounts.
        total:
          $ref: '#/components/schemas/Money'
          description: Gross cost of order after applying taxes and discounts.
        total_excluding_tax:
          $ref: '#/components/schemas/Money'
          description: >-
            Gross cost of order before applying taxes and after applying
            discounts.
        total_discount:
          $ref: '#/components/schemas/Money'
          description: Discount total towards order.
        one_time_total:
          $ref: '#/components/schemas/Money'
          description: Gross cost of one off products after applying taxes and discounts.
        one_time_total_excluding_tax:
          $ref: '#/components/schemas/Money'
          description: >-
            Gross cost of one off products before applying taxes and after
            applying discounts.
    SubscriptionLineItem:
      type: object
      description: Subscription Line Item
      additionalProperties: false
      properties:
        item:
          description: >-
            Item associated with the subscription line item. **Expandable**
            (shows only ID when not expanded).
          additionalProperties: true
          type: object
          properties:
            id:
              type: string
        price:
          $ref: '#/components/schemas/Money'
          description: Price of the subscription line item per unit.
        quantity:
          type: integer
          description: Quantity of the item in the subscription line item.
        type:
          type: string
          enum:
            - protection
            - unit_type
            - custom_product
        created_at:
          type: string
          format: date-time
          description: Creation date and time of the subscription line item.
        updated_at:
          type: string
          format: date-time
          description: Last update date and time of the subscription line item.
    UnitAllocation:
      type: object
      description: Unit Allocation
      additionalProperties: false
      properties:
        id:
          type: string
          description: Unique identifier for the unit allocation.
          pattern: ^alloc_
        created_at:
          type: string
          format: date-time
          description: Creation date and time.
        updated_at:
          type: string
          format: date-time
          description: Last update date and time.
        reserved_at:
          type:
            - string
            - 'null'
          format: date-time
          description: >-
            Date and time when the unit was reserved for the customer. A
            reserved unit is held for the customer but they do not yet have
            access. This field is null if the unit was allocated directly
            without a reservation phase.
        granted_access_at:
          type:
            - string
            - 'null'
          format: date-time
          description: >-
            Date and time when the customer was granted access to the unit
            (move-in date). This marks when the customer can physically access
            their unit. This field is null if access has not yet been granted.
        unit:
          $ref: '#/components/schemas/Unit'
          description: >-
            Unit associated with this allocation. **Expandable** (shows only ID
            when not expanded).
        tenancy:
          $ref: '#/components/schemas/Tenancy'
          description: >-
            Tenancy associated with this allocation. **Expandable** (shows only
            ID when not expanded).
    Money:
      type: object
      description: Money
      additionalProperties: false
      properties:
        amount:
          type: integer
          description: Amount of money in the smallest currency unit (e.g., cents for USD).
        currency:
          enum:
            - AED
            - AUD
            - BGN
            - BRL
            - CAD
            - CHF
            - CZK
            - DKK
            - EUR
            - GBP
            - HKD
            - HUF
            - MXN
            - MYR
            - NOK
            - NZD
            - PLN
            - RON
            - SEK
            - SGD
            - THB
            - USD
          description: ISO 4217 currency code.
          type: string
        formatted:
          type: string
          description: >-
            Formatted string representation of the money amount, including the
            currency symbol.
    InvoiceLineItem:
      type: object
      description: Invoice Line Item
      additionalProperties: false
      properties:
        description:
          type: string
          description: Name of the line item product.
        type:
          type:
            - string
            - 'null'
          enum:
            - unit
            - protection
            - recurring_product
            - one_time_product
            - null
          description: Type of the line item product.
        accounting_code:
          type: string
          description: Unique account identifier.
        quantity:
          type: integer
          description: Quantity of product.
        proration:
          type: boolean
          description: Time based distribution.
        total:
          $ref: '#/components/schemas/Money'
          description: Gross cost of line item.
        price:
          $ref: '#/components/schemas/Money'
          description: Per-item cost of line item.
        tax:
          $ref: '#/components/schemas/Money'
          description: Total cost of taxes.
        total_excluding_tax:
          $ref: '#/components/schemas/Money'
          description: Total cost of line item before applying taxes.
        discount_total:
          $ref: '#/components/schemas/Money'
          description: Discount towards line item.
    Coupon:
      oneOf:
        - $ref: '#/components/schemas/CouponPercentage'
        - $ref: '#/components/schemas/CouponAmount'
        - description: ID-only reference (unexpanded)
          type: object
          additionalProperties: false
          properties:
            id:
              type: string
              pattern: ^cpn_
    Price:
      type: object
      description: Price
      additionalProperties: false
      properties:
        price:
          $ref: '#/components/schemas/Money'
          description: Price for the specified billing period.
        billing_period:
          enum:
            - monthly
            - weekly
            - every_four_weeks
            - every_three_months
            - every_six_months
            - yearly
            - one_time
          description: Billing period for the price.
          type: string
        stripe_price_id:
          type: string
          description: >-
            Stripe Price ID associated with this price, used for payment
            processing.
    Links:
      type: object
      description: Links related to the resource.
      additionalProperties:
        type: object
        additionalProperties: false
        properties:
          href:
            type: string
            description: Relative path for API links, relative path for CURIE links.
          method:
            type: string
            description: Available only for API links. Other links use always `get`.
            enum:
              - get
              - post
              - patch
              - delete
          title:
            type: string
            description: Human-readable label for the link.
          reference:
            type:
              - string
              - 'null'
            description: >-
              OpenAPI reference for API links. Component schema for self links,
              path operation for action links.
    ContractTemplate:
      type: object
      description: Contract Template
      additionalProperties: false
      properties:
        id:
          type: string
          description: Unique identifier for the contract template.
        name:
          type: string
          description: Name of the contract template.
        created_at:
          type: string
          format: date-time
          description: Creation date and time of the contract template.
        updated_at:
          type: string
          format: date-time
          description: Last update date and time of the contract template.
    OrderLineItem:
      type: object
      description: Order Line Item
      additionalProperties: false
      properties:
        id:
          type: string
          description: Unique identifier for the order line item.
        item:
          description: >-
            Item associated with the line item. Can be a Unit type, Protection
            level, or Product. **Expandable** (shows only ID when not expanded).
          oneOf:
            - $ref: '#/components/schemas/UnitType'
            - $ref: '#/components/schemas/ProtectionLevel'
            - $ref: '#/components/schemas/Product'
            - type: 'null'
        price:
          $ref: '#/components/schemas/Money'
          description: Per-item cost of line item.
        quantity:
          type: integer
          description: Quantity of the item in the order line item.
        type:
          type: string
          enum:
            - unit_type
            - protection
            - product
            - security_deposit
        created_at:
          type: string
          format: date-time
          description: Creation date and time of the order line item.
        updated_at:
          type: string
          format: date-time
          description: Last update date and time of the order line item.
        total:
          $ref: '#/components/schemas/Money'
          description: Gross cost of line item.
        tax:
          $ref: '#/components/schemas/Money'
          description: Total cost of taxes.
        total_excluding_tax:
          $ref: '#/components/schemas/Money'
          description: Total cost of line item before applying taxes.
        discount_total:
          $ref: '#/components/schemas/Money'
          description: Discount towards line item.
    CouponPercentage:
      type: object
      description: Coupon with percentage discount
      additionalProperties: false
      required:
        - type
      properties:
        id:
          type: string
          pattern: ^cpn_
          description: Unique identifier for the coupon.
        type:
          const: percentage
          description: Type of the coupon, which is `percentage` in this case.
        percent:
          type: number
          description: >-
            Percentage discount provided by the coupon. E.g. 20 for a 20%
            discount.
        name:
          type: string
          description: Name of the coupon.
        code:
          type:
            - string
            - 'null'
          description: Unique code for the coupon for non-public coupons.
        title:
          type:
            - string
            - 'null'
          description: Title of the coupon.
        public:
          type: boolean
          description: >-
            Indicates if the coupon is publicly available for any contact to
            use. When set to `true`, the `code` field is not used.
        max_redemptions:
          type:
            - integer
            - 'null'
          description: Maximum number of times the coupon can be redeemed.
        duration:
          enum:
            - once
            - forever
            - repeating
          description: Duration of the coupon.
          type: string
        billing_period:
          type:
            - string
            - 'null'
          enum:
            - monthly
            - weekly
            - every_four_weeks
            - every_three_months
            - every_six_months
            - yearly
            - one_time
            - null
          description: Used for `repeating` duration.
        months:
          type:
            - integer
            - 'null'
          description: >-
            Number of months the coupon is valid for, applicable for `repeating`
            duration.
        auto_apply_to:
          $ref: '#/components/schemas/CouponAutoApplyTo'
        created_at:
          type: string
          format: date-time
          description: Creation date and time of the coupon.
        updated_at:
          type: string
          format: date-time
          description: Last update date and time of the coupon.
    CouponAmount:
      type: object
      description: Coupon with fixed amount discount
      additionalProperties: false
      required:
        - type
      properties:
        id:
          type: string
          pattern: ^cpn_
          description: Unique identifier for the coupon.
        type:
          const: amount
          description: Type of the coupon, which is `amount` in this case.
        amount:
          $ref: '#/components/schemas/Money'
          description: Amount deducted from the price when the coupon is applied.
        name:
          type: string
          description: Name of the coupon.
        code:
          type:
            - string
            - 'null'
          description: Unique code for the coupon for non-public coupons.
        title:
          type:
            - string
            - 'null'
          description: Title of the coupon.
        public:
          type: boolean
          description: >-
            Indicates if the coupon is publicly available for any contact to
            use. When set to `true`, the `code` field is not used.
        max_redemptions:
          type:
            - integer
            - 'null'
          description: Maximum number of times the coupon can be redeemed.
        duration:
          enum:
            - once
            - forever
            - repeating
          description: Duration of the coupon.
          type: string
        billing_period:
          type:
            - string
            - 'null'
          enum:
            - monthly
            - weekly
            - every_four_weeks
            - every_three_months
            - every_six_months
            - yearly
            - one_time
            - null
          description: Used for `repeating` duration.
        months:
          type:
            - integer
            - 'null'
          description: >-
            Number of months the coupon is valid for, applicable for `repeating`
            duration.
        auto_apply_to:
          $ref: '#/components/schemas/CouponAutoApplyTo'
        created_at:
          type: string
          format: date-time
          description: Creation date and time of the coupon.
        updated_at:
          type: string
          format: date-time
          description: Last update date and time of the coupon.
    ProtectionLevel:
      type: object
      description: Protection Level
      additionalProperties: false
      properties:
        id:
          type: string
          pattern: ^plvl_
          description: Unique identifier for the protection level.
        stripe_product_id:
          type: string
          description: >-
            Stripe Product ID associated with the protection level, used for
            payment processing.
        cover_level:
          $ref: '#/components/schemas/Money'
          description: Monetary value representing the cover level of the protection.
        account_code:
          type:
            - string
            - 'null'
          description: Account code associated with the protection level.
        public:
          type: boolean
          description: Indicates whether the protection level is available for selection.
        prices:
          type: array
          items:
            $ref: '#/components/schemas/Price'
        created_at:
          type: string
          format: date-time
          description: Creation date and time of the protection level.
        updated_at:
          type: string
          format: date-time
          description: Last update date and time of the protection level.
    Product:
      type: object
      description: Product
      additionalProperties: false
      properties:
        id:
          type: string
          pattern: ^prod_
          description: Unique identifier for the product.
        site:
          $ref: '#/components/schemas/Site'
          description: >-
            Site associated with the product. **Expandable** (shows only ID when
            not expanded).
        name:
          type: string
          description: Name of the product.
        sku:
          type:
            - string
            - 'null'
          description: Stock keeping unit (SKU) of the product.
        description:
          type: string
          description: Detailed description of the product.
        category:
          $ref: '#/components/schemas/ProductCategory'
          description: >-
            Category associated with the product. **Expandable** (shows only ID
            when not expanded).
        charge_type:
          enum:
            - one_time
            - recurring
          description: Type of charge for the product.
          type: string
        accounting_code:
          type:
            - string
            - 'null'
          description: Accounting code associated with the product, if any.
        prices:
          type: array
          items:
            $ref: '#/components/schemas/Price'
        created_at:
          type: string
          format: date-time
          description: Creation date and time of the product.
        updated_at:
          type: string
          format: date-time
          description: Last update date and time of the product.
    CouponAutoApplyTo:
      type: object
      description: Defines how the coupon should be auto-applied when used on an order.
      additionalProperties: false
      properties:
        unit_types:
          type: boolean
          description: Whether the coupon applies to unit type line items.
        protections:
          type: boolean
          description: Whether the coupon applies to protection line items.
        products:
          type: boolean
          description: Whether the coupon applies to product line items.
        subscriptions:
          type: boolean
          description: Whether the coupon applies to the subscription.
    ProductCategory:
      type: object
      description: Product Category
      additionalProperties: false
      properties:
        id:
          type: string
          description: Unique identifier for the product category.
        name:
          type: string
          description: Name of the product category.
  securitySchemes:
    Bearer:
      description: Bearer Token necessary to use API
      type: http
      scheme: bearer
      bearerFormat: token
    OAuth2:
      type: oauth2
      description: OAuth 2 authentication
      flows:
        clientCredentials:
          tokenUrl: /oauth2/token
          scopes:
            public.access_token:read: Access Token (Read)
            public.application:read: Application (Read)
            public.contact:read: Contact (Read)
            public.contact:write: Contact (Write)
            public.contract:read: Contract (Read)
            public.contract_template:read: Contract Template (Read)
            public.coupon:read: Coupon (Read)
            public.credit_note:read: Credit Note (Read)
            public.deal:read: Deal (Read)
            public.deal:write: Deal (Write)
            public.deal_stage:read: Deal Stage (Read)
            public.identity_verification:read: Identity Verification (Read)
            public.invoice:read: Invoice (Read)
            public.note:read: Note (Read)
            public.note:write: Note (Write)
            public.order:read: Order (Read)
            public.order:write: Order (Write)
            public.product:read: Product (Read)
            public.product:write: Product (Write)
            public.product_category:read: Product Category (Read)
            public.protection_level:read: Protection Level (Read)
            public.protection_level:write: Protection Level (Write)
            public.site:read: Site (Read)
            public.staff:read: Staff (Read)
            public.subscription:read: Subscription (Read)
            public.task:read: Task (Read)
            public.task:write: Task (Write)
            public.tenancy:read: Tenancy (Read)
            public.timeline_event:read: Timeline Event (Read)
            public.timeline_event:write: Timeline Event (Write)
            public.timeline_source:read: Timeline Source (Read)
            public.timeline_template:read: Timeline Template (Read)
            public.unit:read: Unit (Read)
            public.unit:write: Unit (Write)
            public.unit_allocation:read: Unit Allocation (Read)
            public.unit_type:read: Unit Type (Read)
            public.unit_type:write: Unit Type (Write)
            public.webhook_endpoint:read: Webhook Endpoint (Read)
            public.webhook_endpoint:write: Webhook Endpoint (Write)
        authorizationCode:
          authorizationUrl: https://app.stora.co/oauth2/authorize
          tokenUrl: /oauth2/token
          scopes:
            public.access_token:read: Access Token (Read)
            public.application:read: Application (Read)
            public.contact:read: Contact (Read)
            public.contact:write: Contact (Write)
            public.contract:read: Contract (Read)
            public.contract_template:read: Contract Template (Read)
            public.coupon:read: Coupon (Read)
            public.credit_note:read: Credit Note (Read)
            public.deal:read: Deal (Read)
            public.deal:write: Deal (Write)
            public.deal_stage:read: Deal Stage (Read)
            public.identity_verification:read: Identity Verification (Read)
            public.invoice:read: Invoice (Read)
            public.note:read: Note (Read)
            public.note:write: Note (Write)
            public.order:read: Order (Read)
            public.order:write: Order (Write)
            public.product:read: Product (Read)
            public.product:write: Product (Write)
            public.product_category:read: Product Category (Read)
            public.protection_level:read: Protection Level (Read)
            public.protection_level:write: Protection Level (Write)
            public.site:read: Site (Read)
            public.staff:read: Staff (Read)
            public.subscription:read: Subscription (Read)
            public.task:read: Task (Read)
            public.task:write: Task (Write)
            public.tenancy:read: Tenancy (Read)
            public.timeline_event:read: Timeline Event (Read)
            public.timeline_event:write: Timeline Event (Write)
            public.timeline_source:read: Timeline Source (Read)
            public.timeline_template:read: Timeline Template (Read)
            public.unit:read: Unit (Read)
            public.unit:write: Unit (Write)
            public.unit_allocation:read: Unit Allocation (Read)
            public.unit_type:read: Unit Type (Read)
            public.unit_type:write: Unit Type (Write)
            public.webhook_endpoint:read: Webhook Endpoint (Read)
            public.webhook_endpoint:write: Webhook Endpoint (Write)

````