Skip to main content
PATCH
/
2025-09
/
deals
/
{deal_id}
Update a Deal
curl --request PATCH \
  --url https://public-api.stora.co/2025-09/deals/{deal_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Acme Corp Storage (Renamed)",
  "line_items": [
    {
      "type": "unit_type",
      "item": {
        "id": "utype_f18fc91387cdf710"
      }
    }
  ]
}
'
{
  "deal": {
    "id": "deal_127b3057d5df338e",
    "assignee": {
      "id": "staff_947b3057d5df338e"
    },
    "contact": {
      "id": "con_1234567890abcdef"
    },
    "created_at": "2025-02-22T14:41:00Z",
    "creator": {
      "id": "staff_947b3057d5df338e"
    },
    "line_items": [
      {
        "item": {
          "id": "utype_f18fc91387cdf710"
        },
        "quantity": 1,
        "type": "unit_type"
      }
    ],
    "lost_reason": null,
    "metadata": {},
    "name": "Acme Corp Storage (Renamed)",
    "note": "£50 per month",
    "site": {
      "id": "site_14b419f1096013f1"
    },
    "stage": {
      "id": "dstg_127b3057d5df338e"
    },
    "starts_at": null,
    "status": "open",
    "updated_at": "2025-02-22T14:41:00Z",
    "value_estimate": "£50 per month"
  },
  "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"
      }
    ]
  }
}

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.

Authorizations

Authorization
string
header
required

Bearer Token necessary to use API

Path Parameters

deal_id
string
required

The ID of the deal to retrieve

Body

application/json

Update Deal Request

name
string

The name of the deal

contact
object
stage
object
assignee
object

To remove the association, set assignee to null.

site
object

To remove the association, set site to null.

note
string | null

Free-text note for the deal. Displayed under 'Deal value estimate' in Backoffice. To remove the existing value, set to null.

starts_at
string<date-time> | null

The intended move-in date. To remove the existing move-in date, set to null.

metadata
object

Set of key-value pairs for storing additional information on the deal. Learn more about metadata.

line_items
object[] | null

Skip this property (do not include it inside the request) if you don't want to update the line items. Existing line items not included here in the update request will be removed. To remove all line items, provide an empty array. At most one item per type is allowed.

Maximum array length: 2

Deal Unit Type Line Item

Response

deal updated

Single Deal

deal
object

Deal

meta
object