render-openapi.json

{
  "openapi": "3.0.2",
  "info": {
    "title": "Render Public API",
    "description": "Manage everything about your Render services",
    "version": "1.0.0",
    "contact": {
      "name": "Render API",
      "url": "https://community.render.com",
      "email": "support@render.com"
    }
  },
  "x-readme": {
    "metrics-enabled": false,
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "servers": [
    {
      "url": "https://api.render.com/v1"
    }
  ],
  "security": [
    {
      "BearerAuth": []
    }
  ],
  "tags": [
    {
      "name": "Blueprints",
      "description": "[Blueprints](https://docs.render.com/infrastructure-as-code) allow you to define your resources in a `render.yaml` file and automatically sync changes to your Render services.\nThe API gives control over how your blueprints are used to create and manage resources.\n"
    },
    {
      "name": "Custom Domains",
      "description": "[Custom Domains](https://docs.render.com/custom-domains) allow you to associate domain names with your Render services.\n"
    },
    {
      "name": "Deploys",
      "description": "[Deploys](https://docs.render.com/deploys) are the process of updating your service with new code or configuration.\nThese endpoints allow you to retrieve data on the deploys of your services\nas well as trigger new deploys and rollbacks. Most changes to your service\nwill require a new deploy to take effect.\n\nTo create and manage services, use the `Services` endpoints.\n"
    },
    {
      "name": "Disks",
      "description": "[Disks](https://docs.render.com/disks) allow you to attach persistent storage to your services.\n"
    },
    {
      "name": "Environment Groups",
      "description": "Collections of environment variables and secret files that can be shared between multiple services"
    },
    {
      "name": "Logs",
      "description": "[Logs](https://docs.render.com/logging) allow you to retrieve logs for your services, PostgreSQL databases, and redis instances.\nYou can query for logs or subscribe to logs in real-time via a websocket.\n"
    },
    {
      "name": "Maintenance",
      "description": "The `Maintenance` endpoints allow you to retrieve the latest maintenance runs for your Render services. You can also reschedule maintenance or trigger it to start immediately."
    },
    {
      "name": "Metrics",
      "description": "The `Metrics` endpoints allow you to retrieve metrics for your services, PostgreSQL databases, and redis instances."
    },
    {
      "name": "Notification Settings",
      "description": "[Notification Settings](https://docs.render.com/notifications) allow you to configure which notifications you want to recieve, and\nwhere you will receive them.\n"
    },
    {
      "name": "One-Off Jobs",
      "description": "[One-off jobs](https://docs.render.com/jobs) are standalone tasks that run to completion using the most recent successful build of an existing service.\n"
    },
    {
      "name": "Owners",
      "description": "The `Owners` endpoints supply more information about the users and teams that your API key has access to."
    },
    {
      "name": "PostgreSQL",
      "description": "[PostgreSQL](https://docs.render.com/databases) endpoints enable you to interact with your Render PostgreSQL databases.\nYou can manage databases, backups, recoveries, and failovers.\n"
    },
    {
      "name": "Projects & Environments",
      "description": "Collections of services and other resources organized by environment (staging, production, etc.)"
    },
    {
      "name": "Redis",
      "description": "[Redis](https://docs.render.com/redis) allows you to interact with your Render Redis instances.\n"
    },
    {
      "name": "Registry Credentials",
      "description": "[Registry Credentials](https://docs.render.com/deploy-an-image#credentials-for-private-images) allows you to manage credentials for private Docker images.\n"
    },
    {
      "name": "Services",
      "description": "[Services](https://docs.render.com/services) allow you to manage your web services, private services, background workers, cron jobs, and static sites.\n"
    },
    {
      "name": "Services - Cron Jobs",
      "description": "[Cron Jobs](https://docs.render.com/cronjobs) allow you to interact with runs of your cron jobs.\n"
    },
    {
      "name": "Services - Headers",
      "description": "Use HTTP headers to inject response headers in static site responses. You can also use wildcards like /path/* to add headers to responses for all matching request paths."
    },
    {
      "name": "Services - Routes",
      "description": "Add Redirect or Rewrite Rules to modify requests to your site without writing code. You can use URL parameters to capture path segments, and wildcards to redirect everything under a given path."
    }
  ],
  "paths": {
    "/blueprints": {
      "get": {
        "summary": "List blueprints",
        "description": "List blueprints for the provided owners. If no owners are provided, returns all blueprints you have permissions to view.\n",
        "operationId": "list-blueprints",
        "parameters": [
          {
            "$ref": "#/components/parameters/ownerIdParam"
          },
          {
            "$ref": "#/components/parameters/cursorParam"
          },
          {
            "$ref": "#/components/parameters/limitParam"
          }
        ],
        "tags": ["Blueprints"],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/blueprintWithCursor"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/blueprints/{blueprintId}": {
      "parameters": [
        {
          "name": "blueprintId",
          "in": "path",
          "required": true,
          "description": "The ID of the blueprint",
          "schema": {
            "type": "string",
            "pattern": "^exs-[0-9a-z]{20}$",
            "example": "exs-cph1rs3idesc73a2b2mg"
          }
        }
      ],
      "get": {
        "summary": "Retrieve blueprint",
        "description": "Retrieve the blueprint with the provided ID.\n",
        "operationId": "retrieve-blueprint",
        "tags": ["Blueprints"],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "id",
                    "name",
                    "status",
                    "autoSync",
                    "repo",
                    "branch",
                    "resources"
                  ],
                  "properties": {
                    "id": {
                      "$ref": "#/paths/~1blueprints~1%7BblueprintId%7D/parameters/0/schema"
                    },
                    "name": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "created",
                        "paused",
                        "in_sync",
                        "syncing",
                        "error"
                      ]
                    },
                    "autoSync": {
                      "$ref": "#/paths/~1blueprints~1%7BblueprintId%7D/patch/requestBody/content/application~1json/schema/properties/autoSync"
                    },
                    "repo": {
                      "type": "string"
                    },
                    "branch": {
                      "type": "string"
                    },
                    "lastSync": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "resources": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": ["id", "name", "type"],
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "name": {
                            "type": "string"
                          },
                          "type": {
                            "type": "string",
                            "description": "type of the resource (ex. web_service or postgres)",
                            "enum": [
                              "static_site",
                              "web_service",
                              "private_service",
                              "background_worker",
                              "cron_job",
                              "redis",
                              "postgres",
                              "environment_group"
                            ]
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "patch": {
        "summary": "Update blueprint",
        "description": "Update the blueprint with the provided ID.\n",
        "operationId": "update-blueprint",
        "tags": ["Blueprints"],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "autoSync": {
                    "type": "boolean",
                    "description": "Automatically sync changes to render.yaml"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Updated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/blueprintWithCursor/properties/blueprint"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "delete": {
        "summary": "Disconnect blueprint",
        "operationId": "disconnect-blueprint",
        "description": "Disconnect the blueprint with the provided ID.\n\nDisconnecting a blueprint stops automatic resource syncing via the associated `render.yaml` file. It does not _delete_ any services or other resources that were managed by the blueprint.\n",
        "tags": ["Blueprints"],
        "responses": {
          "204": {
            "description": "Blueprint disconnected"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/blueprints/{blueprintId}/syncs": {
      "parameters": [
        {
          "$ref": "#/paths/~1blueprints~1%7BblueprintId%7D/parameters/0"
        },
        {
          "$ref": "#/components/parameters/cursorParam"
        },
        {
          "$ref": "#/components/parameters/limitParam"
        }
      ],
      "get": {
        "description": "List syncs for the blueprint with the provided ID.\n",
        "summary": "List blueprint syncs",
        "operationId": "list-blueprint-syncs",
        "tags": ["Blueprints"],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/syncWithCursor"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/disks": {
      "get": {
        "summary": "List disks",
        "description": "List persistent disks matching the provided filters. If no filters are provided, returns all disks you have permissions to view.\n",
        "parameters": [
          {
            "$ref": "#/components/parameters/ownerIdParam"
          },
          {
            "name": "diskId",
            "in": "query",
            "description": "Filter by disk IDs",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/paths/~1disks~1%7BdiskId%7D/parameters/0/schema"
              }
            }
          },
          {
            "$ref": "#/components/parameters/nameParam"
          },
          {
            "$ref": "#/components/parameters/createdBeforeParam"
          },
          {
            "$ref": "#/components/parameters/createdAfterParam"
          },
          {
            "$ref": "#/components/parameters/updatedBeforeParam"
          },
          {
            "$ref": "#/components/parameters/updatedAfterParam"
          },
          {
            "$ref": "#/components/parameters/serviceIdsParam"
          },
          {
            "$ref": "#/components/parameters/cursorParam"
          },
          {
            "$ref": "#/components/parameters/limitParam"
          }
        ],
        "operationId": "list-disks",
        "tags": ["Disks"],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/diskWithCursor"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "post": {
        "summary": "Add disk",
        "description": "Attach a persistent disk to a web service, private service, or background worker.\n\nThe service must be redeployed for the disk to be attached.\n",
        "operationId": "add-disk",
        "tags": ["Disks"],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["name", "sizeGB", "mountPath", "serviceId"],
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "sizeGB": {
                    "type": "integer"
                  },
                  "mountPath": {
                    "type": "string"
                  },
                  "serviceId": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/diskWithCursor/properties/disk"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/disks/{diskId}": {
      "parameters": [
        {
          "name": "diskId",
          "in": "path",
          "required": true,
          "description": "The ID of the disk",
          "schema": {
            "type": "string",
            "pattern": "^dsk-[0-9a-z]{20}$",
            "example": "dsk-cph1rs3idesc73a2b2mg"
          }
        }
      ],
      "get": {
        "summary": "Retrieve disk",
        "description": "Retrieve the persistent disk with the provided ID.\n",
        "operationId": "retrieve-disk",
        "tags": ["Disks"],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/diskWithCursor/properties/disk"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "patch": {
        "summary": "Update disk",
        "description": "Update the persistent disk with the provided ID.\n\nThe disk's associated service must be deployed and active for updates to take effect.\n\nWhen resizing a disk, the new size must be greater than the current size.\n",
        "operationId": "update-disk",
        "tags": ["Disks"],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "sizeGB": {
                    "type": "integer"
                  },
                  "mountPath": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Updated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/diskWithCursor/properties/disk"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "delete": {
        "summary": "Delete disk",
        "description": "Delete a persistent disk attached to a service.\n\n**All data on the disk will be lost.** The disk's associated service will immediately lose access to it.\n",
        "operationId": "delete-disk",
        "tags": ["Disks"],
        "responses": {
          "204": {
            "description": "Disk deleted"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/disks/{diskId}/snapshots": {
      "parameters": [
        {
          "name": "diskId",
          "in": "path",
          "required": true,
          "description": "The ID of the disk",
          "schema": {
            "type": "string"
          }
        }
      ],
      "get": {
        "summary": "List snapshots",
        "description": "List snapshots for the persistent disk with the provided ID. Each snapshot is a point-in-time copy of the disk's data.\n",
        "operationId": "list-snapshots",
        "tags": ["Disks"],
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/diskSnapshot"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/disks/{diskId}/snapshots/restore": {
      "parameters": [
        {
          "name": "diskId",
          "in": "path",
          "required": true,
          "description": "The ID of the disk",
          "schema": {
            "type": "string"
          }
        }
      ],
      "post": {
        "summary": "Restore snapshot",
        "description": "Restore a persistent disk to an available snapshot.\n\n**This operation is irreversible.** It will overwrite the current disk data. It might also trigger a service deploy.\n\nSnapshot keys returned from the [List snapshots](https://api-docs.render.com/reference/list-snapshots) endpoint expire after 24 hours. If a snapshot key has expired, query the endpoint again for a new key.\n",
        "operationId": "restore-snapshot",
        "tags": ["Disks"],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/snapshotRestorePOST"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Restored",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/diskWithCursor/properties/disk"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/owners": {
      "get": {
        "summary": "List authorized users and teams",
        "description": "List the users and teams matching the provided filters. If no filters are provided, return all users and teams you have permissions to view.\n",
        "operationId": "list-owners",
        "tags": ["Owners"],
        "parameters": [
          {
            "name": "name",
            "in": "query",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "email",
            "in": "query",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "$ref": "#/components/parameters/cursorParam"
          },
          {
            "$ref": "#/components/parameters/limitParam"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "properties": {
                      "owner": {
                        "$ref": "#/components/schemas/owner"
                      },
                      "cursor": {
                        "$ref": "#/components/schemas/cursor"
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/owners/{ownerId}": {
      "parameters": [
        {
          "name": "ownerId",
          "in": "path",
          "required": true,
          "description": "The ID of the user or team",
          "schema": {
            "type": "string"
          }
        }
      ],
      "get": {
        "summary": "Retrieve user or team",
        "description": "Retrieve a user or team given the user or team id.\n",
        "operationId": "retrieve-owner",
        "tags": ["Owners"],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/owner"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/notification-settings/owners/{ownerId}": {
      "parameters": [
        {
          "$ref": "#/components/parameters/ownerIdPathParam"
        }
      ],
      "get": {
        "summary": "Retrieve notification settings",
        "description": "Retrieve notification settings for the owner with the provided ID.\n\nNote that you provide an owner ID to this endpoint, not the ID for a particular resource.\n",
        "operationId": "retrieve-owner-notification-settings",
        "tags": ["Notification Settings"],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "ownerId",
                    "slackEnabled",
                    "emailEnabled",
                    "previewNotificationsEnabled",
                    "notificationsToSend"
                  ],
                  "properties": {
                    "ownerId": {
                      "type": "string"
                    },
                    "slackEnabled": {
                      "type": "boolean"
                    },
                    "emailEnabled": {
                      "type": "boolean"
                    },
                    "previewNotificationsEnabled": {
                      "type": "boolean"
                    },
                    "notificationsToSend": {
                      "$ref": "#/paths/~1notification-settings~1owners~1%7BownerId%7D/patch/requestBody/content/application~1json/schema/properties/notificationsToSend"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "patch": {
        "summary": "Update notification settings",
        "description": "Update notification settings for the owner with the provided ID.\n",
        "operationId": "patch-owner-notification-settings",
        "tags": ["Notification Settings"],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "emailEnabled": {
                    "type": "boolean"
                  },
                  "previewNotificationsEnabled": {
                    "type": "boolean"
                  },
                  "notificationsToSend": {
                    "type": "string",
                    "enum": ["none", "failure", "all"]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/paths/~1notification-settings~1owners~1%7BownerId%7D/get/responses/200/content/application~1json/schema"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/notification-settings/overrides": {
      "get": {
        "parameters": [
          {
            "$ref": "#/components/parameters/ownerIdParam"
          },
          {
            "$ref": "#/components/parameters/serviceIdsParam"
          },
          {
            "$ref": "#/components/parameters/cursorParam"
          },
          {
            "$ref": "#/components/parameters/limitParam"
          }
        ],
        "summary": "List notification overrides",
        "description": "List notification overrides matching the provided filters. If no filters are provided, returns all notification overrides for all teams the user belongs to.\n",
        "operationId": "list-notification-overrides",
        "tags": ["Notification Settings"],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/notificationOverrideWithCursor"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/notification-settings/overrides/services/{serviceId}": {
      "parameters": [
        {
          "$ref": "#/components/parameters/serviceIdParam"
        }
      ],
      "get": {
        "summary": "Retrieve notification override",
        "description": "Retrieve the notification override for the service with the provided ID.\n\nNote that you provide a service ID to this endpoint, not the ID for a particular override.\n",
        "operationId": "retrieve-service-notification-overrides",
        "tags": ["Notification Settings"],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "serviceId",
                    "previewNotificationsEnabled",
                    "notificationsToSend"
                  ],
                  "properties": {
                    "serviceId": {
                      "type": "string"
                    },
                    "previewNotificationsEnabled": {
                      "$ref": "#/paths/~1notification-settings~1overrides~1services~1%7BserviceId%7D/patch/requestBody/content/application~1json/schema/properties/previewNotificationsEnabled"
                    },
                    "notificationsToSend": {
                      "$ref": "#/paths/~1notification-settings~1overrides~1services~1%7BserviceId%7D/patch/requestBody/content/application~1json/schema/properties/notificationsToSend"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "patch": {
        "summary": "Update notification override",
        "description": "Update the notification override for the service with the provided ID.\n",
        "operationId": "patch-service-notification-overrides",
        "tags": ["Notification Settings"],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "previewNotificationsEnabled": {
                    "type": "string",
                    "enum": ["default", "false", "true"]
                  },
                  "notificationsToSend": {
                    "type": "string",
                    "enum": ["default", "none", "failure", "all"]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/paths/~1notification-settings~1overrides~1services~1%7BserviceId%7D/get/responses/200/content/application~1json/schema"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/registrycredentials": {
      "get": {
        "summary": "List registry credentials",
        "description": "List registry credentials matching the provided filters. If no filters are provided, returns all registry credentials you have permissions to view.\n",
        "operationId": "list-registry-credentials",
        "tags": ["Registry Credentials"],
        "parameters": [
          {
            "name": "name",
            "in": "query",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "style": "form",
            "explode": false,
            "required": false,
            "description": "Filter for the name of a credential"
          },
          {
            "name": "username",
            "in": "query",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "style": "form",
            "explode": false,
            "required": false,
            "description": "Filter for the username of a credential"
          },
          {
            "name": "type",
            "in": "query",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/registryCredentialRegistry"
              }
            },
            "style": "form",
            "explode": false,
            "required": false,
            "description": "Filter for the registry type for the credential"
          },
          {
            "name": "createdBefore",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "required": false,
            "description": "Filter for services created before a certain time (specified as an ISO 8601 timestamp)",
            "example": "2021-06-17T08:15:30Z"
          },
          {
            "name": "createdAfter",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "required": false,
            "description": "Filter for services created after a certain time (specified as an ISO 8601 timestamp)",
            "example": "2021-02-17T08:15:30Z"
          },
          {
            "name": "updatedBefore",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "required": false,
            "description": "Filter for services updated before a certain time (specified as an ISO 8601 timestamp)",
            "example": "2021-06-17T08:15:30Z"
          },
          {
            "name": "updatedAfter",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "required": false,
            "description": "Filter for services updated after a certain time (specified as an ISO 8601 timestamp)",
            "example": "2021-02-17T08:15:30Z"
          },
          {
            "$ref": "#/components/parameters/ownerIdParam"
          },
          {
            "$ref": "#/components/parameters/cursorParam"
          },
          {
            "$ref": "#/components/parameters/limitParam"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/registryCredential"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "post": {
        "summary": "Create registry credential",
        "description": "Create a new registry credential.",
        "operationId": "create-registry-credential",
        "tags": ["Registry Credentials"],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "name",
                  "registry",
                  "username",
                  "authToken",
                  "ownerId"
                ],
                "properties": {
                  "registry": {
                    "$ref": "#/components/schemas/registryCredentialRegistry"
                  },
                  "name": {
                    "type": "string"
                  },
                  "username": {
                    "type": "string"
                  },
                  "authToken": {
                    "type": "string"
                  },
                  "ownerId": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/registryCredential"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/402PaymentRequired"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "409": {
            "$ref": "#/components/responses/409Conflict"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/registrycredentials/{registryCredentialId}": {
      "parameters": [
        {
          "name": "registryCredentialId",
          "in": "path",
          "required": true,
          "description": "The ID of the registry credential",
          "schema": {
            "type": "string"
          }
        }
      ],
      "get": {
        "summary": "Retrieve registry credential",
        "description": "Retrieve the registry credential with the provided ID.",
        "operationId": "retrieve-registry-credential",
        "tags": ["Registry Credentials"],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/registryCredential"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "patch": {
        "summary": "Update registry credential",
        "description": "Update the registry credential with the provided ID. Services that use this credential must be redeployed to use updated values.",
        "operationId": "update-registry-credential",
        "tags": ["Registry Credentials"],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["name", "registry", "username", "authToken"],
                "properties": {
                  "registry": {
                    "$ref": "#/components/schemas/registryCredentialRegistry"
                  },
                  "name": {
                    "type": "string"
                  },
                  "username": {
                    "type": "string"
                  },
                  "authToken": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/registryCredential"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/402PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "409": {
            "$ref": "#/components/responses/409Conflict"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "delete": {
        "summary": "Delete registry credential",
        "description": "Delete the registry credential with the provided ID.",
        "operationId": "delete-registry-credential",
        "tags": ["Registry Credentials"],
        "responses": {
          "204": {
            "description": "Registry credential deleted"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/services": {
      "get": {
        "summary": "List services",
        "description": "List services matching the provided filters. If no filters are provided, returns all services you have permissions to view.\n",
        "operationId": "list-services",
        "tags": ["Services"],
        "parameters": [
          {
            "$ref": "#/components/parameters/nameParam"
          },
          {
            "$ref": "#/components/parameters/serviceTypeParam"
          },
          {
            "$ref": "#/components/parameters/envParam"
          },
          {
            "$ref": "#/components/parameters/regionParam"
          },
          {
            "$ref": "#/components/parameters/suspendedParam"
          },
          {
            "$ref": "#/components/parameters/createdBeforeParam"
          },
          {
            "$ref": "#/components/parameters/createdAfterParam"
          },
          {
            "$ref": "#/components/parameters/updatedBeforeParam"
          },
          {
            "$ref": "#/components/parameters/updatedAfterParam"
          },
          {
            "$ref": "#/components/parameters/ownerIdParam"
          },
          {
            "$ref": "#/components/parameters/cursorParam"
          },
          {
            "$ref": "#/components/parameters/limitParam"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "service": {
                        "$ref": "#/components/schemas/service"
                      },
                      "cursor": {
                        "$ref": "#/components/schemas/cursor"
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "post": {
        "summary": "Create service",
        "description": "Create a service.\n",
        "operationId": "create-service",
        "tags": ["Services"],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/servicePOST"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/serviceAndDeploy"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/402PaymentRequired"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "409": {
            "$ref": "#/components/responses/409Conflict"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/services/{serviceId}": {
      "parameters": [
        {
          "$ref": "#/components/parameters/serviceIdParam"
        }
      ],
      "get": {
        "summary": "Retrieve service",
        "description": "Retrieve the service with the provided ID.\n",
        "operationId": "retrieve-service",
        "tags": ["Services"],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/service"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "patch": {
        "summary": "Update service",
        "description": "Update the service with the provided ID.\n",
        "operationId": "update-service",
        "tags": ["Services"],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/servicePATCH"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/service"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/402PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "409": {
            "$ref": "#/components/responses/409Conflict"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "delete": {
        "summary": "Delete service",
        "description": "Delete the service with the provided ID.\n",
        "operationId": "delete-service",
        "tags": ["Services"],
        "responses": {
          "204": {
            "description": "Service deleted"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/services/{serviceId}/deploys": {
      "parameters": [
        {
          "$ref": "#/components/parameters/serviceIdParam"
        }
      ],
      "get": {
        "summary": "List deploys",
        "description": "List deploys matching the provided filters. If no filters are provided, all deploys for the service are returned.\n",
        "operationId": "list-deploys",
        "tags": ["Deploys"],
        "parameters": [
          {
            "name": "createdBefore",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "required": false,
            "description": "Filter for deploys created before a certain time (specified as an ISO 8601 timestamp)",
            "example": "2021-06-17T08:15:30Z"
          },
          {
            "name": "createdAfter",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "required": false,
            "description": "Filter for deploys created after a certain time (specified as an ISO 8601 timestamp)",
            "example": "2021-02-17T08:15:30Z"
          },
          {
            "name": "updatedBefore",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "required": false,
            "description": "Filter for deploys updated before a certain time (specified as an ISO 8601 timestamp)",
            "example": "2021-06-17T08:15:30Z"
          },
          {
            "name": "updatedAfter",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "required": false,
            "description": "Filter for deploys updated after a certain time (specified as an ISO 8601 timestamp)",
            "example": "2021-02-17T08:15:30Z"
          },
          {
            "name": "finishedBefore",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "required": false,
            "description": "Filter for deploys finished before a certain time (specified as an ISO 8601 timestamp)",
            "example": "2021-06-17T08:15:30Z"
          },
          {
            "name": "finishedAfter",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "required": false,
            "description": "Filter for deploys finished after a certain time (specified as an ISO 8601 timestamp)",
            "example": "2021-02-17T08:15:30Z"
          },
          {
            "$ref": "#/components/parameters/cursorParam"
          },
          {
            "$ref": "#/components/parameters/limitParam"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "deploy": {
                        "$ref": "#/components/schemas/deploy"
                      },
                      "cursor": {
                        "$ref": "#/components/schemas/cursor"
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "post": {
        "summary": "Trigger deploy",
        "description": "Trigger a deploy for the service with the provided ID.\n",
        "operationId": "create-deploy",
        "tags": ["Deploys"],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "clearCache": {
                    "type": "string",
                    "enum": ["clear", "do_not_clear"],
                    "default": "do_not_clear",
                    "description": "If `clear`, Render clears the service's build cache before deploying. This can be useful if you're experiencing issues with your build."
                  },
                  "commitId": {
                    "type": "string",
                    "description": "The SHA of a specific Git commit to deploy for a service. Defaults to the latest commit on the service's connected branch.\n\nNote that deploying a specific commit with this endpoint does not disable autodeploys for the service.\n\nYou can toggle autodeploys for your service with the [Update service](https://api-docs.render.com/reference/update-service) endpoint or in the Render Dashboard.\n\nNot supported for cron jobs.\n"
                  },
                  "imageUrl": {
                    "type": "string",
                    "description": "The URL of the image to deploy for an image-backed service.\n\nThe host, repository, and image name all must match the currently configured image for the service.\n"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/deploy"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "409": {
            "$ref": "#/components/responses/409Conflict"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/services/{serviceId}/deploys/{deployId}": {
      "parameters": [
        {
          "$ref": "#/components/parameters/serviceIdParam"
        },
        {
          "$ref": "#/components/parameters/deployIdParam"
        }
      ],
      "get": {
        "summary": "Retrieve deploy",
        "description": "Retrieve the details of a particular deploy for a particular service.\n",
        "operationId": "retrieve-deploy",
        "tags": ["Deploys"],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/deploy"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/services/{serviceId}/deploys/{deployId}/cancel": {
      "parameters": [
        {
          "$ref": "#/components/parameters/serviceIdParam"
        },
        {
          "$ref": "#/components/parameters/deployIdParam"
        }
      ],
      "post": {
        "summary": "Cancel deploy",
        "description": "Cancel an in-progress deploy for a service.\n\nNot supported for cron jobs.\n",
        "operationId": "cancel-deploy",
        "tags": ["Deploys"],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/deploy"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/services/{serviceId}/rollback": {
      "parameters": [
        {
          "$ref": "#/components/parameters/serviceIdParam"
        }
      ],
      "post": {
        "summary": "Roll back deploy",
        "description": "Trigger a rollback to a previous deploy of the specified service.\n\nTriggering a rollback with this endpoint does not disable autodeploys for the service. This means an autodeploy might restore changes you had intentionally rolled back.\n\nYou can toggle autodeploys for your service with the [Update service](https://api-docs.render.com/reference/update-service) endpoint or in the Render Dashboard.\n",
        "operationId": "rollback-deploy",
        "tags": ["Deploys"],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["deployId"],
                "properties": {
                  "deployId": {
                    "type": "string",
                    "description": "The ID of the deploy to roll back to"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/deploy"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/services/{serviceId}/env-vars": {
      "parameters": [
        {
          "$ref": "#/components/parameters/serviceIdParam"
        }
      ],
      "get": {
        "summary": "List environment variables",
        "description": "List all environment variables for the service with the provided ID.\n",
        "operationId": "get-env-vars-for-service",
        "tags": ["Services"],
        "parameters": [
          {
            "$ref": "#/components/parameters/cursorParam"
          },
          {
            "$ref": "#/components/parameters/limitParam"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/envVarWithCursor"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "put": {
        "summary": "Update environment variables",
        "description": "Replace all environment variables for a service with the provided list of environment variables.",
        "operationId": "update-env-vars-for-service",
        "tags": ["Services"],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/envVarInputArray"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/envVarWithCursor"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/services/{serviceId}/env-vars/{envVarKey}": {
      "parameters": [
        {
          "$ref": "#/components/parameters/serviceIdParam"
        },
        {
          "$ref": "#/components/parameters/envVarKeyParam"
        }
      ],
      "get": {
        "summary": "Retrieve environment variable",
        "description": "Retrieve a particular environment variable for a particular service.\n\nThis only applies to environment variables set directly on the service, not to environment variables in a linked environment group.\n",
        "operationId": "retrieve-env-var",
        "tags": ["Services"],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/envVar"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "put": {
        "summary": "Add or update environment variable",
        "description": "Add or update a particular environment variable for a particular service.\n\nThis only applies to environment variables set directly on the service, not to environment variables in a linked environment group.\n",
        "operationId": "update-env-var",
        "tags": ["Services"],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/addUpdateEnvVarInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/envVar"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "delete": {
        "summary": "Delete environment variable",
        "description": "Delete a particular environment variable from a particular service.\n\nThis only applies to environment variables set directly on the service, not to environment variables in a linked environment group.\n",
        "operationId": "delete-env-var",
        "tags": ["Services"],
        "responses": {
          "204": {
            "description": "Environment variable deleted"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/services/{serviceId}/secret-files": {
      "parameters": [
        {
          "$ref": "#/components/parameters/serviceIdParam"
        }
      ],
      "get": {
        "summary": "List secret files",
        "description": "List all secret files for the service with the provided ID.\n",
        "operationId": "list-secret-files-for-service",
        "tags": ["Services"],
        "parameters": [
          {
            "$ref": "#/components/parameters/cursorParam"
          },
          {
            "$ref": "#/components/parameters/limitParam"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/secretFileWithCursor"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "put": {
        "summary": "Update secret files",
        "description": "Replace all secret files for a service with the provided list of secret files.\n\n**Any of the service's existing secret files not included in this request will be deleted.**\n\nThis only applies to secret files set directly on the service, not to secret files in a linked environment group.\n",
        "operationId": "update-secret-files-for-service",
        "tags": ["Services"],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/secretFileInput"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/secretFileWithCursor"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/services/{serviceId}/secret-files/{secretFileName}": {
      "parameters": [
        {
          "$ref": "#/components/parameters/serviceIdParam"
        },
        {
          "name": "secretFileName",
          "in": "path",
          "required": true,
          "description": "The file name of the secret file",
          "schema": {
            "type": "string"
          }
        }
      ],
      "get": {
        "summary": "Retrieve secret file",
        "description": "Retrieve a particular secret file for a particular service.\n\nThis only applies to secret files set directly on the service, not to secret files in a linked environment group.\n",
        "operationId": "retrieve-secret-file",
        "tags": ["Services"],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/secretFile"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "put": {
        "summary": "Add or update secret file",
        "description": "Add or update a particular secret file for a particular service.\n\nThis only applies to secret files set directly on the service, not to secret files in a linked environment group.\n",
        "operationId": "add-or-update-secret-file",
        "tags": ["Services"],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "content": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/secretFile"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "delete": {
        "summary": "Delete secret file",
        "description": "Delete a particular secret file from a particular service.\n\nThis only applies to secret files set directly on the service, not to secret files in a linked environment group.\n",
        "operationId": "delete-secret-file",
        "tags": ["Services"],
        "responses": {
          "204": {
            "description": "Secret file deleted"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/services/{serviceId}/events": {
      "get": {
        "tags": ["Services"],
        "summary": "List events",
        "description": "List recent events that occurred for the service with the provided ID.",
        "operationId": "list-events",
        "parameters": [
          {
            "$ref": "#/components/parameters/serviceIdParam"
          },
          {
            "$ref": "#/components/parameters/eventTypeParam"
          },
          {
            "$ref": "#/components/parameters/startTimeParam"
          },
          {
            "$ref": "#/components/parameters/endTimeParam"
          },
          {
            "$ref": "#/components/parameters/cursorParam"
          },
          {
            "$ref": "#/components/parameters/limitParam"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/serviceEventWithCursor"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/services/{serviceId}/headers": {
      "parameters": [
        {
          "$ref": "#/components/parameters/serviceIdParam"
        }
      ],
      "get": {
        "summary": "List header rules",
        "description": "List a particular service's response header rules that match the provided filters. If no filters are provided, all rules for the service are returned.\n",
        "operationId": "list-headers",
        "tags": ["Services - Headers"],
        "parameters": [
          {
            "name": "path",
            "in": "query",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "style": "form",
            "explode": false,
            "required": false,
            "description": "Filter for specific paths that headers apply to"
          },
          {
            "name": "name",
            "in": "query",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "style": "form",
            "explode": false,
            "required": false,
            "description": "Filter for header names"
          },
          {
            "name": "value",
            "in": "query",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "style": "form",
            "explode": false,
            "required": false,
            "description": "Filter for header values"
          },
          {
            "$ref": "#/components/parameters/cursorParam"
          },
          {
            "$ref": "#/components/parameters/limitParam"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/headerWithCursor"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "post": {
        "summary": "Add header rule",
        "description": "Add a response header rule to the service with the provided ID.\n",
        "operationId": "add-headers",
        "tags": ["Services - Headers"],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/headerInput"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "headers": {
                      "$ref": "#/components/schemas/header"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "put": {
        "summary": "Replace header rules",
        "description": "Replace all header rules for a particular service with the provided list.\n\n**This deletes all existing header rules for the service that aren't included in the request.**\n",
        "operationId": "update-headers",
        "tags": ["Services - Headers"],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/headerInput"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/header"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/services/{serviceId}/headers/{headerId}": {
      "parameters": [
        {
          "$ref": "#/components/parameters/serviceIdParam"
        },
        {
          "name": "headerId",
          "in": "path",
          "required": true,
          "description": "The id of the header",
          "schema": {
            "type": "string"
          }
        }
      ],
      "delete": {
        "summary": "Delete header rule",
        "description": "Delete a particular response header rule for a particular service.\n",
        "operationId": "delete-header",
        "tags": ["Services - Headers"],
        "responses": {
          "204": {
            "description": "Header deleted"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/services/{serviceId}/routes": {
      "parameters": [
        {
          "$ref": "#/components/parameters/serviceIdParam"
        }
      ],
      "get": {
        "summary": "List redirect/rewrite rules",
        "description": "List a particular service's redirect/rewrite rules that match the provided filters. If no filters are provided, all rules for the service are returned.\n",
        "operationId": "list-routes",
        "tags": ["Services - Routes"],
        "parameters": [
          {
            "name": "type",
            "in": "query",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": ["redirect", "rewrite"]
              }
            },
            "style": "form",
            "explode": false,
            "required": false,
            "description": "Filter for the type of route rule"
          },
          {
            "name": "source",
            "in": "query",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "style": "form",
            "explode": false,
            "required": false,
            "description": "Filter for the source path of the route"
          },
          {
            "name": "destination",
            "in": "query",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "style": "form",
            "explode": false,
            "required": false,
            "description": "Filter for the destination path of the route"
          },
          {
            "$ref": "#/components/parameters/cursorParam"
          },
          {
            "$ref": "#/components/parameters/limitParam"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/routeWithCursor"
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "post": {
        "summary": "Add redirect/rewrite rules",
        "description": "Add redirect/rewrite rules to the service with the provided ID.\n",
        "operationId": "add-route",
        "tags": ["Services - Routes"],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/routePost"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/route"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "patch": {
        "summary": "Update redirect/rewrite rule priority",
        "description": "Update the priority for a particular redirect/rewrite rule.\n\nTo apply redirect/rewrite rules to an incoming request, Render starts from the rule with priority `0` and applies the first encountered rule that matches the request's path (if any).\n\nRender increments the priority of other rules by `1` as necessary to make space for the updated rule.\n",
        "operationId": "patch-route",
        "tags": ["Services - Routes"],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/routePatch"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Updated",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "headers": {
                      "$ref": "#/components/schemas/route"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "put": {
        "summary": "Update redirect/rewrite rules",
        "description": "Replace all redirect/rewrite rules for a particular service with the provided list.\n\n**This deletes all existing redirect/rewrite rules for the service that aren't included in the request.**\n\nRule priority is assigned according to list order (the first rule in the list has the highest priority).\n",
        "operationId": "put-routes",
        "tags": ["Services - Routes"],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/routePut"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Updated",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/route"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/services/{serviceId}/routes/{routeId}": {
      "parameters": [
        {
          "$ref": "#/components/parameters/serviceIdParam"
        },
        {
          "name": "routeId",
          "in": "path",
          "required": true,
          "description": "The id of the route",
          "schema": {
            "type": "string"
          }
        }
      ],
      "delete": {
        "summary": "Delete redirect/rewrite rule",
        "description": "Delete a particular redirect/rewrite rule for a particular service.\n",
        "operationId": "delete-route",
        "tags": ["Services - Routes"],
        "responses": {
          "204": {
            "description": "Route deleted"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/services/{serviceId}/custom-domains": {
      "parameters": [
        {
          "$ref": "#/components/parameters/serviceIdParam"
        }
      ],
      "get": {
        "summary": "List custom domains",
        "description": "List a particular service's custom domains that match the provided filters. If no filters are provided, all custom domains for the service are returned.\n",
        "operationId": "list-custom-domains",
        "tags": ["Custom Domains"],
        "parameters": [
          {
            "$ref": "#/components/parameters/cursorParam"
          },
          {
            "$ref": "#/components/parameters/limitParam"
          },
          {
            "name": "name",
            "in": "query",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "style": "form",
            "explode": false,
            "required": false,
            "description": "Filter for the names of custom domain"
          },
          {
            "name": "domainType",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": ["apex", "subdomain"]
            },
            "required": false,
            "description": "Filter for domain type"
          },
          {
            "name": "verificationStatus",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": ["verified", "unverified"]
            },
            "required": false,
            "description": "Filter for domain verification status (`verified` or `unverified`)"
          },
          {
            "name": "createdBefore",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "required": false,
            "description": "Filter for custom domains created before a certain time (specified as an ISO 8601 timestamp)",
            "example": "2021-06-17T08:15:30Z"
          },
          {
            "name": "createdAfter",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "required": false,
            "description": "Filter for custom domains created after a certain time (specified as an ISO 8601 timestamp)",
            "example": "2021-02-17T08:15:30Z"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/customDomainWithCursor"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "post": {
        "summary": "Add custom domain",
        "description": "Add a custom domain to the service with the provided ID.\n",
        "operationId": "create-custom-domain",
        "tags": ["Custom Domains"],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["name"],
                "properties": {
                  "name": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/customDomain"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "402": {
            "$ref": "#/components/responses/402PaymentRequired"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "409": {
            "$ref": "#/components/responses/409Conflict"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/services/{serviceId}/custom-domains/{customDomainIdOrName}": {
      "parameters": [
        {
          "$ref": "#/components/parameters/serviceIdParam"
        },
        {
          "$ref": "#/components/parameters/customDomainIdOrNameParam"
        }
      ],
      "get": {
        "summary": "Retrieve custom domain",
        "description": "Retrieve a particular custom domain for a particular service.\n",
        "operationId": "retrieve-custom-domain",
        "tags": ["Custom Domains"],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/customDomain"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "delete": {
        "summary": "Delete custom domain",
        "description": "Delete a custom domain for a service given the service id and custom domain id or name.\n",
        "operationId": "delete-custom-domain",
        "tags": ["Custom Domains"],
        "responses": {
          "204": {
            "description": "Custom domain deleted"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/services/{serviceId}/custom-domains/{customDomainIdOrName}/verify": {
      "parameters": [
        {
          "$ref": "#/components/parameters/serviceIdParam"
        },
        {
          "$ref": "#/components/parameters/customDomainIdOrNameParam"
        }
      ],
      "post": {
        "summary": "Verify DNS configuration",
        "description": "Verify the DNS configuration for a custom domain.\n",
        "operationId": "refresh-custom-domain",
        "tags": ["Custom Domains"],
        "responses": {
          "202": {
            "description": "Custom domain verification triggered"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/services/{serviceId}/suspend": {
      "parameters": [
        {
          "$ref": "#/components/parameters/serviceIdParam"
        }
      ],
      "post": {
        "summary": "Suspend service",
        "description": "Suspend the service with the provided ID.\n",
        "operationId": "suspend-service",
        "tags": ["Services"],
        "responses": {
          "202": {
            "description": "Service suspended successfully"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/services/{serviceId}/resume": {
      "parameters": [
        {
          "$ref": "#/components/parameters/serviceIdParam"
        }
      ],
      "post": {
        "summary": "Resume service",
        "description": "Resume the service with the provided ID (if it's currently suspended).\n",
        "operationId": "resume-service",
        "tags": ["Services"],
        "responses": {
          "202": {
            "description": "Service resumed successfully"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/services/{serviceId}/restart": {
      "parameters": [
        {
          "$ref": "#/components/parameters/serviceIdParam"
        }
      ],
      "post": {
        "summary": "Restart service",
        "description": "Restart the service with the provided ID.\n\nNot supported for cron jobs.\n",
        "operationId": "restart-service",
        "tags": ["Services"],
        "responses": {
          "200": {
            "description": "Service restarted"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/services/{serviceId}/scale": {
      "parameters": [
        {
          "$ref": "#/components/parameters/serviceIdParam"
        }
      ],
      "post": {
        "summary": "Scale instance count",
        "description": "[Scale](https://docs.render.com/scaling#manual-scaling) the service with the provided ID to a fixed number of instances.\n\nRender ignores this value as long as autoscaling is enabled for the service.\n",
        "operationId": "scale-service",
        "tags": ["Services"],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["numInstances"],
                "properties": {
                  "numInstances": {
                    "type": "integer",
                    "example": 3
                  }
                }
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Service scaled successfully"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/services/{serviceId}/autoscaling": {
      "parameters": [
        {
          "$ref": "#/components/parameters/serviceIdParam"
        }
      ],
      "put": {
        "summary": "Update autoscaling config",
        "description": "Update the [autoscaling](https://docs.render.com/scaling#autoscaling) config for the service with the provided ID.\n",
        "operationId": "autoscale-service",
        "tags": ["Services"],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/webServiceDetails/properties/autoscaling"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Autoscaling configuration updated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/webServiceDetails/properties/autoscaling"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "delete": {
        "summary": "Delete autoscaling config",
        "description": "Delete the autoscaling config for a service given the service id.\n",
        "operationId": "delete-autoscaling-config",
        "tags": ["Services"],
        "responses": {
          "204": {
            "description": "Autoscaling config deleted"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/services/{serviceId}/preview": {
      "parameters": [
        {
          "$ref": "#/components/parameters/serviceIdParam"
        }
      ],
      "post": {
        "summary": "Create service preview (image-backed)",
        "description": "Create a preview instance for an image-backed service. The preview uses the settings of the base service (referenced by `serviceId`), except settings overridden via provided parameters.\n\nView all active previews from your service's Previews tab in the Render Dashboard.\n\nNote that you can't create previews for Git-backed services using the Render API.\n",
        "operationId": "preview-service",
        "tags": ["Services"],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/previewInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/serviceAndDeploy"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/services/{serviceId}/jobs": {
      "parameters": [
        {
          "$ref": "#/components/parameters/serviceIdParam"
        }
      ],
      "get": {
        "summary": "List jobs",
        "description": "List jobs for the provided service that match the provided filters. If no filters are provided, all jobs for the service are returned.\n",
        "operationId": "list-job",
        "tags": ["One-Off Jobs"],
        "parameters": [
          {
            "$ref": "#/components/parameters/cursorParam"
          },
          {
            "$ref": "#/components/parameters/limitParam"
          },
          {
            "name": "status",
            "in": "query",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": ["pending", "running", "succeeded", "failed"]
              }
            },
            "style": "form",
            "explode": false,
            "required": false,
            "description": "Filter for the status of the job (`pending`, `running`, `succeeded`, or `failed`)"
          },
          {
            "name": "createdBefore",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "required": false,
            "description": "Filter for jobs created before a certain time (specified as an ISO 8601 timestamp)",
            "example": "2021-06-17T08:15:30Z"
          },
          {
            "name": "createdAfter",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "required": false,
            "description": "Filter for jobs created after a certain time (specified as an ISO 8601 timestamp)",
            "example": "2021-02-17T08:15:30Z"
          },
          {
            "name": "startedBefore",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "required": false,
            "description": "Filter for jobs started before a certain time (specified as an ISO 8601 timestamp)",
            "example": "2021-06-17T08:15:30Z"
          },
          {
            "name": "startedAfter",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "required": false,
            "description": "Filter for jobs started after a certain time (specified as an ISO 8601 timestamp)",
            "example": "2021-02-17T08:15:30Z"
          },
          {
            "name": "finishedBefore",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "required": false,
            "description": "Filter for jobs finished before a certain time (specified as an ISO 8601 timestamp)",
            "example": "2021-06-17T08:15:30Z"
          },
          {
            "name": "finishedAfter",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            },
            "required": false,
            "description": "Filter for jobs finished after a certain time (specified as an ISO 8601 timestamp)",
            "example": "2021-02-17T08:15:30Z"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "job": {
                        "$ref": "#/paths/~1services~1%7BserviceId%7D~1jobs/post/responses/200/content/application~1json/schema"
                      },
                      "cursor": {
                        "$ref": "#/components/schemas/cursor"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "post": {
        "summary": "Create job",
        "description": "Create a one-off job using the provided service. For details, see [One-Off Jobs](https://docs.render.com/jobs).\n",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["startCommand"],
                "properties": {
                  "startCommand": {
                    "type": "string"
                  },
                  "planId": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "operationId": "post-job",
        "tags": ["One-Off Jobs"],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "id",
                    "serviceId",
                    "startCommand",
                    "planId",
                    "createdAt"
                  ],
                  "properties": {
                    "id": {
                      "$ref": "#/paths/~1services~1%7BserviceId%7D~1jobs~1%7BjobId%7D/parameters/1/schema"
                    },
                    "serviceId": {
                      "type": "string",
                      "example": "srv-xxxxx"
                    },
                    "startCommand": {
                      "type": "string",
                      "example": "echo 'hello world'"
                    },
                    "planId": {
                      "type": "string",
                      "example": "plan-srv-004"
                    },
                    "status": {
                      "type": "string",
                      "enum": ["succeeded", "failed", "canceled"]
                    },
                    "createdAt": {
                      "type": "string",
                      "format": "date-time",
                      "example": "2021-07-15T07:20:05.777035-07:00"
                    },
                    "startedAt": {
                      "type": "string",
                      "format": "date-time",
                      "example": "2021-07-15T07:20:05.777035-07:00"
                    },
                    "finishedAt": {
                      "type": "string",
                      "format": "date-time",
                      "example": "2021-07-15T07:20:05.777035-07:00"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/services/{serviceId}/jobs/{jobId}": {
      "parameters": [
        {
          "$ref": "#/components/parameters/serviceIdParam"
        },
        {
          "name": "jobId",
          "in": "path",
          "required": true,
          "description": "The ID of the job",
          "schema": {
            "type": "string",
            "pattern": "^job-[0-9a-z]{20}$",
            "example": "job-cph1rs3idesc73a2b2mg"
          }
        }
      ],
      "get": {
        "summary": "Retrieve job",
        "description": "Retrieve the details of a particular one-off job for a particular service.\n",
        "operationId": "retrieve-job",
        "tags": ["One-Off Jobs"],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/paths/~1services~1%7BserviceId%7D~1jobs/post/responses/200/content/application~1json/schema"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/services/{serviceId}/jobs/{jobId}/cancel": {
      "parameters": [
        {
          "$ref": "#/components/parameters/serviceIdParam"
        },
        {
          "$ref": "#/paths/~1services~1%7BserviceId%7D~1jobs~1%7BjobId%7D/parameters/1"
        }
      ],
      "post": {
        "summary": "Cancel running job",
        "description": "Cancel a particular one-off job for a particular service.\n",
        "operationId": "cancel-job",
        "tags": ["One-Off Jobs"],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/paths/~1services~1%7BserviceId%7D~1jobs/post/responses/200/content/application~1json/schema"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/cron-jobs/{cronJobId}/runs": {
      "parameters": [
        {
          "$ref": "#/components/parameters/cronJobIdParam"
        }
      ],
      "post": {
        "summary": "Trigger cron job run",
        "description": "Trigger a run for a cron job and cancel any active runs.",
        "operationId": "run-cron-job",
        "tags": ["Services - Cron Jobs"],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/cronJobRun"
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "delete": {
        "summary": "Cancel running cron job",
        "description": "Cancel a currently running cron job.",
        "operationId": "cancel-cron-job-run",
        "tags": ["Services - Cron Jobs"],
        "responses": {
          "204": {
            "description": "Cancelled"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/logs": {
      "get": {
        "summary": "List logs",
        "description": "List logs matching the provided filters. Logs are paginated by start and end timestamps.\nThere are more logs to fetch if `hasMore` is true in the response. Provide the `nextStartTime`\nand `nextEndTime` timestamps as the `startTime` and `endTime` query parameters to fetch the next page of logs.\n\nYou can query for logs across multiple resources, but all resources must be in the same region and belong to the same owner.\n",
        "operationId": "list-logs",
        "tags": ["Logs"],
        "parameters": [
          {
            "name": "ownerId",
            "in": "query",
            "description": "The ID of the owner (team or personal user) whose resources should be returned",
            "schema": {
              "type": "string"
            },
            "required": true
          },
          {
            "$ref": "#/components/parameters/startTimeParam"
          },
          {
            "$ref": "#/components/parameters/endTimeParam"
          },
          {
            "name": "direction",
            "in": "query",
            "required": false,
            "description": "The direction to query logs for. Backward will return most recent logs first.\nForward will start with the oldest logs in the time range.\n",
            "schema": {
              "default": "backward",
              "type": "string",
              "enum": ["forward", "backward"]
            }
          },
          {
            "name": "resource",
            "in": "query",
            "required": true,
            "description": "Filter logs by their resource. A resource is the id of a server, cronjob, job, postgres, or redis.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "instance",
            "in": "query",
            "required": false,
            "description": "Filter logs by the instance they were emitted from. An instance is the id of a specific running server.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "host",
            "in": "query",
            "required": false,
            "description": "Filter request logs by their host. [Wildcards and regex](https://docs.render.com/logging#wildcards-and-regular-expressions) are supported.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "statusCode",
            "in": "query",
            "required": false,
            "description": "Filter request logs by their status code. [Wildcards and regex](https://docs.render.com/logging#wildcards-and-regular-expressions) are supported.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "method",
            "in": "query",
            "required": false,
            "description": "Filter request logs by their requests method. [Wildcards and regex](https://docs.render.com/logging#wildcards-and-regular-expressions) are supported.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "level",
            "in": "query",
            "required": false,
            "description": "Filter logs by their severity level. [Wildcards and regex](https://docs.render.com/logging#wildcards-and-regular-expressions) are supported.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "Filter logs by their type. Types include `app` for application logs and `request` for request logs. You can find the full set of types available for a query by using the `GET /logs/values` endpoint.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "text",
            "in": "query",
            "required": false,
            "description": "Filter by the text of the logs. [Wildcards and regex](https://docs.render.com/logging#wildcards-and-regular-expressions) are supported.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "path",
            "in": "query",
            "required": false,
            "description": "Filter request logs by their path. [Wildcards and regex](https://docs.render.com/logging#wildcards-and-regular-expressions) are supported.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "$ref": "#/components/parameters/limitParam"
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/Logs200Response"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/logs/subscribe": {
      "get": {
        "summary": "Subscribe to new logs",
        "description": "Open a websocket connection to subscribe to logs matching the provided filters. Logs are streamed in real-time as they are generated.\n\nYou can query for logs across multiple resources, but all resources must be in the same region and belong to the same owner.\n",
        "operationId": "subscribe-logs",
        "tags": ["Logs"],
        "parameters": [
          {
            "name": "ownerId",
            "in": "query",
            "description": "The ID of the owner (team or personal user) whose resources should be returned",
            "schema": {
              "type": "string"
            },
            "required": true
          },
          {
            "$ref": "#/components/parameters/startTimeParam"
          },
          {
            "$ref": "#/components/parameters/endTimeParam"
          },
          {
            "$ref": "#/paths/~1logs/get/parameters/3"
          },
          {
            "$ref": "#/paths/~1logs/get/parameters/4"
          },
          {
            "$ref": "#/paths/~1logs/get/parameters/5"
          },
          {
            "$ref": "#/paths/~1logs/get/parameters/6"
          },
          {
            "$ref": "#/paths/~1logs/get/parameters/7"
          },
          {
            "$ref": "#/paths/~1logs/get/parameters/8"
          },
          {
            "$ref": "#/paths/~1logs/get/parameters/9"
          },
          {
            "$ref": "#/paths/~1logs/get/parameters/10"
          },
          {
            "$ref": "#/paths/~1logs/get/parameters/11"
          },
          {
            "$ref": "#/paths/~1logs/get/parameters/12"
          },
          {
            "$ref": "#/components/parameters/limitParam"
          }
        ],
        "responses": {
          "101": {
            "description": "The connection has been upgraded to a websocket. The server will send log messages as they are generated in the format defined below.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "A log entry with metadata",
                  "required": ["id", "message", "timestamp", "labels"],
                  "properties": {
                    "id": {
                      "description": "A unique ID of the log entry",
                      "type": "string"
                    },
                    "message": {
                      "description": "The message of the log entry",
                      "type": "string"
                    },
                    "timestamp": {
                      "description": "The timestamp of the log entry",
                      "type": "string",
                      "format": "date-time"
                    },
                    "labels": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "description": "A log label",
                        "required": ["name", "value"],
                        "properties": {
                          "name": {
                            "description": "The name of the log label",
                            "type": "string",
                            "enum": [
                              "resource",
                              "instance",
                              "host",
                              "statusCode",
                              "method",
                              "level",
                              "type",
                              "text",
                              "path"
                            ]
                          },
                          "value": {
                            "description": "The value of the log label",
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/logs/values": {
      "get": {
        "summary": "List log label values",
        "description": "List all values for a given log label in the logs matching the provided filters.",
        "operationId": "list-logs-values",
        "tags": ["Logs"],
        "parameters": [
          {
            "name": "ownerId",
            "in": "query",
            "description": "The ID of the owner (team or personal user) whose resources should be returned",
            "schema": {
              "type": "string"
            },
            "required": true
          },
          {
            "name": "label",
            "in": "query",
            "required": true,
            "description": "The label to query logs for",
            "schema": {
              "type": "string",
              "enum": [
                "instance",
                "host",
                "statusCode",
                "method",
                "level",
                "type"
              ]
            }
          },
          {
            "$ref": "#/components/parameters/startTimeParam"
          },
          {
            "$ref": "#/components/parameters/endTimeParam"
          },
          {
            "$ref": "#/paths/~1logs/get/parameters/3"
          },
          {
            "$ref": "#/paths/~1logs/get/parameters/4"
          },
          {
            "$ref": "#/paths/~1logs/get/parameters/5"
          },
          {
            "$ref": "#/paths/~1logs/get/parameters/6"
          },
          {
            "$ref": "#/paths/~1logs/get/parameters/7"
          },
          {
            "$ref": "#/paths/~1logs/get/parameters/8"
          },
          {
            "$ref": "#/paths/~1logs/get/parameters/9"
          },
          {
            "$ref": "#/paths/~1logs/get/parameters/10"
          },
          {
            "$ref": "#/paths/~1logs/get/parameters/11"
          },
          {
            "$ref": "#/paths/~1logs/get/parameters/12"
          },
          {
            "$ref": "#/components/parameters/limitParam"
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/LogsValues200Response"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/metrics/cpu": {
      "parameters": [
        {
          "$ref": "#/components/parameters/startTimeParam"
        },
        {
          "$ref": "#/components/parameters/endTimeParam"
        },
        {
          "name": "resolutionSeconds",
          "in": "query",
          "schema": {
            "type": "number",
            "minimum": 30,
            "example": 60,
            "default": 60
          },
          "required": false,
          "description": "The resolution of the returned data"
        },
        {
          "name": "resource",
          "in": "query",
          "description": "Resource ID to query. When multiple resource query params are provided, they are ORed together. Resources can be service ids, Postgres ids, or Redis ids",
          "schema": {
            "type": "string",
            "example": "srv-xxxxx,dpg-xxxxx,red-xxxxx"
          }
        },
        {
          "name": "service",
          "in": "query",
          "deprecated": true,
          "description": "This parameter is deprecated. Please use `resource` instead",
          "schema": {
            "type": "string",
            "example": "srv-xxxxx"
          }
        },
        {
          "name": "instance",
          "in": "query",
          "required": false,
          "description": "Instance ID to query. When multiple instance ID query params are provided, they are ORed together",
          "schema": {
            "type": "string",
            "example": "srv-xxxxx-yyyy"
          }
        },
        {
          "name": "aggregationMethod",
          "in": "query",
          "required": false,
          "description": "The aggregation method to apply to multiple time series",
          "schema": {
            "type": "string",
            "enum": ["AVG", "MAX", "MIN"]
          }
        }
      ],
      "get": {
        "summary": "Get CPU usage",
        "description": "Get CPU usage for one or more resources.\n",
        "operationId": "get-cpu",
        "tags": ["Metrics"],
        "responses": {
          "200": {
            "description": "A successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "description": "A collection of time series",
                  "required": ["items"],
                  "items": {
                    "type": "object",
                    "description": "A time series data point",
                    "required": ["labels", "values", "unit"],
                    "properties": {
                      "labels": {
                        "type": "array",
                        "description": "List of labels describing the time series",
                        "items": {
                          "type": "object",
                          "description": "A time series datapoint label",
                          "required": ["field", "value"],
                          "properties": {
                            "field": {
                              "type": "string",
                              "example": "service"
                            },
                            "value": {
                              "type": "string",
                              "example": "srv-xxxxx"
                            }
                          }
                        }
                      },
                      "values": {
                        "type": "array",
                        "description": "The values of the time series",
                        "items": {
                          "description": "A time series datapoint value",
                          "type": "object",
                          "required": ["timestamp", "value", "unit"],
                          "properties": {
                            "timestamp": {
                              "type": "string",
                              "format": "date-time",
                              "example": "2021-06-17T08:15:30Z"
                            },
                            "value": {
                              "type": "number",
                              "example": 1
                            }
                          }
                        }
                      },
                      "unit": {
                        "type": "string",
                        "example": "GB"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          }
        }
      }
    },
    "/metrics/cpu-limit": {
      "parameters": [
        {
          "$ref": "#/components/parameters/startTimeParam"
        },
        {
          "$ref": "#/components/parameters/endTimeParam"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/2"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/3"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/4"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/5"
        }
      ],
      "get": {
        "summary": "Get CPU limit",
        "description": "Get the CPU limit for one or more resources.\n",
        "operationId": "get-cpu-limit",
        "tags": ["Metrics"],
        "responses": {
          "200": {
            "$ref": "#/paths/~1metrics~1cpu/get/responses/200"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          }
        }
      }
    },
    "/metrics/cpu-target": {
      "parameters": [
        {
          "$ref": "#/components/parameters/startTimeParam"
        },
        {
          "$ref": "#/components/parameters/endTimeParam"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/2"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/3"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/4"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/5"
        }
      ],
      "get": {
        "summary": "Get CPU target",
        "description": "Get CPU target for one or more resources.\n",
        "operationId": "get-cpu-target",
        "tags": ["Metrics"],
        "responses": {
          "200": {
            "$ref": "#/paths/~1metrics~1cpu/get/responses/200"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          }
        }
      }
    },
    "/metrics/memory": {
      "parameters": [
        {
          "$ref": "#/components/parameters/startTimeParam"
        },
        {
          "$ref": "#/components/parameters/endTimeParam"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/2"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/3"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/4"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/5"
        }
      ],
      "get": {
        "summary": "Get memory usage",
        "description": "Get memory usage for one or more resources.\n",
        "operationId": "get-memory",
        "tags": ["Metrics"],
        "responses": {
          "200": {
            "$ref": "#/paths/~1metrics~1cpu/get/responses/200"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          }
        }
      }
    },
    "/metrics/memory-limit": {
      "parameters": [
        {
          "$ref": "#/components/parameters/startTimeParam"
        },
        {
          "$ref": "#/components/parameters/endTimeParam"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/2"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/3"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/4"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/5"
        }
      ],
      "get": {
        "summary": "Get memory limit",
        "description": "Get the memory limit for one or more resources.\n",
        "operationId": "get-memory-limit",
        "tags": ["Metrics"],
        "responses": {
          "200": {
            "$ref": "#/paths/~1metrics~1cpu/get/responses/200"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          }
        }
      }
    },
    "/metrics/memory-target": {
      "parameters": [
        {
          "$ref": "#/components/parameters/startTimeParam"
        },
        {
          "$ref": "#/components/parameters/endTimeParam"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/2"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/3"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/4"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/5"
        }
      ],
      "get": {
        "summary": "Get memory target",
        "description": "Get memory target for one or more resources.\n",
        "operationId": "get-memory-target",
        "tags": ["Metrics"],
        "responses": {
          "200": {
            "$ref": "#/paths/~1metrics~1cpu/get/responses/200"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          }
        }
      }
    },
    "/metrics/http-requests": {
      "parameters": [
        {
          "$ref": "#/components/parameters/startTimeParam"
        },
        {
          "$ref": "#/components/parameters/endTimeParam"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/2"
        },
        {
          "$ref": "#/paths/~1metrics~1bandwidth/parameters/2"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/4"
        },
        {
          "$ref": "#/paths/~1metrics~1http-latency/parameters/5"
        },
        {
          "$ref": "#/paths/~1metrics~1http-latency/parameters/6"
        },
        {
          "name": "aggregateBy",
          "in": "query",
          "required": false,
          "description": "The field to aggregate by",
          "schema": {
            "type": "string",
            "enum": ["statusCode", "host"]
          }
        }
      ],
      "get": {
        "summary": "Get HTTP request count",
        "description": "Get the HTTP request count for one or more resources.\n",
        "operationId": "get-http-requests",
        "tags": ["Metrics"],
        "responses": {
          "200": {
            "$ref": "#/paths/~1metrics~1cpu/get/responses/200"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          }
        }
      }
    },
    "/metrics/http-latency": {
      "parameters": [
        {
          "$ref": "#/components/parameters/startTimeParam"
        },
        {
          "$ref": "#/components/parameters/endTimeParam"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/2"
        },
        {
          "$ref": "#/paths/~1metrics~1bandwidth/parameters/2"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/4"
        },
        {
          "name": "host",
          "in": "query",
          "required": false,
          "description": "The hosts of HTTP requests to filter to. When multiple host query params are provided, they are ORed together",
          "schema": {
            "type": "string",
            "example": "example.com"
          }
        },
        {
          "name": "path",
          "in": "query",
          "required": false,
          "description": "The paths of HTTP requests to filter to. When multiple path query params are provided, they are ORed together",
          "schema": {
            "type": "string",
            "example": "/graphql"
          }
        },
        {
          "name": "quantile",
          "in": "query",
          "required": false,
          "description": "The quantile of latencies to fetch. When multiple quantile query params are provided, they are ORed together",
          "schema": {
            "type": "number",
            "format": "float",
            "example": 0.99
          }
        }
      ],
      "get": {
        "summary": "Get HTTP latency",
        "description": "Get HTTP latency metrics for one or more resources.\n",
        "operationId": "get-http-latency",
        "tags": ["Metrics"],
        "responses": {
          "200": {
            "$ref": "#/paths/~1metrics~1cpu/get/responses/200"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          }
        }
      }
    },
    "/metrics/bandwidth": {
      "parameters": [
        {
          "$ref": "#/components/parameters/startTimeParam"
        },
        {
          "$ref": "#/components/parameters/endTimeParam"
        },
        {
          "name": "resource",
          "in": "query",
          "description": "Service ID to query. When multiple service ids are provided, they are ORed together",
          "schema": {
            "type": "string",
            "example": "srv-xxxxx"
          }
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/4"
        }
      ],
      "get": {
        "summary": "Get bandwidth usage",
        "description": "Get bandwidth usage for one or more resources.\n",
        "operationId": "get-bandwidth",
        "tags": ["Metrics"],
        "responses": {
          "200": {
            "$ref": "#/paths/~1metrics~1cpu/get/responses/200"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          }
        }
      }
    },
    "/metrics/disk-usage": {
      "parameters": [
        {
          "$ref": "#/components/parameters/startTimeParam"
        },
        {
          "$ref": "#/components/parameters/endTimeParam"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/2"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/3"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/4"
        }
      ],
      "get": {
        "summary": "Get disk usage",
        "description": "Get persistent disk usage for one or more resources.\n",
        "operationId": "get-disk-usage",
        "tags": ["Metrics"],
        "responses": {
          "200": {
            "$ref": "#/paths/~1metrics~1cpu/get/responses/200"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          }
        }
      }
    },
    "/metrics/disk-capacity": {
      "parameters": [
        {
          "$ref": "#/components/parameters/startTimeParam"
        },
        {
          "$ref": "#/components/parameters/endTimeParam"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/2"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/3"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/4"
        }
      ],
      "get": {
        "summary": "Get disk capacity",
        "description": "Get persistent disk capacity for one or more resources.\n",
        "operationId": "get-disk-capacity",
        "tags": ["Metrics"],
        "responses": {
          "200": {
            "$ref": "#/paths/~1metrics~1cpu/get/responses/200"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          }
        }
      }
    },
    "/metrics/instance-count": {
      "parameters": [
        {
          "$ref": "#/components/parameters/startTimeParam"
        },
        {
          "$ref": "#/components/parameters/endTimeParam"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/2"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/3"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/4"
        }
      ],
      "get": {
        "summary": "Get instance count",
        "description": "Get the instance count for one or more resources.\n",
        "operationId": "get-instance-count",
        "tags": ["Metrics"],
        "responses": {
          "200": {
            "$ref": "#/paths/~1metrics~1cpu/get/responses/200"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          }
        }
      }
    },
    "/metrics/active-connections": {
      "parameters": [
        {
          "$ref": "#/components/parameters/startTimeParam"
        },
        {
          "$ref": "#/components/parameters/endTimeParam"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/2"
        },
        {
          "name": "resource",
          "in": "query",
          "description": "Resource ID to query. When multiple resource query params are provided, they are ORed together. Resources Postgres ids or Redis ids",
          "schema": {
            "type": "string",
            "example": "dpg-xxxxx,red-xxxxx"
          }
        }
      ],
      "get": {
        "summary": "Get active connection count",
        "description": "Get the number of active connections for one or more PostgreSQL databases or Redis instances.\n",
        "operationId": "get-active-connections",
        "tags": ["Metrics"],
        "responses": {
          "200": {
            "$ref": "#/paths/~1metrics~1cpu/get/responses/200"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          }
        }
      }
    },
    "/metrics/replication-lag": {
      "parameters": [
        {
          "$ref": "#/components/parameters/startTimeParam"
        },
        {
          "$ref": "#/components/parameters/endTimeParam"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/2"
        },
        {
          "name": "resource",
          "in": "query",
          "description": "Postgres ID to query. When multiple resource query params are provided, they are ORed together",
          "schema": {
            "type": "string",
            "example": "dpg-xxxxx"
          }
        }
      ],
      "get": {
        "summary": "Get replica lag",
        "description": "Get milliseconds of replica lag of a PostgreSQL replica.\n",
        "operationId": "get-replication-lag",
        "tags": ["Metrics"],
        "responses": {
          "200": {
            "$ref": "#/paths/~1metrics~1cpu/get/responses/200"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          }
        }
      }
    },
    "/metrics/filters/application": {
      "parameters": [
        {
          "$ref": "#/components/parameters/startTimeParam"
        },
        {
          "$ref": "#/components/parameters/endTimeParam"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/2"
        },
        {
          "$ref": "#/paths/~1metrics~1bandwidth/parameters/2"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/4"
        }
      ],
      "get": {
        "summary": "List queryable instance values",
        "description": "List instance values to filter by for one or more resources.\n",
        "operationId": "list-application-filter-values",
        "tags": ["Metrics"],
        "responses": {
          "200": {
            "description": "A successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "description": "A collection of filter values for application metrics",
                  "required": ["items"],
                  "items": {
                    "type": "object",
                    "properties": {
                      "filter": {
                        "type": "string",
                        "enum": ["instance"]
                      },
                      "values": {
                        "type": "array",
                        "items": {
                          "type": "string",
                          "example": "srv-xxxxx-yyyy"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          }
        }
      }
    },
    "/metrics/filters/http": {
      "parameters": [
        {
          "$ref": "#/components/parameters/startTimeParam"
        },
        {
          "$ref": "#/components/parameters/endTimeParam"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/2"
        },
        {
          "$ref": "#/paths/~1metrics~1bandwidth/parameters/2"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/4"
        },
        {
          "$ref": "#/paths/~1metrics~1http-latency/parameters/5"
        },
        {
          "name": "statusCode",
          "in": "query",
          "required": false,
          "description": "The status codes of HTTP requests to filter to. When multiple status code query params are provided, they are ORed together",
          "schema": {
            "type": "string",
            "example": "200"
          }
        }
      ],
      "get": {
        "summary": "List queryable status codes and host values",
        "description": "List status codes and host values to filter by for one or more resources.\n",
        "operationId": "list-http-filter-values",
        "tags": ["Metrics"],
        "responses": {
          "200": {
            "description": "A successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "description": "A collection of filter values for HTTP metrics",
                  "required": ["items"],
                  "items": {
                    "type": "object",
                    "properties": {
                      "filter": {
                        "type": "string",
                        "enum": ["host", "statusCode"]
                      },
                      "values": {
                        "type": "array",
                        "items": {
                          "type": "string",
                          "example": "api.example.com"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          }
        }
      }
    },
    "/metrics/filters/path": {
      "parameters": [
        {
          "$ref": "#/components/parameters/startTimeParam"
        },
        {
          "$ref": "#/components/parameters/endTimeParam"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/2"
        },
        {
          "$ref": "#/paths/~1metrics~1bandwidth/parameters/2"
        },
        {
          "$ref": "#/paths/~1metrics~1cpu/parameters/4"
        },
        {
          "$ref": "#/paths/~1metrics~1http-latency/parameters/5"
        },
        {
          "$ref": "#/paths/~1metrics~1filters~1http/parameters/6"
        },
        {
          "$ref": "#/paths/~1metrics~1http-latency/parameters/6"
        }
      ],
      "get": {
        "summary": "List queryable paths",
        "description": "The path suggestions are based on the most recent 5000 log lines as filtered by the provided filters",
        "operationId": "list-path-filter-values",
        "tags": ["Metrics"],
        "responses": {
          "200": {
            "description": "A successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "description": "A collection of suggested paths to filter by",
                  "required": ["items"],
                  "items": {
                    "type": "string",
                    "example": "/user/*"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          }
        }
      }
    },
    "/redis": {
      "get": {
        "tags": ["Redis"],
        "summary": "List Redis instances",
        "description": "List Redis instances matching the provided filters. If no filters are provided, all Redis instances are returned.\n",
        "operationId": "list-redis",
        "parameters": [
          {
            "$ref": "#/components/parameters/nameParam"
          },
          {
            "$ref": "#/components/parameters/regionParam"
          },
          {
            "$ref": "#/components/parameters/createdBeforeParam"
          },
          {
            "$ref": "#/components/parameters/createdAfterParam"
          },
          {
            "$ref": "#/components/parameters/updatedBeforeParam"
          },
          {
            "$ref": "#/components/parameters/updatedAfterParam"
          },
          {
            "$ref": "#/components/parameters/ownerIdParam"
          },
          {
            "$ref": "#/components/parameters/environmentIdParam"
          },
          {
            "$ref": "#/components/parameters/cursorParam"
          },
          {
            "$ref": "#/components/parameters/limitParam"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "redis": {
                        "$ref": "#/components/schemas/redis"
                      },
                      "cursor": {
                        "$ref": "#/components/schemas/cursor"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "409": {
            "$ref": "#/components/responses/409Conflict"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "post": {
        "tags": ["Redis"],
        "summary": "Create Redis instance",
        "description": "Create a new Redis instance.\n",
        "operationId": "create-redis",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/redisPOSTInput"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/redisDetail"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/redis/{redisId}": {
      "get": {
        "tags": ["Redis"],
        "summary": "Retrieve Redis instance",
        "description": "Retrieve a Redis instance by ID.\n",
        "operationId": "retrieve-redis",
        "parameters": [
          {
            "in": "path",
            "name": "redisId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/redisDetail"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "patch": {
        "tags": ["Redis"],
        "summary": "Update Redis instance",
        "description": "Update a Redis instance by ID.\n",
        "operationId": "update-redis",
        "parameters": [
          {
            "in": "path",
            "name": "redisId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/redisPATCHInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Updated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/redisDetail"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "409": {
            "$ref": "#/components/responses/409Conflict"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "delete": {
        "tags": ["Redis"],
        "summary": "Delete Redis instance",
        "description": "Delete a Redis instance by ID.\n",
        "operationId": "delete-redis",
        "parameters": [
          {
            "in": "path",
            "name": "redisId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Redis instance deleted"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/redis/{redisId}/connection-info": {
      "get": {
        "tags": ["Redis"],
        "summary": "Retrieve Redis connection info",
        "description": "Retrieve connection info for a Redis instance by ID. Connection info includes sensitive information.\n",
        "operationId": "retrieve-redis-connection-info",
        "parameters": [
          {
            "in": "path",
            "name": "redisId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/redisConnectionInfo"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/postgres": {
      "get": {
        "tags": ["PostgreSQL"],
        "summary": "List PostgreSQL instances",
        "description": "List PostgreSQL instances matching the provided filters. If no filters are provided, all PostgreSQL instances are returned.\n",
        "operationId": "list-postgres",
        "parameters": [
          {
            "$ref": "#/components/parameters/nameParam"
          },
          {
            "$ref": "#/components/parameters/regionParam"
          },
          {
            "$ref": "#/components/parameters/suspendedParam"
          },
          {
            "$ref": "#/components/parameters/createdBeforeParam"
          },
          {
            "$ref": "#/components/parameters/createdAfterParam"
          },
          {
            "$ref": "#/components/parameters/updatedBeforeParam"
          },
          {
            "$ref": "#/components/parameters/updatedAfterParam"
          },
          {
            "$ref": "#/components/parameters/ownerIdParam"
          },
          {
            "$ref": "#/components/parameters/environmentIdParam"
          },
          {
            "$ref": "#/components/parameters/includeReplicasParam"
          },
          {
            "$ref": "#/components/parameters/cursorParam"
          },
          {
            "$ref": "#/components/parameters/limitParam"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "postgres": {
                        "$ref": "#/components/schemas/postgres"
                      },
                      "cursor": {
                        "$ref": "#/components/schemas/cursor"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "409": {
            "$ref": "#/components/responses/409Conflict"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "post": {
        "tags": ["PostgreSQL"],
        "summary": "Create PostgreSQL instance",
        "description": "Create a new PostgreSQL instance.\n",
        "operationId": "create-postgres",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/postgresPOSTInput"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/postgresDetail"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/postgres/{postgresId}": {
      "get": {
        "tags": ["PostgreSQL"],
        "summary": "Retrieve PostgreSQL instance",
        "description": "Retrieve a PostgreSQL instance by ID.\n",
        "operationId": "retrieve-postgres",
        "parameters": [
          {
            "in": "path",
            "name": "postgresId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/postgresDetail"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "patch": {
        "tags": ["PostgreSQL"],
        "summary": "Update PostgreSQL instance",
        "description": "Update a PostgreSQL instance by ID.\n",
        "operationId": "update-postgres",
        "parameters": [
          {
            "in": "path",
            "name": "postgresId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/postgresPATCHInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Updated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/postgresDetail"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "409": {
            "$ref": "#/components/responses/409Conflict"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "delete": {
        "tags": ["PostgreSQL"],
        "summary": "Delete PostgreSQL instance",
        "description": "Delete a PostgreSQL instance by ID. This operation is irreversible, and\nall data will be lost.\n",
        "operationId": "delete-postgres",
        "parameters": [
          {
            "in": "path",
            "name": "postgresId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "PostgreSQL instance deleted"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/postgres/{postgresId}/connection-info": {
      "get": {
        "tags": ["PostgreSQL"],
        "summary": "Retrieve PostgreSQL connection info",
        "description": "Retrieve connection info for a PostgreSQL instance by ID. Connection info includes sensitive information.\n",
        "operationId": "retrieve-postgres-connection-info",
        "parameters": [
          {
            "in": "path",
            "name": "postgresId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/postgresConnectionInfo"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/postgres/{postgresId}/recovery": {
      "get": {
        "tags": ["PostgreSQL"],
        "summary": "Retrieve point-in-time recovery status",
        "description": "Retrieve information on the availability of PostgreSQL point-in-time recovery for a PostgreSQL instance by ID.\n",
        "operationId": "retrieve-postgres-recovery-info",
        "parameters": [
          {
            "in": "path",
            "name": "postgresId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": ["recoveryStatus"],
                  "properties": {
                    "recoveryStatus": {
                      "type": "string",
                      "description": "Availability of point-in-time recovery.",
                      "enum": ["AVAILABLE", "BACKUP_NOT_READY", "NOT_AVAILABLE"]
                    },
                    "startsAt": {
                      "type": "string",
                      "format": "date-time"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "post": {
        "tags": ["PostgreSQL"],
        "summary": "Trigger point-in-time recovery",
        "description": "Trigger [point-in-time recovery](https://docs.render.com/postgresql-backups#point-in-time-recovery) on the PostgreSQL instance with the provided ID.\n",
        "operationId": "recover-postgres",
        "parameters": [
          {
            "in": "path",
            "name": "postgresId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["restoreTime"],
                "properties": {
                  "restoreName": {
                    "description": "Name of the new database.",
                    "type": "string"
                  },
                  "restoreTime": {
                    "type": "string",
                    "format": "date-time",
                    "description": "The point in time to restore the database to. See `/recovery-info` for restore availability"
                  },
                  "datadogApiKey": {
                    "type": "string",
                    "description": "Datadog API key to use for monitoring the new database. Defaults to the API key of the original database. Use an empty string to prevent copying of the API key to the new database."
                  },
                  "plan": {
                    "type": "string",
                    "description": "The plan to use for the new database. Defaults to the same plan as the original database. Cannot be a lower tier plan than the original database."
                  },
                  "environmentId": {
                    "type": "string",
                    "description": "The environment to create the new database in. Defaults to the environment of the original database."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Recovery initiated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/postgresDetail"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/postgres/{postgresId}/suspend": {
      "parameters": [
        {
          "in": "path",
          "name": "postgresId",
          "required": true,
          "schema": {
            "type": "string"
          }
        }
      ],
      "post": {
        "summary": "Suspend PostgreSQL instance",
        "description": "Suspend a PostgreSQL instance by ID.\n",
        "operationId": "suspend-postgres",
        "tags": ["PostgreSQL"],
        "responses": {
          "202": {
            "description": "Service suspended successfully"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/postgres/{postgresId}/resume": {
      "parameters": [
        {
          "in": "path",
          "name": "postgresId",
          "required": true,
          "schema": {
            "type": "string"
          }
        }
      ],
      "post": {
        "summary": "Resume PostgreSQL instance",
        "description": "Resume a PostgreSQL instance by ID.\n",
        "operationId": "resume-postgres",
        "tags": ["PostgreSQL"],
        "responses": {
          "202": {
            "description": "Service resumed successfully"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/postgres/{postgresId}/restart": {
      "parameters": [
        {
          "in": "path",
          "name": "postgresId",
          "required": true,
          "schema": {
            "type": "string"
          }
        }
      ],
      "post": {
        "summary": "Restart PostgreSQL instance",
        "description": "Restart a PostgreSQL instance by ID.\n",
        "operationId": "restart-postgres",
        "tags": ["PostgreSQL"],
        "responses": {
          "202": {
            "description": "Service restarted successfully"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/postgres/{postgresId}/failover": {
      "parameters": [
        {
          "in": "path",
          "name": "postgresId",
          "required": true,
          "schema": {
            "type": "string"
          }
        }
      ],
      "post": {
        "summary": "Failover PostgreSQL instance",
        "description": "Failover a [highly available PostgreSQL](https://docs.render.com/postgresql-high-availability) instance.\n",
        "operationId": "failover-postgres",
        "tags": ["PostgreSQL"],
        "responses": {
          "202": {
            "description": "Service failed over successfully"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/postgres/{postgresId}/backup": {
      "parameters": [
        {
          "in": "path",
          "name": "postgresId",
          "required": true,
          "schema": {
            "type": "string"
          }
        }
      ],
      "get": {
        "summary": "List PostgreSQL backups",
        "description": "List [backups](https://docs.render.com/postgresql-backups#standard-backups) for a PostgreSQL instance by ID. Returns a URL to download the backup.\n",
        "operationId": "list-postgres-backup",
        "tags": ["PostgreSQL"],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "required": ["id", "createdAt"],
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "createdAt": {
                        "type": "string",
                        "format": "date-time"
                      },
                      "url": {
                        "type": "string",
                        "description": "URL to download the Postgres backup"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "post": {
        "summary": "Create PostgreSQL backup",
        "description": "Create a [backup](https://docs.render.com/postgresql-backups#standard-backups) of a PostgreSQL instance by ID.\n",
        "operationId": "create-postgres-backup",
        "tags": ["PostgreSQL"],
        "responses": {
          "202": {
            "description": "Backup started successfully"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "406": {
            "$ref": "#/components/responses/406NotAcceptable"
          },
          "410": {
            "$ref": "#/components/responses/410Gone"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/projects": {
      "get": {
        "tags": ["Projects & Environments"],
        "summary": "List projects",
        "description": "List projects matching the provided filters. If no filters are provided, all projects are returned.\n",
        "operationId": "list-projects",
        "parameters": [
          {
            "$ref": "#/components/parameters/nameParam"
          },
          {
            "$ref": "#/components/parameters/createdBeforeParam"
          },
          {
            "$ref": "#/components/parameters/createdAfterParam"
          },
          {
            "$ref": "#/components/parameters/updatedBeforeParam"
          },
          {
            "$ref": "#/components/parameters/updatedAfterParam"
          },
          {
            "$ref": "#/components/parameters/ownerIdParam"
          },
          {
            "$ref": "#/components/parameters/cursorParam"
          },
          {
            "$ref": "#/components/parameters/limitParam"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/projectWithCursor"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "post": {
        "tags": ["Projects & Environments"],
        "summary": "Create project",
        "description": "Create a new project.\n",
        "operationId": "create-project",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/projectPOSTInput"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/project"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/projects/{projectId}": {
      "get": {
        "tags": ["Projects & Environments"],
        "summary": "Retrieve Project",
        "description": "Retrieve the project with the provided ID.\n",
        "operationId": "retrieve-project",
        "parameters": [
          {
            "in": "path",
            "name": "projectId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/project"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "patch": {
        "tags": ["Projects & Environments"],
        "summary": "Update project",
        "description": "Update the details of a project.\n\nTo update the details of a particular _environment_ in the project, instead use the [Update environment](https://api-docs.render.com/reference/update-environment) endpoint.\n",
        "operationId": "update-project",
        "parameters": [
          {
            "in": "path",
            "name": "projectId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/projectPATCHInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Updated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/project"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "delete": {
        "tags": ["Projects & Environments"],
        "summary": "Delete project",
        "description": "Delete the project with the provided ID, along with all environments and services in that project.\n\n**This operation is irreversible.** All services and other resources belonging to the project will be deleted.\n",
        "operationId": "delete-project",
        "parameters": [
          {
            "in": "path",
            "name": "projectId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Project deleted"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/environments": {
      "post": {
        "tags": ["Projects & Environments"],
        "summary": "Create environment",
        "description": "Create a new environment belonging to the project with the provided ID.\n",
        "operationId": "create-environment",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/environmentPOSTInput"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/environment"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "get": {
        "tags": ["Projects & Environments"],
        "summary": "List environments",
        "description": "List a particular project's environments matching the provided filters. If no filters are provided, all environments are returned.\n",
        "operationId": "list-environments",
        "parameters": [
          {
            "$ref": "#/components/parameters/nameParam"
          },
          {
            "$ref": "#/components/parameters/projectIdParam"
          },
          {
            "$ref": "#/components/parameters/createdBeforeParam"
          },
          {
            "$ref": "#/components/parameters/createdAfterParam"
          },
          {
            "$ref": "#/components/parameters/updatedBeforeParam"
          },
          {
            "$ref": "#/components/parameters/updatedAfterParam"
          },
          {
            "$ref": "#/components/parameters/ownerIdParam"
          },
          {
            "$ref": "#/components/parameters/environmentIdParam"
          },
          {
            "$ref": "#/components/parameters/cursorParam"
          },
          {
            "$ref": "#/components/parameters/limitParam"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/environmentWithCursor"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/environments/{environmentId}": {
      "get": {
        "parameters": [
          {
            "in": "path",
            "name": "environmentId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": ["Projects & Environments"],
        "summary": "Retrieve environment",
        "description": "Retrieve the environment with the provided ID.",
        "operationId": "retrieve-environment",
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/environment"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "patch": {
        "parameters": [
          {
            "in": "path",
            "name": "environmentId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": ["Projects & Environments"],
        "summary": "Update environment",
        "description": "Update the details of the environment with the provided ID.",
        "operationId": "update-environment",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/environmentPATCHInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Updated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/environment"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "delete": {
        "parameters": [
          {
            "in": "path",
            "name": "environmentId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "tags": ["Projects & Environments"],
        "summary": "Delete environment",
        "description": "Delete the environment with the provided ID, along with all resources that belong to it.\n\n**This operation is irreversible.** All services and other resources belonging to the environment will be deleted.\n",
        "operationId": "delete-environment",
        "responses": {
          "204": {
            "description": "Environment deleted"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/environments/{environmentId}/resources": {
      "post": {
        "description": "Add resources to the environment with the provided ID.\n",
        "parameters": [
          {
            "in": "path",
            "name": "environmentId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/environmentResourcesPOSTInput"
              }
            }
          }
        },
        "tags": ["Projects & Environments"],
        "summary": "Add resources to environment",
        "operationId": "add-resources-to-environment",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/environment"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "delete": {
        "description": "Remove resources from the environment with the provided ID.\n",
        "parameters": [
          {
            "in": "path",
            "name": "environmentId",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "resourceIds",
            "required": true,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "description": "The ID of an env group, a service, a PostgreSQL database, or a Redis instance"
              }
            }
          }
        ],
        "tags": ["Projects & Environments"],
        "operationId": "remove-resources-from-environment",
        "summary": "Remove resources from environment",
        "responses": {
          "204": {
            "description": "Resources removed from environment"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/env-groups": {
      "get": {
        "operationId": "list-env-groups",
        "tags": ["Environment Groups"],
        "summary": "List environment groups",
        "description": "List environment groups matching the provided filters. If no filters are provided, all environment groups are returned.\n",
        "parameters": [
          {
            "$ref": "#/components/parameters/nameParam"
          },
          {
            "$ref": "#/components/parameters/createdBeforeParam"
          },
          {
            "$ref": "#/components/parameters/createdAfterParam"
          },
          {
            "$ref": "#/components/parameters/updatedBeforeParam"
          },
          {
            "$ref": "#/components/parameters/updatedAfterParam"
          },
          {
            "$ref": "#/components/parameters/ownerIdParam"
          },
          {
            "$ref": "#/components/parameters/environmentIdParam"
          },
          {
            "$ref": "#/components/parameters/cursorParam"
          },
          {
            "$ref": "#/components/parameters/limitParam"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/envGroupMeta"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "post": {
        "operationId": "create-env-group",
        "tags": ["Environment Groups"],
        "summary": "Create environment group",
        "description": "Create a new environment group.\n",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/envGroupPOSTInput"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/envGroup"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/env-groups/{envGroupId}": {
      "get": {
        "operationId": "retrieve-env-group",
        "tags": ["Environment Groups"],
        "summary": "Retrieve environment group",
        "description": "Retrieve an environment group by ID.\n",
        "parameters": [
          {
            "$ref": "#/components/parameters/envGroupIdParam"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/envGroup"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "patch": {
        "operationId": "update-env-group",
        "tags": ["Environment Groups"],
        "summary": "Update environment group",
        "description": "Update the attributes of an environment group.",
        "parameters": [
          {
            "in": "path",
            "name": "envGroupId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/envGroupPATCHInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Updated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/envGroup"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "delete": {
        "operationId": "delete-env-group",
        "tags": ["Environment Groups"],
        "summary": "Delete environment group",
        "description": "Delete the environment group with the provided ID, including all environment variables and secret files it contains.",
        "parameters": [
          {
            "in": "path",
            "name": "envGroupId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "environment group deleted"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/env-groups/{envGroupId}/services/{serviceId}": {
      "post": {
        "operationId": "link-service-to-env-group",
        "tags": ["Environment Groups"],
        "summary": "Link service",
        "description": "Link a particular service to a particular environment group.\n\nThe linked service will have access to the environment variables and secret files in the group.\n",
        "parameters": [
          {
            "$ref": "#/components/parameters/envGroupIdParam"
          },
          {
            "$ref": "#/components/parameters/serviceIdParam"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/envGroup"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "delete": {
        "operationId": "unlink-service-from-env-group",
        "tags": ["Environment Groups"],
        "summary": "Unlink service",
        "description": "Unlink a particular service from a particular environment group.\n\nThe service will lose access to the environment variables and secret files in the group.\n",
        "parameters": [
          {
            "in": "path",
            "name": "envGroupId",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "serviceId",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "service unlinked from environment group"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/env-groups/{envGroupId}/env-vars/{envVarKey}": {
      "get": {
        "operationId": "retrieve-env-group-env-var",
        "tags": ["Environment Groups"],
        "summary": "Retrieve environment variable",
        "description": "Retrieve a particular environment variable in a particular environment group.\n",
        "parameters": [
          {
            "$ref": "#/components/parameters/envGroupIdParam"
          },
          {
            "$ref": "#/components/parameters/envVarKeyParam"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/envVar"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "put": {
        "operationId": "update-env-group-env-var",
        "tags": ["Environment Groups"],
        "summary": "Add or update environment variable",
        "description": "Add or update a particular environment variable in a particular environment group.\n",
        "parameters": [
          {
            "$ref": "#/components/parameters/envGroupIdParam"
          },
          {
            "$ref": "#/components/parameters/envVarKeyParam"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/addUpdateEnvVarInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/envGroup"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "delete": {
        "operationId": "delete-env-group-env-var",
        "tags": ["Environment Groups"],
        "summary": "Remove environment variable",
        "description": "Remove a particular environment variable from a particular environment group.\n",
        "parameters": [
          {
            "in": "path",
            "name": "envGroupId",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/envVarKeyParam"
          }
        ],
        "responses": {
          "204": {
            "description": "environment variable removed from environment group"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/env-groups/{envGroupId}/secret-files/{secretFileName}": {
      "get": {
        "operationId": "retrieve-env-group-secret-file",
        "tags": ["Environment Groups"],
        "summary": "Retrieve secret file",
        "description": "Retrieve a particular secret file in a particular environment group.\n",
        "parameters": [
          {
            "$ref": "#/components/parameters/envGroupIdParam"
          },
          {
            "$ref": "#/components/parameters/secretFileNameParam"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/secretFile"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "put": {
        "operationId": "update-env-group-secret-file",
        "tags": ["Environment Groups"],
        "summary": "Add or update secret file",
        "description": "Add or update a particular secret file in an particular environment group.\n",
        "parameters": [
          {
            "in": "path",
            "name": "envGroupId",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "secretFileName",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "content": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/envGroup"
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "delete": {
        "operationId": "delete-env-group-secret-file",
        "tags": ["Environment Groups"],
        "summary": "Remove secret file",
        "description": "Remove a particular secret file from a particular environment group.\n",
        "parameters": [
          {
            "$ref": "#/components/parameters/envGroupIdParam"
          },
          {
            "$ref": "#/components/parameters/secretFileNameParam"
          }
        ],
        "responses": {
          "204": {
            "description": "secret file removed from environment group"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/maintenance": {
      "get": {
        "tags": ["Maintenance"],
        "summary": "List maintenance runs",
        "description": "List scheduled and/or recent maintenance runs for specified resources.\n",
        "operationId": "list-maintenance",
        "parameters": [
          {
            "name": "resourceId",
            "in": "query",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "description": "The Id of a resource that can undergo maintenance (Id of a service, a Postgres instance, or a Redis instance)"
              }
            },
            "style": "form",
            "explode": false,
            "required": false
          },
          {
            "$ref": "#/components/parameters/ownerIdParam"
          },
          {
            "name": "state",
            "in": "query",
            "required": false,
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "scheduled",
                  "in_progress",
                  "user_fix_required",
                  "cancelled",
                  "succeeded",
                  "failed"
                ]
              }
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/paths/~1maintenance~1%7BmaintenanceRunParam%7D/get/responses/200/content/application~1json/schema"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/maintenance/{maintenanceRunParam}": {
      "get": {
        "tags": ["Maintenance"],
        "summary": "Retrieve maintenance run",
        "description": "Retrieve the maintenance run with the provided ID.",
        "operationId": "retrieve-maintenance",
        "parameters": [
          {
            "name": "maintenanceRunParam",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^mrn-[0-9a-z]{20}$",
              "example": "mrn-cph1rs3idesc73a2b2mg"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "id",
                    "type",
                    "scheduledAt",
                    "state",
                    "resourceId"
                  ],
                  "properties": {
                    "id": {
                      "$ref": "#/paths/~1maintenance~1%7BmaintenanceRunParam%7D/get/parameters/0/schema"
                    },
                    "type": {
                      "type": "string"
                    },
                    "scheduledAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "pendingMaintenanceBy": {
                      "type": "string",
                      "format": "date-time",
                      "description": "If present, the maintenance run cannot be scheduled for later than this date-time."
                    },
                    "state": {
                      "$ref": "#/paths/~1maintenance/get/parameters/2/schema/items"
                    },
                    "resourceId": {
                      "$ref": "#/paths/~1maintenance/get/parameters/0/schema/items"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      },
      "patch": {
        "tags": ["Maintenance"],
        "summary": "Update maintenance run",
        "description": "Update the maintenance run with the provided ID.\n\nUpdates from this endpoint are asynchronous. To check your update's status, use the [Retrieve maintenance run](https://api-docs.render.com/reference/retrieve-maintenance) endpoint.\n",
        "operationId": "update-maintenance",
        "parameters": [
          {
            "$ref": "#/paths/~1maintenance~1%7BmaintenanceRunParam%7D/get/parameters/0"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "scheduledAt": {
                    "description": "The date-time at which the maintenance is scheduled to start. This must be before the pendingMaintenanceBy date-time.",
                    "type": "string",
                    "format": "date-time"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Maintenance run updated"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    },
    "/maintenance/{maintenanceRunParam}/trigger": {
      "post": {
        "tags": ["Maintenance"],
        "summary": "Trigger maintenance run",
        "description": "Trigger the scheduled maintenance run with the provided ID.\n\nTriggering maintenance is asynchronous. To check whether maintenance has started, use the [Retrieve maintenance run](https://api-docs.render.com/reference/retrieve-maintenance) endpoint.\n\nAs maintenance progresses, the run's `state` will change from `scheduled` to other values, such as `in_progress` and `succeeded`.\n",
        "operationId": "trigger-maintenance",
        "parameters": [
          {
            "$ref": "#/paths/~1maintenance~1%7BmaintenanceRunParam%7D/get/parameters/0"
          }
        ],
        "responses": {
          "202": {
            "description": "Maintenance run triggered"
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/404NotFound"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/503ServiceUnavailable"
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer"
      }
    },
    "parameters": {
      "cursorParam": {
        "name": "cursor",
        "in": "query",
        "required": false,
        "description": "The position in the result list to start from when fetching paginated results. For details, see [Pagination](https://api-docs.render.com/reference/pagination).",
        "schema": {
          "type": "string"
        }
      },
      "customDomainIdOrNameParam": {
        "name": "customDomainIdOrName",
        "in": "path",
        "required": true,
        "description": "The ID or name of the custom domain",
        "schema": {
          "type": "string"
        }
      },
      "deployIdParam": {
        "name": "deployId",
        "in": "path",
        "required": true,
        "description": "The ID of the deploy",
        "schema": {
          "type": "string"
        }
      },
      "limitParam": {
        "name": "limit",
        "in": "query",
        "required": false,
        "description": "The maximum number of items to return. For details, see [Pagination](https://api-docs.render.com/reference/pagination).",
        "schema": {
          "type": "integer",
          "default": 20,
          "minimum": 1,
          "maximum": 100,
          "description": "Defaults to 20"
        }
      },
      "ownerIdPathParam": {
        "name": "ownerId",
        "in": "path",
        "description": "The ID of the owner (team or personal user) whose resources should be returned",
        "schema": {
          "type": "string"
        },
        "required": true
      },
      "ownerIdParam": {
        "name": "ownerId",
        "in": "query",
        "description": "The ID of the owner (team or personal user) whose resources should be returned",
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "style": "form",
        "explode": false,
        "required": false
      },
      "serviceIdParam": {
        "name": "serviceId",
        "in": "path",
        "required": true,
        "description": "The ID of the service",
        "schema": {
          "type": "string"
        }
      },
      "cronJobIdParam": {
        "name": "cronJobId",
        "in": "path",
        "required": true,
        "description": "The ID of the cron job",
        "schema": {
          "type": "string"
        }
      },
      "serviceIdsParam": {
        "name": "serviceId",
        "in": "query",
        "description": "Filter for resources by service ID",
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "style": "form",
        "required": false
      },
      "startTimeParam": {
        "name": "startTime",
        "in": "query",
        "schema": {
          "type": "string",
          "format": "date-time",
          "example": "2021-06-17T08:15:30Z"
        },
        "required": false,
        "description": "Epoch/Unix timestamp of end of time range to return. Defaults to `now() - 1 hour`."
      },
      "endTimeParam": {
        "name": "endTime",
        "in": "query",
        "schema": {
          "type": "string",
          "format": "date-time",
          "example": "2021-06-17T08:30:30Z"
        },
        "required": false,
        "description": "Epoch/Unix timestamp of end of time range to return. Defaults to `now()`."
      },
      "nameParam": {
        "name": "name",
        "in": "query",
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "style": "form",
        "explode": false,
        "required": false,
        "description": "Filter by name"
      },
      "serviceTypeParam": {
        "name": "type",
        "in": "query",
        "schema": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/serviceType"
          }
        },
        "style": "form",
        "explode": false,
        "required": false,
        "description": "Filter for types of services"
      },
      "envParam": {
        "name": "env",
        "in": "query",
        "schema": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/serviceRuntime"
          }
        },
        "style": "form",
        "explode": false,
        "required": false,
        "description": "Filter for environments (runtimes) of services"
      },
      "regionParam": {
        "name": "region",
        "in": "query",
        "schema": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/region"
          }
        },
        "style": "form",
        "explode": false,
        "required": false,
        "description": "Filter by resource region"
      },
      "suspendedParam": {
        "name": "suspended",
        "in": "query",
        "schema": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": ["suspended", "not_suspended"]
          }
        },
        "style": "form",
        "explode": false,
        "required": false,
        "description": "Filter resources based on whether they're suspended or not suspended"
      },
      "createdBeforeParam": {
        "name": "createdBefore",
        "in": "query",
        "schema": {
          "type": "string",
          "format": "date-time"
        },
        "required": false,
        "description": "Filter for resources created before a certain time (specified as an ISO 8601 timestamp)",
        "example": "2021-06-17T08:15:30Z"
      },
      "createdAfterParam": {
        "name": "createdAfter",
        "in": "query",
        "schema": {
          "type": "string",
          "format": "date-time"
        },
        "required": false,
        "description": "Filter for resources created after a certain time (specified as an ISO 8601 timestamp)",
        "example": "2021-02-17T08:15:30Z"
      },
      "updatedBeforeParam": {
        "name": "updatedBefore",
        "in": "query",
        "schema": {
          "type": "string",
          "format": "date-time"
        },
        "required": false,
        "description": "Filter for resources updated before a certain time (specified as an ISO 8601 timestamp)",
        "example": "2021-06-17T08:15:30Z"
      },
      "updatedAfterParam": {
        "name": "updatedAfter",
        "in": "query",
        "schema": {
          "type": "string",
          "format": "date-time"
        },
        "required": false,
        "description": "Filter for resources updated after a certain time (specified as an ISO 8601 timestamp)",
        "example": "2021-06-17T08:15:30Z"
      },
      "projectIdParam": {
        "name": "projectId",
        "in": "query",
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "style": "form",
        "explode": false,
        "required": true,
        "description": "Filter for resources that belong to a project"
      },
      "environmentIdParam": {
        "name": "environmentId",
        "in": "query",
        "schema": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "style": "form",
        "explode": false,
        "required": false,
        "description": "Filter for resources that belong to an environment"
      },
      "includeReplicasParam": {
        "name": "includeReplicas",
        "in": "query",
        "schema": {
          "type": "boolean",
          "default": true
        },
        "required": false,
        "description": "Include replicas in the response"
      },
      "envGroupIdParam": {
        "name": "envGroupId",
        "in": "path",
        "required": true,
        "schema": {
          "type": "string"
        },
        "description": "Filter for resources that belong to an environment group"
      },
      "envVarKeyParam": {
        "name": "envVarKey",
        "in": "path",
        "required": true,
        "schema": {
          "type": "string"
        },
        "description": "The name of the environment variable"
      },
      "secretFileNameParam": {
        "name": "secretFileName",
        "in": "path",
        "required": true,
        "schema": {
          "type": "string"
        },
        "description": "The name of the secret file"
      },
      "eventTypeParam": {
        "name": "eventType",
        "in": "query",
        "description": "The type of event to filter to",
        "required": false,
        "schema": {
          "anyOf": [
            {
              "type": "string",
              "enum": [
                "autoscaling_config_changed",
                "autoscaling_ended",
                "autoscaling_started",
                "branch_deleted",
                "build_ended",
                "build_plan_changed",
                "build_started",
                "commit_ignored",
                "cron_job_run_ended",
                "cron_job_run_started",
                "deploy_ended",
                "deploy_started",
                "disk_created",
                "disk_updated",
                "disk_deleted",
                "image_pull_failed",
                "initial_deploy_hook_ended",
                "initial_deploy_hook_started",
                "instance_count_changed",
                "job_run_ended",
                "maintenance_ended",
                "maintenance_started",
                "plan_changed",
                "pre_deploy_ended",
                "pre_deploy_started",
                "server_available",
                "server_failed",
                "server_hardware_failure",
                "server_restarted",
                "server_unhealthy",
                "service_resumed",
                "service_suspended",
                "suspender_added",
                "suspender_removed",
                "zero_downtime_redeploy_ended",
                "zero_downtime_redeploy_started"
              ]
            }
          ]
        }
      }
    },
    "schemas": {
      "cursor": {
        "type": "string"
      },
      "service": {
        "type": "object",
        "required": [
          "id",
          "name",
          "ownerId",
          "type",
          "createdAt",
          "dashboardUrl",
          "updatedAt",
          "suspended",
          "suspenders",
          "autoDeploy",
          "notifyOnFail",
          "slug",
          "serviceDetails",
          "rootDir"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "autoDeploy": {
            "$ref": "#/components/schemas/autoDeploy"
          },
          "branch": {
            "type": "string"
          },
          "buildFilter": {
            "$ref": "#/components/schemas/buildFilter"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "dashboardUrl": {
            "type": "string",
            "description": "The URL to view the service in the Render Dashboard"
          },
          "environmentId": {
            "type": "string"
          },
          "imagePath": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "notifyOnFail": {
            "$ref": "#/components/schemas/notifySetting"
          },
          "ownerId": {
            "type": "string"
          },
          "registryCredential": {
            "$ref": "#/components/schemas/registryCredentialSummary"
          },
          "repo": {
            "type": "string",
            "example": "https://github.com/render-examples/flask-hello-world"
          },
          "rootDir": {
            "type": "string"
          },
          "slug": {
            "type": "string"
          },
          "suspended": {
            "type": "string",
            "enum": ["suspended", "not_suspended"]
          },
          "suspenders": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/suspenderType"
            }
          },
          "type": {
            "$ref": "#/components/schemas/serviceType"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          },
          "serviceDetails": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/staticSiteDetails"
              },
              {
                "$ref": "#/components/schemas/webServiceDetails"
              },
              {
                "$ref": "#/components/schemas/privateServiceDetails"
              },
              {
                "$ref": "#/components/schemas/backgroundWorkerDetails"
              },
              {
                "$ref": "#/components/schemas/cronJobDetails"
              }
            ]
          }
        }
      },
      "serviceAndDeploy": {
        "type": "object",
        "properties": {
          "service": {
            "$ref": "#/components/schemas/service"
          },
          "deployId": {
            "type": "string"
          }
        }
      },
      "autoDeploy": {
        "type": "string",
        "enum": ["yes", "no"],
        "default": "yes"
      },
      "buildFilter": {
        "type": "object",
        "required": ["paths", "ignoredPaths"],
        "properties": {
          "paths": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "ignoredPaths": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "registryCredentialSummary": {
        "type": "object",
        "required": ["id", "name"],
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          }
        }
      },
      "registryCredentialRegistry": {
        "type": "string",
        "enum": ["GITHUB", "GITLAB", "DOCKER", "GOOGLE_ARTIFACT"],
        "description": "The registry to use this credential with"
      },
      "registryCredential": {
        "type": "object",
        "required": ["id", "name", "username", "registry"],
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier for this credential"
          },
          "name": {
            "type": "string",
            "description": "Descriptive name for this credential"
          },
          "registry": {
            "$ref": "#/components/schemas/registryCredentialRegistry"
          },
          "username": {
            "type": "string",
            "description": "The username associated with the credential"
          }
        }
      },
      "image": {
        "type": "object",
        "required": ["imagePath", "ownerId"],
        "properties": {
          "ownerId": {
            "type": "string",
            "description": "The ID of the owner for this image. This should match the owner of the service as well as the owner of any specified registry credential."
          },
          "registryCredentialId": {
            "type": "string",
            "description": "Optional reference to the registry credential passed to the image repository to retrieve this image."
          },
          "imagePath": {
            "type": "string",
            "description": "Path to the image used for this server (e.g docker.io/library/nginx:latest)."
          }
        }
      },
      "dockerDetails": {
        "type": "object",
        "required": ["dockerCommand", "dockerContext", "dockerfilePath"],
        "properties": {
          "dockerCommand": {
            "type": "string"
          },
          "dockerContext": {
            "type": "string"
          },
          "dockerfilePath": {
            "type": "string"
          },
          "preDeployCommand": {
            "type": "string"
          },
          "registryCredential": {
            "$ref": "#/components/schemas/registryCredential"
          }
        }
      },
      "nativeEnvironmentDetails": {
        "type": "object",
        "required": ["buildCommand", "startCommand"],
        "properties": {
          "buildCommand": {
            "type": "string"
          },
          "startCommand": {
            "type": "string"
          },
          "preDeployCommand": {
            "type": "string"
          }
        }
      },
      "staticSiteDetails": {
        "type": "object",
        "required": [
          "buildCommand",
          "publishPath",
          "pullRequestPreviewsEnabled",
          "url",
          "buildPlan"
        ],
        "properties": {
          "buildCommand": {
            "type": "string"
          },
          "parentServer": {
            "$ref": "#/components/schemas/resource"
          },
          "publishPath": {
            "type": "string"
          },
          "pullRequestPreviewsEnabled": {
            "$ref": "#/components/schemas/pullRequestPreviewsEnabled"
          },
          "url": {
            "type": "string"
          },
          "buildPlan": {
            "$ref": "#/components/schemas/buildPlan"
          }
        }
      },
      "maxShutdownDelaySeconds": {
        "type": "integer",
        "description": "The maximum amount of time (in seconds) that Render waits for your application process to exit gracefully after sending it a SIGTERM signal.",
        "minimum": 1,
        "maximum": 300,
        "default": 30
      },
      "webServiceDetails": {
        "type": "object",
        "required": [
          "env",
          "envSpecificDetails",
          "plan",
          "region",
          "pullRequestPreviewsEnabled",
          "numInstances",
          "buildPlan",
          "healthCheckPath",
          "openPorts",
          "url"
        ],
        "properties": {
          "autoscaling": {
            "type": "object",
            "required": ["enabled", "min", "max", "criteria"],
            "properties": {
              "enabled": {
                "type": "boolean",
                "default": false
              },
              "min": {
                "type": "integer",
                "description": "The minimum number of instances for the service"
              },
              "max": {
                "type": "integer",
                "description": "The maximum number of instances for the service"
              },
              "criteria": {
                "type": "object",
                "required": ["cpu", "memory"],
                "properties": {
                  "cpu": {
                    "type": "object",
                    "required": ["enabled", "percentage"],
                    "properties": {
                      "enabled": {
                        "type": "boolean",
                        "default": false
                      },
                      "percentage": {
                        "type": "integer",
                        "description": "Determines when your service will be scaled. If the average resource utilization is significantly above/below the target, we will increase/decrease the number of instances.\n"
                      }
                    }
                  },
                  "memory": {
                    "$ref": "#/components/schemas/webServiceDetails/properties/autoscaling/properties/criteria/properties/cpu"
                  }
                }
              }
            }
          },
          "disk": {
            "type": "object",
            "required": ["id", "name", "sizeGB", "mountPath"],
            "properties": {
              "id": {
                "$ref": "#/paths/~1disks~1%7BdiskId%7D/parameters/0/schema"
              },
              "name": {
                "type": "string"
              },
              "sizeGB": {
                "type": "integer"
              },
              "mountPath": {
                "type": "string"
              }
            }
          },
          "env": {
            "$ref": "#/components/schemas/serviceRuntime"
          },
          "envSpecificDetails": {
            "$ref": "#/components/schemas/envSpecificDetails"
          },
          "healthCheckPath": {
            "type": "string"
          },
          "numInstances": {
            "type": "integer",
            "description": "For a *manually* scaled service, this is the number of instances the service is scaled to. DOES NOT indicate the number of running instances for an *autoscaled* service."
          },
          "openPorts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/serverPort"
            }
          },
          "parentServer": {
            "$ref": "#/components/schemas/resource"
          },
          "plan": {
            "$ref": "#/components/schemas/plan"
          },
          "pullRequestPreviewsEnabled": {
            "$ref": "#/components/schemas/pullRequestPreviewsEnabled"
          },
          "region": {
            "$ref": "#/components/schemas/region"
          },
          "url": {
            "type": "string"
          },
          "buildPlan": {
            "$ref": "#/components/schemas/buildPlan"
          },
          "maxShutdownDelaySeconds": {
            "$ref": "#/components/schemas/maxShutdownDelaySeconds"
          }
        }
      },
      "envSpecificDetails": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/dockerDetails"
          },
          {
            "$ref": "#/components/schemas/nativeEnvironmentDetails"
          }
        ]
      },
      "envSpecificDetailsPATCH": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/dockerDetailsPATCH"
          },
          {
            "$ref": "#/components/schemas/nativeEnvironmentDetailsPATCH"
          }
        ]
      },
      "envSpecificDetailsPOST": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/dockerDetailsPOST"
          },
          {
            "$ref": "#/components/schemas/nativeEnvironmentDetailsPOST"
          }
        ]
      },
      "resource": {
        "required": ["id", "name"],
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          }
        }
      },
      "privateServiceDetails": {
        "type": "object",
        "required": [
          "env",
          "envSpecificDetails",
          "plan",
          "region",
          "pullRequestPreviewsEnabled",
          "numInstances",
          "buildPlan",
          "openPorts",
          "url"
        ],
        "properties": {
          "autoscaling": {
            "$ref": "#/components/schemas/webServiceDetails/properties/autoscaling"
          },
          "disk": {
            "$ref": "#/components/schemas/webServiceDetails/properties/disk"
          },
          "env": {
            "$ref": "#/components/schemas/serviceRuntime"
          },
          "envSpecificDetails": {
            "$ref": "#/components/schemas/envSpecificDetails"
          },
          "numInstances": {
            "type": "integer",
            "description": "For a *manually* scaled service, this is the number of instances the service is scaled to. DOES NOT indicate the number of running instances for an *autoscaled* service."
          },
          "openPorts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/serverPort"
            }
          },
          "parentServer": {
            "$ref": "#/components/schemas/resource"
          },
          "plan": {
            "$ref": "#/components/schemas/plan"
          },
          "pullRequestPreviewsEnabled": {
            "$ref": "#/components/schemas/pullRequestPreviewsEnabled"
          },
          "region": {
            "$ref": "#/components/schemas/region"
          },
          "url": {
            "type": "string"
          },
          "buildPlan": {
            "$ref": "#/components/schemas/buildPlan"
          },
          "maxShutdownDelaySeconds": {
            "$ref": "#/components/schemas/maxShutdownDelaySeconds"
          }
        }
      },
      "serviceDisk": {
        "type": "object",
        "required": ["name", "mountPath"],
        "properties": {
          "name": {
            "type": "string"
          },
          "mountPath": {
            "type": "string"
          },
          "sizeGB": {
            "type": "integer",
            "minimum": 1,
            "description": "Defaults to 1"
          }
        }
      },
      "diskWithCursor": {
        "required": ["disk", "cursor"],
        "type": "object",
        "properties": {
          "disk": {
            "type": "object",
            "required": [
              "id",
              "name",
              "sizeGB",
              "mountPath",
              "createdAt",
              "updatedAt"
            ],
            "properties": {
              "id": {
                "$ref": "#/paths/~1disks~1%7BdiskId%7D/parameters/0/schema"
              },
              "name": {
                "type": "string"
              },
              "sizeGB": {
                "type": "integer"
              },
              "mountPath": {
                "type": "string"
              },
              "serviceId": {
                "type": "string"
              },
              "createdAt": {
                "type": "string",
                "format": "date-time"
              },
              "updatedAt": {
                "type": "string",
                "format": "date-time"
              }
            }
          },
          "cursor": {
            "$ref": "#/components/schemas/cursor"
          }
        }
      },
      "instanceId": {
        "description": "When a service with a disk is scaled, the instanceId is used to identify the instance that the disk is attached to. Each instance's disks get their own snapshots, and can be restored separately.",
        "type": "string"
      },
      "diskSnapshot": {
        "type": "object",
        "properties": {
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "snapshotKey": {
            "type": "string"
          },
          "instanceId": {
            "$ref": "#/components/schemas/instanceId"
          }
        }
      },
      "snapshotRestorePOST": {
        "type": "object",
        "required": ["snapshotKey"],
        "properties": {
          "snapshotKey": {
            "type": "string"
          },
          "instanceId": {
            "$ref": "#/components/schemas/instanceId"
          }
        }
      },
      "backgroundWorkerDetails": {
        "type": "object",
        "required": [
          "env",
          "envSpecificDetails",
          "plan",
          "region",
          "pullRequestPreviewsEnabled",
          "numInstances",
          "buildPlan"
        ],
        "properties": {
          "autoscaling": {
            "$ref": "#/components/schemas/webServiceDetails/properties/autoscaling"
          },
          "disk": {
            "$ref": "#/components/schemas/webServiceDetails/properties/disk"
          },
          "env": {
            "$ref": "#/components/schemas/serviceRuntime"
          },
          "envSpecificDetails": {
            "$ref": "#/components/schemas/envSpecificDetails"
          },
          "numInstances": {
            "type": "integer",
            "description": "For a *manually* scaled service, this is the number of instances the service is scaled to. DOES NOT indicate the number of running instances for an *autoscaled* service."
          },
          "parentServer": {
            "$ref": "#/components/schemas/resource"
          },
          "plan": {
            "$ref": "#/components/schemas/plan"
          },
          "pullRequestPreviewsEnabled": {
            "$ref": "#/components/schemas/pullRequestPreviewsEnabled"
          },
          "region": {
            "$ref": "#/components/schemas/region"
          },
          "buildPlan": {
            "$ref": "#/components/schemas/buildPlan"
          },
          "maxShutdownDelaySeconds": {
            "$ref": "#/components/schemas/maxShutdownDelaySeconds"
          }
        }
      },
      "cronJobDetails": {
        "required": [
          "env",
          "envSpecificDetails",
          "plan",
          "region",
          "schedule",
          "buildPlan"
        ],
        "type": "object",
        "properties": {
          "env": {
            "$ref": "#/components/schemas/serviceRuntime"
          },
          "envSpecificDetails": {
            "$ref": "#/components/schemas/envSpecificDetails"
          },
          "lastSuccessfulRunAt": {
            "type": "string",
            "format": "date-time"
          },
          "plan": {
            "$ref": "#/components/schemas/plan"
          },
          "region": {
            "$ref": "#/components/schemas/region"
          },
          "schedule": {
            "type": "string"
          },
          "buildPlan": {
            "$ref": "#/components/schemas/buildPlan"
          }
        }
      },
      "servicePOST": {
        "type": "object",
        "required": ["type", "name", "ownerId"],
        "properties": {
          "type": {
            "$ref": "#/components/schemas/serviceType"
          },
          "name": {
            "type": "string"
          },
          "ownerId": {
            "type": "string"
          },
          "repo": {
            "type": "string",
            "example": "https://github.com/render-examples/flask-hello-world",
            "description": "Do not include the branch in the repo string. You can instead supply a 'branch' parameter."
          },
          "autoDeploy": {
            "$ref": "#/components/schemas/autoDeploy"
          },
          "branch": {
            "type": "string",
            "description": "If left empty, this will fall back to the default branch of the repository"
          },
          "image": {
            "$ref": "#/components/schemas/image"
          },
          "buildFilter": {
            "$ref": "#/components/schemas/buildFilter"
          },
          "rootDir": {
            "type": "string"
          },
          "envVars": {
            "$ref": "#/components/schemas/envVarInputArray"
          },
          "secretFiles": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/secretFileInput"
            }
          },
          "serviceDetails": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/staticSiteDetailsPOST"
              },
              {
                "$ref": "#/components/schemas/webServiceDetailsPOST"
              },
              {
                "$ref": "#/components/schemas/privateServiceDetailsPOST"
              },
              {
                "$ref": "#/components/schemas/backgroundWorkerDetailsPOST"
              },
              {
                "$ref": "#/components/schemas/cronJobDetailsPOST"
              }
            ]
          }
        }
      },
      "dockerDetailsPOST": {
        "type": "object",
        "properties": {
          "dockerCommand": {
            "type": "string"
          },
          "dockerContext": {
            "type": "string"
          },
          "dockerfilePath": {
            "type": "string",
            "description": "Defaults to \"./Dockerfile\""
          },
          "registryCredentialId": {
            "type": "string"
          }
        }
      },
      "nativeEnvironmentDetailsPOST": {
        "type": "object",
        "required": ["buildCommand", "startCommand"],
        "properties": {
          "buildCommand": {
            "type": "string"
          },
          "startCommand": {
            "type": "string"
          }
        },
        "description": "Fields for native environment (runtime) services"
      },
      "staticSiteDetailsPOST": {
        "type": "object",
        "properties": {
          "buildCommand": {
            "type": "string"
          },
          "headers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/headerInput"
            }
          },
          "publishPath": {
            "type": "string",
            "description": "Defaults to \"public\""
          },
          "pullRequestPreviewsEnabled": {
            "$ref": "#/components/schemas/pullRequestPreviewsEnabled"
          },
          "routes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/routePost"
            }
          }
        }
      },
      "webServiceDetailsPOST": {
        "type": "object",
        "required": ["runtime"],
        "properties": {
          "autoscaling": {
            "$ref": "#/components/schemas/webServiceDetails/properties/autoscaling"
          },
          "disk": {
            "$ref": "#/components/schemas/serviceDisk"
          },
          "env": {
            "$ref": "#/components/schemas/serviceEnv"
          },
          "runtime": {
            "$ref": "#/components/schemas/serviceRuntime"
          },
          "envSpecificDetails": {
            "$ref": "#/components/schemas/envSpecificDetailsPOST"
          },
          "healthCheckPath": {
            "type": "string"
          },
          "numInstances": {
            "type": "integer",
            "minimum": 1,
            "description": "Defaults to 1"
          },
          "plan": {
            "$ref": "#/components/schemas/paidPlan"
          },
          "preDeployCommand": {
            "type": "string"
          },
          "pullRequestPreviewsEnabled": {
            "$ref": "#/components/schemas/pullRequestPreviewsEnabled"
          },
          "region": {
            "$ref": "#/components/schemas/region"
          },
          "maxShutdownDelaySeconds": {
            "$ref": "#/components/schemas/maxShutdownDelaySeconds"
          }
        }
      },
      "privateServiceDetailsPOST": {
        "type": "object",
        "required": ["runtime"],
        "properties": {
          "autoscaling": {
            "$ref": "#/components/schemas/webServiceDetails/properties/autoscaling"
          },
          "disk": {
            "$ref": "#/components/schemas/serviceDisk"
          },
          "env": {
            "$ref": "#/components/schemas/serviceEnv"
          },
          "runtime": {
            "$ref": "#/components/schemas/serviceRuntime"
          },
          "envSpecificDetails": {
            "$ref": "#/components/schemas/envSpecificDetailsPOST"
          },
          "numInstances": {
            "type": "integer",
            "minimum": 1,
            "default": 1,
            "description": "Defaults to 1"
          },
          "plan": {
            "$ref": "#/components/schemas/paidPlan"
          },
          "preDeployCommand": {
            "type": "string"
          },
          "pullRequestPreviewsEnabled": {
            "$ref": "#/components/schemas/pullRequestPreviewsEnabled"
          },
          "region": {
            "$ref": "#/components/schemas/region"
          },
          "maxShutdownDelaySeconds": {
            "$ref": "#/components/schemas/maxShutdownDelaySeconds"
          }
        }
      },
      "backgroundWorkerDetailsPOST": {
        "type": "object",
        "required": ["runtime"],
        "properties": {
          "autoscaling": {
            "$ref": "#/components/schemas/webServiceDetails/properties/autoscaling"
          },
          "disk": {
            "$ref": "#/components/schemas/serviceDisk"
          },
          "env": {
            "$ref": "#/components/schemas/serviceEnv"
          },
          "runtime": {
            "$ref": "#/components/schemas/serviceRuntime"
          },
          "envSpecificDetails": {
            "$ref": "#/components/schemas/envSpecificDetailsPOST"
          },
          "numInstances": {
            "type": "integer",
            "minimum": 1,
            "default": 1,
            "description": "Defaults to 1"
          },
          "plan": {
            "$ref": "#/components/schemas/paidPlan"
          },
          "preDeployCommand": {
            "type": "string"
          },
          "pullRequestPreviewsEnabled": {
            "$ref": "#/components/schemas/pullRequestPreviewsEnabled"
          },
          "region": {
            "$ref": "#/components/schemas/region"
          },
          "maxShutdownDelaySeconds": {
            "$ref": "#/components/schemas/maxShutdownDelaySeconds"
          }
        }
      },
      "cronJobDetailsPOST": {
        "type": "object",
        "required": ["runtime", "schedule"],
        "properties": {
          "env": {
            "$ref": "#/components/schemas/serviceEnv"
          },
          "runtime": {
            "$ref": "#/components/schemas/serviceRuntime"
          },
          "envSpecificDetails": {
            "$ref": "#/components/schemas/envSpecificDetails"
          },
          "plan": {
            "$ref": "#/components/schemas/paidPlan"
          },
          "region": {
            "$ref": "#/components/schemas/region"
          },
          "schedule": {
            "type": "string"
          }
        }
      },
      "servicePATCH": {
        "type": "object",
        "properties": {
          "autoDeploy": {
            "$ref": "#/components/schemas/autoDeploy"
          },
          "repo": {
            "type": "string"
          },
          "branch": {
            "type": "string"
          },
          "image": {
            "$ref": "#/components/schemas/image"
          },
          "name": {
            "type": "string"
          },
          "buildFilter": {
            "$ref": "#/components/schemas/buildFilter"
          },
          "rootDir": {
            "type": "string"
          },
          "serviceDetails": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/staticSiteDetailsPATCH"
              },
              {
                "$ref": "#/components/schemas/webServiceDetailsPATCH"
              },
              {
                "$ref": "#/components/schemas/privateServiceDetailsPATCH"
              },
              {
                "$ref": "#/components/schemas/backgroundWorkerDetailsPATCH"
              },
              {
                "$ref": "#/components/schemas/cronJobDetailsPATCH"
              }
            ]
          }
        }
      },
      "dockerDetailsPATCH": {
        "type": "object",
        "properties": {
          "dockerCommand": {
            "type": "string"
          },
          "dockerContext": {
            "type": "string"
          },
          "dockerfilePath": {
            "type": "string"
          },
          "registryCredentialId": {
            "type": "string"
          }
        }
      },
      "nativeEnvironmentDetailsPATCH": {
        "type": "object",
        "properties": {
          "buildCommand": {
            "type": "string"
          },
          "startCommand": {
            "type": "string"
          }
        }
      },
      "staticSiteDetailsPATCH": {
        "type": "object",
        "properties": {
          "buildCommand": {
            "type": "string"
          },
          "publishPath": {
            "type": "string"
          },
          "pullRequestPreviewsEnabled": {
            "$ref": "#/components/schemas/pullRequestPreviewsEnabled"
          }
        }
      },
      "webServiceDetailsPATCH": {
        "type": "object",
        "properties": {
          "envSpecificDetails": {
            "$ref": "#/components/schemas/envSpecificDetailsPATCH"
          },
          "healthCheckPath": {
            "type": "string"
          },
          "plan": {
            "$ref": "#/components/schemas/paidPlan"
          },
          "preDeployCommand": {
            "type": "string"
          },
          "pullRequestPreviewsEnabled": {
            "$ref": "#/components/schemas/pullRequestPreviewsEnabled"
          },
          "runtime": {
            "$ref": "#/components/schemas/serviceRuntime"
          },
          "maxShutdownDelaySeconds": {
            "$ref": "#/components/schemas/maxShutdownDelaySeconds"
          }
        }
      },
      "privateServiceDetailsPATCH": {
        "type": "object",
        "properties": {
          "envSpecificDetails": {
            "$ref": "#/components/schemas/envSpecificDetailsPATCH"
          },
          "plan": {
            "$ref": "#/components/schemas/paidPlan"
          },
          "preDeployCommand": {
            "type": "string"
          },
          "pullRequestPreviewsEnabled": {
            "$ref": "#/components/schemas/pullRequestPreviewsEnabled"
          },
          "runtime": {
            "$ref": "#/components/schemas/serviceRuntime"
          },
          "maxShutdownDelaySeconds": {
            "$ref": "#/components/schemas/maxShutdownDelaySeconds"
          }
        }
      },
      "backgroundWorkerDetailsPATCH": {
        "type": "object",
        "properties": {
          "envSpecificDetails": {
            "$ref": "#/components/schemas/envSpecificDetailsPATCH"
          },
          "plan": {
            "$ref": "#/components/schemas/paidPlan"
          },
          "preDeployCommand": {
            "type": "string"
          },
          "pullRequestPreviewsEnabled": {
            "$ref": "#/components/schemas/pullRequestPreviewsEnabled"
          },
          "runtime": {
            "$ref": "#/components/schemas/serviceRuntime"
          },
          "maxShutdownDelaySeconds": {
            "$ref": "#/components/schemas/maxShutdownDelaySeconds"
          }
        }
      },
      "cronJobDetailsPATCH": {
        "type": "object",
        "properties": {
          "envSpecificDetails": {
            "$ref": "#/components/schemas/envSpecificDetailsPATCH"
          },
          "plan": {
            "$ref": "#/components/schemas/paidPlan"
          },
          "schedule": {
            "type": "string"
          },
          "runtime": {
            "$ref": "#/components/schemas/serviceRuntime"
          }
        }
      },
      "envVarInputArray": {
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/envVarInput"
        }
      },
      "envVarInput": {
        "type": "object",
        "oneOf": [
          {
            "$ref": "#/components/schemas/envVarKeyValue"
          },
          {
            "$ref": "#/components/schemas/envVarKeyGenerateValue"
          }
        ]
      },
      "envVarKeyValue": {
        "type": "object",
        "required": ["key", "value"],
        "properties": {
          "key": {
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        }
      },
      "envVarValue": {
        "type": "object",
        "required": ["value"],
        "properties": {
          "value": {
            "type": "string"
          }
        }
      },
      "envVarKeyGenerateValue": {
        "type": "object",
        "required": ["key", "generateValue"],
        "properties": {
          "key": {
            "type": "string"
          },
          "generateValue": {
            "type": "boolean"
          }
        }
      },
      "envVarGenerateValue": {
        "type": "object",
        "required": ["generateValue"],
        "properties": {
          "generateValue": {
            "type": "boolean"
          }
        }
      },
      "addUpdateEnvVarInput": {
        "type": "object",
        "oneOf": [
          {
            "$ref": "#/components/schemas/envVarValue"
          },
          {
            "$ref": "#/components/schemas/envVarGenerateValue"
          }
        ]
      },
      "previewInput": {
        "type": "object",
        "required": ["imagePath"],
        "properties": {
          "imagePath": {
            "type": "string",
            "example": "docker.io/library/nginx:latest",
            "description": "Must be either a full URL or the relative path to an image. If a relative path, Render uses the base service's image URL as its root. For example, if the base service's image URL is `docker.io/library/nginx:latest`, then valid values are: `docker.io/library/nginx:<any tag or SHA>`, `library/nginx:<any tag or SHA>`, or `nginx:<any tag or SHA>`. Note that the path must match (only the tag or SHA can vary)."
          },
          "name": {
            "type": "string",
            "example": "preview",
            "description": "A name for the service preview instance. If not specified, Render generates the name using the base service's name and the specified tag or SHA."
          },
          "plan": {
            "$ref": "#/components/schemas/plan"
          }
        }
      },
      "plan": {
        "type": "string",
        "enum": [
          "starter",
          "starter_plus",
          "standard",
          "standard_plus",
          "pro",
          "pro_plus",
          "pro_max",
          "pro_ultra",
          "free",
          "custom"
        ],
        "example": "starter",
        "description": "The instance type to use for the preview instance. Note that base services with any paid instance type can't create preview instances with the `free` instance type."
      },
      "header": {
        "type": "object",
        "required": ["id", "path", "name", "value"],
        "properties": {
          "id": {
            "type": "string"
          },
          "path": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        }
      },
      "headerInput": {
        "type": "object",
        "required": ["path", "name", "value"],
        "properties": {
          "path": {
            "type": "string",
            "description": "The request path to add the header to. Wildcards will cause headers to be applied to all matching paths.",
            "example": "/static/*"
          },
          "name": {
            "type": "string",
            "description": "Header name",
            "example": "Cache-Control"
          },
          "value": {
            "type": "string",
            "description": "Header value",
            "example": "public, max-age=604800"
          }
        }
      },
      "notificationOverrideWithCursor": {
        "required": ["override", "cursor"],
        "type": "object",
        "properties": {
          "override": {
            "type": "object",
            "required": [
              "type",
              "serviceId",
              "previewNotificationsEnabled",
              "notificationsToSend"
            ],
            "properties": {
              "serviceId": {
                "type": "string"
              },
              "previewNotificationsEnabled": {
                "$ref": "#/paths/~1notification-settings~1overrides~1services~1%7BserviceId%7D/patch/requestBody/content/application~1json/schema/properties/previewNotificationsEnabled"
              },
              "notificationsToSend": {
                "$ref": "#/paths/~1notification-settings~1overrides~1services~1%7BserviceId%7D/patch/requestBody/content/application~1json/schema/properties/notificationsToSend"
              }
            }
          },
          "cursor": {
            "$ref": "#/components/schemas/cursor"
          }
        }
      },
      "owner": {
        "type": "object",
        "required": ["id", "name", "email", "type"],
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "twoFactorAuthEnabled": {
            "type": "boolean",
            "description": "Whether two-factor authentication is enabled for the owner. Only present for user owners."
          },
          "type": {
            "type": "string",
            "enum": ["user", "team"]
          }
        }
      },
      "route": {
        "type": "object",
        "required": ["id", "type", "source", "destination", "priority"],
        "properties": {
          "id": {
            "type": "string"
          },
          "type": {
            "$ref": "#/components/schemas/routeType"
          },
          "source": {
            "type": "string"
          },
          "destination": {
            "type": "string"
          },
          "priority": {
            "type": "integer",
            "description": "Redirect and Rewrite Rules are applied in priority order starting at 0"
          }
        }
      },
      "headerWithCursor": {
        "type": "object",
        "required": ["header", "cursor"],
        "properties": {
          "header": {
            "$ref": "#/components/schemas/header"
          },
          "cursor": {
            "type": "string"
          }
        }
      },
      "routeWithCursor": {
        "type": "object",
        "required": ["route", "cursor"],
        "properties": {
          "route": {
            "$ref": "#/components/schemas/route"
          },
          "cursor": {
            "type": "string"
          }
        }
      },
      "routePost": {
        "type": "object",
        "required": ["type", "source", "destination"],
        "properties": {
          "type": {
            "$ref": "#/components/schemas/routeType"
          },
          "source": {
            "type": "string",
            "example": "/:bar/foo"
          },
          "destination": {
            "type": "string",
            "example": "/foo/:bar"
          },
          "priority": {
            "type": "integer",
            "description": "Redirect and Rewrite Rules are applied in priority order starting at 0. Defaults to last in the priority list."
          }
        }
      },
      "routePatch": {
        "type": "object",
        "required": ["priority"],
        "properties": {
          "priority": {
            "x-go-type": "*int",
            "type": "integer",
            "description": "Redirect and Rewrite Rules are applied in priority order starting at 0. Moves this route to the specified priority and adjusts other route priorities accordingly."
          }
        }
      },
      "routePut": {
        "type": "object",
        "required": ["type", "source", "destination"],
        "properties": {
          "type": {
            "$ref": "#/components/schemas/routeType"
          },
          "source": {
            "type": "string",
            "example": "/:bar/foo"
          },
          "destination": {
            "type": "string",
            "example": "/foo/:bar"
          }
        }
      },
      "routeType": {
        "type": "string",
        "enum": ["redirect", "rewrite"]
      },
      "serviceType": {
        "type": "string",
        "enum": [
          "static_site",
          "web_service",
          "private_service",
          "background_worker",
          "cron_job"
        ]
      },
      "serviceTypeShort": {
        "type": "string",
        "enum": ["static", "web", "pserv", "worker", "cron"]
      },
      "serviceRuntime": {
        "type": "string",
        "enum": [
          "docker",
          "elixir",
          "go",
          "node",
          "python",
          "ruby",
          "rust",
          "image"
        ],
        "description": "Runtime"
      },
      "serviceEnv": {
        "type": "string",
        "enum": [
          "docker",
          "elixir",
          "go",
          "node",
          "python",
          "ruby",
          "rust",
          "image"
        ],
        "deprecated": true,
        "description": "This field has been deprecated, runtime should be used in its place."
      },
      "region": {
        "type": "string",
        "enum": ["frankfurt", "oregon", "ohio", "singapore", "virginia"],
        "default": "oregon",
        "description": "Defaults to \"oregon\""
      },
      "notifySetting": {
        "type": "string",
        "enum": ["default", "notify", "ignore"]
      },
      "suspenderType": {
        "type": "string",
        "enum": ["admin", "billing", "user", "parent_service", "unknown"]
      },
      "deploy": {
        "type": "object",
        "required": ["id"],
        "properties": {
          "id": {
            "type": "string"
          },
          "commit": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "createdAt": {
                "type": "string",
                "format": "date-time"
              }
            }
          },
          "image": {
            "description": "Image information used when creating the deploy. Not present for Git-backed deploys",
            "type": "object",
            "properties": {
              "ref": {
                "description": "Image reference used when creating the deploy",
                "type": "string"
              },
              "sha": {
                "description": "SHA that the image reference was resolved to when creating the deploy",
                "type": "string"
              },
              "registryCredential": {
                "description": "Name of credential used to pull the image, if provided",
                "type": "string"
              }
            }
          },
          "status": {
            "type": "string",
            "enum": [
              "created",
              "build_in_progress",
              "update_in_progress",
              "live",
              "deactivated",
              "build_failed",
              "update_failed",
              "canceled",
              "pre_deploy_in_progress",
              "pre_deploy_failed"
            ]
          },
          "trigger": {
            "type": "string",
            "enum": [
              "api",
              "blueprint_sync",
              "deploy_hook",
              "deployed_by_render",
              "manual",
              "other",
              "new_commit",
              "rollback",
              "service_resumed",
              "service_updated"
            ]
          },
          "finishedAt": {
            "type": "string",
            "format": "date-time"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "envVar": {
        "type": "object",
        "required": ["key", "value"],
        "properties": {
          "key": {
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        }
      },
      "envVarWithCursor": {
        "type": "object",
        "required": ["envVar", "cursor"],
        "properties": {
          "envVar": {
            "$ref": "#/components/schemas/envVar"
          },
          "cursor": {
            "$ref": "#/components/schemas/cursor"
          }
        }
      },
      "customDomainWithCursor": {
        "required": ["customDomain", "cursor"],
        "type": "object",
        "properties": {
          "customDomain": {
            "$ref": "#/components/schemas/customDomain"
          },
          "cursor": {
            "$ref": "#/components/schemas/cursor"
          }
        }
      },
      "customDomain": {
        "type": "object",
        "required": [
          "id",
          "name",
          "domainType",
          "publicSuffix",
          "verificationStatus",
          "createdAt",
          "redirectForName"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "domainType": {
            "type": "string",
            "enum": ["apex", "subdomain"]
          },
          "publicSuffix": {
            "type": "string"
          },
          "redirectForName": {
            "type": "string"
          },
          "verificationStatus": {
            "type": "string",
            "enum": ["verified", "unverified"]
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "server": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "name": {
                "type": "string"
              }
            }
          }
        }
      },
      "serverPort": {
        "type": "object",
        "required": ["port", "protocol"],
        "properties": {
          "port": {
            "type": "integer",
            "example": 10000
          },
          "protocol": {
            "type": "string",
            "enum": ["TCP", "UDP"]
          }
        }
      },
      "error": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "message": {
            "type": "string"
          }
        }
      },
      "pullRequestPreviewsEnabled": {
        "type": "string",
        "enum": ["yes", "no"],
        "default": "no",
        "description": "Defaults to \"no\""
      },
      "buildPlan": {
        "type": "string",
        "enum": ["starter", "performance"],
        "default": "starter"
      },
      "redisPOSTInput": {
        "type": "object",
        "description": "Input type for creating a Redis instance",
        "required": ["name", "ownerId", "plan"],
        "properties": {
          "name": {
            "type": "string",
            "description": "The name of the Redis instance"
          },
          "ownerId": {
            "type": "string",
            "description": "The ID of the owner of the Redis instance"
          },
          "plan": {
            "$ref": "#/components/schemas/redisPlan"
          },
          "region": {
            "type": "string",
            "description": "The region where the Redis instance is located"
          },
          "environmentId": {
            "type": "string"
          },
          "maxmemoryPolicy": {
            "$ref": "#/components/schemas/maxmemoryPolicy"
          },
          "ipAllowList": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/cidrBlockAndDescription"
            }
          }
        }
      },
      "redisPATCHInput": {
        "type": "object",
        "description": "Input type for updating a Redis instance",
        "properties": {
          "name": {
            "type": "string",
            "description": "The name of the Redis instance"
          },
          "plan": {
            "$ref": "#/components/schemas/redisPlan"
          },
          "maxmemoryPolicy": {
            "$ref": "#/components/schemas/maxmemoryPolicy"
          },
          "ipAllowList": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/cidrBlockAndDescription"
            }
          }
        }
      },
      "maxmemoryPolicy": {
        "type": "string",
        "description": "The eviction policy for the Redis instance",
        "enum": [
          "noeviction",
          "allkeys_lfu",
          "allkeys_lru",
          "allkeys_random",
          "volatile_lfu",
          "volatile_lru",
          "volatile_random",
          "volatile_ttl"
        ]
      },
      "redis": {
        "type": "object",
        "description": "A Redis instance",
        "required": [
          "id",
          "createdAt",
          "updatedAt",
          "status",
          "region",
          "plan",
          "name",
          "owner",
          "options",
          "ipAllowList",
          "version",
          "dashboardUrl"
        ],
        "properties": {
          "id": {
            "description": "The ID of the Redis instance",
            "type": "string"
          },
          "createdAt": {
            "description": "The creation time of the Redis instance",
            "type": "string",
            "format": "date-time"
          },
          "updatedAt": {
            "description": "The last updated time of the Redis instance",
            "type": "string",
            "format": "date-time"
          },
          "status": {
            "$ref": "#/components/schemas/databaseStatus"
          },
          "region": {
            "$ref": "#/components/schemas/region"
          },
          "plan": {
            "$ref": "#/components/schemas/redisPlan"
          },
          "name": {
            "description": "The name of the Redis instance",
            "type": "string"
          },
          "owner": {
            "$ref": "#/components/schemas/owner"
          },
          "options": {
            "$ref": "#/components/schemas/redisOptions"
          },
          "ipAllowList": {
            "description": "The IP allow list for the Redis instance",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/cidrBlockAndDescription"
            }
          },
          "environmentId": {
            "description": "The ID of the environment the Redis instance is associated with",
            "type": "string"
          },
          "version": {
            "description": "The version of Redis",
            "type": "string"
          },
          "dashboardUrl": {
            "type": "string",
            "description": "The URL to view the Redis instance in the Render Dashboard"
          }
        }
      },
      "redisDetail": {
        "type": "object",
        "description": "A Redis instance",
        "required": [
          "id",
          "createdAt",
          "updatedAt",
          "status",
          "region",
          "plan",
          "name",
          "owner",
          "options",
          "ipAllowList",
          "version"
        ],
        "properties": {
          "id": {
            "description": "The ID of the Redis instance",
            "type": "string"
          },
          "createdAt": {
            "description": "The creation time of the Redis instance",
            "type": "string",
            "format": "date-time"
          },
          "updatedAt": {
            "description": "The last updated time of the Redis instance",
            "type": "string",
            "format": "date-time"
          },
          "status": {
            "$ref": "#/components/schemas/databaseStatus"
          },
          "region": {
            "$ref": "#/components/schemas/region"
          },
          "plan": {
            "$ref": "#/components/schemas/redisPlan"
          },
          "name": {
            "description": "The name of the Redis instance",
            "type": "string"
          },
          "owner": {
            "$ref": "#/components/schemas/owner"
          },
          "options": {
            "$ref": "#/components/schemas/redisOptions"
          },
          "ipAllowList": {
            "description": "The IP allow list for the Redis instance",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/cidrBlockAndDescription"
            }
          },
          "environmentId": {
            "description": "The ID of the environment the Redis instance is associated with",
            "type": "string"
          },
          "version": {
            "description": "The version of Redis",
            "type": "string"
          },
          "maintenance": {
            "type": "object",
            "required": ["id", "type", "scheduledAt", "state"],
            "properties": {
              "id": {
                "$ref": "#/paths/~1maintenance~1%7BmaintenanceRunParam%7D/get/parameters/0/schema"
              },
              "type": {
                "type": "string"
              },
              "scheduledAt": {
                "type": "string",
                "format": "date-time"
              },
              "pendingMaintenanceBy": {
                "type": "string",
                "format": "date-time",
                "description": "If present, the maintenance run cannot be scheduled for later than this date-time."
              },
              "state": {
                "$ref": "#/paths/~1maintenance/get/parameters/2/schema/items"
              }
            }
          }
        }
      },
      "redisConnectionInfo": {
        "type": "object",
        "description": "A Redis instance",
        "required": [
          "internalConnectionString",
          "externalConnectionString",
          "redisCLICommand"
        ],
        "properties": {
          "internalConnectionString": {
            "description": "The connection string to use from within Render",
            "type": "string"
          },
          "externalConnectionString": {
            "description": "The connection string to use from outside Render",
            "type": "string",
            "format": "password"
          },
          "redisCLICommand": {
            "description": "The Redis CLI command to connect to the Redis instance",
            "type": "string",
            "format": "password"
          }
        }
      },
      "redisOptions": {
        "description": "Options for a Redis instance",
        "type": "object",
        "properties": {
          "maxmemoryPolicy": {
            "type": "string"
          }
        }
      },
      "cidrBlockAndDescription": {
        "type": "object",
        "required": ["cidrBlock", "description"],
        "properties": {
          "cidrBlock": {
            "type": "string"
          },
          "description": {
            "description": "User-provided description of the CIDR block",
            "type": "string"
          }
        }
      },
      "redisPlan": {
        "type": "string",
        "enum": ["free", "starter", "standard", "pro", "pro_plus", "custom"]
      },
      "databaseStatus": {
        "type": "string",
        "enum": [
          "creating",
          "available",
          "unavailable",
          "config_restart",
          "suspended",
          "maintenance_scheduled",
          "maintenance_in_progress",
          "recovery_failed",
          "recovery_in_progress",
          "unknown",
          "updating_instance"
        ]
      },
      "projectWithCursor": {
        "type": "object",
        "required": ["project", "cursor"],
        "properties": {
          "project": {
            "$ref": "#/components/schemas/project"
          },
          "cursor": {
            "$ref": "#/components/schemas/cursor"
          }
        }
      },
      "project": {
        "description": "A project is a collection of environments",
        "type": "object",
        "required": [
          "id",
          "createdAt",
          "updatedAt",
          "name",
          "owner",
          "environmentIds"
        ],
        "properties": {
          "id": {
            "description": "The ID of the project",
            "type": "string"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          },
          "name": {
            "description": "The name of the project",
            "type": "string"
          },
          "owner": {
            "$ref": "#/components/schemas/owner"
          },
          "environmentIds": {
            "description": "The environments associated with the project",
            "type": "array",
            "items": {
              "type": "string",
              "description": "The ID of the environment"
            }
          }
        }
      },
      "projectPOSTInput": {
        "type": "object",
        "required": ["name", "ownerId", "environments"],
        "properties": {
          "name": {
            "description": "The name of the project",
            "type": "string"
          },
          "ownerId": {
            "description": "The ID of the owner that the project belongs to",
            "type": "string"
          },
          "environments": {
            "description": "The environments to create when creating the project",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/projectPOSTEnvironmentInput"
            }
          }
        }
      },
      "projectPATCHInput": {
        "description": "Input type for updating a project",
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          }
        }
      },
      "projectPOSTEnvironmentInput": {
        "type": "object",
        "required": ["name"],
        "properties": {
          "name": {
            "type": "string"
          },
          "protectedStatus": {
            "$ref": "#/components/schemas/protectedStatus"
          }
        }
      },
      "environmentPOSTInput": {
        "type": "object",
        "required": ["name", "projectId"],
        "properties": {
          "name": {
            "type": "string"
          },
          "projectId": {
            "type": "string"
          },
          "protectedStatus": {
            "$ref": "#/components/schemas/protectedStatus"
          }
        }
      },
      "environmentResourcesPOSTInput": {
        "type": "object",
        "required": ["resourceIds"],
        "properties": {
          "resourceIds": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "The ID of an env group, a service, a PostgreSQL database, or a Redis instance"
            }
          }
        }
      },
      "environmentPATCHInput": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "protectedStatus": {
            "$ref": "#/components/schemas/protectedStatus"
          }
        }
      },
      "environment": {
        "type": "object",
        "required": [
          "id",
          "name",
          "projectId",
          "databasesIds",
          "redisIds",
          "serviceIds",
          "envGroupIds",
          "protectedStatus"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "projectId": {
            "type": "string"
          },
          "databasesIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "redisIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "serviceIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "envGroupIds": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "protectedStatus": {
            "$ref": "#/components/schemas/protectedStatus"
          }
        }
      },
      "environmentWithCursor": {
        "type": "object",
        "description": "An environment with a cursor",
        "required": ["environment", "cursor"],
        "properties": {
          "environment": {
            "$ref": "#/components/schemas/environment"
          },
          "cursor": {
            "$ref": "#/components/schemas/cursor"
          }
        }
      },
      "protectedStatus": {
        "type": "string",
        "description": "Indicates whether an environment is `unprotected` or `protected`. Only admin users can perform destructive actions in `protected` environments.",
        "enum": ["unprotected", "protected"]
      },
      "envGroupPOSTInput": {
        "type": "object",
        "required": ["name", "ownerId", "envVars"],
        "properties": {
          "name": {
            "type": "string"
          },
          "ownerId": {
            "type": "string"
          },
          "envVars": {
            "$ref": "#/components/schemas/envVarInputArray"
          },
          "secretFiles": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/secretFileInput"
            }
          },
          "serviceIds": {
            "type": "array",
            "items": {
              "description": "List of serviceIds to link the envGroup to",
              "type": "string"
            }
          },
          "environmentId": {
            "type": "string"
          }
        }
      },
      "envGroupPATCHInput": {
        "type": "object",
        "required": ["name"],
        "properties": {
          "name": {
            "type": "string"
          }
        }
      },
      "secretFileInput": {
        "type": "object",
        "required": ["name", "content"],
        "properties": {
          "name": {
            "type": "string"
          },
          "content": {
            "type": "string"
          }
        }
      },
      "envGroup": {
        "allOf": [
          {
            "$ref": "#/components/schemas/envGroupMeta"
          },
          {
            "type": "object",
            "required": ["envVars", "secretFiles"],
            "properties": {
              "envVars": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/envVar"
                }
              },
              "secretFiles": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/secretFile"
                }
              }
            }
          }
        ]
      },
      "envGroupMeta": {
        "type": "object",
        "required": [
          "id",
          "name",
          "ownerId",
          "createdAt",
          "updatedAt",
          "serviceLinks"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "ownerId": {
            "type": "string"
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          },
          "serviceLinks": {
            "description": "List of serviceIds linked to the envGroup",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/serviceLink"
            }
          },
          "environmentId": {
            "type": "string"
          }
        }
      },
      "secretFile": {
        "type": "object",
        "required": ["name", "content"],
        "properties": {
          "name": {
            "type": "string"
          },
          "content": {
            "type": "string"
          }
        }
      },
      "secretFileWithCursor": {
        "type": "object",
        "required": ["secretFile", "cursor"],
        "properties": {
          "secretFile": {
            "$ref": "#/components/schemas/secretFile"
          },
          "cursor": {
            "$ref": "#/components/schemas/cursor"
          }
        }
      },
      "serviceLink": {
        "type": "object",
        "required": ["id", "name", "type"],
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "type": {
            "$ref": "#/components/schemas/serviceTypeShort"
          }
        }
      },
      "postgresPOSTInput": {
        "type": "object",
        "required": ["name", "plan", "ownerId", "version"],
        "properties": {
          "databaseName": {
            "type": "string",
            "default": "randomly generated"
          },
          "databaseUser": {
            "type": "string",
            "default": "randomly generated"
          },
          "datadogAPIKey": {
            "type": "string"
          },
          "name": {
            "type": "string",
            "description": "The name of the database as it will appear in the Render Dashboard"
          },
          "enableHighAvailability": {
            "type": "boolean",
            "default": false
          },
          "environmentId": {
            "type": "string"
          },
          "ownerId": {
            "type": "string",
            "description": "The ID of the owner (team or personal user) whose resources should be returned"
          },
          "plan": {
            "$ref": "#/components/schemas/postgres/properties/plan"
          },
          "region": {
            "type": "string"
          },
          "ipAllowList": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/cidrBlockAndDescription"
            }
          },
          "readReplicas": {
            "$ref": "#/components/schemas/readReplicasInput"
          },
          "version": {
            "$ref": "#/components/schemas/postgresVersion"
          }
        },
        "description": "Input for creating a database"
      },
      "postgresPATCHInput": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "plan": {
            "$ref": "#/components/schemas/postgres/properties/plan"
          },
          "enableHighAvailability": {
            "type": "boolean"
          },
          "datadogAPIKey": {
            "type": "string"
          },
          "ipAllowList": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/cidrBlockAndDescription"
            }
          },
          "readReplicas": {
            "$ref": "#/components/schemas/readReplicasInput"
          }
        }
      },
      "readReplicas": {
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/readReplica"
        }
      },
      "readReplica": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The replica instance identifier."
          },
          "name": {
            "type": "string",
            "description": "The display name of the replica instance."
          }
        },
        "required": ["id", "name"]
      },
      "readReplicasInput": {
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/readReplicaInput"
        }
      },
      "readReplicaInput": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The display name of the replica instance."
          }
        },
        "required": ["name"]
      },
      "postgresConnectionInfo": {
        "type": "object",
        "required": [
          "password",
          "internalConnectionString",
          "externalConnectionString",
          "psqlCommand"
        ],
        "properties": {
          "password": {
            "type": "string",
            "format": "password"
          },
          "internalConnectionString": {
            "type": "string",
            "format": "password"
          },
          "externalConnectionString": {
            "type": "string",
            "format": "password"
          },
          "psqlCommand": {
            "type": "string",
            "format": "password"
          }
        }
      },
      "postgres": {
        "type": "object",
        "required": [
          "id",
          "ipAllowList",
          "createdAt",
          "updatedAt",
          "databaseName",
          "databaseUser",
          "highAvailabilityEnabled",
          "name",
          "owner",
          "plan",
          "region",
          "readReplicas",
          "role",
          "status",
          "version",
          "suspended",
          "suspenders",
          "dashboardUrl"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "ipAllowList": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/cidrBlockAndDescription"
            }
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          },
          "expiresAt": {
            "description": "The time at which the database will be expire. Applies to free tier databases only.",
            "type": "string",
            "format": "date-time"
          },
          "databaseName": {
            "type": "string"
          },
          "databaseUser": {
            "type": "string"
          },
          "environmentId": {
            "type": "string"
          },
          "highAvailabilityEnabled": {
            "type": "boolean"
          },
          "name": {
            "type": "string"
          },
          "owner": {
            "$ref": "#/components/schemas/owner"
          },
          "plan": {
            "type": "string",
            "enum": ["free", "starter", "standard", "pro", "pro_plus", "custom"]
          },
          "primaryPostgresID": {
            "type": "string"
          },
          "region": {
            "$ref": "#/components/schemas/region"
          },
          "readReplicas": {
            "$ref": "#/components/schemas/readReplicas"
          },
          "role": {
            "$ref": "#/components/schemas/databaseRole"
          },
          "status": {
            "$ref": "#/components/schemas/databaseStatus"
          },
          "version": {
            "$ref": "#/components/schemas/postgresVersion"
          },
          "suspended": {
            "type": "string",
            "enum": ["suspended", "not_suspended"]
          },
          "suspenders": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/suspenderType"
            }
          },
          "dashboardUrl": {
            "type": "string",
            "description": "The URL to view the PostgreSQL instance in the Render Dashboard"
          }
        }
      },
      "postgresDetail": {
        "type": "object",
        "required": [
          "id",
          "ipAllowList",
          "createdAt",
          "updatedAt",
          "dashboardUrl",
          "databaseName",
          "databaseUser",
          "highAvailabilityEnabled",
          "name",
          "owner",
          "project",
          "plan",
          "region",
          "readReplicas",
          "role",
          "status",
          "version",
          "suspended",
          "suspenders"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "ipAllowList": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/cidrBlockAndDescription"
            }
          },
          "createdAt": {
            "type": "string",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time"
          },
          "expiresAt": {
            "description": "The time at which the database will be expire. Applies to free tier databases only.",
            "type": "string",
            "format": "date-time"
          },
          "dashboardUrl": {
            "type": "string",
            "description": "The URL to view the PostgreSQL instance in the Render Dashboard"
          },
          "databaseName": {
            "type": "string"
          },
          "databaseUser": {
            "type": "string"
          },
          "environmentId": {
            "type": "string"
          },
          "highAvailabilityEnabled": {
            "type": "boolean"
          },
          "maintenance": {
            "$ref": "#/components/schemas/redisDetail/properties/maintenance"
          },
          "name": {
            "type": "string"
          },
          "owner": {
            "$ref": "#/components/schemas/owner"
          },
          "plan": {
            "$ref": "#/components/schemas/postgres/properties/plan"
          },
          "primaryPostgresID": {
            "type": "string"
          },
          "region": {
            "$ref": "#/components/schemas/region"
          },
          "readReplicas": {
            "$ref": "#/components/schemas/readReplicas"
          },
          "role": {
            "$ref": "#/components/schemas/databaseRole"
          },
          "status": {
            "$ref": "#/components/schemas/databaseStatus"
          },
          "version": {
            "$ref": "#/components/schemas/postgresVersion"
          },
          "suspended": {
            "type": "string",
            "enum": ["suspended", "not_suspended"]
          },
          "suspenders": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/suspenderType"
            }
          }
        }
      },
      "postgresVersion": {
        "type": "string",
        "description": "The PostgreSQL version",
        "enum": ["11", "12", "13", "14", "15", "16"]
      },
      "databaseRole": {
        "type": "string",
        "enum": ["primary", "replica"]
      },
      "paidPlan": {
        "type": "string",
        "enum": [
          "starter",
          "standard",
          "pro",
          "pro_plus",
          "pro_max",
          "pro_ultra"
        ],
        "default": "starter",
        "description": "Defaults to \"starter\""
      },
      "cronJobRun": {
        "type": "object",
        "description": "A run of a cron job",
        "required": ["id", "status"],
        "properties": {
          "id": {
            "description": "The ID of the run",
            "type": "string"
          },
          "status": {
            "type": "string",
            "enum": ["pending", "successful", "unsuccessful", "canceled"]
          },
          "startedAt": {
            "type": "string",
            "format": "date-time",
            "example": "2021-07-15T07:20:05.777035-07:00"
          },
          "finishedAt": {
            "type": "string",
            "format": "date-time",
            "example": "2021-07-15T07:20:05.777035-07:00"
          },
          "triggeredBy": {
            "type": "string",
            "description": "user who triggered the cron job run"
          },
          "canceledBy": {
            "type": "string",
            "description": "user who cancelled the cron job run"
          }
        }
      },
      "blueprintWithCursor": {
        "type": "object",
        "description": "A blueprint with a cursor",
        "required": ["blueprint", "cursor"],
        "properties": {
          "blueprint": {
            "type": "object",
            "required": ["id", "name", "status", "autoSync", "repo", "branch"],
            "properties": {
              "id": {
                "$ref": "#/paths/~1blueprints~1%7BblueprintId%7D/parameters/0/schema"
              },
              "name": {
                "type": "string"
              },
              "status": {
                "$ref": "#/paths/~1blueprints~1%7BblueprintId%7D/get/responses/200/content/application~1json/schema/properties/status"
              },
              "autoSync": {
                "$ref": "#/paths/~1blueprints~1%7BblueprintId%7D/patch/requestBody/content/application~1json/schema/properties/autoSync"
              },
              "repo": {
                "type": "string"
              },
              "branch": {
                "type": "string"
              },
              "lastSync": {
                "type": "string",
                "format": "date-time"
              }
            }
          },
          "cursor": {
            "$ref": "#/components/schemas/cursor"
          }
        }
      },
      "syncWithCursor": {
        "type": "object",
        "description": "A blueprint sync with a cursor",
        "required": ["sync", "cursor"],
        "properties": {
          "sync": {
            "type": "object",
            "required": ["id", "commit", "state"],
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^exe-[0-9a-z]{20}$",
                "example": "exe-cph1rs3idesc73a2b2mg"
              },
              "commit": {
                "type": "object",
                "required": ["id"],
                "properties": {
                  "id": {
                    "type": "string"
                  }
                }
              },
              "startedAt": {
                "type": "string",
                "format": "date-time"
              },
              "completedAt": {
                "type": "string",
                "format": "date-time"
              },
              "state": {
                "type": "string",
                "enum": ["created", "pending", "running", "error", "success"]
              }
            }
          },
          "cursor": {
            "$ref": "#/components/schemas/cursor"
          }
        }
      },
      "serviceEventWithCursor": {
        "type": "object",
        "description": "A service event with a cursor",
        "required": ["event", "cursor"],
        "properties": {
          "event": {
            "type": "object",
            "required": ["id", "timestamp", "serviceId", "type", "details"],
            "properties": {
              "id": {
                "type": "string"
              },
              "timestamp": {
                "type": "string",
                "format": "date-time"
              },
              "serviceId": {
                "type": "string"
              },
              "type": {
                "$ref": "#/components/parameters/eventTypeParam/schema/anyOf/0"
              },
              "details": {
                "oneOf": [
                  {
                    "type": "object",
                    "required": ["deployId"],
                    "properties": {
                      "deployId": {
                        "type": "string"
                      }
                    }
                  },
                  {
                    "type": "object",
                    "required": ["toConfig"],
                    "properties": {
                      "fromConfig": {
                        "$ref": "#/components/schemas/webServiceDetails/properties/autoscaling"
                      },
                      "toConfig": {
                        "$ref": "#/components/schemas/webServiceDetails/properties/autoscaling"
                      }
                    }
                  },
                  {
                    "type": "object",
                    "required": ["fromInstances", "toInstances"],
                    "properties": {
                      "fromInstances": {
                        "type": "integer"
                      },
                      "toInstances": {
                        "type": "integer"
                      }
                    }
                  },
                  {
                    "type": "object",
                    "required": ["fromInstances", "toInstances"],
                    "properties": {
                      "fromInstances": {
                        "type": "integer"
                      },
                      "toInstances": {
                        "type": "integer"
                      },
                      "currentCPU": {
                        "type": "integer",
                        "x-go-type": "int64"
                      },
                      "targetCPU": {
                        "type": "integer",
                        "x-go-type": "int64"
                      },
                      "currentMemory": {
                        "type": "integer",
                        "x-go-type": "int64"
                      },
                      "targetMemory": {
                        "type": "integer",
                        "x-go-type": "int64"
                      }
                    }
                  },
                  {
                    "type": "object",
                    "required": ["deletedBranch", "newBranch"],
                    "properties": {
                      "deletedBranch": {
                        "type": "string"
                      },
                      "newBranch": {
                        "type": "string"
                      }
                    }
                  },
                  {
                    "type": "object",
                    "required": ["buildId", "status", "reason"],
                    "properties": {
                      "buildId": {
                        "type": "string"
                      },
                      "status": {
                        "type": "integer"
                      },
                      "reason": {
                        "type": "object",
                        "properties": {
                          "buildFailed": {
                            "$ref": "#/components/schemas/serviceEventWithCursor/properties/event/properties/details/oneOf/5/properties/reason/properties/newBuild"
                          },
                          "newBuild": {
                            "type": "object",
                            "required": ["id"],
                            "properties": {
                              "id": {
                                "type": "string"
                              }
                            }
                          },
                          "newDeploy": {
                            "$ref": "#/components/schemas/serviceEventWithCursor/properties/event/properties/details/oneOf/5/properties/reason/properties/newBuild"
                          },
                          "failure": {
                            "$ref": "#/components/schemas/serviceEventWithCursor/properties/event/properties/details/oneOf/9/properties/reason"
                          }
                        }
                      }
                    }
                  },
                  {
                    "type": "object",
                    "required": ["from", "to"],
                    "properties": {
                      "from": {
                        "type": "string"
                      },
                      "to": {
                        "type": "string"
                      }
                    }
                  },
                  {
                    "type": "object",
                    "required": ["buildId", "trigger"],
                    "properties": {
                      "buildId": {
                        "type": "string"
                      },
                      "trigger": {
                        "type": "object",
                        "required": [
                          "firstBuild",
                          "envUpdated",
                          "manual",
                          "deployedByRender",
                          "clearCache",
                          "rollback"
                        ],
                        "properties": {
                          "firstBuild": {
                            "description": "Deploy was triggered by service creation",
                            "type": "boolean"
                          },
                          "envUpdated": {
                            "description": "Deploy was triggered by an environment update",
                            "type": "boolean"
                          },
                          "manual": {
                            "description": "Deploy was triggered manually from the dashboard",
                            "type": "boolean"
                          },
                          "user": {
                            "$ref": "#/components/schemas/serviceEventWithCursor/properties/event/properties/details/oneOf/9/properties/user"
                          },
                          "updatedProperty": {
                            "description": "Updated property that triggered the deploy",
                            "type": "string"
                          },
                          "newCommit": {
                            "description": "Commit that triggered the deploy",
                            "type": "string"
                          },
                          "deployedByRender": {
                            "description": "Deploy was triggered by Render",
                            "type": "boolean"
                          },
                          "clearCache": {
                            "description": "Whether the cache was cleared for the deploy",
                            "type": "boolean"
                          },
                          "rollback": {
                            "description": "Whether the deploy was triggered by a rollback",
                            "type": "boolean"
                          },
                          "rollbackTargetDeployId": {
                            "description": "Deploy ID that was rolled back to",
                            "type": "string"
                          }
                        }
                      }
                    }
                  },
                  {
                    "type": "object",
                    "required": ["id", "url"],
                    "properties": {
                      "id": {
                        "description": "the commit id",
                        "type": "string"
                      },
                      "url": {
                        "description": "the commit url",
                        "type": "string"
                      }
                    }
                  },
                  {
                    "type": "object",
                    "required": ["cronJobRunId", "status"],
                    "properties": {
                      "cronJobRunId": {
                        "type": "string"
                      },
                      "status": {
                        "type": "string",
                        "enum": [
                          "canceled",
                          "pending",
                          "successful",
                          "unsuccessful"
                        ]
                      },
                      "reason": {
                        "type": "object",
                        "required": ["evicted"],
                        "properties": {
                          "evicted": {
                            "type": "boolean"
                          },
                          "nonZeroExit": {
                            "type": "integer"
                          },
                          "oomKilled": {
                            "type": "object",
                            "required": ["memoryLimit"],
                            "properties": {
                              "memoryLimit": {
                                "type": "string"
                              }
                            }
                          },
                          "timedOutSeconds": {
                            "type": "integer",
                            "format": "int64"
                          },
                          "unhealthy": {
                            "type": "string"
                          },
                          "timedOutReason": {
                            "type": "string"
                          }
                        }
                      },
                      "user": {
                        "type": "object",
                        "description": "User who triggered the action",
                        "required": ["id", "email"],
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "email": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  },
                  {
                    "type": "object",
                    "required": ["cronJobRunId"],
                    "properties": {
                      "cronJobRunId": {
                        "type": "string"
                      }
                    }
                  },
                  {
                    "type": "object",
                    "required": ["deployId", "reason", "status"],
                    "properties": {
                      "deployId": {
                        "type": "string"
                      },
                      "reason": {
                        "$ref": "#/components/schemas/serviceEventWithCursor/properties/event/properties/details/oneOf/5/properties/reason"
                      },
                      "status": {
                        "type": "integer"
                      }
                    }
                  },
                  {
                    "type": "object",
                    "required": ["deployId", "trigger"],
                    "properties": {
                      "deployId": {
                        "type": "string"
                      },
                      "trigger": {
                        "$ref": "#/components/schemas/serviceEventWithCursor/properties/event/properties/details/oneOf/7/properties/trigger"
                      }
                    }
                  },
                  {
                    "type": "object",
                    "required": ["diskId", "sizeGB"],
                    "properties": {
                      "diskId": {
                        "$ref": "#/paths/~1disks~1%7BdiskId%7D/parameters/0/schema"
                      },
                      "sizeGB": {
                        "type": "integer"
                      }
                    }
                  },
                  {
                    "type": "object",
                    "required": ["diskId", "fromSizeGB", "toSizeGB"],
                    "properties": {
                      "diskId": {
                        "$ref": "#/paths/~1disks~1%7BdiskId%7D/parameters/0/schema"
                      },
                      "fromSizeGB": {
                        "type": "integer"
                      },
                      "toSizeGB": {
                        "type": "integer"
                      }
                    }
                  },
                  {
                    "type": "object",
                    "required": ["diskId"],
                    "properties": {
                      "diskId": {
                        "$ref": "#/paths/~1disks~1%7BdiskId%7D/parameters/0/schema"
                      }
                    }
                  },
                  {
                    "type": "object",
                    "required": ["message", "imageURL"],
                    "properties": {
                      "message": {
                        "type": "string"
                      },
                      "imageURL": {
                        "type": "string"
                      }
                    }
                  },
                  {
                    "type": "object",
                    "required": ["deployId"],
                    "properties": {
                      "deployId": {
                        "type": "string"
                      }
                    }
                  },
                  {
                    "type": "object",
                    "required": ["fromInstances", "toInstances"],
                    "properties": {
                      "fromInstances": {
                        "type": "integer"
                      },
                      "toInstances": {
                        "type": "integer"
                      }
                    }
                  },
                  {
                    "type": "object",
                    "required": ["jobId", "status"],
                    "properties": {
                      "jobId": {
                        "$ref": "#/paths/~1services~1%7BserviceId%7D~1jobs~1%7BjobId%7D/parameters/1/schema"
                      },
                      "status": {
                        "$ref": "#/paths/~1services~1%7BserviceId%7D~1jobs/post/responses/200/content/application~1json/schema/properties/status"
                      },
                      "reason": {
                        "$ref": "#/components/schemas/serviceEventWithCursor/properties/event/properties/details/oneOf/9/properties/reason"
                      }
                    }
                  },
                  {
                    "type": "object"
                  },
                  {
                    "type": "object",
                    "required": ["trigger"],
                    "properties": {
                      "trigger": {
                        "type": "object",
                        "required": ["manual", "startedByRender"],
                        "properties": {
                          "user": {
                            "$ref": "#/components/schemas/serviceEventWithCursor/properties/event/properties/details/oneOf/9/properties/user"
                          },
                          "manual": {
                            "description": "Maintenance was triggered manually",
                            "type": "boolean"
                          },
                          "startedByRender": {
                            "description": "Maintenance was triggered by Render",
                            "type": "boolean"
                          }
                        }
                      }
                    }
                  },
                  {
                    "type": "object",
                    "required": ["from", "to"],
                    "properties": {
                      "from": {
                        "type": "string"
                      },
                      "to": {
                        "type": "string"
                      }
                    }
                  },
                  {
                    "type": "object",
                    "required": [
                      "deployCommandExecutionId",
                      "deployId",
                      "status",
                      "reason"
                    ],
                    "properties": {
                      "deployCommandExecutionId": {
                        "type": "string"
                      },
                      "deployId": {
                        "type": "string"
                      },
                      "status": {
                        "type": "integer"
                      },
                      "reason": {
                        "$ref": "#/components/schemas/serviceEventWithCursor/properties/event/properties/details/oneOf/5/properties/reason"
                      }
                    }
                  },
                  {
                    "type": "object",
                    "required": ["deployCommandExecutionId", "deployId"],
                    "properties": {
                      "deployCommandExecutionId": {
                        "type": "string"
                      },
                      "deployId": {
                        "type": "string"
                      }
                    }
                  },
                  {
                    "type": "object"
                  },
                  {
                    "type": "object",
                    "properties": {
                      "reason": {
                        "$ref": "#/components/schemas/serviceEventWithCursor/properties/event/properties/details/oneOf/9/properties/reason"
                      }
                    }
                  },
                  {
                    "type": "object"
                  },
                  {
                    "type": "object",
                    "required": ["triggeredByUser"],
                    "properties": {
                      "triggeredByUser": {
                        "type": "string",
                        "nullable": true
                      }
                    }
                  },
                  {
                    "type": "object"
                  },
                  {
                    "type": "object"
                  },
                  {
                    "type": "object"
                  },
                  {
                    "type": "object",
                    "required": ["actor"],
                    "properties": {
                      "actor": {
                        "type": "string"
                      },
                      "suspendedByUser": {
                        "$ref": "#/components/schemas/serviceEventWithCursor/properties/event/properties/details/oneOf/9/properties/user"
                      }
                    }
                  },
                  {
                    "type": "object",
                    "required": ["actor"],
                    "properties": {
                      "actor": {
                        "type": "string"
                      },
                      "resumedByUser": {
                        "$ref": "#/components/schemas/serviceEventWithCursor/properties/event/properties/details/oneOf/9/properties/user"
                      }
                    }
                  },
                  {
                    "type": "object"
                  },
                  {
                    "type": "object",
                    "required": ["trigger"],
                    "properties": {
                      "trigger": {
                        "type": "string"
                      }
                    }
                  }
                ]
              }
            }
          }
        }
      }
    },
    "responses": {
      "400BadRequest": {
        "description": "The request could not be understood by the server.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/error"
            }
          }
        }
      },
      "401Unauthorized": {
        "description": "Authorization information is missing or invalid.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/error"
            }
          }
        }
      },
      "402PaymentRequired": {
        "description": "You must enter payment information to perform this request.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/error"
            }
          }
        }
      },
      "403Forbidden": {
        "description": "You do not have permissions for the requested resource.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/error"
            }
          }
        }
      },
      "404NotFound": {
        "description": "Unable to find the requested resource.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/error"
            }
          }
        }
      },
      "406NotAcceptable": {
        "description": "Unable to generate preferred media types as specified by Accept request header.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/error"
            }
          }
        }
      },
      "409Conflict": {
        "description": "The current state of the resource conflicts with this request.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/error"
            }
          }
        }
      },
      "410Gone": {
        "description": "The requested resource is no longer available.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/error"
            }
          }
        }
      },
      "429RateLimit": {
        "description": "Rate limit has been surpassed.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/error"
            }
          }
        }
      },
      "500InternalServerError": {
        "description": "An unexpected server error has occurred.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/error"
            }
          }
        }
      },
      "503ServiceUnavailable": {
        "description": "Server currently unavailable.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/error"
            }
          }
        }
      },
      "Logs200Response": {
        "description": "A collection of logs with pagination metadata",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "description": "A run of a cron job",
              "required": ["hasMore", "nextStartTime", "nextEndTime", "logs"],
              "properties": {
                "hasMore": {
                  "description": "Ture if there are more logs to fetch",
                  "type": "boolean"
                },
                "nextStartTime": {
                  "description": "The start time to use in the next query to fetch the next set of logs",
                  "type": "string",
                  "format": "date-time",
                  "example": "2021-07-15T07:20:05.777035-07:00"
                },
                "nextEndTime": {
                  "description": "The end time to use in the next query to fetch the next set of logs",
                  "type": "string",
                  "format": "date-time",
                  "example": "2021-07-15T07:20:05.777035-07:00"
                },
                "logs": {
                  "type": "array",
                  "items": {
                    "$ref": "#/paths/~1logs~1subscribe/get/responses/101/content/application~1json/schema"
                  }
                }
              }
            }
          }
        }
      },
      "LogsValues200Response": {
        "description": "An array of possible values for a log label",
        "content": {
          "application/json": {
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        }
      }
    }
  }
}