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

# Changelog

> Version history for the Stora Public API.

<Update label="2026-05-20" tags={["Deals API"]}>
  **Added**

  * **Deals API**: create, update, and destroy endpoints
</Update>

<Update label="2026-05-06" tags={["Orders API"]}>
  **Added**

  * **Orders API**: filter by `source` and `billing_period`, plus `updated_at` and `starts_at` time-range filters
</Update>

<Update label="2026-04-14" tags={["Contacts API"]}>
  **Added**

  * **Contacts API**: filter by `use_case`, `type`, `source` `marketing_source`
</Update>

<Update label="2026-04-08" tags={["Contacts API"]}>
  **Added**

  * **Contacts API**: expose `identity_check`
</Update>

<Update label="2026-04-03" tags={["Contracts API"]}>
  **Added**

  * **Contracts API**: filter by `contact_id`, `contract_template_id` and `tenancy_id` query params
</Update>

<Update label="2026-04-01" tags={["Identity Verifications API"]}>
  **Added**

  * **Identity Verifications API**: webhook events
</Update>

<Update label="2026-03-31" tags={["Identity Verifications API", "Unit Types API"]}>
  **Added**

  * **Identity Verifications API**: read endpoints
  * **Unit Types API**: `promotion` expandable association
</Update>

<Update label="2026-03-24" tags={["Deals API"]}>
  **Added**

  * **Deals API**: index filters
</Update>

<Update label="2026-03-23" tags={["Unit Types API"]}>
  **Added**

  * **Unit Types API**: filter by `site_id` query parameter
</Update>

<Update label="2026-03-20" tags={["Contracts API", "Unit Types API"]}>
  **Added**

  * **Contracts API**: link to sign the contract on Storefront
  * **Unit Types API**: link to create a new order on Storefront
</Update>

<Update label="2026-03-19" tags={["Images API"]}>
  **Added**

  * **Images API**: expose sites and unit types images
</Update>

<Update label="2026-03-17" tags={["Deals API"]}>
  **Added**

  * **Deals API**: add `lose` endpoint; add `reopen` endpoint
</Update>

<Update label="2026-03-13" tags={["Invoices API"]}>
  **Fixed**

  * **Invoices API**: response payload will show accounting nominal code
</Update>

<Update label="2026-03-11" tags={["Invoices API"]}>
  **Added**

  * **Invoices API**: add `subscription` and `tenancy` expandable objects and filters to invoice resource
</Update>

<Update label="2026-03-09" tags={["Deals API"]}>
  **Added**

  * **Deals API**: add `win` endpoint
</Update>

<Update label="2026-03-04" tags={["Contacts API", "Orders API", "Tasks API"]}>
  **Added**

  * **Contacts API**: add `metadata` to contact resource
  * **Orders API**: add `metadata` to order resource
  * **Tasks API**: add `metadata` to task resource
</Update>

<Update label="2026-03-03" tags={["Notes API", "Timeline Events API", "Timeline Sources API", "Timeline Templates API"]}>
  **Added**

  * **Notes API**: add `metadata` to note resource
  * **Timeline Events API**: create, update, and destroy endpoints
  * **Timeline Sources API**: read endpoints
  * **Timeline Templates API**: read endpoints
</Update>

<Update label="2026-02-27" tags={["Contracts API", "Deals API"]}>
  **Added**

  * **Contracts API**: `contract.created` webhook event; `contract.signed` webhook event
  * **Deals API**: `deal.won` webhook event; `deal.reopened` webhook event; `deal.lost` webhook event
</Update>

<Update label="2026-02-26" tags={["Contracts API"]}>
  **Added**

  * **Contracts API**: filter by site ID and status

  **Fixed**

  * **Contracts API (beta)**: replace `subscription` with `tenancy` in contract response
</Update>

<Update label="2026-02-24" tags={["Contracts API", "Notes API", "Webhook Endpoints API"]}>
  **Added**

  * **Contracts API**: show endpoint; list endpoint
  * **Notes API**: filter by resource\_type
  * **Webhook Endpoints API**: add `metadata` to webhook endpoint resource
</Update>

<Update label="2026-02-20" tags={["Credit Notes API", "Deals API", "Units API"]}>
  **Added**

  * **Credit Notes API**: sorting
  * **Deals API**: `deal.created` webhook event; `deal.updated` webhook event
  * **Units API**: search filter on the list endpoint
</Update>

<Update label="2026-02-17" tags={["Notes API", "Sites API", "Subscriptions API"]}>
  **Added**

  * **Notes API**: `note.created` webhook event; `note.updated` webhook event; create endpoint
  * **Sites API**: search filter on the list endpoint
  * **Subscriptions API**: filter by contact ID

  **Fixed**

  * **OpenAPI**: add missing pagination params to Staff API
</Update>

<Update label="2026-02-16" tags={["Contacts API", "Notes API", "Units API"]}>
  **Added**

  * **Contacts API**: search filter on the list endpoint
  * **Notes API**: update endpoint; destroy endpoint; show endpoint
  * **Units API**: overlock endpoint; remove overlock endpoint

  **Fixed**

  * **OpenAPI**: fixes (consistency & references)
</Update>

<Update label="2026-02-13" tags={["Deal Stages API", "Deals API", "Notes API"]}>
  **Added**

  * **Deal Stages API**: list and show endpoints
  * **Deals API**: list and show endpoints
  * **Notes API**: list endpoint
</Update>

<Update label="2026-02-11" tags={["Staff API", "Units API"]}>
  **Added**

  * **Staff API**: search filter by name or email
  * **Units API**: add `unit_allocation` expandable object to unit resource
</Update>

<Update label="2026-02-10" tags={["Units API"]}>
  **Added**

  * **Units API**: grant access endpoint; deallocate endpoint
</Update>

<Update label="2026-02-09" tags={["Tasks API"]}>
  **Added**

  * **Tasks API**: index filters and sorting
</Update>

<Update label="2026-02-05" tags={["Units API"]}>
  **Added**

  * **Units API**: reserve endpoint
</Update>

<Update label="2026-02-04" tags={["Tasks API", "Webhook Endpoints API"]}>
  **Added**

  * **Tasks API**: `task.reopened` webhook event; `task.updated` webhook event
  * **Webhook Endpoints API**: endpoints scoped and managed by OAuth apps
</Update>

<Update label="2026-02-03" tags={["Webhook Endpoints API"]}>
  **Added**

  * **Webhook Endpoints API**: add `creator` to webhook endpoint resource
</Update>

<Update label="2026-01-29" tags={["Tasks API"]}>
  **Added**

  * **Tasks API**: `task.completed` webhook event; `task.created` webhook event
</Update>

<Update label="2026-01-28" tags={["Staff API"]}>
  **Added**

  * **Staff API**: show endpoint
</Update>

<Update label="2026-01-27" tags={["Staff API"]}>
  **Added**

  * **Staff API**: list endpoint
</Update>

<Update label="2026-01-23" tags={["Tasks API"]}>
  **Added**

  * **Tasks API**: open endpoint
</Update>

<Update label="2026-01-22" tags={["Tasks API", "Unit Allocations API"]}>
  **Added**

  * **Tasks API**: complete endpoint; delete endpoint; update endpoint
  * **Unit Allocations API**: list endpoint
</Update>

<Update label="2026-01-21" tags={["Unit Allocations API"]}>
  **Added**

  * **OAuth 2**: Authorization Code flow support
  * **Unit Allocations API**: show endpoint
</Update>

<Update label="2026-01-19" tags={["Contacts API"]}>
  **Added**

  * **Contacts API**: filter by email
</Update>

<Update label="2026-01-16" tags={["Tasks API"]}>
  **Added**

  * **Tasks API**: create endpoint
</Update>

<Update label="2026-01-13" tags={["Tasks API"]}>
  **Added**

  * **Tasks API**: show endpoint; list endpoint
</Update>

<Update label="2025-12-17" tags={["Webhook Endpoints API"]}>
  **Added**

  * **Webhook Endpoints API**: index filters
</Update>

<Update label="2025-12-16" tags={["Contacts API", "Contract Templates API", "Coupons API", "Credit Notes API", "Invoices API", "Orders API", "Orders Line Items API", "Product Categories API", "Products API", "Protection Levels API", "Sites API", "Subscriptions API", "Tenancies API", "Unit Types API", "Units API"]} rss={{ title: "Official release of the 2025-09 version" }}>
  Official release of the `2025-09` version.

  **Added**

  * **Contacts API**: initial
  * **Contract Templates API**: initial
  * **Coupons API**: initial
  * **Credit Notes API**: PDF support; filters; initial
  * **Filters**: Time ranged filters
  * **Invoices API**: PDF support; filters; initial
  * **Orders API**: orders summary; support for starts at now; update action; filters; initial version of the create action; add `billing_period` to the order; initial version of index and show actions
  * **Orders Line Items API**: delete endpoint; update endpoint; create endpoint; list endpoint
  * **Product Categories API**: initial
  * **Products API**: filters; initial
  * **Protection Levels API**: initial
  * **Sites API**: initial
  * **Subscriptions API**: initial
  * **Tenancies API**: initial
  * **Unit Types API**: Base Price; initial
  * **Units API**: filters; initial
  * Add the `Money` component
  * Expandable responses
  * Initial resource sorting
  * Preparation for expandable resources in responses
  * Webhooks Core
</Update>