---
title: "Set maintenance time"
method: POST
path: "/admin/maintenance-time"
tags: ["Admin"]
---

# Set maintenance time

`POST /admin/maintenance-time`

## Request

- Base URL: `https://api.testnet.rise.trade`
- URL: `https://api.testnet.rise.trade/admin/maintenance-time`
- Auth: none required
- TypeScript: <https://skmtc.dev/rise/apis/risex-rest-api/docs/admin/maintenance-time/post.ts> (a function with typed inputs; its response is checked against the schema)

Set the scheduled next-maintenance time as Unix seconds. Pass <= 0 to clear it. Exposed to clients via GetSystemConfig.maintenance_time for the countdown banner.

## Request body

- ApiSetMaintenanceTimeRequest
  - `maintenance_time` string, int64: Scheduled next-maintenance time as Unix seconds. Pass <= 0 to clear it.
  - `maintenance_end_time` string, int64: Expected maintenance end time as Unix seconds. Pass <= 0 to clear it.
  - `maintenance_message` string: Free-text announcement shown in the banner. Pass "" to clear it.

## Response `200`

A successful response.

- ApiSetMaintenanceTimeResponse
  - `maintenance_time` string, int64: Maintenance time after the update: Unix seconds, or -1 when cleared.
  - `maintenance_end_time` string, int64: Maintenance end time after the update: Unix seconds, or -1 when cleared.
  - `maintenance_message` string: Message after the update ("" when cleared).

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-11-03** `98eabcd6a6ad`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rise/apis/risex-rest-api/changes/admin/maintenance-time/post.md)

---

[API](https://skmtc.dev/rise/apis/risex-rest-api.md) - [All operations](https://skmtc.dev/rise/apis/risex-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rise/apis/risex-rest-api/revisions/98eabcd6a6ad?raw)