Create or replace an organization-wide cap profile

curl --request POST \ --url https://api.ridergy.com/v1/organizations/schedules \ --header 'Content-Type: application/json' \ --header 'x-api-key: <api-key>' \ --data ' { "startTime": "2026-06-12T08:00:00Z", "endTime": "2026-06-12T18:00:00Z", "limitKw": 500, "priority": 5 } '

{ "tenantUuid": "<string>", "priority": 5, "limitKw": 500, "startTime": "2023-11-07T05:31:56Z", "endTime": "2023-11-07T05:31:56Z", "note": "Organization-wide cap enforcement is not yet active; this profile is recorded for future use." }

Authorizations

x-api-key

string

header

required

Per-tenant API key. Tenant is derived from the key — never from the request.

Body

application/json

startTime

string<date-time>

required

ISO-8601 UTC timestamp. Required.

Example:

"2026-06-12T08:00:00Z"

endTime

string<date-time>

required

ISO-8601 UTC timestamp. Must be after startTime and in the future. Required.

Example:

"2026-06-12T18:00:00Z"

limitKw

number<float>

required

Power limit in kW. Must be greater than 0. Required.

Example:

50

priority

integer

default:0

OCPP-stack-style priority level, 0 (lowest) to 10 (highest). Submitting a profile at a priority that already exists for this target replaces it.

Required range: 0 <= x <= 10

Example:

5

Response

Org profile created/replaced

tenantUuid

string

priority

integer

Example:

5

limitKw

number

Example:

500

startTime

string<date-time>

endTime

string<date-time>

status

enum<string>

Available options:

SCHEDULED,

ACTIVE,

EXPIRED

note

string

Example:

"Organization-wide cap enforcement is not yet active; this profile is recorded for future use."