Update callout location and return callout

curl -X POST https://staging-panic.aura.services/panic-api/v2/callouts/12345/updateLocationAndReturnCallout \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "latitude": -33.9249,
  "longitude": 18.4241
}'

{
  "message": "Callout location successfully updated",
  "callout": {
    "id": 12345,
    "status": "created",
    "url": "https://staging-dispatch.aura.services/dispatch/?sessionToken=example&calloutId=12345",
    "cancelledByCustomer": false,
    "dispatchRequired": true,
    "internalTest": false,
    "verified": false,
    "externalRefId": null,
    "requestedByCustomerId": null,
    "customer": {
      "id": 12345,
      "name": "Audit",
      "surname": "Tester",
      "mobile": "+27849990001",
      "gender": null,
      "email": "audit@example.com",
      "vehicleMake": null,
      "vehicleModel": null,
      "vehicleColour": null,
      "vehicleLicensePlate": null,
      "dateOfBirth": null,
      "auth0UserId": "12345",
      "imageId": null,
      "businessName": null,
      "customerTypeId": null
    },
    "incidentInformation": [
      {
        "calloutId": 12345,
        "status": "created",
        "createdAt": "2026-06-08T15:33:45.371Z",
        "calloutClassification": {
          "id": 2,
          "value": "TEST"
        },
        "verified": false,
        "responseType": {
          "id": 1,
          "value": "SECURITY"
        },
        "incidentDetails": null,
        "typeOfEmergency": null,
        "incidentcategory": null,
        "calloutCurrentLocation": {
          "latitude": "-26.2",
          "longitude": "28.2",
          "formattedAddress": "1202 Emlembe St, Balmoral, Boksburg, 1401, South Africa",
          "region": "Gauteng",
          "city": "City of Ekurhuleni Metropolitan Municipality",
          "country": "South Africa",
          "description": null,
          "placeId": null,
          "calloutLocationType": null,
          "regionId": 1
        },
        "dispatchInformation": {
          "responderDispatchedAt": null,
          "responderArrivedAt": null,
          "responderCompletedAt": null,
          "responder": null,
          "supplier": null,
          "calloutResponseEta": null,
          "responderRoute": null
        },
        "calloutEvents": []
      }
    ]
  }
}

Updates an active callout’s location and returns the updated callout state. Legacy docs recommend polling every 5 to 20 seconds while the callout is active. The path parameter is canonical; the body should contain the location fields only.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

calloutIdintegerRequired

Callout identifier.

Request

This endpoint expects an object.

latitudedoubleRequired

longitudedoubleRequired

accuracydoubleOptional

calloutIdintegerOptionalDeprecated

Ignored. The callout is resolved from the {calloutId} path parameter; a calloutId in the body has no effect and is accepted only for backward compatibility with older integrators.

Response

Successful.

messagestring

calloutobject

The nested callout view returned when reading a callout (GET /callouts/{calloutId}) or updating its location and returning it (updateLocationAndReturnCallout). This differs from the flat Callout returned by the creation endpoints: incident, location, and dispatch details are grouped under incidentInformation.

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error