Skip to main content
POST
/
operator
/
control
/
flexibility
Load flexibility control
curl --request POST \
  --url https://api.telluspower.example.com/v1/operator/control/flexibility \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "target_type": "site",
  "target_ids": [
    "site_001",
    "site_002"
  ],
  "command": "set_power_limit",
  "params": {
    "power_limit_percent": 50,
    "duration": 1800,
    "reason": "grid_overload"
  }
}
'
{
  "code": 123,
  "message": "<string>",
  "data": {
    "control_id": "<string>",
    "status": "executing"
  }
}

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

Body

application/json
​
target_type
enum<string>
required
Available options:
site,
operator,
all
​
command
enum<string>
required
Available options:
set_power_limit,
pause_charging
​
params
object
required

Command-specific parameters.

  • For set_power_limit: { power_limit_percent: int 0–100, duration: int seconds, reason?: string }
  • For pause_charging: { duration: int seconds, reason?: string }
​
target_ids
string[]

Required when target_type is site or operator.

Response

200 - application/json

Flexibility command issued.

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.