Jump to

• Request
• Response

Create a new blackout reason

post

https://EM_HOST:EM_CONSOLE_HTTPS_PORT/em/api/blackouts/reasons

Creates a new user-defined blackout reason.

Request

There are no request parameters for this operation.

Supported Media Types

• application/json

Request Body - application/json ()

Root Schema : schema

Type: object

Payload to create a new blackout reason.

Match All

Payload to create a new blackout reason.

Show Source

• object Reason
  Reason of a blackout.

{
    "x-em-sdk-level":"emSDK",
    "type":"object",
    "description":"Payload to create a new blackout reason.",
    "allOf":[
        {
            "$ref":"#/components/schemas/Reason"
        }
    ]
}

Nested Schema : Reason

Type: object

Reason of a blackout.

Show Source

• reason: string
  Predefined reason in English or a user defined reason.

{
    "x-em-sdk-level":"emSDK",
    "type":"object",
    "description":"Reason of a blackout.",
    "properties":{
        "reason":{
            "type":"string",
            "description":"Predefined reason in English or a user defined reason."
        }
    }
}

Examples

Select an example Create a blackout reason

Back to Top

Response

Supported Media Types

• application/json

201 Response

Created.

Body ()

Root Schema : BlackoutReason

Type: object

A single blackout reason.

Show Source

• reasonDisplayName: string
  Localized predefined reason or the user defined reason as provided by the user.

{
    "x-em-sdk-level":"emSDK",
    "description":"A single blackout reason.",
    "type":"object",
    "properties":{
        "reasonDisplayName":{
            "type":"string",
            "description":"Localized predefined reason or the user defined reason as provided by the user."
        }
    },
    "allOf":[
        {
            "$ref":"#/components/schemas/ReasonId"
        },
        {
            "$ref":"#/components/schemas/Reason"
        }
    ]
}

Match All

A single blackout reason.

A single blackout reason.

Show Source

• object ReasonId
  Reason id of a blackout.
• object Reason
  Reason of a blackout.

{
    "x-em-sdk-level":"emSDK",
    "description":"A single blackout reason.",
    "type":"object",
    "properties":{
        "reasonDisplayName":{
            "type":"string",
            "description":"Localized predefined reason or the user defined reason as provided by the user."
        }
    },
    "allOf":[
        {
            "$ref":"#/components/schemas/ReasonId"
        },
        {
            "$ref":"#/components/schemas/Reason"
        }
    ]
}

Nested Schema : ReasonId

Type: object

Reason id of a blackout.

Show Source

• id: string
  Reason id of a blackout.

{
    "x-em-sdk-level":"emSDK",
    "type":"object",
    "description":"Reason id of a blackout.",
    "properties":{
        "id":{
            "type":"string",
            "description":"Reason id of a blackout."
        }
    }
}

Nested Schema : Reason

Type: object

Reason of a blackout.

Show Source

• reason: string
  Predefined reason in English or a user defined reason.

{
    "x-em-sdk-level":"emSDK",
    "type":"object",
    "description":"Reason of a blackout.",
    "properties":{
        "reason":{
            "type":"string",
            "description":"Predefined reason in English or a user defined reason."
        }
    }
}

Examples

Select an example Result - Create a new blackout reason

400 Response

One of the given parameters is invalid.

Body ()

Root Schema : ErrorResponse

Type: object

Response sent back in the case of an Error

Show Source

• code(required): string
  customer facing error code
• details: array details
  (Optional) List of additional details for the errors found.
• message(required): string
  customer facing error description

{
    "description":"Response sent back in the case of an Error",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"customer facing error code"
        },
        "message":{
            "type":"string",
            "description":"customer facing error description"
        },
        "details":{
            "type":"array",
            "description":"(Optional) List of additional details for the errors found.",
            "items":{
                "$ref":"#/components/schemas/ErrorDetail"
            }
        }
    }
}

Nested Schema : details

Type: array

(Optional) List of additional details for the errors found.

Show Source

• Array of: object ErrorDetail
  listed as part of ErrorResponse

{
    "type":"array",
    "description":"(Optional) List of additional details for the errors found.",
    "items":{
        "$ref":"#/components/schemas/ErrorDetail"
    }
}

Nested Schema : ErrorDetail

Type: object

listed as part of ErrorResponse

Show Source

• message(required): string
  specific error description

{
    "description":"listed as part of ErrorResponse",
    "type":"object",
    "required":[
        "message"
    ],
    "properties":{
        "message":{
            "type":"string",
            "description":"specific error description"
        }
    }
}

401 Response

client is not authenticated

Body ()

Root Schema : ErrorResponse

Type: object

Response sent back in the case of an Error

Show Source

• code(required): string
  customer facing error code
• details: array details
  (Optional) List of additional details for the errors found.
• message(required): string
  customer facing error description

{
    "description":"Response sent back in the case of an Error",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"customer facing error code"
        },
        "message":{
            "type":"string",
            "description":"customer facing error description"
        },
        "details":{
            "type":"array",
            "description":"(Optional) List of additional details for the errors found.",
            "items":{
                "$ref":"#/components/schemas/ErrorDetail"
            }
        }
    }
}

Nested Schema : details

Type: array

(Optional) List of additional details for the errors found.

Show Source

• Array of: object ErrorDetail
  listed as part of ErrorResponse

{
    "type":"array",
    "description":"(Optional) List of additional details for the errors found.",
    "items":{
        "$ref":"#/components/schemas/ErrorDetail"
    }
}

Nested Schema : ErrorDetail

Type: object

listed as part of ErrorResponse

Show Source

• message(required): string
  specific error description

{
    "description":"listed as part of ErrorResponse",
    "type":"object",
    "required":[
        "message"
    ],
    "properties":{
        "message":{
            "type":"string",
            "description":"specific error description"
        }
    }
}

409 Response

not authorized or target already exists

Body ()

Root Schema : ErrorResponse

Type: object

Response sent back in the case of an Error

Show Source

• code(required): string
  customer facing error code
• details: array details
  (Optional) List of additional details for the errors found.
• message(required): string
  customer facing error description

{
    "description":"Response sent back in the case of an Error",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"customer facing error code"
        },
        "message":{
            "type":"string",
            "description":"customer facing error description"
        },
        "details":{
            "type":"array",
            "description":"(Optional) List of additional details for the errors found.",
            "items":{
                "$ref":"#/components/schemas/ErrorDetail"
            }
        }
    }
}

Nested Schema : details

Type: array

(Optional) List of additional details for the errors found.

Show Source

• Array of: object ErrorDetail
  listed as part of ErrorResponse

{
    "type":"array",
    "description":"(Optional) List of additional details for the errors found.",
    "items":{
        "$ref":"#/components/schemas/ErrorDetail"
    }
}

Nested Schema : ErrorDetail

Type: object

listed as part of ErrorResponse

Show Source

• message(required): string
  specific error description

{
    "description":"listed as part of ErrorResponse",
    "type":"object",
    "required":[
        "message"
    ],
    "properties":{
        "message":{
            "type":"string",
            "description":"specific error description"
        }
    }
}

500 Response

internal error serving the request

Body ()

Root Schema : ErrorResponse

Type: object

Response sent back in the case of an Error

Show Source

• code(required): string
  customer facing error code
• details: array details
  (Optional) List of additional details for the errors found.
• message(required): string
  customer facing error description

{
    "description":"Response sent back in the case of an Error",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"customer facing error code"
        },
        "message":{
            "type":"string",
            "description":"customer facing error description"
        },
        "details":{
            "type":"array",
            "description":"(Optional) List of additional details for the errors found.",
            "items":{
                "$ref":"#/components/schemas/ErrorDetail"
            }
        }
    }
}

Nested Schema : details

Type: array

(Optional) List of additional details for the errors found.

Show Source

• Array of: object ErrorDetail
  listed as part of ErrorResponse

{
    "type":"array",
    "description":"(Optional) List of additional details for the errors found.",
    "items":{
        "$ref":"#/components/schemas/ErrorDetail"
    }
}

Nested Schema : ErrorDetail

Type: object

listed as part of ErrorResponse

Show Source

• message(required): string
  specific error description

{
    "description":"listed as part of ErrorResponse",
    "type":"object",
    "required":[
        "message"
    ],
    "properties":{
        "message":{
            "type":"string",
            "description":"specific error description"
        }
    }
}

503 Response

indicates that a required service is not available.

Body ()

Root Schema : ErrorResponse

Type: object

Response sent back in the case of an Error

Show Source

• code(required): string
  customer facing error code
• details: array details
  (Optional) List of additional details for the errors found.
• message(required): string
  customer facing error description

{
    "description":"Response sent back in the case of an Error",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"customer facing error code"
        },
        "message":{
            "type":"string",
            "description":"customer facing error description"
        },
        "details":{
            "type":"array",
            "description":"(Optional) List of additional details for the errors found.",
            "items":{
                "$ref":"#/components/schemas/ErrorDetail"
            }
        }
    }
}

Nested Schema : details

Type: array

(Optional) List of additional details for the errors found.

Show Source

• Array of: object ErrorDetail
  listed as part of ErrorResponse

{
    "type":"array",
    "description":"(Optional) List of additional details for the errors found.",
    "items":{
        "$ref":"#/components/schemas/ErrorDetail"
    }
}

Nested Schema : ErrorDetail

Type: object

listed as part of ErrorResponse

Show Source

• message(required): string
  specific error description

{
    "description":"listed as part of ErrorResponse",
    "type":"object",
    "required":[
        "message"
    ],
    "properties":{
        "message":{
            "type":"string",
            "description":"specific error description"
        }
    }
}

Back to Top