Purchase Orders - Bulk

Update purchase orders

Changed on

Bulk-updates multiple purchase orders in a single request. Accepts a JSON:API array of partial purchase_orders resources keyed by ID.

patch/api/v2/purchase_orders

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/purchase_orders
  • Auth
    none declared

Request body

Example request

{
  "data": [
    {
      "type": "purchase_orders",
      "id": "1234567",
      "attributes": {
        "status_id": 2,
        "delivery_on": "2026-05-01"
      }
    },
    {
      "type": "purchase_orders",
      "id": "1234568",
      "attributes": {
        "status_id": 2,
        "sent_on": "2026-04-14"
      }
    }
  ]
}

Response

Paginated list of purchase orders in JSON:API format, with related vendor, deal, creator, document type, bill-to, bill-from, and attachment resources available via include.

Example response

{
  "data": [
    {
      "id": "45",
      "type": "purchase_orders",
      "attributes": {
        "number": "PO-2026-045",
        "status": "approved",
        "amount": "25000.00",
        "currency": "USD",
        "date": "2026-02-01",
        "created_at": "2026-02-01T10:00:00.000+00:00"
      },
      "relationships": {
        "company": {
          "data": {
            "type": "companies",
            "id": "65111"
          }
        }
      }
    }
  ],
  "included": [],
  "meta": {
    "current_page": 1,
    "total_pages": 5,
    "total_count": 42,
    "page_size": 30,
    "max_page_size": 200
  }
}

Changes

    • warning

      added the new bad_decimal_format enum value to the // response property for the response status

    • warning

      added the new non_finite_number enum value to the // response property for the response status

    • warning

      added the new null_bytes_in_params enum value to the // response property for the response status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • breaking

      the request property type changed from object to array

    • breaking

      the /// response's property type changed from string to no type, and format from date to no format for status

    • breaking

      the /// response's property type changed from string to no type for status

    • breaking

      the /// response's property type changed from number to string for status

    • breaking

      the /// response's property type changed from string to no type for status

    • breaking

      the /// response's property type changed from integer to no type for status

    • breaking

      the /// response's property type changed from string to no type for status

    • breaking

      the /// response's property type changed from string to no type, and format from date-time to no format for status

    • breaking

      the /// response's property type changed from string to no type for status

    • breaking

      the /// response's property type changed from string to no type, and format from date-time to no format for status

    • breaking

      the /// response's property type changed from string to no type, and format from date to no format for status

    • warning

      deleted the header request parameter X-Organization-Id

    • warning

      removed the request property /

    • info

      added the non-success response with the status

    • info

      added to the /// response property anyOf list for the response status

    • info

      added to the /// response property anyOf list for the response status

    • info

      added to the /// response property anyOf list for the response status

    • info

      added to the /// response property anyOf list for the response status

    • info

      added to the /// response property anyOf list for the response status

    • info

      added to the /// response property anyOf list for the response status

    • info

      added to the /// response property anyOf list for the response status

    • info

      added to the /// response property anyOf list for the response status

    • info

      added subschema #2 to the /// response property anyOf list for the response status

    • info

      added subschema #2 to the /// response property anyOf list for the response status

    • info

      added subschema #2 to the /// response property anyOf list for the response status

    • info

      added subschema #2 to the /// response property anyOf list for the response status

    • info

      added subschema #2 to the /// response property anyOf list for the response status

    • info

      added subschema #2 to the /// response property anyOf list for the response status

    • info

      added subschema #2 to the /// response property anyOf list for the response status

    • info

      added subschema #2 to the /// response property anyOf list for the response status

    • info

      added subschema #2 to the /// response property anyOf list for the response status

    • info

      removed subschema #1: Single data from the /// response property anyOf list for the response status

    • info

      removed subschema #1: Single data from the /// response property anyOf list for the response status

    • info

      removed subschema #1: Single data from the /// response property anyOf list for the response status

    • info

      removed subschema #1: Single data from the /// response property anyOf list for the response status

    • info

      removed subschema #1: Single data from the /// response property anyOf list for the response status

    • info

      removed subschema #1: Single data from the /// response property anyOf list for the response status

    • info

      removed subschema #1: Single data from the /// response property anyOf list for the response status

    • info

      removed subschema #1: Single data from the /// response property anyOf list for the response status

    • info

      the response property ///// became required for the status

    • info

      the response property ////// became required for the status

    • info

      the response property ///// became required for the status

    • info

      the response property ////// became required for the status

    • info

      the response property ///// became required for the status

    • info

      the response property ////// became required for the status

    • info

      the response property ///// became required for the status

    • info

      the response property ////// became required for the status

    • info

      the response property ///// became required for the status

    • info

      the response property ////// became required for the status

    • info

      the response property ///// became required for the status

    • info

      the response property ////// became required for the status

    • info

      the response property ///// became required for the status

    • info

      the response property ////// became required for the status

    • info

      the response property ///// became required for the status

    • info

      the response property ////// became required for the status

    • info

      removed the 1.00 enum value from the /// response property for the response status

    • info

      removed the 10.00 enum value from the /// response property for the response status

    • info

      removed the 11.00 enum value from the /// response property for the response status

    • info

      removed the 2.00 enum value from the /// response property for the response status

    • info

      removed the 3.00 enum value from the /// response property for the response status

    • info

      removed the 4.00 enum value from the /// response property for the response status

    • info

      removed the 5.00 enum value from the /// response property for the response status

    • info

      removed the 6.00 enum value from the /// response property for the response status

    • info

      removed the 7.00 enum value from the /// response property for the response status

    • info

      removed the 8.00 enum value from the /// response property for the response status

    • info

      removed the 9.00 enum value from the /// response property for the response status

    This list may be incomplete.