PUT /api/v1/service_orders/:order_number.json
Updates an existing service order.

Supported Formats

json

Errors

Code Description
404 Resource Not Found
422 Validation Error
500 Internal Server Error

Examples

curl 'https://app.octopi.co/api/v1/service_orders/ORDER_NUMBER.json' \
  -X 'PUT' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Token token=YOURTOKEN' \
  -d '{ \
    "service_order": {
      "order_number": "API_TEST_002_UPDATED",
      "due_at": "2024-04-31T00:00:00Z",
      "comment": "Updating order number and due at"
    }
  }'

{
  "id": 41,
  "order_number": "API_TEST_002_UPDATED",
  "due_at": "2024-04-30T20:00:00-04:00",
  "cargo_type": "container",
  "status": "pending",
  "comment": "Updating order number and due at",
  "created_at": "2024-01-29T05:33:55-05:00",
  "ordered_by": "System",
  "service_order_items": [
    {
      "id": 74,
      "container_id": 4337700,
      "status": "pending",
      "container_number": "0317933",
      "service_type": "custom",
      "service_id": 721,
      "service_name": "Repainting"
    },
    {
      "id": 75,
      "container_id": 4337700,
      "status": "pending",
      "container_number": "0317933",
      "service_type": "default",
      "service_id": "cleaning",
      "service_name": "Cleaning (Default)"
    }
  ]
}

Params

Param name Description
order_number
required

Octopi ID or the unique service order number given while creating one.

Validations:

  • Must be a String
service_order
optional

Validations:

  • Must be a Hash
service_order[order_number]
required

The unique service order number given while creating one.

Validations:

  • Must be a String
service_order[due_at]
optional

The date and time before which you want to fulfil the order, in ISO 8601 format (Eg. 2023-08-18T14:00:00Z) in UTC.

Validations:

  • Must be a String
service_order[comment]
optional

Comments for this order.

Validations:

  • Must be a String