{
  "openapi": "3.0.3",
  "info": {
    "title": "Fly.io Deployments API",
    "version": "1.0.0",
    "description": "GitHub launcher deployments of a Fly.io app: read what happened, diagnose failures, redeploy, and launch an app from a repository."
  },
  "servers": [
    {
      "url": "https://api.fly.io/api/v1"
    }
  ],
  "security": [
    {
      "FlyToken": []
    }
  ],
  "paths": {
    "/apps/{app_name}/deployments": {
      "get": {
        "operationId": "listDeployments",
        "summary": "List deployments, newest first",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppName"
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 20
            }
          },
          {
            "name": "before",
            "in": "query",
            "description": "A deployment id; returns older ones.",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Deployments",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/DeploymentSummary"
                      }
                    },
                    "page": {
                      "type": "object",
                      "properties": {
                        "next_before": {
                          "type": "integer",
                          "nullable": true
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad parameter",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Unknown app or deployment, a token without access, or no token.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      },
      "post": {
        "operationId": "createDeployment",
        "summary": "Deploy the repository (like \"Deploy now\")",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppName"
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "ref": {
                    "type": "string",
                    "description": "Branch or full commit SHA. Defaults to the settings' branch or the repository's default branch."
                  },
                  "replace": {
                    "type": "boolean",
                    "description": "Start even though a deployment is running; the running one is stopped."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "The new deployment",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Deployment"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "No member of the app's organization to deploy as, or none with a linked GitHub account is a collaborator on the repository",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "A deployment is running, or the app hasn't finished its first launch",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "No linked repository, or unknown ref",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Too many API deployments for this app",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "GitHub or the deployer is unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Unknown app or deployment, a token without access, or no token.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/apps/{app_name}/deployments/{id}": {
      "get": {
        "operationId": "getDeployment",
        "summary": "Show a deployment",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppName"
          },
          {
            "$ref": "#/components/parameters/DeploymentId"
          },
          {
            "name": "wait",
            "in": "query",
            "description": "For a running deployment, wait up to this many seconds for a change.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 30
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The deployment",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Deployment"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad parameter",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Unknown app or deployment, a token without access, or no token.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/apps/{app_name}/deployments/{id}/logs": {
      "get": {
        "operationId": "getDeploymentLogs",
        "summary": "Customer-facing log lines",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppName"
          },
          {
            "$ref": "#/components/parameters/DeploymentId"
          },
          {
            "name": "step",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Keep the last N lines.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 5000
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Log lines",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "deployment_id": {
                          "type": "integer"
                        },
                        "status": {
                          "$ref": "#/components/schemas/Status"
                        },
                        "truncated": {
                          "type": "boolean"
                        },
                        "lines": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "step": {
                                "type": "string"
                              },
                              "type": {
                                "type": "string"
                              },
                              "message": {
                                "type": "string"
                              }
                            }
                          }
                        },
                        "available": {
                          "type": "boolean",
                          "description": "False when the log can't be read; lines is then empty."
                        },
                        "unavailable_reason": {
                          "type": "string",
                          "nullable": true,
                          "enum": [
                            "expired",
                            "temporarily_unavailable",
                            null
                          ],
                          "description": "expired: the deployment predates the current log store and its logs are past retention. temporarily_unavailable: the log store didn't answer; try again later."
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad parameter",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Unknown app or deployment, a token without access, or no token.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "description": "A log that can't be read isn't an error: the answer is 200 with available: false."
      }
    },
    "/apps/{app_name}/deployments/{id}/diagnosis": {
      "get": {
        "operationId": "getDeploymentDiagnosis",
        "summary": "Markdown brief for an agent fixing the repository",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppName"
          },
          {
            "$ref": "#/components/parameters/DeploymentId"
          },
          {
            "name": "lines",
            "in": "query",
            "description": "Log lines to include.",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "maximum": 500,
              "default": 80
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The brief",
            "content": {
              "text/markdown": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "Bad parameter",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Unknown app or deployment, a token without access, or no token.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/apps/{app_name}/deployments/{id}/retry": {
      "post": {
        "operationId": "retryDeployment",
        "summary": "Deploy the same commit again",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppName"
          },
          {
            "$ref": "#/components/parameters/DeploymentId"
          }
        ],
        "responses": {
          "201": {
            "description": "The new deployment",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Deployment"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Still running",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Too many API deployments for this app",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Unknown app or deployment, a token without access, or no token.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "No member of the app's organization to deploy as, or none with a linked GitHub account is a collaborator on the repository",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "No linked repository, or the commit can't be deployed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "GitHub or the deployer is unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/apps/{app_name}/deployments/{id}/cancel": {
      "post": {
        "operationId": "cancelDeployment",
        "summary": "Stop a running deployment",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppName"
          },
          {
            "$ref": "#/components/parameters/DeploymentId"
          }
        ],
        "responses": {
          "200": {
            "description": "The stopped deployment",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Deployment"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Already finished",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Unknown app or deployment, a token without access, or no token.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/apps/{app_name}/deployments/{id}/plan": {
      "get": {
        "operationId": "getLaunchPlan",
        "summary": "The plan a launch detected",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppName"
          },
          {
            "$ref": "#/components/parameters/DeploymentId"
          }
        ],
        "responses": {
          "200": {
            "description": "The plan",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Plan"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Not a launch",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Unknown app or deployment, a token without access, or no token.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/apps/{app_name}/deployments/{id}/confirm": {
      "post": {
        "operationId": "confirmLaunchPlan",
        "summary": "Confirm a launch plan",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppName"
          },
          {
            "$ref": "#/components/parameters/DeploymentId"
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "settings": {
                    "type": "object",
                    "description": "Overrides.",
                    "properties": {
                      "region": {
                        "type": "string"
                      },
                      "http_service_port": {
                        "type": "integer"
                      },
                      "vm_size": {
                        "type": "string"
                      },
                      "vm_memory": {
                        "type": "integer"
                      },
                      "vm_cpus": {
                        "type": "integer"
                      },
                      "vm_cpukind": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": false
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The deployment",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Deployment"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Unknown setting",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "The plan isn't awaiting confirmation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "Not a launch, or invalid settings",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Unknown app or deployment, a token without access, or no token.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/apps/{app_name}/deployments/source": {
      "get": {
        "operationId": "getRepositorySettings",
        "summary": "The app's repository settings",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppName"
          }
        ],
        "responses": {
          "200": {
            "description": "Settings",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Source"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Unknown app or deployment, a token without access, or no token.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateRepositorySettings",
        "summary": "Update the app's repository settings",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppName"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "branch": {
                    "type": "string"
                  },
                  "auto_deploy": {
                    "type": "boolean"
                  },
                  "config_path": {
                    "type": "string"
                  },
                  "working_directory": {
                    "type": "string"
                  }
                },
                "additionalProperties": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Settings",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Source"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Unknown field",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "Invalid setting",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Unknown app or deployment, a token without access, or no token.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/apps/{app_name}/deployments/launch": {
      "post": {
        "operationId": "launchFromRepository",
        "summary": "Link a GitHub repository to an existing app and deploy it",
        "parameters": [
          {
            "$ref": "#/components/parameters/AppName"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "repository"
                ],
                "properties": {
                  "repository": {
                    "type": "string",
                    "example": "acme/shop"
                  },
                  "branch": {
                    "type": "string"
                  },
                  "config_path": {
                    "type": "string"
                  },
                  "working_directory": {
                    "type": "string"
                  },
                  "review_plan": {
                    "type": "boolean",
                    "description": "Wait for confirmLaunchPlan instead of using the detected plan."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "The launch deployment",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Deployment"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad body",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "Needs a token for an organization member",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "Already launched, a deployment is running, or a step only a person can take (action_required).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ActionRequiredError"
                }
              }
            }
          },
          "422": {
            "description": "The repository's fly.toml is for another app",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "503": {
            "description": "GitHub or the deployer is unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "Unknown app or deployment, a token without access, or no token.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "FlyToken": {
        "type": "http",
        "scheme": "bearer",
        "description": "A Fly.io token: `fly auth token`, an org token, or `fly tokens create deploy|readonly`. Reads need app read access, writes app deploy access."
      }
    },
    "parameters": {
      "AppName": {
        "name": "app_name",
        "in": "path",
        "required": true,
        "schema": {
          "type": "string"
        }
      },
      "DeploymentId": {
        "name": "id",
        "in": "path",
        "required": true,
        "description": "A deployment id, or `latest`.",
        "schema": {
          "type": "string"
        }
      }
    },
    "schemas": {
      "Status": {
        "type": "string",
        "enum": [
          "running",
          "complete",
          "failed",
          "stopped"
        ]
      },
      "Error": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "string"
          }
        }
      },
      "ActionRequiredError": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "action_required": {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "enum": [
                  "github_app_install",
                  "github_repo_access",
                  "github_collaborator",
                  "launch_prerequisites"
                ]
              },
              "url": {
                "type": "string"
              },
              "failing_checks": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          }
        }
      },
      "DeploymentSummary": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer"
          },
          "app": {
            "type": "string"
          },
          "status": {
            "$ref": "#/components/schemas/Status"
          },
          "current_step": {
            "type": "string",
            "nullable": true
          },
          "trigger": {
            "type": "string",
            "nullable": true
          },
          "git": {
            "type": "object",
            "properties": {
              "repository": {
                "type": "string",
                "nullable": true
              },
              "ref": {
                "type": "string",
                "nullable": true
              },
              "commit": {
                "type": "string",
                "nullable": true
              },
              "commit_message": {
                "type": "string",
                "nullable": true
              },
              "commit_author": {
                "type": "string",
                "nullable": true
              }
            }
          },
          "release": {
            "type": "object",
            "nullable": true,
            "properties": {
              "version": {
                "type": "integer"
              },
              "image": {
                "type": "string",
                "nullable": true
              }
            }
          },
          "plan_status": {
            "type": "string",
            "nullable": true,
            "enum": [
              "detecting",
              "awaiting_confirmation",
              "confirmed",
              "unavailable",
              null
            ]
          },
          "failure": {
            "type": "object",
            "nullable": true,
            "properties": {
              "step": {
                "type": "string",
                "nullable": true
              },
              "category": {
                "type": "string",
                "enum": [
                  "npm_build_error",
                  "dockerfile_build_error",
                  "plan_step_error",
                  "install_dependencies_error",
                  "git_pull_error",
                  "deployer_setup_error",
                  "unknown"
                ]
              },
              "title": {
                "type": "string"
              }
            }
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "dashboard_url": {
            "type": "string"
          }
        }
      },
      "Deployment": {
        "allOf": [
          {
            "$ref": "#/components/schemas/DeploymentSummary"
          },
          {
            "type": "object",
            "properties": {
              "source": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/Source"
                  }
                ],
                "nullable": true
              },
              "steps": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string"
                    },
                    "description": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "pending",
                        "running",
                        "complete",
                        "failed",
                        "stopped"
                      ]
                    },
                    "duration_seconds": {
                      "type": "number",
                      "nullable": true
                    }
                  }
                }
              },
              "errors": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "step": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    },
                    "stderr": {
                      "type": "string",
                      "nullable": true
                    }
                  }
                }
              },
              "generated_files": {
                "type": "array",
                "description": "Files the deployer generated or changed before building (Dockerfile, fly.toml...), with the content the build used. Files taken unchanged from the repository are left out.",
                "items": {
                  "type": "object",
                  "properties": {
                    "path": {
                      "type": "string"
                    },
                    "content": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        ]
      },
      "Source": {
        "type": "object",
        "properties": {
          "repository": {
            "type": "string"
          },
          "branch": {
            "type": "string",
            "nullable": true
          },
          "auto_deploy": {
            "type": "boolean"
          },
          "config_path": {
            "type": "string",
            "nullable": true
          },
          "working_directory": {
            "type": "string",
            "nullable": true
          }
        }
      },
      "Plan": {
        "type": "object",
        "properties": {
          "deployment_id": {
            "type": "integer"
          },
          "status": {
            "type": "string",
            "enum": [
              "detecting",
              "awaiting_confirmation",
              "confirmed",
              "unavailable"
            ],
            "description": "detecting: the deployer is inspecting the repository. awaiting_confirmation: confirm it with confirmLaunchPlan. confirmed: the plan was used, including dashboard launches started with a plan already chosen. unavailable: the deployment finished without a plan."
          },
          "settings": {
            "type": "object",
            "nullable": true,
            "additionalProperties": true
          },
          "files": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "path": {
                  "type": "string"
                },
                "content": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    }
  }
}
