---
updatedAt: 2026-07-28T19:57:20.000Z
---
# Initiate a post-maintenance validation for a maintenance activity
Initiate a post-maintenance validation for a specific maintenance activity using the unique identifier of the maintenance activity.
Token Permissions: [ event_broker_upgrade:post ]
# OpenAPI definition
```json
{
"openapi": "3.0.1",
"info": {
"title": "MISSION CONTROL",
"description": "Documentation for Mission Control API",
"version": "2.2.1"
},
"servers": [
{
"url": "https://api.solace.cloud",
"description": "Solace Cloud US EAST Region"
},
{
"url": "https://api.solacecloud.com.au",
"description": "Solace Cloud AU Region"
},
{
"url": "https://api.solacecloud.eu",
"description": "Solace Cloud EU Region"
},
{
"url": "https://api.solacecloud.sg",
"description": "Solace Cloud SG Region"
}
],
"security": [
{
"bearerAuth": []
}
],
"paths": {
"/api/v2/missionControl/maintenanceActivities/{maintenanceActivityId}/initiatePostMaintenanceCheck": {
"post": {
"tags": [
"Maintenance Activities"
],
"summary": "Initiate a post-maintenance validation for a maintenance activity",
"description": "Initiate a post-maintenance validation for a specific maintenance activity using the unique identifier of the maintenance activity.
Token Permissions: [ event_broker_upgrade:post ]",
"operationId": "initiatePostMaintenanceCheck",
"parameters": [
{
"name": "maintenanceActivityId",
"in": "path",
"description": "The identifier of the maintenance activity.",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"202": {
"description": "Accepted",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MaintenanceActivityResponseDTO"
}
}
}
},
"400": {
"description": "Bad request.",
"content": {
"application/json": {}
}
},
"401": {
"description": "Unauthorized.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"example": {
"message": "An authentication error occurred.",
"errorId": "618e2fb0-a198-4d9d-9219-13e51ef0ecec"
}
}
}
},
"403": {
"description": "Forbidden.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"example": {
"message": "You do not have permissions to perform this operation.",
"errorId": "618e2fb0-a198-4d9d-9219-13e51ef0ecec"
}
}
}
},
"404": {
"description": "Not found.",
"content": {
"application/json": {}
}
},
"502": {
"description": "Bad Gateway - Marketplace integration error.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
}
}
}
}
},
"components": {
"schemas": {
"ErrorResponse": {
"type": "object",
"properties": {
"message": {
"type": "string",
"description": "A user-friendly message that describes the error.",
"example": "An error occurred."
},
"errorId": {
"type": "string",
"description": "The UUID (Universally Unique Identifier) that is logged with an appropriate stack trace for a WARN or ERROR log that allows support to better determine what cause the error.",
"example": "123e4567-e89b-12d3-a456-426655440000"
},
"meta": {
"type": "object",
"additionalProperties": {
"type": "object",
"description": "The metadata about the error. This provides additional information about the error that occurred.",
"example": "'object': { 'field': 'description' }"
},
"description": "The metadata about the error. This provides additional information about the error that occurred.",
"example": "'object': { 'field': 'description' }"
},
"validationDetails": {
"type": "object",
"additionalProperties": {
"type": "array",
"description": "When applicable, these are the details of issues with the fields provided for the REST call.",
"example": "'name': ['Not unique']",
"items": {
"type": "string",
"description": "When applicable, these are the details of issues with the fields provided for the REST call.",
"example": "'name': ['Not unique']"
}
},
"description": "When applicable, these are the details of issues with the fields provided for the REST call.",
"example": "'name': ['Not unique']"
}
}
},
"MaintenanceActivity": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The unique identifier of the maintenance activity."
},
"description": {
"type": "string",
"description": "The description of the maintenance activity."
},
"environmentId": {
"type": "string",
"description": "The identifier of the environment the maintenance activity belongs to."
},
"maintenanceWindowId": {
"type": "string",
"description": "The identifier of the maintenance window the activity is associated with."
},
"orgId": {
"type": "string",
"description": "The organization identifier associated with the maintenance activity."
},
"maintenanceType": {
"type": "string",
"description": "The type of maintenance schedule. \n\n- DATA_PATH: Maintenance affecting resources responsible for data operations, such as event broker services.
\n\n- CONTROL_PLANE: Maintenance affecting resources responsible for environment operations, such as the Mission Control Agent.
\n\n
",
"enum": [
"DATA_PATH",
"CONTROL_PLANE"
]
},
"startTime": {
"type": "string",
"description": "The actual time when the maintenance activity started.",
"format": "date-time"
},
"endTime": {
"type": "string",
"description": "The actual time when the maintenance activity ended.",
"format": "date-time"
},
"scheduledStartTime": {
"type": "string",
"description": "The planned start time for the maintenance activity.",
"format": "date-time"
},
"scheduledEndTime": {
"type": "string",
"description": "The planned end time for the maintenance activity.",
"format": "date-time"
},
"resourceId": {
"type": "string",
"description": "The identifier of the resource being maintained."
},
"resourceName": {
"type": "string",
"description": "The name of the resource being maintained."
},
"resourceType": {
"type": "string",
"description": "The type of resource being maintained (for example, SOLACE_EVENT_BROKER, DATADOG_AGENT, MISSION_CONTROL_AGENT).",
"enum": [
"SOLACE_EVENT_BROKER",
"DATADOG_AGENT",
"MISSION_CONTROL_AGENT"
]
},
"activityType": {
"type": "string",
"description": "The type of activity being performed (for example, SERVICE_UPGRADE, SERVICE_SCALE_UP).",
"enum": [
"SERVICE_UPGRADE",
"SERVICE_SCALE_UP",
"MANUAL_SERVICE_UPGRADE"
]
},
"details": {
"type": "string",
"description": "Additional information about the maintenance activity."
},
"preMaintenanceValidationStatus": {
"type": "string",
"description": "The current status of the pre-maintenance operation (for example, SCHEDULED, IN_PROGRESS, COMPLETED, FAILED).",
"enum": [
"SCHEDULED",
"IN_PROGRESS",
"COMPLETED",
"FAILED",
"CANCELLED",
"SKIPPED",
"PAUSED",
"WARNING",
"RESOLVED"
]
},
"postMaintenanceValidationStatus": {
"type": "string",
"description": "The current status of the post-maintenance operation (for example, SCHEDULED, IN_PROGRESS, COMPLETED, FAILED).",
"enum": [
"SCHEDULED",
"IN_PROGRESS",
"COMPLETED",
"FAILED",
"CANCELLED",
"SKIPPED",
"PAUSED",
"WARNING",
"RESOLVED"
]
},
"operationStatus": {
"type": "string",
"description": "The current status of the maintenance operation (for example, SCHEDULED, IN_PROGRESS, COMPLETED, FAILED).",
"enum": [
"SCHEDULED",
"IN_PROGRESS",
"COMPLETED",
"FAILED",
"CANCELLED",
"SKIPPED",
"PAUSED",
"WARNING",
"RESOLVED"
]
},
"maintenanceActivityStatus": {
"type": "string",
"description": "The combined status of preMaintenanceValidationStatus, operationStatus and postMaintenanceValidationStatus (for example, SCHEDULED, IN_PROGRESS, COMPLETED, FAILED).",
"enum": [
"SCHEDULED",
"IN_PROGRESS",
"COMPLETED",
"FAILED",
"CANCELLED",
"SKIPPED",
"PAUSED",
"WARNING",
"RESOLVED"
]
},
"createdBy": {
"type": "string",
"description": "The user who created the maintenance activity."
},
"createdTime": {
"type": "string",
"description": "When the maintenance activity was created.",
"format": "date-time"
},
"updatedBy": {
"type": "string",
"description": "The user who last updated the maintenance activity."
},
"updatedTime": {
"type": "string",
"description": "The time when the maintenance activity was last updated.",
"format": "date-time"
},
"preMaintenanceValidationResults": {
"type": "array",
"description": "Pre-maintenance validation results associated with the activity.",
"items": {
"type": "string",
"description": "Pre-maintenance validation results associated with the activity."
}
},
"postMaintenanceValidationResults": {
"type": "array",
"description": "Post-maintenance validation results associated with the activity.",
"items": {
"type": "string",
"description": "Post-maintenance validation results associated with the activity."
}
},
"critical": {
"type": "boolean",
"description": "Indicates whether the maintenance activity is critical. Critical activities may not be cancelled, only rescheduled."
},
"maintenanceLogs": {
"type": "array",
"description": "Maintenance logs associated with the activity.",
"items": {
"type": "string",
"description": "Maintenance logs associated with the activity."
}
},
"type": {
"type": "string",
"description": "The type of object for informational purposes."
},
"_links": {
"type": "object",
"additionalProperties": {
"$ref": "#/components/schemas/MaintenanceActivityLink"
},
"description": "Links to related resources for this activity, keyed by relation name. Always present, and empty when the activity has none. A manual (self-managed) event broker upgrade waiting for you to redeploy carries deploymentArtifacts, the deployment artifacts for the target version, and, where available, deploymentInstructions."
}
}
},
"MaintenanceActivityLink": {
"type": "object",
"properties": {
"href": {
"type": "string",
"description": "The URL of the linked resource."
}
},
"description": "Links to related resources for this activity, keyed by relation name. Always present, and empty when the activity has none. A manual (self-managed) event broker upgrade waiting for you to redeploy carries deploymentArtifacts, the deployment artifacts for the target version, and, where available, deploymentInstructions."
},
"MaintenanceActivityResponseDTO": {
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/MaintenanceActivity"
}
}
}
},
"securitySchemes": {
"bearerAuth": {
"type": "http",
"scheme": "bearer",
"bearerFormat": "JWT"
}
}
}
}
```