Update Box

PUT

https://app.gotreek.com/api/boxes/{id}

Boxes

Last modified:2025-12-25 15:05:20

Update an existing box by its ID, applying validated changes to its attributes (type, dimensions, weight..) and returning the updated resource.

💡

Authentication

Bearer token authentication is required.

Only boxes owned or accessible by the authenticated user should be updated according to your access rules.

📌

Behavior

If the box exists, the API updates only the allowed fields (type, length, width, height, weight) from the validated request and returns the updated box in the response body.

Request

Authorization

OAuth 2.0

Client Credentials

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Token URL: https://app.gotreek.com/api/auth/login

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Box updated successfully

Body

🟠404

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://app.gotreek.com/api/boxes/' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": "primary",
    "length": 22,
    "width": 15,
    "height": 36,
    "weight": 3
}'

Response Example

200 - Example 1

{
    "success": true,
    "message": "Box updated successfully",
    "data": {
        "id": 1,
        "type": "Small Box",
        "length": 33,
        "width": 14,
        "height": 8,
        "weight": 31,
        "user_id": 94,
        "created_at": "2025-07-21T13:05:41Z",
        "updated_at": "2025-07-21T13:05:41Z"
    }
}

Modified at 2025-12-25 15:05:20

Box Details

Merchants Details