Cancel a callout

POST

/panic-api/v2/callouts/:calloutId/cancel

POST

/panic-api/v2/callouts/:calloutId/cancel

$ curl -X POST https://staging-panic.aura.services/panic-api/v2/callouts/12345/cancel \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "safeCode": "4567"
> }'

1 {
2   "callout": {
3     "id": 12345,
4     "status": "created",
5     "cancelledByCustomer": true,
6     "customerSourceId": 249,
7     "customerId": 12345,
8     "metaData": {
9       "responderMediaCaptureEnabled": true,
10       "customer": {
11         "customerId": 12345
12       }
13     },
14     "calloutincidentdetail": {
15       "id": 93416,
16       "responderId": null,
17       "responderDispatched": false,
18       "supplierIdBeforeCancellation": null,
19       "supplierId": null
20     },
21     "requestedByCustomer": {
22       "id": null,
23       "mobile": null,
24       "name": null,
25       "surname": null,
26       "email": null
27     }
28   }
29 }

Cancels an active callout. Include safeCode for verified customer cancellation and duress detection; omit it for unconditional integrator-driven or fixed-location cancellation.

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.

safeCodestringOptional

Optional last four digits of the customer's registered mobile number. Omit to perform an unconditional cancel.

Response

Successful.

calloutobject

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error