openapi.v1.json

{
  "openapi": "3.0.3",
  "info": {
    "title": "Cloud Regions Geo API",
    "description": "API to get geographic data for cloud provider regions",
    "version": "1.0.0"
  },
  "paths": {
    "/api/v1/cloud-locations/{provider}": {
      "get": {
        "summary": "Get all regions for a specific cloud provider",
        "description": "Returns geographic data for all regions of a specific cloud provider",
        "operationId": "getCloudProviderRegions",
        "parameters": [
          {
            "name": "provider",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "aws",
                "gcp",
                "azure"
              ]
            },
            "description": "Cloud provider (aws, gcp, azure)"
          }
        ],
        "responses": {
          "200": {
            "description": "Successfully returned geographic data for cloud provider regions",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": {
                    "$ref": "#/components/schemas/CloudRegionGeoData"
                  }
                }
              }
            }
          },
          "404": {
            "description": "Cloud provider not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "example": "Cloud provider 'unknown' not found"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/deployment-versions/{deploymentVersionId}/approve/environment/{environmentId}": {
      "post": {
        "summary": "Approve a deployment version for an environment",
        "operationId": "approveDeploymentVersionForEnvironment",
        "parameters": [
          {
            "name": "deploymentVersionId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "environmentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "reason": {
                    "type": "string"
                  },
                  "approvedAt": {
                    "type": "string",
                    "format": "date-time"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Approval record created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApprovalRecord"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Deployment version or environment not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/deployment-versions/{deploymentVersionId}/approve": {
      "post": {
        "summary": "Approve a deployment version",
        "operationId": "approveDeploymentVersion",
        "parameters": [
          {
            "name": "deploymentVersionId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "description": "The deployment version ID"
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "reason": {
                    "type": "string"
                  },
                  "approvedAt": {
                    "type": "string",
                    "format": "date-time",
                    "nullable": true
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Deployment version approved",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApprovalRecord"
                }
              }
            }
          },
          "403": {
            "description": "Permission denied",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Deployment version not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/deployment-versions/{deploymentVersionId}/environments/{environmentId}/rollout": {
      "get": {
        "summary": "Get the rollout information across all release targets for a given deployment version and environment",
        "operationId": "getRolloutInfo",
        "parameters": [
          {
            "name": "deploymentVersionId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "description": "The deployment version ID"
          },
          {
            "name": "environmentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "description": "The environment ID"
          }
        ],
        "responses": {
          "200": {
            "description": "The rollout information",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "allOf": [
                      {
                        "$ref": "#/components/schemas/ReleaseTarget"
                      },
                      {
                        "type": "object",
                        "properties": {
                          "rolloutTime": {
                            "type": "string",
                            "format": "date-time",
                            "nullable": true
                          },
                          "rolloutPosition": {
                            "type": "number"
                          }
                        },
                        "required": [
                          "rolloutTime",
                          "rolloutPosition"
                        ]
                      }
                    ]
                  }
                }
              }
            }
          },
          "404": {
            "description": "The deployment version or environment was not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/deployment-versions/{deploymentVersionId}": {
      "patch": {
        "summary": "Updates a deployment version",
        "operationId": "updateDeploymentVersion",
        "parameters": [
          {
            "name": "deploymentVersionId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The deployment version ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "tag": {
                    "type": "string"
                  },
                  "deploymentId": {
                    "type": "string"
                  },
                  "createdAt": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "name": {
                    "type": "string"
                  },
                  "config": {
                    "type": "object",
                    "additionalProperties": true
                  },
                  "jobAgentConfig": {
                    "type": "object",
                    "additionalProperties": true
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "ready",
                      "building",
                      "failed",
                      "rejected"
                    ]
                  },
                  "message": {
                    "type": "string"
                  },
                  "metadata": {
                    "type": "object",
                    "additionalProperties": {
                      "type": "string"
                    }
                  },
                  "dependencies": {
                    "type": "array",
                    "items": {
                      "$ref": "#/components/schemas/VersionDependency"
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeploymentVersion"
                }
              }
            }
          },
          "404": {
            "description": "Deployment version not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/deployment-versions/{deploymentVersionId}/reject/environment/{environmentId}": {
      "post": {
        "summary": "Reject a deployment version for an environment",
        "operationId": "rejectDeploymentVersionForEnvironment",
        "parameters": [
          {
            "name": "deploymentVersionId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "environmentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "reason": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Rejection record created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApprovalRecord"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Deployment version or environment not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/deployment-versions/{deploymentVersionId}/reject": {
      "post": {
        "summary": "Reject a deployment version",
        "operationId": "rejectDeploymentVersion",
        "parameters": [
          {
            "name": "deploymentVersionId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "description": "The deployment version ID"
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "reason": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Deployment version rejected",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApprovalRecord"
                }
              }
            }
          },
          "403": {
            "description": "Permission denied",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Deployment version not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/deployment-versions": {
      "post": {
        "summary": "Upserts a deployment version",
        "operationId": "upsertDeploymentVersion",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "tag": {
                    "type": "string"
                  },
                  "deploymentId": {
                    "type": "string"
                  },
                  "createdAt": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "name": {
                    "type": "string"
                  },
                  "config": {
                    "type": "object",
                    "additionalProperties": true
                  },
                  "jobAgentConfig": {
                    "type": "object",
                    "additionalProperties": true
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "ready",
                      "building",
                      "failed",
                      "rejected"
                    ]
                  },
                  "message": {
                    "type": "string"
                  },
                  "metadata": {
                    "type": "object",
                    "additionalProperties": {
                      "type": "string"
                    }
                  },
                  "dependencies": {
                    "type": "array",
                    "items": {
                      "$ref": "#/components/schemas/VersionDependency"
                    }
                  }
                },
                "required": [
                  "tag",
                  "deploymentId"
                ]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeploymentVersion"
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/deployments/{deploymentId}": {
      "get": {
        "summary": "Get a deployment",
        "operationId": "getDeployment",
        "parameters": [
          {
            "name": "deploymentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Deployment found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Deployment"
                }
              }
            }
          },
          "404": {
            "description": "Deployment not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          }
        }
      },
      "delete": {
        "summary": "Delete a deployment",
        "operationId": "deleteDeployment",
        "parameters": [
          {
            "name": "deploymentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Deployment deleted",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Deployment"
                }
              }
            }
          },
          "404": {
            "description": "Deployment not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          },
          "500": {
            "description": "Failed to delete deployment",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          }
        }
      },
      "patch": {
        "summary": "Update a deployment",
        "operationId": "updateDeployment",
        "parameters": [
          {
            "name": "deploymentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "slug": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string"
                  },
                  "systemId": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "jobAgentId": {
                    "type": "string",
                    "format": "uuid",
                    "nullable": true
                  },
                  "jobAgentConfig": {
                    "type": "object",
                    "additionalProperties": true
                  },
                  "retryCount": {
                    "type": "integer"
                  },
                  "timeout": {
                    "type": "integer",
                    "nullable": true
                  },
                  "resourceSelector": {
                    "type": "object",
                    "additionalProperties": true,
                    "nullable": true
                  },
                  "exitHooks": {
                    "type": "array",
                    "items": {
                      "$ref": "#/components/schemas/ExitHook"
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Deployment updated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Deployment"
                }
              }
            }
          },
          "404": {
            "description": "Deployment not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          },
          "500": {
            "description": "Failed to update deployment",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/v1/deployments/{deploymentId}/resources": {
      "get": {
        "summary": "Get resources for a deployment",
        "operationId": "getResourcesForDeployment",
        "parameters": [
          {
            "name": "deploymentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "UUID of the deployment"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "resources": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Resource"
                      }
                    },
                    "count": {
                      "type": "number"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/deployments/{deploymentId}/variables": {
      "get": {
        "summary": "Get all variables for a deployment",
        "operationId": "getDeploymentVariables",
        "parameters": [
          {
            "name": "deploymentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Variables fetched successfully",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DeploymentVariable"
                  }
                }
              }
            }
          },
          "404": {
            "description": "Deployment not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          },
          "500": {
            "description": "Failed to fetch variables",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          }
        }
      },
      "post": {
        "summary": "Create a new variable for a deployment",
        "operationId": "createDeploymentVariable",
        "parameters": [
          {
            "name": "deploymentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "key": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string"
                  },
                  "config": {
                    "type": "object",
                    "additionalProperties": true
                  },
                  "directValues": {
                    "type": "array",
                    "items": {
                      "$ref": "#/components/schemas/DirectDeploymentVariableValue"
                    }
                  },
                  "referenceValues": {
                    "type": "array",
                    "items": {
                      "$ref": "#/components/schemas/ReferenceDeploymentVariableValue"
                    }
                  }
                },
                "required": [
                  "key",
                  "config"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Variable created successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeploymentVariable"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request body",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          },
          "404": {
            "description": "Deployment not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          },
          "500": {
            "description": "Failed to create variable",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/v1/deployments/{deploymentId}/versions": {
      "get": {
        "summary": "List deployment versions",
        "operationId": "listDeploymentVersions",
        "parameters": [
          {
            "name": "deploymentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "ready",
                "building",
                "failed",
                "rejected"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Deployment versions",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DeploymentVersion"
                  }
                }
              }
            }
          },
          "404": {
            "description": "Deployment not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/v1/deployments": {
      "post": {
        "summary": "Create a deployment",
        "operationId": "createDeployment",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "systemId": {
                    "type": "string",
                    "format": "uuid",
                    "description": "The ID of the system to create the deployment for",
                    "example": "123e4567-e89b-12d3-a456-426614174000"
                  },
                  "name": {
                    "type": "string",
                    "description": "The name of the deployment",
                    "example": "My Deployment"
                  },
                  "slug": {
                    "type": "string",
                    "description": "The slug of the deployment",
                    "example": "my-deployment"
                  },
                  "description": {
                    "type": "string",
                    "description": "The description of the deployment",
                    "example": "This is a deployment for my system"
                  },
                  "jobAgentId": {
                    "type": "string",
                    "format": "uuid",
                    "description": "The ID of the job agent to use for the deployment",
                    "example": "123e4567-e89b-12d3-a456-426614174000"
                  },
                  "jobAgentConfig": {
                    "type": "object",
                    "description": "The configuration for the job agent",
                    "example": {
                      "key": "value"
                    }
                  },
                  "retryCount": {
                    "type": "number",
                    "description": "The number of times to retry the deployment",
                    "example": 3
                  },
                  "timeout": {
                    "type": "number",
                    "description": "The timeout for the deployment",
                    "example": 60
                  },
                  "resourceSelector": {
                    "type": "object",
                    "description": "The resource selector for the deployment",
                    "example": {
                      "key": "value"
                    },
                    "additionalProperties": true
                  },
                  "exitHooks": {
                    "type": "array",
                    "items": {
                      "$ref": "#/components/schemas/ExitHook"
                    }
                  }
                },
                "required": [
                  "systemId",
                  "slug",
                  "name"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Deployment updated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Deployment"
                }
              }
            }
          },
          "201": {
            "description": "Deployment created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Deployment"
                }
              }
            }
          },
          "409": {
            "description": "Deployment already exists",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    },
                    "id": {
                      "type": "string",
                      "format": "uuid"
                    }
                  },
                  "required": [
                    "error",
                    "id"
                  ]
                }
              }
            }
          },
          "500": {
            "description": "Failed to create deployment",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/v1/environments/{environmentId}": {
      "get": {
        "summary": "Get an environment",
        "operationId": "getEnvironment",
        "parameters": [
          {
            "name": "environmentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "UUID of the environment"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Environment"
                }
              }
            }
          },
          "404": {
            "description": "Environment not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "example": "Environment not found"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          }
        }
      },
      "delete": {
        "summary": "Delete an environment",
        "operationId": "deleteEnvironment",
        "parameters": [
          {
            "name": "environmentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "UUID of the environment"
          }
        ],
        "responses": {
          "200": {
            "description": "Environment deleted successfully"
          }
        }
      }
    },
    "/v1/environments/{environmentId}/resources": {
      "get": {
        "summary": "Get resources for an environment",
        "operationId": "getResourcesForEnvironment",
        "parameters": [
          {
            "name": "environmentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "UUID of the environment"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "resources": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Resource"
                      }
                    },
                    "count": {
                      "type": "number"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/environments": {
      "post": {
        "summary": "Create an environment",
        "operationId": "createEnvironment",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "systemId",
                  "name"
                ],
                "properties": {
                  "directory": {
                    "type": "string",
                    "description": "The directory path of the environment",
                    "example": "my/env/path",
                    "default": ""
                  },
                  "systemId": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string"
                  },
                  "resourceSelector": {
                    "type": "object",
                    "additionalProperties": true
                  },
                  "metadata": {
                    "type": "object",
                    "additionalProperties": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Environment created successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Environment"
                }
              }
            }
          },
          "409": {
            "description": "Environment already exists",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    },
                    "id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Failed to create environment",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/v1/job-agents/{agentId}/jobs/running": {
      "get": {
        "summary": "Get a agents running jobs",
        "operationId": "getAgentRunningJobs",
        "parameters": [
          {
            "name": "agentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The execution ID"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "jobs": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Job"
                      }
                    }
                  },
                  "required": [
                    "jobs"
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/v1/job-agents/{agentId}/queue/acknowledge": {
      "post": {
        "summary": "Acknowledge a job for an agent",
        "operationId": "acknowledgeAgentJob",
        "description": "Marks a job as acknowledged by the agent",
        "parameters": [
          {
            "name": "agentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The ID of the job agent"
          }
        ],
        "responses": {
          "200": {
            "description": "Successfully acknowledged job",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "job": {
                      "$ref": "#/components/schemas/Job"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Workspace not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/job-agents/{agentId}/queue/next": {
      "get": {
        "summary": "Get the next jobs",
        "operationId": "getNextJobs",
        "parameters": [
          {
            "name": "agentId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The agent ID"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "jobs": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "$ref": "#/components/schemas/Job"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/job-agents/name": {
      "patch": {
        "summary": "Upserts the agent",
        "operationId": "upsertJobAgent",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "workspaceId": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "type": {
                    "type": "string"
                  }
                },
                "required": [
                  "type",
                  "name",
                  "workspaceId"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successfully retrieved or created the agent",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "workspaceId": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "name",
                    "workspaceId"
                  ]
                }
              }
            }
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    },
    "/v1/jobs/{jobId}/acknowledge": {
      "post": {
        "summary": "Acknowledge a job",
        "operationId": "acknowledgeJob",
        "parameters": [
          {
            "name": "jobId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The job ID"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "sucess": {
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "sucess"
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/v1/jobs/{jobId}": {
      "get": {
        "summary": "Get a Job",
        "operationId": "getJob",
        "parameters": [
          {
            "name": "jobId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The job ID"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JobWithTrigger"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "example": "Job not found."
                    }
                  }
                }
              }
            }
          }
        }
      },
      "patch": {
        "summary": "Update a job",
        "operationId": "updateJob",
        "parameters": [
          {
            "name": "jobId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The execution ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "status": {
                    "$ref": "#/components/schemas/JobStatus",
                    "nullable": true
                  },
                  "message": {
                    "type": "string",
                    "nullable": true
                  },
                  "externalId": {
                    "type": "string",
                    "nullable": true
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    },
                    "message": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "success",
                    "message"
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/v1/policies/{policyId}": {
      "get": {
        "summary": "Get a policy",
        "operationId": "getPolicy",
        "parameters": [
          {
            "name": "policyId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Policy"
                }
              }
            }
          },
          "404": {
            "description": "Policy not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      },
      "patch": {
        "summary": "Update a policy",
        "operationId": "updatePolicy",
        "parameters": [
          {
            "name": "policyId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string"
                  },
                  "priority": {
                    "type": "number"
                  },
                  "enabled": {
                    "type": "boolean"
                  },
                  "workspaceId": {
                    "type": "string"
                  },
                  "targets": {
                    "type": "array",
                    "items": {
                      "$ref": "#/components/schemas/PolicyTarget"
                    }
                  },
                  "denyWindows": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "timeZone": {
                          "type": "string"
                        },
                        "rrule": {
                          "type": "object",
                          "additionalProperties": true
                        },
                        "dtend": {
                          "type": "string",
                          "format": "date-time"
                        }
                      },
                      "required": [
                        "timeZone"
                      ]
                    }
                  },
                  "deploymentVersionSelector": {
                    "$ref": "#/components/schemas/DeploymentVersionSelector"
                  },
                  "versionAnyApprovals": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "requiredApprovalsCount": {
                          "type": "number"
                        }
                      }
                    }
                  },
                  "versionUserApprovals": {
                    "type": "array",
                    "items": {
                      "$ref": "#/components/schemas/VersionUserApproval"
                    }
                  },
                  "versionRoleApprovals": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "roleId": {
                          "type": "string"
                        },
                        "requiredApprovalsCount": {
                          "type": "number"
                        }
                      },
                      "required": [
                        "roleId"
                      ]
                    }
                  },
                  "concurrency": {
                    "$ref": "#/components/schemas/PolicyConcurrency"
                  },
                  "environmentVersionRollout": {
                    "$ref": "#/components/schemas/InsertEnvironmentVersionRollout"
                  },
                  "maxRetries": {
                    "$ref": "#/components/schemas/MaxRetries"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Policy"
                }
              }
            }
          },
          "404": {
            "description": "Policy not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      },
      "delete": {
        "summary": "Delete a policy",
        "operationId": "deletePolicy",
        "parameters": [
          {
            "name": "policyId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "count": {
                      "type": "number"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/policies/{policyId}/release-targets": {
      "get": {
        "summary": "Get release targets for a policy",
        "operationId": "getReleaseTargetsForPolicy",
        "parameters": [
          {
            "name": "policyId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "UUID of the policy"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "releaseTargets": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/ReleaseTarget"
                      }
                    },
                    "count": {
                      "type": "number"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/policies": {
      "post": {
        "summary": "Upsert a policy",
        "operationId": "upsertPolicy",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string"
                  },
                  "priority": {
                    "type": "number"
                  },
                  "enabled": {
                    "type": "boolean"
                  },
                  "workspaceId": {
                    "type": "string"
                  },
                  "targets": {
                    "type": "array",
                    "items": {
                      "$ref": "#/components/schemas/PolicyTarget"
                    }
                  },
                  "denyWindows": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "timeZone": {
                          "type": "string"
                        },
                        "rrule": {
                          "type": "object",
                          "additionalProperties": true
                        },
                        "dtend": {
                          "type": "string",
                          "format": "date-time"
                        }
                      },
                      "required": [
                        "timeZone"
                      ]
                    }
                  },
                  "deploymentVersionSelector": {
                    "$ref": "#/components/schemas/DeploymentVersionSelector"
                  },
                  "versionAnyApprovals": {
                    "$ref": "#/components/schemas/VersionAnyApproval"
                  },
                  "versionUserApprovals": {
                    "type": "array",
                    "items": {
                      "$ref": "#/components/schemas/VersionUserApproval"
                    }
                  },
                  "versionRoleApprovals": {
                    "type": "array",
                    "items": {
                      "$ref": "#/components/schemas/VersionRoleApproval"
                    }
                  },
                  "concurrency": {
                    "$ref": "#/components/schemas/PolicyConcurrency"
                  },
                  "environmentVersionRollout": {
                    "$ref": "#/components/schemas/InsertEnvironmentVersionRollout"
                  },
                  "maxRetries": {
                    "$ref": "#/components/schemas/MaxRetries"
                  }
                },
                "required": [
                  "name",
                  "workspaceId",
                  "targets"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Policy"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/relationship/job-to-resource": {
      "post": {
        "summary": "Create a relationship between a job and a resource",
        "operationId": "createJobToResourceRelationship",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "jobId": {
                    "type": "string",
                    "format": "uuid",
                    "description": "Unique identifier of the job",
                    "example": "123e4567-e89b-12d3-a456-426614174000"
                  },
                  "resourceIdentifier": {
                    "type": "string",
                    "description": "Unique identifier of the resource",
                    "maxLength": 255,
                    "example": "resource-123"
                  }
                },
                "required": [
                  "jobId",
                  "resourceIdentifier"
                ],
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Relationship created successfully",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "example": "Relationship created successfully"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid request body",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "example": "Invalid jobId format"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Job or resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "example": "Job with specified ID not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Relationship already exists",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "example": "Relationship between job and resource already exists"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "example": "Internal server error occurred"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/relationship/resource-to-resource": {
      "post": {
        "summary": "Create a relationship between two resources",
        "operationId": "createResourceToResourceRelationship",
        "tags": [
          "Resource Relationships"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "workspaceId": {
                    "type": "string",
                    "format": "uuid",
                    "description": "The workspace ID",
                    "example": "123e4567-e89b-12d3-a456-426614174000"
                  },
                  "fromIdentifier": {
                    "type": "string",
                    "description": "The identifier of the resource to connect",
                    "example": "my-resource"
                  },
                  "toIdentifier": {
                    "type": "string",
                    "description": "The identifier of the resource to connect to",
                    "example": "my-resource"
                  },
                  "type": {
                    "type": "string",
                    "description": "The type of relationship",
                    "example": "depends_on"
                  }
                },
                "required": [
                  "workspaceId",
                  "fromIdentifier",
                  "toIdentifier",
                  "type"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Relationship created",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "example": "Relationship created successfully"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid request body",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Relationship already exists",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/release-targets/{releaseTargetId}/latest-jobs": {
      "get": {
        "summary": "Get the 10 latest jobs for a release target",
        "operationId": "getLatestJobs",
        "parameters": [
          {
            "name": "releaseTargetId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "description": "The release target ID"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/JobWithTrigger"
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "example": "Job not found."
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "example": "Internal server error."
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/release-targets/{releaseTargetId}/lock": {
      "post": {
        "summary": "Lock a release target",
        "operationId": "lockReleaseTarget",
        "parameters": [
          {
            "name": "releaseTargetId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Release target locked",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReleaseTargetLockRecord"
                }
              }
            }
          },
          "409": {
            "description": "Release target is already locked",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/release-targets/{releaseTargetId}": {
      "get": {
        "summary": "Get a release target",
        "operationId": "getReleaseTarget",
        "parameters": [
          {
            "name": "releaseTargetId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The release target",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReleaseTarget"
                }
              }
            }
          },
          "404": {
            "description": "Release target not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/release-targets/{releaseTargetId}/pin": {
      "post": {
        "summary": "Pin a version to a release target",
        "operationId": "pinReleaseTarget",
        "parameters": [
          {
            "name": "releaseTargetId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "oneOf": [
                  {
                    "type": "object",
                    "properties": {
                      "versionId": {
                        "type": "string",
                        "format": "uuid",
                        "example": "123e4567-e89b-12d3-a456-426614174000",
                        "description": "The ID of the version to pin"
                      }
                    },
                    "required": [
                      "versionId"
                    ]
                  },
                  {
                    "type": "object",
                    "properties": {
                      "versionTag": {
                        "type": "string",
                        "example": "1.0.0",
                        "description": "The tag of the version to pin"
                      }
                    },
                    "required": [
                      "versionTag"
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Version pinned",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Version not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/release-targets/{releaseTargetId}/redeploy": {
      "post": {
        "summary": "Redeploy a release target",
        "operationId": "redeployReleaseTarget",
        "parameters": [
          {
            "name": "releaseTargetId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Release target not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/release-targets/{releaseTargetId}/releases": {
      "get": {
        "summary": "Get the latest 100 releases for a release target",
        "operationId": "getReleaseTargetReleases",
        "parameters": [
          {
            "name": "releaseTargetId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The latest 100 releases for the release target",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "deployment": {
                        "$ref": "#/components/schemas/Deployment"
                      },
                      "version": {
                        "$ref": "#/components/schemas/DeploymentVersion"
                      },
                      "variables": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "key": {
                              "type": "string"
                            },
                            "value": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "key",
                            "value"
                          ]
                        }
                      }
                    },
                    "required": [
                      "deployment",
                      "version",
                      "variables"
                    ]
                  }
                }
              }
            }
          },
          "404": {
            "description": "The release target was not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          },
          "500": {
            "description": "An internal server error occurred",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/v1/release-targets/{releaseTargetId}/unlock": {
      "post": {
        "summary": "Unlock a release target",
        "operationId": "unlockReleaseTarget",
        "parameters": [
          {
            "name": "releaseTargetId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Release target unlocked",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReleaseTargetLockRecord"
                }
              }
            }
          },
          "400": {
            "description": "Release target is not locked",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Release target was not locked by the current user",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/release-targets/{releaseTargetId}/unpin": {
      "post": {
        "summary": "Unpin a version from a release target",
        "operationId": "unpinReleaseTarget",
        "parameters": [
          {
            "name": "releaseTargetId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/releases/{releaseId}": {
      "patch": {
        "summary": "Updates a release",
        "operationId": "updateRelease",
        "parameters": [
          {
            "name": "releaseId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The release ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "string"
                  },
                  "deploymentId": {
                    "type": "string"
                  },
                  "createdAt": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "name": {
                    "type": "string"
                  },
                  "config": {
                    "type": "object",
                    "additionalProperties": true
                  },
                  "jobAgentConfig": {
                    "type": "object",
                    "additionalProperties": true
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "ready",
                      "building",
                      "failed",
                      "rejected"
                    ]
                  },
                  "message": {
                    "type": "string"
                  },
                  "metadata": {
                    "type": "object",
                    "additionalProperties": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Release"
                }
              }
            }
          }
        }
      }
    },
    "/v1/releases": {
      "post": {
        "summary": "Upserts a release",
        "operationId": "upsertRelease",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "string"
                  },
                  "deploymentId": {
                    "type": "string"
                  },
                  "createdAt": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "name": {
                    "type": "string"
                  },
                  "config": {
                    "type": "object",
                    "additionalProperties": true
                  },
                  "jobAgentConfig": {
                    "type": "object",
                    "additionalProperties": true
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "ready",
                      "building",
                      "failed",
                      "rejected"
                    ]
                  },
                  "message": {
                    "type": "string"
                  },
                  "metadata": {
                    "type": "object",
                    "additionalProperties": {
                      "type": "string"
                    }
                  }
                },
                "required": [
                  "version",
                  "deploymentId"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Release"
                }
              }
            }
          },
          "409": {
            "description": "Release already exists",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    },
                    "id": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/resource-providers/{providerId}/set": {
      "patch": {
        "summary": "Sets the resource for a provider.",
        "operationId": "setResourceProvidersResources",
        "parameters": [
          {
            "name": "providerId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "UUID of the scanner"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "resources"
                ],
                "properties": {
                  "resources": {
                    "type": "array",
                    "items": {
                      "$ref": "#/components/schemas/CreateResource"
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successfully updated the deployment resources",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "resources": {
                      "type": "object",
                      "properties": {
                        "ignored": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "identifier": {
                                "type": "string"
                              },
                              "name": {
                                "type": "string"
                              },
                              "version": {
                                "type": "string"
                              },
                              "kind": {
                                "type": "string"
                              },
                              "workspaceId": {
                                "type": "string"
                              }
                            }
                          }
                        },
                        "inserted": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "name": {
                                "type": "string"
                              },
                              "version": {
                                "type": "string"
                              },
                              "kind": {
                                "type": "string"
                              },
                              "config": {
                                "type": "object",
                                "additionalProperties": true
                              }
                            }
                          }
                        },
                        "updated": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "name": {
                                "type": "string"
                              },
                              "version": {
                                "type": "string"
                              },
                              "kind": {
                                "type": "string"
                              },
                              "config": {
                                "type": "object",
                                "additionalProperties": true
                              }
                            }
                          }
                        },
                        "deleted": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string"
                              },
                              "name": {
                                "type": "string"
                              },
                              "version": {
                                "type": "string"
                              },
                              "kind": {
                                "type": "string"
                              },
                              "config": {
                                "type": "object",
                                "additionalProperties": true
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid request"
          },
          "404": {
            "description": "Deployment resources not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    },
    "/v1/resource-relationship-rules/{ruleId}": {
      "patch": {
        "summary": "Update a resource relationship rule",
        "operationId": "updateResourceRelationshipRule",
        "parameters": [
          {
            "name": "ruleId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateResourceRelationshipRule"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The updated resource relationship rule",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceRelationshipRule"
                }
              }
            }
          },
          "404": {
            "description": "The resource relationship rule was not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          },
          "500": {
            "description": "An error occurred while updating the resource relationship rule",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          }
        }
      },
      "delete": {
        "summary": "Delete a resource relationship rule",
        "operationId": "deleteResourceRelationshipRule",
        "parameters": [
          {
            "name": "ruleId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The deleted resource relationship rule",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceRelationshipRule"
                }
              }
            }
          },
          "404": {
            "description": "The resource relationship rule was not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          },
          "500": {
            "description": "An error occurred while deleting the resource relationship rule",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/v1/resource-relationship-rules": {
      "post": {
        "summary": "Create a resource relationship rule",
        "operationId": "createResourceRelationshipRule",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateResourceRelationshipRule"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Resource relationship rule created successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceRelationshipRule"
                }
              }
            }
          },
          "409": {
            "description": "Resource relationship rule already exists",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Failed to create resource relationship rule",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/resource-schemas": {
      "post": {
        "summary": "Create a resource schema",
        "operationId": "createResourceSchema",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "workspaceId",
                  "version",
                  "kind",
                  "jsonSchema"
                ],
                "properties": {
                  "workspaceId": {
                    "type": "string",
                    "format": "uuid",
                    "description": "The ID of the workspace"
                  },
                  "version": {
                    "type": "string",
                    "description": "Version of the schema"
                  },
                  "kind": {
                    "type": "string",
                    "description": "Kind of resource this schema is for"
                  },
                  "jsonSchema": {
                    "type": "object",
                    "description": "The JSON schema definition"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Resource schema created successfully",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "workspaceId": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "version": {
                      "type": "string"
                    },
                    "kind": {
                      "type": "string"
                    },
                    "jsonSchema": {
                      "type": "object"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid request body",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Schema already exists for this version and kind",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    },
                    "id": {
                      "type": "string",
                      "format": "uuid"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/resource-schemas/{schemaId}": {
      "delete": {
        "summary": "Delete a resource schema",
        "operationId": "deleteResourceSchema",
        "parameters": [
          {
            "name": "schemaId",
            "in": "path",
            "required": true,
            "description": "UUID of the schema to delete",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Schema deleted successfully",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Schema not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "example": "Schema not found"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/resources/{resourceId}": {
      "get": {
        "summary": "Get a resource",
        "operationId": "getResource",
        "parameters": [
          {
            "name": "resourceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The resource ID"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceWithVariablesAndMetadata"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Permission denied"
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "example": "Resource not found"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          }
        }
      },
      "patch": {
        "summary": "Update a resource",
        "operationId": "updateResource",
        "parameters": [
          {
            "name": "resourceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "version": {
                    "type": "string"
                  },
                  "kind": {
                    "type": "string"
                  },
                  "identifier": {
                    "type": "string"
                  },
                  "workspaceId": {
                    "type": "string"
                  },
                  "metadata": {
                    "$ref": "#/components/schemas/MetadataMap"
                  },
                  "config": {
                    "type": "object",
                    "additionalProperties": true
                  },
                  "variables": {
                    "type": "array",
                    "items": {
                      "$ref": "#/components/schemas/DirectVariable"
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Resource updated successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceWithVariablesAndMetadata"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Permission denied"
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          }
        }
      },
      "delete": {
        "summary": "Delete a resource",
        "operationId": "deleteResource",
        "parameters": [
          {
            "name": "resourceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "The resource ID"
          }
        ],
        "responses": {
          "200": {
            "description": "Resource deleted successfully",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "success"
                  ],
                  "properties": {
                    "success": {
                      "type": "boolean"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Permission denied"
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/v1/resources/{resourceId}/release-targets": {
      "get": {
        "summary": "Get release targets for a resource",
        "operationId": "getReleaseTargets",
        "parameters": [
          {
            "name": "resourceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "description": "The resource ID"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ReleaseTarget"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/resources": {
      "post": {
        "summary": "Create or update a resource",
        "operationId": "upsertResource",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "workspaceId",
                  "name",
                  "kind",
                  "identifier",
                  "version",
                  "config"
                ],
                "properties": {
                  "workspaceId": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "name": {
                    "type": "string"
                  },
                  "kind": {
                    "type": "string"
                  },
                  "identifier": {
                    "type": "string"
                  },
                  "version": {
                    "type": "string"
                  },
                  "config": {
                    "type": "object",
                    "additionalProperties": true
                  },
                  "metadata": {
                    "type": "object",
                    "additionalProperties": {
                      "type": "string"
                    }
                  },
                  "variables": {
                    "type": "array",
                    "items": {
                      "$ref": "#/components/schemas/Variable"
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The created or updated resource",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Resource"
                }
              }
            }
          }
        }
      }
    },
    "/v1/systems/{systemId}/environments/{name}": {
      "delete": {
        "summary": "Delete an environment",
        "operationId": "deleteEnvironmentByName",
        "parameters": [
          {
            "name": "systemId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "UUID of the system"
          },
          {
            "name": "name",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Name of the environment"
          }
        ],
        "responses": {
          "200": {
            "description": "Environment deleted successfully"
          }
        }
      }
    },
    "/v1/systems/{systemId}": {
      "get": {
        "summary": "Get a system",
        "operationId": "getSystem",
        "parameters": [
          {
            "name": "systemId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "description": "UUID of the system"
          }
        ],
        "responses": {
          "200": {
            "description": "System retrieved successfully",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/System"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "environments": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Environment"
                          }
                        },
                        "deployments": {
                          "type": "array",
                          "items": {
                            "$ref": "#/components/schemas/Deployment"
                          }
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        }
      },
      "patch": {
        "summary": "Update a system",
        "operationId": "updateSystem",
        "parameters": [
          {
            "name": "systemId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "description": "UUID of the system"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "Name of the system"
                  },
                  "slug": {
                    "type": "string",
                    "description": "Slug of the system"
                  },
                  "description": {
                    "type": "string",
                    "description": "Description of the system"
                  },
                  "workspaceId": {
                    "type": "string",
                    "format": "uuid",
                    "description": "UUID of the workspace"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "System updated successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/System"
                }
              }
            }
          },
          "404": {
            "description": "System not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "example": "System not found"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "example": "Internal server error"
                    }
                  }
                }
              }
            }
          }
        }
      },
      "delete": {
        "summary": "Delete a system",
        "operationId": "deleteSystem",
        "parameters": [
          {
            "name": "systemId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "System deleted successfully",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "example": "System deleted"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "System not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "example": "System not found"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "example": "Internal server error"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/systems": {
      "post": {
        "summary": "Create a system",
        "operationId": "createSystem",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "workspaceId": {
                    "type": "string",
                    "format": "uuid",
                    "description": "The workspace ID of the system"
                  },
                  "name": {
                    "type": "string",
                    "description": "The name of the system"
                  },
                  "slug": {
                    "type": "string",
                    "description": "The slug of the system"
                  },
                  "description": {
                    "type": "string",
                    "description": "The description of the system"
                  }
                },
                "required": [
                  "workspaceId",
                  "name",
                  "slug"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "System updated successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/System"
                }
              }
            }
          },
          "201": {
            "description": "System created successfully",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/System"
                }
              }
            }
          },
          "400": {
            "description": "Bad request",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "code": {
                            "type": "string",
                            "enum": [
                              "invalid_type",
                              "invalid_literal",
                              "custom"
                            ]
                          },
                          "message": {
                            "type": "string"
                          },
                          "path": {
                            "type": "array",
                            "items": {
                              "oneOf": [
                                {
                                  "type": "string"
                                },
                                {
                                  "type": "number"
                                }
                              ]
                            }
                          }
                        },
                        "required": [
                          "code",
                          "message",
                          "path"
                        ]
                      }
                    }
                  }
                },
                "examples": {
                  "validation-error": {
                    "value": {
                      "error": [
                        {
                          "code": "invalid_type",
                          "message": "Invalid input",
                          "path": [
                            "name"
                          ]
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "example": "Internal Server Error"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/workspaces/{workspaceId}/deployments": {
      "parameters": [
        {
          "name": "workspaceId",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string"
          },
          "description": "The ID of the workspace"
        }
      ],
      "get": {
        "summary": "List all deployments",
        "operationId": "listDeployments",
        "responses": {
          "200": {
            "description": "All deployments",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Deployment"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/workspaces/{workspaceId}/environments": {
      "parameters": [
        {
          "name": "workspaceId",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string"
          },
          "description": "The ID of the workspace"
        }
      ],
      "get": {
        "summary": "List all environments",
        "operationId": "listEnvironments",
        "responses": {
          "200": {
            "description": "All environments",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Environment"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/workspaces/{workspaceId}/events/{action}": {
      "parameters": [
        {
          "name": "workspaceId",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string",
            "format": "uuid"
          },
          "description": "The ID of the workspace"
        },
        {
          "name": "action",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string"
          }
        }
      ],
      "get": {
        "summary": "Get events by action",
        "operationId": "getEventsByAction",
        "responses": {
          "200": {
            "description": "Events",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Event"
                  }
                }
              }
            }
          },
          "404": {
            "description": "Workspace not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "error"
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/v1/workspaces/{workspaceId}": {
      "get": {
        "summary": "Get a workspace",
        "operationId": "getWorkspace",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "description": "The workspace ID",
              "example": "123e4567-e89b-12d3-a456-426614174000"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Workspace found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Workspace"
                }
              }
            }
          },
          "404": {
            "description": "Workspace not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/workspaces/{workspaceId}/policies/{name}": {
      "delete": {
        "summary": "Delete a policy by name",
        "operationId": "deletePolicyByName",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            },
            "description": "ID of the workspace"
          },
          {
            "name": "name",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Name of the policy"
          }
        ],
        "responses": {
          "200": {
            "description": "Successfully deleted the policy",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Permission denied"
          },
          "404": {
            "description": "Policy not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "example": "Policy not found"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    },
    "/v1/workspaces/{workspaceId}/resource-providers/name/{name}": {
      "get": {
        "summary": "Upserts a resource provider.",
        "operationId": "upsertResourceProvider",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Name of the workspace"
          },
          {
            "name": "name",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Name of the resource provider"
          }
        ],
        "responses": {
          "200": {
            "description": "Successfully retrieved or created the resource provider",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "workspaceId": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "name",
                    "workspaceId"
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Permission denied"
          },
          "404": {
            "description": "Workspace not found"
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    },
    "/v1/workspaces/{workspaceId}/resources/identifier/{identifier}": {
      "get": {
        "summary": "Get a resource by identifier",
        "operationId": "getResourceByIdentifier",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "ID of the workspace"
          },
          {
            "name": "identifier",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Identifier of the resource"
          }
        ],
        "responses": {
          "200": {
            "description": "Successfully retrieved the resource",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ResourceWithVariablesAndMetadata"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "relationships": {
                          "type": "object",
                          "additionalProperties": {
                            "type": "object",
                            "properties": {
                              "ruleId": {
                                "type": "string"
                              },
                              "type": {
                                "type": "string"
                              },
                              "reference": {
                                "type": "string"
                              },
                              "source": {
                                "$ref": "#/components/schemas/Resource"
                              }
                            },
                            "required": [
                              "ruleId",
                              "type",
                              "reference",
                              "source"
                            ]
                          }
                        }
                      }
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Permission denied"
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "example": "Resource not found"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error"
          }
        }
      },
      "delete": {
        "summary": "Delete a resource by identifier",
        "operationId": "deleteResourceByIdentifier",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "ID of the workspace"
          },
          {
            "name": "identifier",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Identifier of the resource"
          }
        ],
        "responses": {
          "200": {
            "description": "Successfully deleted the resource",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "example": true
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Permission denied"
          },
          "404": {
            "description": "Resource not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string",
                      "example": "Resource not found"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    },
    "/v1/workspaces/{workspaceId}/resources/metadata-grouped-counts": {
      "post": {
        "summary": "Get grouped counts of resources",
        "operationId": "getGroupedCounts",
        "parameters": [
          {
            "name": "workspaceId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "ID of the workspace"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "metadataKeys",
                  "allowNullCombinations"
                ],
                "properties": {
                  "metadataKeys": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "allowNullCombinations": {
                    "type": "boolean"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "keys",
                    "combinations"
                  ],
                  "properties": {
                    "keys": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "combinations": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "metadata",
                          "resources"
                        ],
                        "properties": {
                          "metadata": {
                            "type": "object",
                            "additionalProperties": {
                              "type": "string"
                            }
                          },
                          "resources": {
                            "type": "number"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/workspaces/{workspaceId}/resources": {
      "parameters": [
        {
          "name": "workspaceId",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string"
          },
          "description": "The ID of the workspace"
        }
      ],
      "get": {
        "summary": "List all resources",
        "operationId": "listResources",
        "responses": {
          "200": {
            "description": "All resources",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "resources": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Resource"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/workspaces/{workspaceId}/systems": {
      "parameters": [
        {
          "name": "workspaceId",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string"
          },
          "description": "The ID of the workspace"
        }
      ],
      "get": {
        "summary": "List all systems",
        "operationId": "listSystems",
        "responses": {
          "200": {
            "description": "All systems",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/System"
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/workspaces/slug/{workspaceSlug}": {
      "get": {
        "summary": "Get a workspace by slug",
        "operationId": "getWorkspaceBySlug",
        "parameters": [
          {
            "name": "workspaceSlug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "example": "my-workspace"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Workspace found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Workspace"
                }
              }
            }
          },
          "404": {
            "description": "Workspace not found",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "CloudRegionGeoData": {
        "type": "object",
        "required": [
          "timezone",
          "latitude",
          "longitude"
        ],
        "properties": {
          "timezone": {
            "type": "string",
            "description": "Timezone of the region in UTC format",
            "example": "UTC+1"
          },
          "latitude": {
            "type": "number",
            "format": "float",
            "description": "Latitude coordinate for the region",
            "example": 50.1109
          },
          "longitude": {
            "type": "number",
            "format": "float",
            "description": "Longitude coordinate for the region",
            "example": 8.6821
          }
        }
      },
      "ApprovalRecord": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "deploymentVersionId": {
            "type": "string",
            "format": "uuid"
          },
          "environmentId": {
            "type": "string",
            "format": "uuid"
          },
          "userId": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "type": "string",
            "enum": [
              "approved",
              "rejected"
            ]
          },
          "approvedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "reason": {
            "type": "string"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "id",
          "deploymentVersionId",
          "environmentId",
          "userId",
          "status",
          "approvedAt",
          "createdAt",
          "updatedAt"
        ]
      },
      "BaseDeploymentVariableValue": {
        "type": "object",
        "properties": {
          "resourceSelector": {
            "type": "object",
            "nullable": true,
            "additionalProperties": true
          },
          "isDefault": {
            "type": "boolean"
          },
          "priority": {
            "type": "integer",
            "minimum": 0,
            "maximum": 1000
          }
        }
      },
      "DirectDeploymentVariableValue": {
        "allOf": [
          {
            "$ref": "#/components/schemas/BaseDeploymentVariableValue"
          },
          {
            "type": "object",
            "properties": {
              "value": {
                "oneOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "number"
                  },
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "object"
                  },
                  {
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "number"
                        },
                        {
                          "type": "boolean"
                        },
                        {
                          "type": "object"
                        }
                      ]
                    }
                  }
                ],
                "nullable": true
              },
              "sensitive": {
                "type": "boolean"
              }
            },
            "required": [
              "value"
            ]
          }
        ]
      },
      "DirectDeploymentVariableValueWithId": {
        "allOf": [
          {
            "$ref": "#/components/schemas/DirectDeploymentVariableValue"
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "format": "uuid"
              }
            },
            "required": [
              "id"
            ]
          }
        ]
      },
      "ReferenceDeploymentVariableValue": {
        "allOf": [
          {
            "$ref": "#/components/schemas/BaseDeploymentVariableValue"
          },
          {
            "type": "object",
            "properties": {
              "path": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "reference": {
                "type": "string"
              },
              "defaultValue": {
                "oneOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "number"
                  },
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "object"
                  },
                  {
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "number"
                        },
                        {
                          "type": "boolean"
                        },
                        {
                          "type": "object"
                        }
                      ]
                    }
                  }
                ],
                "nullable": true
              }
            },
            "required": [
              "path",
              "reference"
            ]
          }
        ]
      },
      "ReferenceDeploymentVariableValueWithId": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ReferenceDeploymentVariableValue"
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "format": "uuid"
              }
            },
            "required": [
              "id"
            ]
          }
        ]
      },
      "DeploymentVariable": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "key": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "directValues": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DirectDeploymentVariableValueWithId"
            }
          },
          "referenceValues": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ReferenceDeploymentVariableValueWithId"
            }
          },
          "defaultValue": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/DirectDeploymentVariableValueWithId"
              },
              {
                "$ref": "#/components/schemas/ReferenceDeploymentVariableValueWithId"
              }
            ]
          },
          "config": {
            "type": "object",
            "additionalProperties": true
          }
        },
        "required": [
          "id",
          "key",
          "description",
          "directValues",
          "referenceValues",
          "config"
        ]
      },
      "ExitHook": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The name of the exit hook",
            "example": "my-exit-hook"
          },
          "jobAgentId": {
            "type": "string",
            "format": "uuid",
            "description": "The ID of the job agent to use for the exit hook",
            "example": "123e4567-e89b-12d3-a456-426614174000"
          },
          "jobAgentConfig": {
            "type": "object",
            "description": "The configuration for the job agent",
            "example": {
              "key": "value"
            },
            "additionalProperties": true
          }
        },
        "required": [
          "name",
          "jobAgentId",
          "jobAgentConfig"
        ]
      },
      "JobWithTrigger": {
        "allOf": [
          {
            "$ref": "#/components/schemas/Job"
          },
          {
            "type": "object",
            "properties": {
              "links": {
                "type": "object",
                "additionalProperties": {
                  "type": "string"
                }
              },
              "metadata": {
                "type": "object",
                "additionalProperties": {
                  "type": "string"
                }
              },
              "release": {
                "$ref": "#/components/schemas/Release"
              },
              "version": {
                "$ref": "#/components/schemas/DeploymentVersion"
              },
              "deployment": {
                "$ref": "#/components/schemas/Deployment"
              },
              "runbook": {
                "$ref": "#/components/schemas/Runbook"
              },
              "resource": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/ResourceWithVariablesAndMetadata"
                  },
                  {
                    "type": "object",
                    "properties": {
                      "relationships": {
                        "type": "object",
                        "additionalProperties": {
                          "$ref": "#/components/schemas/Resource"
                        }
                      }
                    }
                  }
                ]
              },
              "environment": {
                "$ref": "#/components/schemas/Environment"
              },
              "variables": {
                "$ref": "#/components/schemas/VariableMap"
              },
              "approval": {
                "type": "object",
                "nullable": true,
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "pending",
                      "approved",
                      "rejected"
                    ]
                  },
                  "approver": {
                    "type": "object",
                    "nullable": true,
                    "description": "Null when status is pending, contains approver details when approved or rejected",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "name": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "id",
                      "name"
                    ]
                  }
                },
                "required": [
                  "id",
                  "status"
                ]
              }
            },
            "required": [
              "variables"
            ]
          }
        ]
      },
      "Workspace": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "The workspace ID"
          },
          "name": {
            "type": "string",
            "description": "The name of the workspace"
          },
          "slug": {
            "type": "string",
            "description": "The slug of the workspace"
          },
          "googleServiceAccountEmail": {
            "type": "string",
            "description": "The email of the Google service account attached to the workspace",
            "example": "ctrlplane@ctrlplane-workspace.iam.gserviceaccount.com",
            "nullable": true
          },
          "awsRoleArn": {
            "type": "string",
            "description": "The ARN of the AWS role attached to the workspace",
            "example": "arn:aws:iam::123456789012:role/ctrlplane-workspace-role",
            "nullable": true
          }
        },
        "required": [
          "id",
          "name",
          "slug"
        ]
      },
      "System": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "description": "The system ID"
          },
          "workspaceId": {
            "type": "string",
            "format": "uuid",
            "description": "The workspace ID of the system"
          },
          "name": {
            "type": "string",
            "description": "The name of the system"
          },
          "slug": {
            "type": "string",
            "description": "The slug of the system"
          },
          "description": {
            "type": "string",
            "description": "The description of the system"
          }
        },
        "required": [
          "id",
          "workspaceId",
          "name",
          "slug"
        ]
      },
      "Deployment": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "systemId": {
            "type": "string",
            "format": "uuid"
          },
          "jobAgentId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "jobAgentConfig": {
            "type": "object",
            "additionalProperties": true
          },
          "retryCount": {
            "type": "integer"
          },
          "timeout": {
            "type": "integer",
            "nullable": true
          }
        },
        "required": [
          "id",
          "name",
          "slug",
          "description",
          "systemId",
          "jobAgentConfig"
        ]
      },
      "UpdateDeployment": {
        "type": "object",
        "description": "Schema for updating a deployment (all fields optional)",
        "allOf": [
          {
            "$ref": "#/components/schemas/Deployment"
          },
          {
            "type": "object",
            "additionalProperties": true
          }
        ],
        "required": [
          "id"
        ],
        "additionalProperties": true
      },
      "Release": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": "string"
          },
          "version": {
            "type": "string"
          },
          "config": {
            "type": "object",
            "additionalProperties": true
          },
          "jobAgentConfig": {
            "type": "object",
            "additionalProperties": true
          },
          "deploymentId": {
            "type": "string",
            "format": "uuid"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "metadata": {
            "type": "object",
            "additionalProperties": true
          }
        },
        "required": [
          "id",
          "name",
          "version",
          "config",
          "deploymentId",
          "createdAt",
          "jobAgentConfig"
        ]
      },
      "VersionDependency": {
        "type": "object",
        "properties": {
          "deploymentId": {
            "type": "string",
            "format": "uuid"
          },
          "versionSelector": {
            "type": "object",
            "additionalProperties": true
          }
        },
        "required": [
          "deploymentId"
        ]
      },
      "DeploymentVersion": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": "string"
          },
          "tag": {
            "type": "string"
          },
          "config": {
            "type": "object",
            "additionalProperties": true
          },
          "jobAgentConfig": {
            "type": "object",
            "additionalProperties": true
          },
          "deploymentId": {
            "type": "string",
            "format": "uuid"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "metadata": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          },
          "dependencies": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/VersionDependency"
            }
          },
          "status": {
            "type": "string",
            "enum": [
              "building",
              "ready",
              "failed"
            ]
          }
        },
        "required": [
          "id",
          "name",
          "tag",
          "config",
          "deploymentId",
          "createdAt",
          "jobAgentConfig"
        ]
      },
      "Environment": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "systemId": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "policyId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "resourceSelector": {
            "type": "object",
            "nullable": true,
            "additionalProperties": true
          },
          "directory": {
            "type": "string",
            "description": "The directory path of the environment",
            "example": "my/env/path",
            "default": ""
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "metadata": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          },
          "policy": {
            "$ref": "#/components/schemas/Policy",
            "nullable": true
          }
        },
        "required": [
          "id",
          "systemId",
          "name",
          "createdAt",
          "directory"
        ]
      },
      "Runbook": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": "string"
          },
          "systemId": {
            "type": "string",
            "format": "uuid"
          },
          "jobAgentId": {
            "type": "string",
            "format": "uuid"
          }
        },
        "required": [
          "id",
          "name",
          "systemId",
          "jobAgentId"
        ]
      },
      "Resource": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": "string"
          },
          "version": {
            "type": "string"
          },
          "kind": {
            "type": "string"
          },
          "identifier": {
            "type": "string"
          },
          "config": {
            "type": "object",
            "additionalProperties": true
          },
          "metadata": {
            "type": "object",
            "additionalProperties": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          },
          "deletedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "workspaceId": {
            "type": "string",
            "format": "uuid"
          },
          "providerId": {
            "type": "string",
            "format": "uuid"
          }
        },
        "required": [
          "id",
          "name",
          "version",
          "kind",
          "identifier",
          "config",
          "workspaceId",
          "createdAt",
          "updatedAt",
          "deletedAt",
          "metadata"
        ]
      },
      "ResourceWithVariables": {
        "allOf": [
          {
            "$ref": "#/components/schemas/Resource"
          },
          {
            "properties": {
              "variables": {
                "$ref": "#/components/schemas/VariableMap"
              }
            }
          }
        ]
      },
      "ResourceWithMetadata": {
        "allOf": [
          {
            "$ref": "#/components/schemas/Resource"
          },
          {
            "properties": {
              "metadata": {
                "$ref": "#/components/schemas/MetadataMap"
              }
            }
          }
        ]
      },
      "ResourceWithVariablesAndMetadata": {
        "allOf": [
          {
            "$ref": "#/components/schemas/ResourceWithVariables"
          },
          {
            "$ref": "#/components/schemas/ResourceWithMetadata"
          }
        ]
      },
      "CreateResource": {
        "type": "object",
        "properties": {
          "identifier": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "version": {
            "type": "string"
          },
          "kind": {
            "type": "string"
          },
          "config": {
            "type": "object",
            "additionalProperties": true
          },
          "metadata": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          },
          "variables": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Variable"
            }
          }
        },
        "required": [
          "identifier",
          "name",
          "version",
          "kind",
          "config",
          "metadata"
        ]
      },
      "JobStatus": {
        "type": "string",
        "enum": [
          "successful",
          "cancelled",
          "skipped",
          "in_progress",
          "action_required",
          "pending",
          "failure",
          "invalid_job_agent",
          "invalid_integration",
          "external_run_not_found"
        ]
      },
      "Job": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "$ref": "#/components/schemas/JobStatus"
          },
          "externalId": {
            "type": "string",
            "nullable": true,
            "description": "External job identifier (e.g. GitHub workflow run ID)"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          },
          "startedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "completedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "jobAgentId": {
            "type": "string",
            "format": "uuid"
          },
          "jobAgentConfig": {
            "type": "object",
            "description": "Configuration for the Job Agent",
            "additionalProperties": true
          },
          "message": {
            "type": "string"
          },
          "reason": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "status",
          "createdAt",
          "updatedAt",
          "jobAgentConfig"
        ]
      },
      "MetadataMap": {
        "type": "object",
        "additionalProperties": {
          "type": "string"
        }
      },
      "VariableMap": {
        "type": "object",
        "additionalProperties": {
          "nullable": true,
          "oneOf": [
            {
              "type": "string"
            },
            {
              "type": "boolean"
            },
            {
              "type": "number"
            },
            {
              "type": "object"
            },
            {
              "type": "array",
              "items": {
                "oneOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "number"
                  },
                  {
                    "type": "object"
                  }
                ]
              }
            }
          ]
        }
      },
      "ReferenceVariable": {
        "type": "object",
        "required": [
          "key",
          "reference",
          "path"
        ],
        "properties": {
          "key": {
            "type": "string"
          },
          "reference": {
            "type": "string"
          },
          "path": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "defaultValue": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "number"
              },
              {
                "type": "boolean"
              },
              {
                "type": "object"
              },
              {
                "type": "array",
                "items": {
                  "oneOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "number"
                    },
                    {
                      "type": "boolean"
                    },
                    {
                      "type": "object"
                    }
                  ]
                }
              }
            ]
          }
        }
      },
      "DirectVariable": {
        "type": "object",
        "required": [
          "key",
          "value"
        ],
        "properties": {
          "key": {
            "type": "string"
          },
          "value": {
            "oneOf": [
              {
                "type": "string"
              },
              {
                "type": "number"
              },
              {
                "type": "boolean"
              },
              {
                "type": "object"
              },
              {
                "type": "array",
                "items": {
                  "oneOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "number"
                    },
                    {
                      "type": "boolean"
                    },
                    {
                      "type": "object"
                    }
                  ]
                }
              }
            ]
          },
          "sensitive": {
            "type": "boolean"
          }
        }
      },
      "Variable": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/DirectVariable"
          },
          {
            "$ref": "#/components/schemas/ReferenceVariable"
          }
        ]
      },
      "PolicyTarget": {
        "type": "object",
        "properties": {
          "deploymentSelector": {
            "type": "object",
            "additionalProperties": true,
            "nullable": true
          },
          "environmentSelector": {
            "type": "object",
            "additionalProperties": true,
            "nullable": true
          },
          "resourceSelector": {
            "type": "object",
            "additionalProperties": true,
            "nullable": true
          }
        }
      },
      "DenyWindow": {
        "type": "object",
        "properties": {
          "timeZone": {
            "type": "string"
          },
          "rrule": {
            "type": "object",
            "additionalProperties": true
          },
          "dtend": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "timeZone",
          "rrule"
        ]
      },
      "DeploymentVersionSelector": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "deploymentVersionSelector": {
            "type": "object",
            "additionalProperties": true
          },
          "description": {
            "type": "string"
          }
        },
        "required": [
          "name",
          "deploymentVersionSelector"
        ]
      },
      "VersionAnyApproval": {
        "type": "object",
        "properties": {
          "requiredApprovalsCount": {
            "type": "number"
          }
        },
        "required": [
          "requiredApprovalsCount"
        ]
      },
      "VersionUserApproval": {
        "type": "object",
        "properties": {
          "userId": {
            "type": "string"
          }
        },
        "required": [
          "userId"
        ]
      },
      "VersionRoleApproval": {
        "type": "object",
        "properties": {
          "roleId": {
            "type": "string"
          },
          "requiredApprovalsCount": {
            "type": "number"
          }
        },
        "required": [
          "roleId",
          "requiredApprovalsCount"
        ]
      },
      "PolicyConcurrency": {
        "type": "integer",
        "nullable": true,
        "minimum": 1,
        "format": "int32"
      },
      "MaxRetries": {
        "type": "integer",
        "nullable": true,
        "minimum": 1,
        "format": "int32"
      },
      "EnvironmentVersionRollout": {
        "type": "object",
        "properties": {
          "positionGrowthFactor": {
            "type": "number",
            "description": "Controls how strongly queue position influences delay — higher values result in a smoother, slower rollout curve."
          },
          "timeScaleInterval": {
            "type": "number",
            "description": "Defines the base time interval that each unit of rollout progression is scaled by — larger values stretch the deployment timeline."
          },
          "rolloutType": {
            "type": "string",
            "enum": [
              "linear",
              "linear-normalized",
              "exponential",
              "exponential-normalized"
            ],
            "description": "Determines the shape of the rollout curve — linear, exponential, or normalized versions of each. A normalized rollout curve limits the maximum delay to the time scale interval, and scales the rollout progression to fit within that interval."
          }
        },
        "required": [
          "positionGrowthFactor",
          "timeScaleInterval",
          "rolloutType"
        ]
      },
      "InsertEnvironmentVersionRollout": {
        "type": "object",
        "properties": {
          "positionGrowthFactor": {
            "type": "number",
            "description": "Controls how strongly queue position influences delay — higher values result in a smoother, slower rollout curve. Defaults to 1 if not specified."
          },
          "timeScaleInterval": {
            "type": "number",
            "description": "Defines the base time interval that each unit of rollout progression is scaled by — larger values stretch the deployment timeline."
          },
          "rolloutType": {
            "type": "string",
            "enum": [
              "linear",
              "linear-normalized",
              "exponential",
              "exponential-normalized"
            ],
            "description": "Determines the shape of the rollout curve — linear, exponential, or normalized versions of each. A normalized rollout curve limits the maximum delay to the time scale interval, and scales the rollout progression to fit within that interval. Defaults to a linear rollout if not specified."
          }
        },
        "required": [
          "timeScaleInterval"
        ]
      },
      "Policy": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "priority": {
            "type": "number"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "enabled": {
            "type": "boolean"
          },
          "workspaceId": {
            "type": "string",
            "format": "uuid"
          },
          "targets": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PolicyTarget"
            }
          },
          "denyWindows": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DenyWindow"
            }
          },
          "deploymentVersionSelector": {
            "$ref": "#/components/schemas/DeploymentVersionSelector"
          },
          "versionAnyApprovals": {
            "$ref": "#/components/schemas/VersionAnyApproval"
          },
          "versionUserApprovals": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/VersionUserApproval"
            }
          },
          "versionRoleApprovals": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/VersionRoleApproval"
            }
          },
          "concurrency": {
            "$ref": "#/components/schemas/PolicyConcurrency"
          },
          "environmentVersionRollout": {
            "$ref": "#/components/schemas/EnvironmentVersionRollout"
          },
          "maxRetries": {
            "$ref": "#/components/schemas/MaxRetries"
          }
        },
        "required": [
          "id",
          "name",
          "priority",
          "createdAt",
          "enabled",
          "workspaceId",
          "targets",
          "denyWindows",
          "versionUserApprovals",
          "versionRoleApprovals"
        ]
      },
      "ReleaseTargetLockRecord": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "releaseTargetId": {
            "type": "string",
            "format": "uuid"
          },
          "lockedAt": {
            "type": "string",
            "format": "date-time"
          },
          "unlockedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "lockedBy": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "format": "uuid"
              },
              "name": {
                "type": "string"
              },
              "email": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "email"
            ]
          }
        },
        "required": [
          "id",
          "releaseTargetId",
          "lockedAt",
          "unlockedAt",
          "lockedBy"
        ]
      },
      "UpdateResourceRelationshipRule": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "reference": {
            "type": "string"
          },
          "dependencyType": {
            "$ref": "#/components/schemas/ResourceRelationshipRuleDependencyType"
          },
          "dependencyDescription": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "sourceKind": {
            "type": "string"
          },
          "sourceVersion": {
            "type": "string"
          },
          "targetKind": {
            "type": "string"
          },
          "targetVersion": {
            "type": "string"
          },
          "metadataKeysMatches": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MetadataKeyMatchConstraint"
            }
          },
          "targetMetadataEquals": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MetadataEqualsConstraint"
            }
          },
          "sourceMetadataEquals": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MetadataEqualsConstraint"
            }
          }
        }
      },
      "ResourceRelationshipRuleDependencyType": {
        "type": "string"
      },
      "MetadataEqualsConstraint": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        }
      },
      "MetadataKeyMatchConstraint": {
        "type": "object",
        "properties": {
          "sourceKey": {
            "type": "string"
          },
          "targetKey": {
            "type": "string"
          }
        },
        "required": [
          "sourceKey",
          "targetKey"
        ]
      },
      "ResourceRelationshipRule": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "workspaceId": {
            "type": "string",
            "format": "uuid"
          },
          "name": {
            "type": "string"
          },
          "reference": {
            "type": "string"
          },
          "dependencyType": {
            "$ref": "#/components/schemas/ResourceRelationshipRuleDependencyType"
          },
          "dependencyDescription": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "sourceKind": {
            "type": "string"
          },
          "sourceVersion": {
            "type": "string"
          },
          "sourceMetadataEquals": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MetadataEqualsConstraint"
            }
          },
          "targetKind": {
            "type": "string"
          },
          "targetVersion": {
            "type": "string"
          },
          "targetMetadataEquals": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MetadataEqualsConstraint"
            }
          },
          "metadataKeysMatches": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MetadataKeyMatchConstraint"
            }
          }
        },
        "required": [
          "id",
          "workspaceId",
          "name",
          "reference",
          "dependencyType",
          "sourceKind",
          "sourceVersion"
        ]
      },
      "CreateResourceRelationshipRule": {
        "type": "object",
        "properties": {
          "workspaceId": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "reference": {
            "type": "string"
          },
          "dependencyType": {
            "$ref": "#/components/schemas/ResourceRelationshipRuleDependencyType"
          },
          "dependencyDescription": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "sourceKind": {
            "type": "string"
          },
          "sourceVersion": {
            "type": "string"
          },
          "targetKind": {
            "type": "string"
          },
          "targetVersion": {
            "type": "string"
          },
          "metadataKeysMatches": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MetadataKeyMatchConstraint"
            }
          },
          "targetMetadataEquals": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MetadataEqualsConstraint"
            }
          },
          "sourceMetadataEquals": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MetadataEqualsConstraint"
            }
          }
        },
        "required": [
          "workspaceId",
          "name",
          "reference",
          "dependencyType",
          "sourceKind",
          "sourceVersion"
        ]
      },
      "ReleaseTarget": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "resource": {
            "$ref": "#/components/schemas/Resource"
          },
          "environment": {
            "$ref": "#/components/schemas/Environment"
          },
          "deployment": {
            "$ref": "#/components/schemas/Deployment"
          }
        },
        "required": [
          "id",
          "resource",
          "environment",
          "deployment"
        ]
      },
      "Event": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "action": {
            "type": "string"
          },
          "payload": {
            "type": "object",
            "additionalProperties": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          }
        },
        "required": [
          "id",
          "action",
          "payload",
          "createdAt"
        ]
      }
    },
    "securitySchemes": {
      "apiKey": {
        "type": "apiKey",
        "in": "header",
        "name": "x-api-key"
      }
    }
  }
}