Create a scheduled service

curl -X POST https://staging-panic.aura.services/panic-api/v2/scheduled/guarding \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "customerId": 12345,
  "scheduledRequestConfig": {
    "name": "Example guarding request",
    "specialInstructions": "Example special instructions",
    "details": {
      "numberOfGuards": 2,
      "armedPreference": "unarmed",
      "contacts": [
        {
          "firstName": "Example",
          "lastName": "Contact",
          "mobile": "+2756789999"
        }
      ]
    },
    "dateFrom": "2026-06-12T00:00:00.000Z",
    "dateTo": "2026-06-13T00:00:00.000Z",
    "repeatsConfig": {
      "type": "single",
      "date": "2026-06-12T00:00:00.000Z",
      "time": {
        "start": "00:45",
        "windowPeriod": "02:00"
      }
    }
  },
  "initialLocation": {
    "latitude": "52.05169309271538",
    "longitude": "5.397453505042579",
    "formattedAddress": "Menlyn Maine Central Square, Amarand Avenue, Waterkloof Glen, Pretoria, South Africa"
  }
}'

{
  "message": "Scheduled request created successfully.",
  "scheduledRequest": {
    "id": 1,
    "scheduledService": "string",
    "customerSourceId": 1,
    "locationTimezone": "string",
    "activeScheduledRequestConfigId": 1,
    "updatedAt": "2024-01-15T09:30:00Z",
    "createdAt": "2024-01-15T09:30:00Z",
    "deletedAt": "2024-01-15T09:30:00Z",
    "scheduledRequestConfig": {
      "id": 1,
      "name": "string",
      "specialInstructions": "string",
      "details": {
        "numberOfGuards": 1,
        "armedPreference": "string",
        "contacts": [
          {
            "firstName": "string",
            "lastName": "string",
            "mobile": "string"
          }
        ]
      },
      "dateFrom": "2024-01-15T09:30:00Z",
      "dateTo": "2024-01-15T09:30:00Z",
      "repeatsConfig": {
        "type": "string",
        "date": "2024-01-15T09:30:00Z",
        "time": {
          "start": "string",
          "windowPeriod": "string"
        }
      },
      "scheduledRequestId": 1,
      "updatedAt": "2024-01-15T09:30:00Z",
      "createdAt": "2024-01-15T09:30:00Z"
    },
    "initialLocation": {
      "latitude": "-26.10911",
      "longitude": "28.053037",
      "formattedAddress": "23 Baker Street",
      "locationIdentifier": "string",
      "locationDescription": "string",
      "locationAdditionalInformation": "string"
    },
    "allLocations": [
      {
        "latitude": "-26.10911",
        "longitude": "28.053037",
        "formattedAddress": "23 Baker Street",
        "locationIdentifier": "string",
        "locationDescription": "string",
        "locationAdditionalInformation": "string"
      }
    ],
    "nowOccurrence": {},
    "nextOccurrence": {},
    "inProgressOccurrence": {}
  }
}

Creates a scheduled service request for the named service type.

Authentication

AuthorizationBearer

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

Path parameters

serviceTypestringRequired

Scheduled service type used when creating a request.

Request

This endpoint expects an object.

customerIdintegerRequired

scheduledRequestConfigobjectRequired

initialLocationobjectRequired

locationTimezonestringOptional

allLocationslist of objectsOptional

scheduledAtdatetimeOptionalDeprecated

latitudedoubleOptionalDeprecated

longitudedoubleOptionalDeprecated

Response

Successful.

messagestring

scheduledRequestobject

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error