Application vehicles

Update a vehicle

Replaces a vehicle entry with the values you send and returns it. Every field is overwritten, so anything you leave out is cleared. Requires the rental_applications:write permission.

PUT

https://services.magicdoor.com/leasing/company-portal/rental-applications/{applicationId}/cars/{id}

Authorization

Authorizationstringrequired

Bearer token — Send your API token in the Authorization header as Bearer <token>. Requests without a valid token are rejected with 401 Unauthorized.

Path parameters

applicationIdstringrequired

The rental application to work with. A Snowflake id, sent as a decimal string.

example: 1830472847398404096

idstringrequired

The vehicle entry to work with. A Snowflake id, sent as a decimal string.

example: 1832847362910384640

Body

application/json

Send the entry in full — this is a replace, not a merge.

carMakestring

Manufacturer. At most 250 characters.

modelstring

Model name. At most 250 characters.

yearinteger

Model year.

licensePlatestring

Registration plate. At most 50 characters.

stateRegistrationstring

State or region the vehicle is registered in. At most 100 characters.

colorstring

Colour. At most 100 characters.

commentstring

Free-text note. At most 500 characters.

Response

200 · The updated vehicle entry.

idstring

The vehicle entry.

carMakestring

Manufacturer, for example "Toyota".

modelstring

Model name.

yearinteger

Model year.

licensePlatestring

Registration plate.

stateRegistrationstring

State or region the vehicle is registered in.

colorstring

Colour.

commentstring

Free-text note stored with the entry.

createdstring · date-time

When the entry was added, in the company's timezone.

updatedstring · date-time

When the entry was last changed, in the company's timezone.

401 · The access token is missing, expired, or not valid.

403 · The caller is authenticated but does not hold the `rental_applications:write` permission.

404 · No vehicle entry with this id exists on this rental application, or the rental application itself was not found.

Allowed in every application status

This is not gated on the application's status — it works on a draft, on a submitted application, and on a retracted one. Only the applicant-facing portal locks an application once it is submitted.