Skip to main content
POST
/
operator
/
devices
/
{device_id}
/
connectors
/
{connector_id}
/
start
Remote start charging
curl --request POST \
  --url https://api.telluspower.example.com/v1/operator/devices/{device_id}/connectors/{connector_id}/start \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "charge_power": 7,
  "duration": 3600,
  "target_soc": 80,
  "transaction_id": "txn_20250315001"
}
'
{
  "code": 0,
  "message": "Command sent",
  "data": {
    "command_id": "cmd_5678",
    "status": "queued"
  }
}

Authorizations

​
Authorization
string
header
required

OAuth2 client-credentials grant for operator-side integrations. Obtain an access token by POSTing client_id and client_secret to /v1/operator/oauth/token. Tokens are valid for 24 hours (86,400 seconds).

Path Parameters

​
device_id
string
required
​
connector_id
integer
required
Required range: x >= 1

Body

application/json
​
charge_power
number

Maximum power limit (kW).

​
duration
integer

Charging duration (seconds).

​
target_soc
integer
Required range: 0 <= x <= 100
​
transaction_id
string

External transaction identifier (e.g., the partner CPMS's session ID).

Response

200 - application/json

Command queued.

Standard response envelope. code is 0 on success and a non-zero application code on error (see Error Codes — §14).

​
code
integer
required

0 = success; otherwise an error code per the Error Codes section.

​
message
string
required

Human-readable description.

​
data
object

Endpoint-specific payload.