Delete vehicle record
DELETE /api/members/vehicle-details/{vehicleId}
- Products: Operator (
FOH) - Features: Front of House Generic Access (
FOHGENERIC)
Overview
Removes one vehicle registration held against a member — for example when a member sells a car, or a registration was recorded wrongly. Vehicle registrations are used for car park and barrier access, so deleting one withdraws that vehicle's access.
Note that the member is not part of the URL. You address the vehicle by its own record id, which you get from Retrieve member vehicle details; the endpoint deletes whichever member's vehicle carries that id. Take care to hold on to the right id.
A member may hold several vehicles but cannot hold the same registration twice, so deleting a record is also how you free a registration up before recording it again.
A successful call returns 204 No Content with no body.
Endpoint
DELETE {base_url}/api/members/vehicle-details/{vehicleId}
{base_url} is the environment URL issued to your integration. See Authenticating with Gladstone APIs.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
vehicleId | integer (int32) | Yes | The id of the vehicle record itself, as returned by Retrieve member vehicle details — not the member id and not the registration plate. Must be a whole number: a non-numeric value, or one containing punctuation, is rejected with 400 before anything is looked up. There is no ownership check against your token here, so the id is the only thing standing between you and another member's record. |
Sample request
curl -X DELETE '{base_url}/api/members/vehicle-details/{vehicleId}' \
-H 'Authorization: Bearer {accessToken}' \
-H 'X-Use-SSO: true'Errors
| Status | Meaning | When |
|---|---|---|
400 | Bad request | vehicleId is not a valid integer — for example a registration plate or a string containing punctuation was sent in its place. The request is rejected before anything is looked up. |
404 | Not found | No vehicle record exists with that id. Returned with an empty body. Deleting a record that has already been deleted therefore gives 404, not a silent success. |
500 | Internal server error | An unexpected server-side failure while reading or deleting the record. |