---
title: "Schedule an action for a storage equipment"
method: POST
path: "/equipments/{equipmentId}/storage/schedule"
tags: ["Equipments"]
---

# Schedule an action for a storage equipment

`POST /equipments/{equipmentId}/storage/schedule`

## Request

- Base URL: `https://connect.clever.gy`
- URL: `https://connect.clever.gy/equipments/{equipmentId}/storage/schedule`
- Auth: API key in header `clevergy-api-key`

Schedules an action (charge or discharge) for a storage equipment.

## Path parameters

- `equipmentId` string, required

## Request body

- ScheduleStorageActionRequest: Request to create a set of scheduled actions for a storage equipment
  - `actions` ScheduleStorageActionItem[]: List of actions to be scheduled
    - `date` string, date-time, required: Date of the action in UTC format (e.g., 2023-10-01T12:00:00Z)
    - `action` 'CHARGE' | 'DISCHARGE' | 'PAUSE', required: Action to be performed on the storage equipment
    - `targetSOC` number, float: Target state of charge in percentage
    - `dispatchTimeMins` integer: Dispatch time in minutes
    - `powerKWDispatch` number, float: Dispatch power in kW

## Response `201`

Action scheduled successfully

## Other responses

- `401`: Unauthorized
- `404`: Not found
- `default`: Unexpected error

---

[API](https://skmtc.dev/clevergy/apis/clevergy-connect-api.md) - [All operations](https://skmtc.dev/clevergy/apis/clevergy-connect-api/llms.txt) - [OpenAPI document](https://skmtc.dev/clevergy/apis/clevergy-connect-api/revisions/d333c5eecb5b?raw)