Error 204551502 when creating maintenance via API - DX Operational Observability

Products

• DX Operational Observability
• DX SaaS

Issue/Introduction

When attempting to create a new maintenance window using the POST /oi/v2/api/maintenance endpoint, the API returns the following error:

{  "code": 204551502,  "msg": "Possible reason could be missing header or incorrect input parameters."}

This occurs even when using a JSON payload retrieved directly from the GET (Retrieve Maintenance) API

Environment

• DX Operational Observability (DX O2)
• Global Maintenance APIs

Cause

The JSON structure returned by the GET (Retrieve) API is not identical to the structure required by the POST (Create) API.

Using the retrieval payload results in "incorrect input parameters" because fields like schedule and members are formatted differently for creation.

Resolution

Use the correct JSON structure for the POST request. Ensure the schedule object and members array follow the creation schema:

1. Construct the payload using the following template:

{
  "name": "####",
  "schedule": {
    "startTime": "YYYY-MM-DD HH:mm:ss",
    "duration": ####,
    "timeZone": "####",
    "recurrencePattern": 1
  },
  "members": [
    {
      "id": "####",
      "type": "DEVICE",
      "name": "####"
    }
  ],
  "status": "ACTIVE"
}

2. Verify the Content-Type: application/json header is included.
3. Ensure the Authorization: Bearer #### header contains a valid token.
4. Subscribe to this article to be updated on fix status for related documentation defect DE677830 (Reference: KB 275360).

For detailed field definitions, refer to the Techdocs DX O2 - Create a Schedule.

To speak with a customer representative or a Support Engineer see Contact Support. Scroll to the bottom of the page and click on your respective region.