Skip to main content
POST
/
operator
/
devices
/
{device_id}
/
connectors
/
{connector_id}
/
discharge
Remote discharge (V2G)
curl --request POST \
  --url https://api.telluspower.example.com/v1/operator/devices/{device_id}/connectors/{connector_id}/discharge \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "discharge_power": 3,
  "duration": 1800,
  "min_soc": 20
}
'
{
  "code": 123,
  "message": "<string>",
  "data": {
    "command_id": "<string>",
    "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
​
discharge_power
number
required

Discharge power (kW).

​
duration
integer
​
min_soc
integer
Required range: 0 <= x <= 100

Response

200 - application/json

Discharge 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.