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."
    },
    {
      "name": "Users",
      "description": "The `User` endpoints allow you to retrieve information about the authenticated user\n"
    }
  ],
  "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" }
        }
      }
    },
    "/users": {
      "get": {
        "summary": "Get the authenticated user",
        "description": "Retrieve the user associated with the provided API key.\n",
        "operationId": "get-user",
        "tags": ["Users"],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/user" }
              }
            }
          },
          "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": {
      "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": { "$ref": "#/components/schemas/ownerWithCursor" }
                }
              }
            }
          },
          "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/environmentIdParam" },
          { "$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/includePreviewsParam" },
          { "$ref": "#/components/parameters/cursorParam" },
          { "$ref": "#/components/parameters/limitParam" }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/serviceList" }
              }
            }
          },
          "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": { "$ref": "#/components/schemas/deployList" }
              }
            }
          },
          "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": { "$ref": "#/components/schemas/jobWithCursor" }
                }
              }
            }
          },
          "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": {
          "201": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/jobWithCursor/properties/job"
                }
              }
            }
          },
          "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": "#/components/schemas/jobWithCursor/properties/job"
                }
              }
            }
          },
          "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": "#/components/schemas/jobWithCursor/properties/job"
                }
              }
            }
          },
          "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, `request` for request logs, and `build` for build 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" }
        }
      }
    },
    "/logs/streams/owner/{ownerId}": {
      "get": {
        "summary": "Get owner log stream",
        "description": "Get log stream information for the provided owner.",
        "operationId": "get-owner-log-stream",
        "tags": ["Logs"],
        "parameters": [
          {
            "name": "ownerId",
            "in": "path",
            "description": "The ID of the owner (team or personal user) whose log streams should be returned",
            "schema": { "type": "string" },
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "Owner log stream setting",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Owner log stream settings",
                  "properties": {
                    "ownerId": {
                      "description": "The ID of the owner.",
                      "type": "string"
                    },
                    "endpoint": {
                      "description": "The endpoint to stream logs to.",
                      "type": "string"
                    },
                    "preview": {
                      "$ref": "#/paths/~1logs~1streams~1owner~1%7BownerId%7D/put/requestBody/content/application~1json/schema/properties/preview"
                    }
                  }
                }
              }
            }
          },
          "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" }
        }
      },
      "put": {
        "summary": "Update owner log stream",
        "description": "Update default log stream information for the provided owner. All logs for resources owned by this owner will be sent to this log stream unless overridden by a resource log stream.",
        "operationId": "update-owner-log-stream",
        "tags": ["Logs"],
        "parameters": [
          {
            "name": "ownerId",
            "in": "path",
            "description": "The ID of the owner (team or personal user) whose log streams should be returned",
            "schema": { "type": "string" },
            "required": true
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["preview"],
                "properties": {
                  "endpoint": {
                    "description": "The endpoint to stream logs to.",
                    "type": "string"
                  },
                  "token": {
                    "description": "The optional token to authenticate the log stream.",
                    "type": "string"
                  },
                  "preview": {
                    "type": "string",
                    "description": "Whether to send logs or drop them.",
                    "enum": ["send", "drop"]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "$ref": "#/paths/~1logs~1streams~1owner~1%7BownerId%7D/get/responses/200"
          },
          "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 owner log stream",
        "description": "Remove the log stream information for the provided owner.",
        "operationId": "delete-owner-log-stream",
        "tags": ["Logs"],
        "parameters": [
          {
            "name": "ownerId",
            "in": "path",
            "description": "The ID of the owner (team or personal user) whose log streams should be returned",
            "schema": { "type": "string" },
            "required": true
          }
        ],
        "responses": {
          "204": { "description": "Log stream setting 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" }
        }
      }
    },
    "/logs/streams/resource": {
      "get": {
        "summary": "List resource log stream overrides",
        "description": "List resource log stream overrides for the provided filters. These overrides take precedence over any existing owner log streams.",
        "operationId": "list-resource-log-streams",
        "tags": ["Logs"],
        "parameters": [
          { "$ref": "#/components/parameters/ownerIdParam" },
          {
            "name": "logStreamId",
            "in": "query",
            "required": false,
            "description": "Filter log streams by their id.",
            "schema": { "type": "array", "items": { "type": "string" } }
          },
          { "$ref": "#/components/parameters/resourceIdParam" },
          {
            "name": "setting",
            "in": "query",
            "required": false,
            "description": "Filter log streams by their setting.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "description": "Whether to send logs or drop them.",
                "enum": ["send", "drop"]
              }
            }
          },
          { "$ref": "#/components/parameters/cursorParam" },
          { "$ref": "#/components/parameters/limitParam" }
        ],
        "responses": {
          "200": {
            "description": "Resource log stream override",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/paths/~1logs~1streams~1resource~1%7BresourceId%7D/get/responses/200/content/application~1json/schema"
                  }
                }
              }
            }
          },
          "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/streams/resource/{resourceId}": {
      "get": {
        "summary": "Get resource log stream override",
        "description": "Get resource log stream override information for the provided resource. A resource log stream override takes precedence over a owner log stream if it exists.",
        "operationId": "get-resource-log-stream",
        "tags": ["Logs"],
        "parameters": [
          {
            "name": "resourceId",
            "in": "path",
            "description": "The ID of the resource (server, cron job, postgres, or redis) whose log streams should be returned",
            "schema": { "type": "string" },
            "required": true
          }
        ],
        "responses": {
          "200": {
            "description": "Resource log stream override",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "Resource log stream overrides",
                  "properties": {
                    "resourceId": {
                      "description": "The ID of the resource.",
                      "type": "string"
                    },
                    "endpoint": {
                      "description": "The endpoint to stream logs to. Must be present if setting is send. Cannot be present if setting is drop.",
                      "type": "string"
                    },
                    "setting": {
                      "$ref": "#/paths/~1logs~1streams~1resource/get/parameters/3/schema/items"
                    }
                  }
                }
              }
            }
          },
          "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" }
        }
      },
      "put": {
        "summary": "Update resource log stream override",
        "description": "Update resource log stream override information for the provided resource. A resource log stream override takes precedence over a owner log stream if it exists.",
        "operationId": "update-resource-log-stream",
        "tags": ["Logs"],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["setting"],
                "properties": {
                  "endpoint": {
                    "$ref": "#/paths/~1logs~1streams~1owner~1%7BownerId%7D/put/requestBody/content/application~1json/schema/properties/endpoint"
                  },
                  "token": {
                    "$ref": "#/paths/~1logs~1streams~1owner~1%7BownerId%7D/put/requestBody/content/application~1json/schema/properties/token"
                  },
                  "setting": {
                    "$ref": "#/paths/~1logs~1streams~1resource/get/parameters/3/schema/items"
                  }
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "resourceId",
            "in": "path",
            "description": "The ID of the resource (server, cron job, postgres, or redis) whose log streams should be returned",
            "schema": { "type": "string" },
            "required": true
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/paths/~1logs~1streams~1resource~1%7BresourceId%7D/get/responses/200"
          },
          "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 resource log stream override",
        "description": "Remove the resource log stream override for the provided resource. This resource will now use the owner log stream if it exists.",
        "operationId": "delete-resource-log-stream",
        "tags": ["Logs"],
        "parameters": [
          {
            "name": "resourceId",
            "in": "path",
            "description": "The ID of the resource (server, cron job, postgres, or redis) whose log streams should be returned",
            "schema": { "type": "string" },
            "required": true
          }
        ],
        "responses": {
          "204": { "description": "Log stream setting 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" }
        }
      }
    },
    "/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": { "$ref": "#/components/schemas/redisWithCursor" }
                }
              }
            }
          },
          "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": { "$ref": "#/components/schemas/postgresWithCursor" }
                }
              }
            }
          },
          "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
      },
      "resourceIdParam": {
        "name": "resourceId",
        "in": "query",
        "required": false,
        "description": "IDs of resources (server, cron job, postgres, or redis) to filter by",
        "schema": { "type": "array", "items": { "type": "string" } }
      },
      "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,
        "deprecated": true,
        "description": "Filter for environments (runtimes) of services (deprecated; use `runtime` instead)"
      },
      "runtimeParam": {
        "name": "env",
        "in": "query",
        "schema": {
          "type": "array",
          "items": { "$ref": "#/components/schemas/serviceRuntime" }
        },
        "style": "form",
        "explode": false,
        "required": false,
        "deprecated": true,
        "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"
      },
      "includePreviewsParam": {
        "name": "includePreviews",
        "in": "query",
        "schema": { "type": "boolean", "default": true },
        "required": false,
        "description": "Include previews in the response"
      },
      "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_mode_enabled",
                "maintenance_mode_uri_updated",
                "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" }
            ]
          }
        }
      },
      "deployList": {
        "type": "array",
        "items": { "$ref": "#/components/schemas/deployWithCursor" }
      },
      "deployWithCursor": {
        "type": "object",
        "properties": {
          "deploy": { "$ref": "#/components/schemas/deploy" },
          "cursor": { "$ref": "#/components/schemas/cursor" }
        }
      },
      "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", "AWS_ECR"],
        "description": "The registry to use this credential with"
      },
      "registryCredential": {
        "type": "object",
        "required": ["id", "name", "username", "registry", "updatedAt"],
        "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"
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Last updated time for 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", "url", "buildPlan"],
        "properties": {
          "buildCommand": { "type": "string" },
          "parentServer": { "$ref": "#/components/schemas/resource" },
          "publishPath": { "type": "string" },
          "pullRequestPreviewsEnabled": {
            "$ref": "#/components/schemas/pullRequestPreviewsEnabled"
          },
          "previews": { "$ref": "#/components/schemas/previews" },
          "url": { "type": "string" },
          "buildPlan": { "$ref": "#/components/schemas/buildPlan" }
        }
      },
      "maintenanceMode": {
        "type": "object",
        "required": ["enabled", "uri"],
        "properties": {
          "enabled": { "type": "boolean" },
          "uri": {
            "type": "string",
            "description": "The page to be served when [maintenance mode](https://docs.render.com/maintenance-mode) is enabled. When empty, the default maintenance mode page is served."
          }
        }
      },
      "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",
          "runtime",
          "envSpecificDetails",
          "plan",
          "region",
          "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/serviceEnv" },
          "envSpecificDetails": {
            "$ref": "#/components/schemas/envSpecificDetails"
          },
          "healthCheckPath": { "type": "string" },
          "maintenanceMode": { "$ref": "#/components/schemas/maintenanceMode" },
          "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"
          },
          "previews": { "$ref": "#/components/schemas/previews" },
          "region": { "$ref": "#/components/schemas/region" },
          "runtime": { "$ref": "#/components/schemas/serviceRuntime" },
          "sshAddress": { "$ref": "#/components/schemas/sshAddress" },
          "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",
          "runtime",
          "envSpecificDetails",
          "plan",
          "region",
          "numInstances",
          "buildPlan",
          "openPorts",
          "url"
        ],
        "properties": {
          "autoscaling": {
            "$ref": "#/components/schemas/webServiceDetails/properties/autoscaling"
          },
          "disk": {
            "$ref": "#/components/schemas/webServiceDetails/properties/disk"
          },
          "env": { "$ref": "#/components/schemas/serviceEnv" },
          "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"
          },
          "previews": { "$ref": "#/components/schemas/previews" },
          "region": { "$ref": "#/components/schemas/region" },
          "runtime": { "$ref": "#/components/schemas/serviceRuntime" },
          "sshAddress": { "$ref": "#/components/schemas/sshAddress" },
          "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",
          "runtime",
          "envSpecificDetails",
          "plan",
          "region",
          "numInstances",
          "buildPlan"
        ],
        "properties": {
          "autoscaling": {
            "$ref": "#/components/schemas/webServiceDetails/properties/autoscaling"
          },
          "disk": {
            "$ref": "#/components/schemas/webServiceDetails/properties/disk"
          },
          "env": { "$ref": "#/components/schemas/serviceEnv" },
          "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"
          },
          "previews": { "$ref": "#/components/schemas/previews" },
          "region": { "$ref": "#/components/schemas/region" },
          "runtime": { "$ref": "#/components/schemas/serviceRuntime" },
          "sshAddress": { "$ref": "#/components/schemas/sshAddress" },
          "buildPlan": { "$ref": "#/components/schemas/buildPlan" },
          "maxShutdownDelaySeconds": {
            "$ref": "#/components/schemas/maxShutdownDelaySeconds"
          }
        }
      },
      "cronJobDetails": {
        "required": [
          "env",
          "runtime",
          "envSpecificDetails",
          "plan",
          "region",
          "schedule",
          "buildPlan"
        ],
        "type": "object",
        "properties": {
          "env": { "$ref": "#/components/schemas/serviceEnv" },
          "envSpecificDetails": {
            "$ref": "#/components/schemas/envSpecificDetails"
          },
          "lastSuccessfulRunAt": { "type": "string", "format": "date-time" },
          "plan": { "$ref": "#/components/schemas/plan" },
          "region": { "$ref": "#/components/schemas/region" },
          "runtime": { "$ref": "#/components/schemas/serviceRuntime" },
          "schedule": { "type": "string" },
          "buildPlan": { "$ref": "#/components/schemas/buildPlan" }
        }
      },
      "serviceList": {
        "type": "array",
        "items": { "$ref": "#/components/schemas/serviceWithCursor" }
      },
      "serviceWithCursor": {
        "type": "object",
        "required": ["service", "cursor"],
        "properties": {
          "service": { "$ref": "#/components/schemas/service" },
          "cursor": { "$ref": "#/components/schemas/cursor" }
        }
      },
      "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"
          },
          "previews": { "$ref": "#/components/schemas/previews" },
          "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" },
          "maintenanceMode": { "$ref": "#/components/schemas/maintenanceMode" },
          "numInstances": {
            "type": "integer",
            "minimum": 1,
            "description": "Defaults to 1"
          },
          "plan": { "$ref": "#/components/schemas/paidPlan" },
          "preDeployCommand": { "type": "string" },
          "pullRequestPreviewsEnabled": {
            "$ref": "#/components/schemas/pullRequestPreviewsEnabled"
          },
          "previews": { "$ref": "#/components/schemas/previews" },
          "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"
          },
          "previews": { "$ref": "#/components/schemas/previews" },
          "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"
          },
          "previews": { "$ref": "#/components/schemas/previews" },
          "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"
          },
          "previews": { "$ref": "#/components/schemas/previews" }
        }
      },
      "webServiceDetailsPATCH": {
        "type": "object",
        "properties": {
          "envSpecificDetails": {
            "$ref": "#/components/schemas/envSpecificDetailsPATCH"
          },
          "healthCheckPath": { "type": "string" },
          "maintenanceMode": { "$ref": "#/components/schemas/maintenanceMode" },
          "plan": { "$ref": "#/components/schemas/paidPlan" },
          "preDeployCommand": { "type": "string" },
          "pullRequestPreviewsEnabled": {
            "$ref": "#/components/schemas/pullRequestPreviewsEnabled"
          },
          "previews": { "$ref": "#/components/schemas/previews" },
          "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"
          },
          "previews": { "$ref": "#/components/schemas/previews" },
          "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"
          },
          "previews": { "$ref": "#/components/schemas/previews" },
          "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"] }
        }
      },
      "ownerWithCursor": {
        "type": "object",
        "properties": {
          "owner": { "$ref": "#/components/schemas/owner" },
          "cursor": { "$ref": "#/components/schemas/cursor" }
        }
      },
      "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."
      },
      "sshAddress": {
        "type": "string",
        "description": "The SSH address for the service. Only present for services that have SSH enabled."
      },
      "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",
        "deprecated": true,
        "description": "This field has been deprecated. previews.generation should be used in its place."
      },
      "previews": {
        "type": "object",
        "properties": {
          "generation": {
            "type": "string",
            "enum": ["off", "manual", "automatic"],
            "default": "off",
            "description": "Defaults to \"off\""
          }
        }
      },
      "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"
          }
        }
      },
      "redisWithCursor": {
        "type": "object",
        "required": ["redis", "cursor"],
        "properties": {
          "redis": { "$ref": "#/components/schemas/redis" },
          "cursor": { "$ref": "#/components/schemas/cursor" }
        }
      },
      "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" },
          "diskSizeGB": {
            "type": "integer",
            "description": "The number of gigabytes of disk space to allocate for the database"
          },
          "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" },
          "diskSizeGB": {
            "type": "integer",
            "description": "The number of gigabytes of disk space to allocate for the database"
          },
          "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" }
        }
      },
      "postgresWithCursor": {
        "type": "object",
        "required": ["postgres", "cursor"],
        "properties": {
          "postgres": { "$ref": "#/components/schemas/postgres" },
          "cursor": { "$ref": "#/components/schemas/cursor" }
        }
      },
      "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",
              "basic_256mb",
              "basic_1gb",
              "basic_4gb",
              "pro_4gb",
              "pro_8gb",
              "pro_16gb",
              "pro_32gb",
              "pro_64gb",
              "pro_128gb",
              "pro_192gb",
              "pro_256gb",
              "pro_384gb",
              "pro_512gb",
              "accelerated_16gb",
              "accelerated_32gb",
              "accelerated_64gb",
              "accelerated_128gb",
              "accelerated_256gb",
              "accelerated_384gb",
              "accelerated_512gb",
              "accelerated_768gb",
              "accelerated_1024gb"
            ]
          },
          "diskSizeGB": { "type": "integer" },
          "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" },
          "diskSizeGB": { "type": "integer" },
          "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": "#/components/schemas/jobWithCursor/properties/job/properties/status"
                      },
                      "reason": {
                        "$ref": "#/components/schemas/serviceEventWithCursor/properties/event/properties/details/oneOf/9/properties/reason"
                      }
                    }
                  },
                  {
                    "type": "object",
                    "required": ["enabled"],
                    "properties": { "enabled": { "type": "boolean" } }
                  },
                  {
                    "type": "object",
                    "required": ["fromURI", "toURI"],
                    "properties": {
                      "fromURI": { "type": "string" },
                      "toURI": { "type": "string" }
                    }
                  },
                  { "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" } }
                  }
                ]
              }
            }
          }
        }
      },
      "jobWithCursor": {
        "type": "object",
        "required": ["job", "cursor"],
        "properties": {
          "job": {
            "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"
              }
            }
          },
          "cursor": { "$ref": "#/components/schemas/cursor" }
        }
      },
      "user": {
        "type": "object",
        "required": ["email", "name"],
        "properties": {
          "email": { "type": "string" },
          "name": { "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" } }
          }
        }
      }
    }
  }
}