---
title: "Send a remote action to a vehicle."
method: POST
path: "/fleets/{fid}/vehicles/{vid}/callbacks/{cbid}/remotes"
tags: ["Remote"]
---

# Send a remote action to a vehicle.

`POST /fleets/{fid}/vehicles/{vid}/callbacks/{cbid}/remotes`

Create a new asynchrone vehicle remote action and request it.

## Path parameters

- `fid` string, required
- `vid` string, required
- `cbid` string, required

## Request body

- Remote — Remote vehicle activation. ```Only one action``` (horn, precond, door...) is supported at a time.
  - `label` string
  - `preconditioning` RemotePreconditioning — Remote preconditioning the vehicle.
    - `airConditioning` object, required — At least one of the parameters must be provided.
      - `immediate` boolean — Determines whether air conditioning will start immediately or not independently if scheduled ```programs``` are set or not. Set to "false" by default.
      - `programs` object[] — List of air conditioning programs to schedule on vehicle.
        - `recurrence` 'None' | 'Daily' — Determines the recurrence of the program. * None: means no recurrence. * Daily: repeated over the week.
        - `start` string, required — The program start time formatted using the duration format based on [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601#Time_intervals) with the schema: P[n]Y[n]M[n]DT[n]H[n]M[n]S _example_: * PT14H30M means 14H and 30Min
        - `occurence` object — The occurrence on the program will spread on days depending on recurrence value.
          - `day` string[], required
        - `slot` integer — This program number. Can only be used ONE time in the same preconditioning list.
        - `enabled` boolean — Determines whether this program is enabled or not.
        - `actionsType` 'Delete' | 'Set' — Action type to apply for this program: * Delete: Delete this air conditioning program entry. Need only the slot number of the program to remove. * Set: Create a new programe o update it if existing. Need to provide all field correctly set.
  - `immobilization` RemoteSetImmobilization — Requesting the vehicle for immobilization.
    - `activate` boolean, required — Set, if ```true```, the vehicle as immobilized or not (otherwise).
  - `door` RemoteDoorsState — Remote vehicle door (lock/unlock) state. _Disclaimer_ : "Forced" parameter is only applicable to lock the doors and is now deprecated because not applicable to all vehicles. It will be ignored to unlock the doors if set. Some additionnal details will be added in the callback when this parameter is considered.
    - `state` 'Unlocked' | 'Locked', required
    - `forced` boolean
  - `horn` RemoteHorn — Remote vehicle horn activation.
    - `state` 'Activated' | 'Unactivated', required — Activate or unactivate this remote horn.
  - `charging` RemoteCharging — Remote electric battery charging action. - ```preferences``` cannot be used in the same remote than ```schedule``` and/or ```immediate```
    - `nextDelayedTime` string — (!Depricated; use schedule instead) Timestamp (as defined in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)) of the next battery charging time.
    - `schedule` object — Charge scheduling. Only one of the two modes, programs or nexDelayedTime, should be provided.
      - `nextDelayedTime` string — Timestamp (as defined in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt)) of the next battery charging time.
      - `programs` object[] — Scheduled charging programs list.
        - `start` string, required — The program relative (to 00:00) start time formatted using the duration format based on [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601#Time_intervals) with the schema: P[n]Y[n]M[n]DT[n]H[n]M[n]S _example_: * PT14H30M means 14H and 30Min
        - `occurence` object — The occurrence on the program will spread on days depending on recurrence value.
          - `day` string[], required
        - `enabled` boolean — true if the progrm is enables, foalse otherwise.
        - `slot` integer — This program number. Can only be used ONE time in the same charging program list.
        - `end` string — The program relative (to 00:00) end time formatted using the duration format based on [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601#Time_intervals) with the schema: P[n]Y[n]M[n]DT[n]H[n]M[n]S _example_: * PT14H30M means 14H and 30Min
    - `immediate` boolean — Determines if the charging will start immediately(```True```) or not.
    - `preferences` object — Set the charging preferences.
      - `level` 'Level1' | 'Level2' | 'Level3' | 'Level4' | 'Level5' — Charging power level.
      - `type` 'Partial' | 'Full' — Configure charging type preferences.
  - `stolen` RemoteStolen — Remote operation to update stolen state, immobilization and configuration information. Only one attribute can be used at a time.
    - `stolen` boolean — Declare the vehicle stolen or not (set at ```True``` to report as stolen).
    - `trackingPeriod` object — Modify vehicle data collection frequency through tracking timer attributes.
      - `running` integer — Data collection frequency when vehicle is in stolen mode and ignition On
      - `shutdown` integer — Data collection frequency when vehicle is in stolen mode and ignition Off
    - `immobilization` object — Requesting the stolen vehicle for immobilization.
      - `activate` boolean, required — Set, if ```true```, the vehicle as immobilized or not (otherwise).
  - `lights` RemoteLights — Remote to swith on / off lights.
    - `on` boolean, required — Swith, if ```true```, the vehicle lights ON or OFF (otherwise).
  - `wakeUp` RemoteWakeUp — Remote to wake up a vehicle (so it can update its data).
    - `action` string
  - `navigation` RemoteNavigation — A remote to share GPS positions with the vehicle so it can navigate through those positions by driving from start (1st) to end (last) position. It can include only 9 points + the destination.
    - `driverApproval` boolean — Whether sharing position with vehicle requires driver approval or not.
    - `positions` Point[], required
      - `coordinates` number[], required — This is a simple 2 (or more) numbers vector used to define Geometry Point objects.
      - `type` 'Point', required

## Response `202`

Remote action creation success response (accepted).

## Other responses

- `default` — unresolved $ref

---

[API](https://skmtc.net/groupe-psa/apis/groupe-psa-connected-car-b2b-api.md) · [All operations](https://skmtc.net/groupe-psa/apis/groupe-psa-connected-car-b2b-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/groupe-psa/groupe-psa-connected-car-b2b-api/revisions/023ff3e3fe51/schema)