PlexiGrid Request Composer

01

Request envelope

Values in this section become the PlexiGrid metadata and activation identity sent to the webhook.

Request description Local result label; it is not included in the webhook body. Event type Lifecycle action written to metadata.type. Environment Source environment written to metadata.environment. Activation ID Stable activation identifier. Reuse it when cancelling the activation. Event ID Unique delivery identifier used for webhook idempotency. Metadata timestamp Time the webhook event was emitted, serialized as UTC. Created at Time the activation data was created, serialized as UTC.

02

Contract and targets

Identify the flexibility product and the exact supply points or DER resources that will receive the schedule.

Flex code PlexiGrid product code, for example 2H211 for export DOE. Contract ID Contract identifier associated with the activation. Contract bid Human-readable bid name supplied by PlexiGrid. Contract description Description of the contracted flexibility service. Supply points ICP identifiers in group_ids.supply_points. Controller IDs such as MCU-* belong to a device, not a supply point. DERs or DER groups DER names or group IDs in group_ids.ders. Use the device's DER name here when targeting one controller-backed device. Response deadline Optional latest time at which a response to the activation is expected. Settlement price per kWh Optional settlement price written to settlement_price_kwh.

03

Control-curve periods

New requests cover the next 24 hours with randomized 15-minute curtailment intervals. Gaps mean no curtailment and are not sent as records.

Schedule start The next quarter-hour boundary. Interval duration (minutes) Every generated curtailment record spans exactly 15 minutes. Planning horizon (hours) The default scenario covers the full next day. Generated curtailment periods Only curtailed slots are included in the request.

ReferenceUnique period ID	StartInclusive UTC boundary	EndExclusive UTC boundary	Requested WRequested flexibility	ConnectIEEE connection mode	Import WopModImpLimW	Export WopModExpLimW	Load WopModLoadLimW	Generation WopModGenLimW	Actions

03

Cancellation

A cancellation references the activation ID above and sends no dispatch instruction or control curve.

Cancellation reason Machine-readable reason written to cancellation_reason. Cancellation fee Optional fee associated with cancelling the activation. Cancelled at Time the activation was cancelled, serialized as UTC.

PlexiGrid request composer

Request envelope

Contract and targets

Control-curve periods

Cancellation

Review and send

Exact outgoing request

Latest server response