Send message to driver
POSThttps://api.uber.com/v1/guests/trips/{request_id}/message
¶ Use case
Use this endpoint to send a message to the Driver app, of the current driver, for the given trip.
This will fail if there’s no driver currently assigned to the trip.
If the request is from a third party (3P) app, please add x-uber-organizationuuid header and the Organization UUID as the value or the request will be denied.
¶ Authorization
OAuth 2.0 Bearer token with the guests.trips
scope.
¶ Request
¶ Example request
curl -X POST \
-H 'authorization: Bearer <access_token>' \
-H 'content-type: application/json' \
-d '{
"message": "Please come to the door on the right"
}' \
'https://api.uber.com/v1/guests/trips/<request_id>/message'
¶ Request URL path parameters
URL path parameter | Type | Description |
---|---|---|
request_id |
string |
A unique identifier of a trip’s request returned when creating a trip (required). |
¶ Request body parameters
Field | Type | Description |
---|---|---|
message |
string |
The message to deliver to the driver app of the current driver of the given trip (required). |
¶ Response
¶ Example response
HTTP 200 OK
¶ Endpoint errors
Example error 1:
{
"code": "bad_request",
"message": "can only send messsage for active rides"
}
Example error 2:
{
"code": "bad_request",
"message": "cannot send message for ride without assigned driver"
}
Example error 3:
{
"code": "bad_request",
"message": "cannot find ride"
}