Approve a Carpool Booking
POST/carpool/bookings/:booking_id/approve
Approves a booking that is waiting for approval. This operation is available to the main account only. The request has no body.
| Current status | Result |
|---|---|
REQUESTED, EXPIRING_APPROVAL | The booking becomes APPROVED. |
| Any other status | 409 with CARPOOL_BOOKING_STATE_CONFLICT. Nothing is changed. |
A booking that does not exist, belongs to another account, or has no vehicle
the account can see returns 404.
The main account decides for every department at once, so any approval or
rejection a department manager already recorded is replaced, and
approved_by and declined_by read null afterwards.
The approval notifications the account has switched on in its Carpool settings are sent to the driver and the fleet managers, the same ones sent when a booking is approved on creation.
Request
Responses
- 200
- 401
- 403
- 404
- 409
- 422
- 429
- 500
- 503
The approved booking.
Unauthorized access. Authentication is required.
The operation requires main account credentials. Valid subusers receive this response.
The requested resource was not found.
The current status of the booking does not permit the action. Nothing was changed.
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.