---
title: "Opens several budgets"
method: PATCH
path: "/api/v2/deals/open"
tags: ["Deals"]
---

# Opens several budgets

`PATCH /api/v2/deals/open`

## Request

- Base URL: `https://developer.productive.io` (the document declares no server; this is the origin it was published from)
- URL: `https://developer.productive.io/api/v2/deals/open`
- Auth: none declared

Reopens several closed budgets in one request. Requires the JSON:API bulk extension header
(`Content-Type: application/vnd.api+json; ext=bulk`); the single-budget endpoint lives at
`/api/v2/deals/{id}/open`. Open is a budget-only action, so a sales deal in the payload is
rejected. Authorization is all or nothing — when any budget is denied (403) or cannot be
opened (409, e.g. it is already open or its delivered on falls in a locked financial month),
none of them open and every blocked row is reported with its `meta.bulk_index`. A batch is
limited to 100 budgets; a larger one is rejected with a 422 before any check runs.

## Request body

- object
  - `data` object[]
    - `id` Id, required (unresolved $ref)
    - `type` 'deals', required

## Response `200`

Collection deal

- object: Paginated list of deal records in JSON:API format.
  - `data` object[]: A deal resource object.
    - `attributes` object: Deal attributes.
      - `access_to_deal` AccessToDeal (unresolved $ref)
      - `amount_credited` AmountCredited (unresolved $ref)
      - `amount_credited_default` AmountCreditedDefault (unresolved $ref)
      - `amount_credited_normalized` AmountCreditedNormalized (unresolved $ref)
      - `billable_time` BillableTime (unresolved $ref)
      - `budget` Budget (unresolved $ref)
      - `budget_total` BudgetTotal (unresolved $ref)
      - `budget_total_default` BudgetTotalDefault (unresolved $ref)
      - `budget_total_normalized` BudgetTotalNormalized (unresolved $ref)
      - `budget_used` BudgetUsed (unresolved $ref)
      - `budget_used_default` BudgetUsedDefault (unresolved $ref)
      - `budget_used_normalized` BudgetUsedNormalized (unresolved $ref)
      - `budget_warning` BudgetWarning (unresolved $ref)
      - `budgeted_time` BudgetedTime (unresolved $ref)
      - `client_access` ClientAccess (unresolved $ref)
      - `closed_at` ClosedAt (unresolved $ref)
      - `color_id` ColorId (unresolved $ref)
      - `connection_status` ConnectionStatus (unresolved $ref)
      - `cost` Cost (unresolved $ref)
      - `cost_default` CostDefault (unresolved $ref)
      - `cost_normalized` CostNormalized (unresolved $ref)
      - `created_at` CreatedAt (unresolved $ref)
      - `currency` Currency (unresolved $ref)
      - `currency_default` CurrencyDefault (unresolved $ref)
      - `currency_normalized` CurrencyNormalized (unresolved $ref)
      - `custom_fields` CustomFields (unresolved $ref)
      - `date` Date (unresolved $ref)
      - `deal_number` DealNumber (unresolved $ref)
      - `deal_type_id` DealTypeId (unresolved $ref)
      - `deleted_at` DeletedAt (unresolved $ref)
      - `delivered_on` DeliveredOn (unresolved $ref)
      - `discount` Discount (unresolved $ref)
      - `draft_invoiced` DraftInvoiced (unresolved $ref)
      - `draft_invoiced_default` DraftInvoicedDefault (unresolved $ref)
      - `draft_invoiced_normalized` DraftInvoicedNormalized (unresolved $ref)
      - `editor_config` EditorConfig (unresolved $ref)
      - `email_key` EmailKey (unresolved $ref)
      - `end_date` EndDate (unresolved $ref)
      - `estimated_time` EstimatedTime (unresolved $ref)
      - `exchange_date` ExchangeDate (unresolved $ref)
      - `exchange_rate` string, nullable: Exchange rate from deal currency to organization default currency.
      - `expense` Expense (unresolved $ref)
      - `expense_approval` ExpenseApproval (unresolved $ref)
      - `expense_default` ExpenseDefault (unresolved $ref)
      - `expense_normalized` ExpenseNormalized (unresolved $ref)
      - `external_id` ExternalId (unresolved $ref)
      - `external_sync` ExternalSync (unresolved $ref)
      - `footer` Footer (unresolved $ref)
      - `footer_interpolated` FooterInterpolated (unresolved $ref)
      - `invoiced` Invoiced (unresolved $ref)
      - `invoiced_default` InvoicedDefault (unresolved $ref)
      - `invoiced_normalized` InvoicedNormalized (unresolved $ref)
      - `last_activity_at` LastActivityAt (unresolved $ref)
      - `lost_comment` LostComment (unresolved $ref)
      - `man_day_minutes` ManDayMinutes (unresolved $ref)
      - `manual_invoicing_status_id` ManualInvoicingStatusId (unresolved $ref)
      - `manually_invoiced` union: Amount marked as manually invoiced outside Productive (budget currency).
        - ManuallyInvoiced (unresolved $ref)
        - integer
      - `manually_invoiced_default` ManuallyInvoicedDefault (unresolved $ref)
      - `manually_invoiced_normalized` ManuallyInvoicedNormalized (unresolved $ref)
      - `name` Name (unresolved $ref)
      - `note` Note (unresolved $ref)
      - `note_interpolated` NoteInterpolated (unresolved $ref)
      - `number` Number (unresolved $ref)
      - `origin_deal_id` OriginDealId (unresolved $ref)
      - `pending_invoicing` PendingInvoicing (unresolved $ref)
      - `pending_invoicing_default` PendingInvoicingDefault (unresolved $ref)
      - `pending_invoicing_normalized` PendingInvoicingNormalized (unresolved $ref)
      - `position` Position (unresolved $ref)
      - `previous_probability` PreviousProbability (unresolved $ref)
      - `probability` Probability (unresolved $ref)
      - `profit` Profit (unresolved $ref)
      - `profit_default` ProfitDefault (unresolved $ref)
      - `profit_margin` ProfitMargin (unresolved $ref)
      - `profit_margin_default` ProfitMarginDefault (unresolved $ref)
      - `profit_margin_normalized` ProfitMarginNormalized (unresolved $ref)
      - `profit_normalized` ProfitNormalized (unresolved $ref)
      - `projected_revenue` ProjectedRevenue (unresolved $ref)
      - `projected_revenue_default` ProjectedRevenueDefault (unresolved $ref)
      - `projected_revenue_normalized` ProjectedRevenueNormalized (unresolved $ref)
      - `proposal_footer` ProposalFooter (unresolved $ref)
      - `proposal_footer_interpolated` ProposalFooterInterpolated (unresolved $ref)
      - `proposal_note` ProposalNote (unresolved $ref)
      - `proposal_note_interpolated` ProposalNoteInterpolated (unresolved $ref)
      - `purchase_order_number` PurchaseOrderNumber (unresolved $ref)
      - `revenue` Revenue (unresolved $ref)
      - `revenue_default` RevenueDefault (unresolved $ref)
      - `revenue_distribution_method` RevenueDistributionMethod (unresolved $ref)
      - `revenue_distribution_type` RevenueDistributionType (unresolved $ref)
      - `revenue_normalized` RevenueNormalized (unresolved $ref)
      - `rounding_interval_id` RoundingIntervalId (unresolved $ref)
      - `rounding_method_id` RoundingMethodId (unresolved $ref)
      - `sales_closed_at` SalesClosedAt (unresolved $ref)
      - `sales_closed_on` SalesClosedOn (unresolved $ref)
      - `sales_status_updated_at` SalesStatusUpdatedAt (unresolved $ref)
      - `sample_data` SampleData (unresolved $ref)
      - `service_type_restricted_tracking` ServiceTypeRestrictedTracking (unresolved $ref)
      - `services_revenue` ServicesRevenue (unresolved $ref)
      - `services_revenue_default` ServicesRevenueDefault (unresolved $ref)
      - `services_revenue_normalized` ServicesRevenueNormalized (unresolved $ref)
      - `suffix` Suffix (unresolved $ref)
      - `tag_list` TagList (unresolved $ref)
      - `time_approval` TimeApproval (unresolved $ref)
      - `time_to_close` TimeToClose (unresolved $ref)
      - `todo_count` TodoCount (unresolved $ref)
      - `todo_due_date` TodoDueDate (unresolved $ref)
      - `tracking_type_id` TrackingTypeId (unresolved $ref)
      - `validate_expense_when_closing` ValidateExpenseWhenClosing (unresolved $ref)
      - `worked_time` WorkedTime (unresolved $ref)
      - `days_in_current_stage` DaysInCurrentStage (unresolved $ref)
      - `days_since_created` DaysSinceCreated (unresolved $ref)
      - `days_since_last_activity` DaysSinceLastActivity (unresolved $ref)
      - `deal_value` union: The fixed monetary value of the deal in the deal's currency, expressed in cents.
        - DealValue (unresolved $ref)
        - string
      - `deal_value_per_period` DealValuePerPeriod (unresolved $ref)
      - `deal_value_per_period_default` DealValuePerPeriodDefault (unresolved $ref)
      - `deal_value_per_period_normalized` DealValuePerPeriodNormalized (unresolved $ref)
      - `deal_value_source` DealValueSource (unresolved $ref)
      - `deal_value_total` DealValueTotal (unresolved $ref)
      - `deal_value_total_default` DealValueTotalDefault (unresolved $ref)
      - `deal_value_total_normalized` DealValueTotalNormalized (unresolved $ref)
      - `retainer_deal_value_type` RetainerDealValueType (unresolved $ref)
      - `retainer_interval` RetainerInterval (unresolved $ref)
      - `retainer_interval_count` RetainerIntervalCount (unresolved $ref)
      - `time_entry_requirements` TimeEntryRequirements (unresolved $ref)
      - `overtime_time` OvertimeTime (unresolved $ref)
      - `export_error` ExportError (unresolved $ref)
      - `export_id` ExportId (unresolved $ref)
      - `export_status` ExportStatus (unresolved $ref)
      - `export_url` ExportUrl (unresolved $ref)
      - `exported` Exported (unresolved $ref)
      - `exported_at` ExportedAt (unresolved $ref)
    - `relationships` object: Deal relationships.
      - `approval_policy_assignment` union: A JSON:API single relationship — links to one related resource or `null`.
        - SingleLinkageNullable
          - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID.
            - `id` string, required: The unique identifier of the resource.
            - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`).
        - NotIncluded: Placeholder for a relationship that was not sideloaded in this response.
          - `meta` object, required: Metadata indicating the sideload status of this relationship.
            - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant.
      - `automatic_invoicing_rule` union: A JSON:API single relationship — links to one related resource or `null`.
        - SingleLinkageNullable
          - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID.
            - `id` string, required: The unique identifier of the resource.
            - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`).
        - NotIncluded: Placeholder for a relationship that was not sideloaded in this response.
          - `meta` object, required: Metadata indicating the sideload status of this relationship.
            - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant.
      - `company` union: A JSON:API single relationship — links to one related resource or `null`.
        - SingleLinkageNullable
          - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID.
            - `id` string, required: The unique identifier of the resource.
            - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`).
        - NotIncluded: Placeholder for a relationship that was not sideloaded in this response.
          - `meta` object, required: Metadata indicating the sideload status of this relationship.
            - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant.
      - `contact` union: A JSON:API single relationship — links to one related resource or `null`.
        - SingleLinkageNullable
          - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID.
            - `id` string, required: The unique identifier of the resource.
            - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`).
        - NotIncluded: Placeholder for a relationship that was not sideloaded in this response.
          - `meta` object, required: Metadata indicating the sideload status of this relationship.
            - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant.
      - `contract` union: A JSON:API single relationship — links to one related resource or `null`.
        - SingleLinkageNullable
          - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID.
            - `id` string, required: The unique identifier of the resource.
            - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`).
        - NotIncluded: Placeholder for a relationship that was not sideloaded in this response.
          - `meta` object, required: Metadata indicating the sideload status of this relationship.
            - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant.
      - `creator` union: A JSON:API single relationship — links to one related resource or `null`.
        - SingleLinkageNullable
          - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID.
            - `id` string, required: The unique identifier of the resource.
            - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`).
        - NotIncluded: Placeholder for a relationship that was not sideloaded in this response.
          - `meta` object, required: Metadata indicating the sideload status of this relationship.
            - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant.
      - `custom_field_attachments` union: A JSON:API collection relationship — links to zero or more related resources.
        - CollectionLinkage
          - `data` Resource[], required
            - `id` string, required: The unique identifier of the resource.
            - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`).
        - NotIncluded: Placeholder for a relationship that was not sideloaded in this response.
          - `meta` object, required: Metadata indicating the sideload status of this relationship.
            - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant.
      - `custom_field_people` union: A JSON:API collection relationship — links to zero or more related resources.
        - CollectionLinkage
          - `data` Resource[], required
            - `id` string, required: The unique identifier of the resource.
            - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`).
        - NotIncluded: Placeholder for a relationship that was not sideloaded in this response.
          - `meta` object, required: Metadata indicating the sideload status of this relationship.
            - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant.
      - `deal_status` union: A JSON:API single relationship — links to one related resource or `null`.
        - SingleLinkageNullable
          - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID.
            - `id` string, required: The unique identifier of the resource.
            - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`).
        - NotIncluded: Placeholder for a relationship that was not sideloaded in this response.
          - `meta` object, required: Metadata indicating the sideload status of this relationship.
            - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant.
      - `document_type` union: A JSON:API single relationship — links to one related resource or `null`.
        - SingleLinkageNullable
          - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID.
            - `id` string, required: The unique identifier of the resource.
            - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`).
        - NotIncluded: Placeholder for a relationship that was not sideloaded in this response.
          - `meta` object, required: Metadata indicating the sideload status of this relationship.
            - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant.
      - `expense_approval_workflow` union: A JSON:API single relationship — links to one related resource or `null`.
        - SingleLinkageNullable
          - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID.
            - `id` string, required: The unique identifier of the resource.
            - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`).
        - NotIncluded: Placeholder for a relationship that was not sideloaded in this response.
          - `meta` object, required: Metadata indicating the sideload status of this relationship.
            - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant.
      - `invoice_template` union: A JSON:API single relationship — links to one related resource or `null`.
        - SingleLinkageNullable
          - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID.
            - `id` string, required: The unique identifier of the resource.
            - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`).
        - NotIncluded: Placeholder for a relationship that was not sideloaded in this response.
          - `meta` object, required: Metadata indicating the sideload status of this relationship.
            - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant.
      - `lost_reason` union: A JSON:API single relationship — links to one related resource or `null`.
        - SingleLinkageNullable
          - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID.
            - `id` string, required: The unique identifier of the resource.
            - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`).
        - NotIncluded: Placeholder for a relationship that was not sideloaded in this response.
          - `meta` object, required: Metadata indicating the sideload status of this relationship.
            - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant.
      - `next_todo` union: A JSON:API single relationship — links to one related resource or `null`.
        - SingleLinkageNullable
          - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID.
            - `id` string, required: The unique identifier of the resource.
            - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`).
        - NotIncluded: Placeholder for a relationship that was not sideloaded in this response.
          - `meta` object, required: Metadata indicating the sideload status of this relationship.
            - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant.
      - `organization` union: A JSON:API single relationship — links to one related resource or `null`.
        - SingleLinkageNullable
          - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID.
            - `id` string, required: The unique identifier of the resource.
            - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`).
        - NotIncluded: Placeholder for a relationship that was not sideloaded in this response.
          - `meta` object, required: Metadata indicating the sideload status of this relationship.
            - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant.
      - `origin_deal` union: A JSON:API single relationship — links to one related resource or `null`.
        - SingleLinkageNullable
          - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID.
            - `id` string, required: The unique identifier of the resource.
            - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`).
        - NotIncluded: Placeholder for a relationship that was not sideloaded in this response.
          - `meta` object, required: Metadata indicating the sideload status of this relationship.
            - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant.
      - `pipeline` union: A JSON:API single relationship — links to one related resource or `null`.
        - SingleLinkageNullable
          - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID.
            - `id` string, required: The unique identifier of the resource.
            - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`).
        - NotIncluded: Placeholder for a relationship that was not sideloaded in this response.
          - `meta` object, required: Metadata indicating the sideload status of this relationship.
            - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant.
      - `project` union: A JSON:API single relationship — links to one related resource or `null`.
        - SingleLinkageNullable
          - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID.
            - `id` string, required: The unique identifier of the resource.
            - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`).
        - NotIncluded: Placeholder for a relationship that was not sideloaded in this response.
          - `meta` object, required: Metadata indicating the sideload status of this relationship.
            - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant.
      - `proposal_document_type` union: A JSON:API single relationship — links to one related resource or `null`.
        - SingleLinkageNullable
          - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID.
            - `id` string, required: The unique identifier of the resource.
            - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`).
        - NotIncluded: Placeholder for a relationship that was not sideloaded in this response.
          - `meta` object, required: Metadata indicating the sideload status of this relationship.
            - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant.
      - `responsible` union: A JSON:API single relationship — links to one related resource or `null`.
        - SingleLinkageNullable
          - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID.
            - `id` string, required: The unique identifier of the resource.
            - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`).
        - NotIncluded: Placeholder for a relationship that was not sideloaded in this response.
          - `meta` object, required: Metadata indicating the sideload status of this relationship.
            - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant.
      - `subsidiary` union: A JSON:API single relationship — links to one related resource or `null`.
        - SingleLinkageNullable
          - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID.
            - `id` string, required: The unique identifier of the resource.
            - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`).
        - NotIncluded: Placeholder for a relationship that was not sideloaded in this response.
          - `meta` object, required: Metadata indicating the sideload status of this relationship.
            - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant.
      - `tax_rate` union: A JSON:API single relationship — links to one related resource or `null`.
        - SingleLinkageNullable
          - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID.
            - `id` string, required: The unique identifier of the resource.
            - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`).
        - NotIncluded: Placeholder for a relationship that was not sideloaded in this response.
          - `meta` object, required: Metadata indicating the sideload status of this relationship.
            - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant.
      - `template` union: A JSON:API single relationship — links to one related resource or `null`.
        - SingleLinkageNullable
          - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID.
            - `id` string, required: The unique identifier of the resource.
            - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`).
        - NotIncluded: Placeholder for a relationship that was not sideloaded in this response.
          - `meta` object, required: Metadata indicating the sideload status of this relationship.
            - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant.
      - `time_approval_workflow` union: A JSON:API single relationship — links to one related resource or `null`.
        - SingleLinkageNullable
          - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID.
            - `id` string, required: The unique identifier of the resource.
            - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`).
        - NotIncluded: Placeholder for a relationship that was not sideloaded in this response.
          - `meta` object, required: Metadata indicating the sideload status of this relationship.
            - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant.
      - `designated_approver` union: A JSON:API single relationship — links to one related resource or `null`.
        - SingleLinkageNullable
          - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID.
            - `id` string, required: The unique identifier of the resource.
            - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`).
        - NotIncluded: Placeholder for a relationship that was not sideloaded in this response.
          - `meta` object, required: Metadata indicating the sideload status of this relationship.
            - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant.
      - `primary_contact` union: A JSON:API single relationship — links to one related resource or `null`.
        - SingleLinkageNullable
          - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID.
            - `id` string, required: The unique identifier of the resource.
            - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`).
        - NotIncluded: Placeholder for a relationship that was not sideloaded in this response.
          - `meta` object, required: Metadata indicating the sideload status of this relationship.
            - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant.
      - `contacts` union: A JSON:API collection relationship — links to zero or more related resources.
        - CollectionLinkage
          - `data` Resource[], required
            - `id` string, required: The unique identifier of the resource.
            - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`).
        - NotIncluded: Placeholder for a relationship that was not sideloaded in this response.
          - `meta` object, required: Metadata indicating the sideload status of this relationship.
            - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant.
      - `memberships` union: A JSON:API collection relationship — links to zero or more related resources.
        - CollectionLinkage
          - `data` Resource[], required
            - `id` string, required: The unique identifier of the resource.
            - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`).
        - NotIncluded: Placeholder for a relationship that was not sideloaded in this response.
          - `meta` object, required: Metadata indicating the sideload status of this relationship.
            - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant.
      - `import` union: A JSON:API single relationship — links to one related resource or `null`.
        - SingleLinkageNullable
          - `data` Resource, required: A JSON:API resource identifier object containing the resource type and ID.
            - `id` string, required: The unique identifier of the resource.
            - `type` string, required: The resource type name (e.g. `tasks`, `people`, `deals`).
        - NotIncluded: Placeholder for a relationship that was not sideloaded in this response.
          - `meta` object, required: Metadata indicating the sideload status of this relationship.
            - `included` false, required: Whether the related resource was included in the sideloaded data. Always `false` for this variant.
  - `included` unknown[]: Sideloaded related resources.
    - unknown
  - `meta` Meta: Pagination and response metadata returned with every collection endpoint.
    - `current_page` integer: The current page number in this paginated response (1-based).
    - `max_page_size` integer: Maximum number of records allowed per page for this endpoint.
    - `organization_features` object: Feature flags and capabilities enabled for the current organization, used for UI rendering.
    - `page_size` integer: Number of records returned per page in this response.
    - `settings` object: Organization or user settings relevant to this resource's display.
    - `total_count` integer: Total number of records matching the current query across all pages.
    - `total_pages` integer: Total number of pages available for the current query and page size.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `406`: Not Acceptable
- `408`: Request Timeout
- `409`: Conflict
- `415`: Unsupported Media Type
- `422`: Unprocessable Content
- `423`: Locked
- `429`: Too Many Requests
- `500`: Internal Server Error

## Changes

- **2026-11-03** `7dcc2525e812`: 1 warning
  - added the new `project_already_exported` enum value to the `errors/items/code` response property for the response status `409`
- **2026-11-02** `fa3060fd0144`: 8 info
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `406`
  - added the non-success response with the status `408`
  - …4 more
- **2026-10-30** `c1d50c4b9aa6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/productive/apis/api-documentation/changes/api/v2/deals/open/patch.md)

---

[API](https://skmtc.dev/productive/apis/api-documentation.md) - [All operations](https://skmtc.dev/productive/apis/api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/productive/apis/api-documentation/revisions/e7bdfdf6cba3?raw)
