Update a Policy

curl -X POST https://api.chargeapi.co/v1/policies/pol_dMBjATAAVcbAKtSNnjlfbmnwviSXr8yP \
  -H "Authorization: Bearer ch_sk_test_..." \
  --json '{
  "name": "Example Policy v2"
}'

{
    "id": "pol_dMBjATAAVcbAKtSNnjlfbmnwviSXr8yP",
    "object": "policy",
    "created": "2026-04-01T00:09:07.493Z",
    "description": null,
    "metadata": {},
    "mode": "enforcement",
    "name": "Example Policy v2",
    "rules": {
        "allowed_operators": ["example_operator"],
        "denied_operators": [],
        "geofences": [
            {
                "center": {
                    "latitude": 48.8698,
                    "longitude": 2.3319
                },
                "name": "Example Zone",
                "radius_meters": 1500
            }
        ],
        "max_price_per_kwh": 25,
        "time_windows": [
            {
                "days_of_week": ["monday", "tuesday", "wednesday", "thursday", "friday"],
                "end_time": "18:00",
                "start_time": "09:00"
            }
        ]
    },
    "status": "active"
}

curl -X POST https://api.chargeapi.co/v1/policies/pol_dMBjATAAVcbAKtSNnjlfbmnwviSXr8yP \
  -H "Authorization: Bearer ch_sk_test_..." \
  --json '{
  "name": "Example Policy v2"
}'

{
    "id": "pol_dMBjATAAVcbAKtSNnjlfbmnwviSXr8yP",
    "object": "policy",
    "created": "2026-04-01T00:09:07.493Z",
    "description": null,
    "metadata": {},
    "mode": "enforcement",
    "name": "Example Policy v2",
    "rules": {
        "allowed_operators": ["example_operator"],
        "denied_operators": [],
        "geofences": [
            {
                "center": {
                    "latitude": 48.8698,
                    "longitude": 2.3319
                },
                "name": "Example Zone",
                "radius_meters": 1500
            }
        ],
        "max_price_per_kwh": 25,
        "time_windows": [
            {
                "days_of_week": ["monday", "tuesday", "wednesday", "thursday", "friday"],
                "end_time": "18:00",
                "start_time": "09:00"
            }
        ]
    },
    "status": "active"
}

Updates a policy. Parameters you omit keep their current values.

curl -X POST https://api.chargeapi.co/v1/policies/pol_dMBjATAAVcbAKtSNnjlfbmnwviSXr8yP \
  -H "Authorization: Bearer ch_sk_test_..." \
  --json '{
  "name": "Example Policy v2"
}'

{
    "id": "pol_dMBjATAAVcbAKtSNnjlfbmnwviSXr8yP",
    "object": "policy",
    "created": "2026-04-01T00:09:07.493Z",
    "description": null,
    "metadata": {},
    "mode": "enforcement",
    "name": "Example Policy v2",
    "rules": {
        "allowed_operators": ["example_operator"],
        "denied_operators": [],
        "geofences": [
            {
                "center": {
                    "latitude": 48.8698,
                    "longitude": 2.3319
                },
                "name": "Example Zone",
                "radius_meters": 1500
            }
        ],
        "max_price_per_kwh": 25,
        "time_windows": [
            {
                "days_of_week": ["monday", "tuesday", "wednesday", "thursday", "friday"],
                "end_time": "18:00",
                "start_time": "09:00"
            }
        ]
    },
    "status": "active"
}

Parameters

mode

string

Updated operational mode of the policy.Available options: enforcement, suggestion

name

string

Updated display name of the policy.

rules

object

Rules that define how the policy behaves.

Show properties

allowed_operators

array of string

A list of charging station operator IDs that are permitted.

denied_operators

array of string

A list of charging station operator IDs that are explicitly forbidden.

geofences

array of object

A list of geographic areas where charging is permitted.

Show properties

center

object

No description available.

Show properties

latitude

number

No description available.

longitude

number

No description available.

name

string

A name for the geofenced area.

radius_meters

integer

The radius from the center point in meters.

max_price_per_kwh

integer | null

The maximum allowable price per kilowatt-hour in the account’s default currency, in the smallest currency unit.

time_windows

array of object

Defines when charging is permitted.

Show properties

days_of_week

array of string

Days of the week this window applies to.Available options: monday, tuesday, wednesday, thursday, friday, saturday, sunday

end_time

string

The end of the time window in 24-hour format.

start_time

string

The start of the time window in 24-hour format.

status

string

Updated status of the policy.Available options: active, inactive

More parameters

description

string | null

Updated description of the policy’s purpose.

metadata

object

Set of key-value pairs that you can attach to an object.

Returns

Returns the updated policy.

Create a Policy Retrieve a Policy

​Parameters

​More parameters

​Returns

Parameters

More parameters

Returns