Immobilise or release a vehicle
PUT/vehicles/:registration/start-inhibit
Blocks or releases the vehicle ignition. This function requires a specific fitment by Cartrack. Send start_inhibit: true to immobilise the vehicle, so the driver cannot power it on. Send start_inhibit: false to release it. If the engine is already running, immobilisation takes effect after the current ignition cycle.
The vehicle must have an active contract and a terminal fitment this command is supported on. A vehicle that does not responds with 422, and it is also absent from GET /vehicles/start-inhibit/status. A registration the caller does not own, or that does not exist, responds with 404.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 422
- 429
- 500
- 503
The command was accepted and queued for the terminal
The request body is declared as JSON but cannot be parsed, or is not a JSON object or array. Nothing was processed.
Unauthorized access. Authentication is required.
Access is forbidden. The user does not have permission to access this resource, or the account is not currently active.
The requested resource was not found.
Validation failed for the input parameters.
Too Many Requests - the endpoint's rate limit has been exceeded. Retry after the number of seconds in the Retry-After header.
Response Headers
Seconds to wait before retrying. The same value as X-RateLimit-Retry-After-Seconds when that wait is non-negative. If the computed wait is negative, Retry-After is floored at 0.
Unix timestamp of the next earliest successful request.
Seconds until the next earliest successful request.
Internal server error.
Service temporarily unavailable. The request did not complete and can be retried after the number of seconds in the Retry-After header, when one is sent.
Response Headers
Seconds to wait before retrying. Sent with db_busy and db_pool_timeout.