Upload pick-up or return photos

Uploads photos of the vehicle taken at pick-up or at return (inspection photos) as multipart/form-data, with each file as images[].

If some files fail to save, the response is a business error with one images.N key per failed file (N is its position), and data.files lists the files that were saved. Resend only the failed ones.

The reservation is looked up by its numeric ID; an unknown ID returns 404.

Responses

🟢200OK

application/json

The photos were saved, or a business error for the files that failed. HTTP 200 is also used for failures: always check success. When it is false, the body is an ErrorBusinessRule (status_code 410) or an ErrorUnauthorized (status_code 401 or 403).

Bodyapplication/json

Example

{
    "success": false,
    "status_code": 410,
    "errors": {
        "images.1": [
            "Something was wrong, please try again"
        ],
        "error_message": "Something was wrong, please try again"
    },
    "data": {
        "type": "pickup",
        "files": [
            {
                "id": 7781,
                "label": "frontleft.jpg",
                "filename": "frontleft.jpg",
                "extension": "jpg",
                "uuid": "4c3b2a19-8d7e-4f6a-b5c4-d3e2f1a0b9c8",
                "uploaded": true
            }
        ]
    }
}

🟠404Record Not Found

🟠422Parameter Error

Request

Responses