Render

Render API

The Render Public API enables full programmatic management of Render services, databases, and infrastructure. It supports deploying web services, static sites, background workers, cron jobs, and private services; managing PostgreSQL and Key-Value databases; configuring environment variables, secret files, custom domains, and blueprints; scaling and autoscaling services; streaming logs and metrics; and orchestrating multi-service workflows. Authentication uses a Bearer API key from the Render Dashboard.

GitHub OpenAPI

Documentation

📖
Documentation
https://render.com/docs/api

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/render/refs/heads/main/openapi/render-openapi.json

Examples

📝
Example
https://raw.githubusercontent.com/api-evangelist/render/refs/heads/main/examples/render-create-service-example.json
📝
Example
https://raw.githubusercontent.com/api-evangelist/render/refs/heads/main/examples/render-trigger-deploy-example.json

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/render/refs/heads/main/json-schema/render-service-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/render/refs/heads/main/json-schema/render-deploy-schema.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/render/refs/heads/main/json-structure/render-service-structure.json

Other Resources

🔗
OpenAPISpec
https://api-docs.render.com/v1.0/openapi/render-public-api-1.json
🔗
ReferenceDocumentation
https://api-docs.render.com
🔗
Rules
https://raw.githubusercontent.com/api-evangelist/render/refs/heads/main/rules/render-rules.yml
🔗
Capabilities
https://raw.githubusercontent.com/api-evangelist/render/refs/heads/main/capabilities/service-deployment.yaml
🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/render/refs/heads/main/json-ld/render-context.jsonld
🔗
Vocabulary
https://raw.githubusercontent.com/api-evangelist/render/refs/heads/main/vocabulary/render-vocabulary.yml

OpenAPI Specification

render-openapi.json Raw ↑ 
{
  "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": "[email protected]"
    }
  },
  "x-readme": {
    "metrics-enabled": false
  },
  "servers": [
    {
      "url": "https://api.render.com/v1"
    }
  ],
  "security": [
    {
      "BearerAuth": []
    }
  ],
  "tags": [
    {
      "name": "Audit Logs",
      "description": "[Audit Logs](https://render.com/docs/audit-logs) allow you to retrieve audit logs for workspaces and organizations.\nThese logs provide a trail of actions and changes made to your resources.\n"
    },
    {
      "name": "Blueprints",
      "description": "[Blueprints](https://render.com/docs/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://render.com/docs/custom-domains) allow you to associate domain names with your Render services.\n"
    },
    {
      "name": "Deploys",
      "description": "[Deploys](https://render.com/docs/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://render.com/docs/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": "Events",
      "description": "View events for a service, postgres or key value"
    },
    {
      "name": "Key Value",
      "description": "[Key Value](https://render.com/docs/key-value) allows you to interact with your Render Key Value instances.\n"
    },
    {
      "name": "Logs",
      "description": "[Logs](https://render.com/docs/logging) allow you to retrieve logs for your services, Postgres 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, Postgres databases, and redis instances."
    },
    {
      "name": "Notification Settings",
      "description": "[Notification Settings](https://render.com/docs/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://render.com/docs/one-off-jobs) are standalone tasks that run to completion using the most recent successful build of an existing service.\n"
    },
    {
      "name": "Postgres",
      "description": "[Postgres](https://render.com/docs/postgresql) endpoints enable you to interact with your Render Postgres databases.\nYou can manage databases, exports, recoveries, and failovers.\n"
    },
    {
      "name": "Projects & Environments",
      "description": "Collections of services and other resources organized by environment (staging, production, etc.)"
    },
    {
      "name": "Registry Credentials",
      "description": "[Registry Credentials](https://render.com/docs/deploying-an-image#credentials-for-private-images) allows you to manage credentials for private Docker images.\n"
    },
    {
      "name": "Services",
      "description": "[Services](https://render.com/docs/service-types) 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://render.com/docs/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"
    },
    {
      "name": "Workspaces",
      "description": "The `Workspaces` endpoints supply more information about the workspaces that your API key has access to. This category was previously called `Owners`, as reflected by endpoint paths."
    },
    {
      "name": "Webhooks",
      "description": "[Webhooks](https://render.com/docs/webhooks) allows you to manage your Render webhook configuration.\n"
    },
    {
      "name": "Workflows (Beta)",
      "description": "Create and manage [Render Workflows](https://render.com/docs/workflows) services. Workflows are in public beta.\n"
    },
    {
      "name": "Workflow Tasks (Beta)",
      "description": "Run and manage tasks as part of [Render Workflows](https://render.com/docs/workflows). Workflows are in public beta.\n"
    },
    {
      "name": "Redis (Deprecated)",
      "description": "[Redis](https://render.com/docs/redis) allows you to interact with your Render Redis instances. This API is deprecated in favor of the Key Value API.\n"
    }
  ],
  "paths": {
    "/blueprints": {
      "get": {
        "summary": "List Blueprints",
        "description": "List Blueprints for the specified workspaces. If no workspaces are provided, returns all Blueprints the API key has access to.\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/validate": {
      "post": {
        "summary": "Validate Blueprint",
        "description": "Validate a `render.yaml` Blueprint file without creating or modifying any resources. This endpoint checks the syntax and structure of the Blueprint, validates that all required fields are present, and returns a plan indicating the resources that would be created.\n\nRequests to this endpoint use `Content-Type: multipart/form-data`. The provided Blueprint file cannot exceed 10MB in size.\n",
        "operationId": "validate-blueprint",
        "tags": [
          "Blueprints"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "required": [
                  "ownerId",
                  "file"
                ],
                "properties": {
                  "ownerId": {
                    "type": "string",
                    "description": "The ID of the workspace to validate against. Obtain your workspace ID from its Settings page in the Render Dashboard.",
                    "example": "tea-cjnxpkdhshc73d12t9i0"
                  },
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The render.yaml file to validate, as a binary file."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Validation complete",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "valid"
                  ],
                  "properties": {
                    "valid": {
                      "type": "boolean",
                      "description": "If `true`, the Blueprint validated successfully. If `false`, at least one validation error occurred."
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "error"
                        ],
                        "properties": {
                          "path": {
                            "type": "string",
                            "description": "The path to the field with the error (e.g., `services[0].plan`)"
                          },
                          "error": {
                            "type": "string",
                            "description": "The error message"
                          },
                          "line": {
                            "type": "integer",
                            "description": "The line number in the YAML file (1-indexed)"
                          },
                          "column": {
                            "type": "integer",
                            "description": "The column number in the YAML file (1-indexed)"
                          }
                        }
                      },
                      "description": "A list of validation errors. Only present if `valid` is `false`."
                    },
                    "plan": {
                      "description": "A summary of the resources that would be created as part of the Blueprint. Only present if `valid` is `true`.",
                      "type": "object",
                      "properties": {
                        "services": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "description": "The names of services that would be created as part of the Blueprint."
                        },
                        "databases": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "description": "The names of Render Postgres databases that would be created as part of the Blueprint."
                        },
                        "keyValue": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "description": "The names of Render Key Value instances that would be created as part of the Blueprint."
                        },
                        "envGroups": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "description": "The names of environment groups that would be created as part of the Blueprint."
                        },
                        "totalActions": {
                          "type": "integer",
                          "description": "The total number of actions that would be performed by the Blueprint. In addition to created resources, this includes modifications to individual configuration fields."
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "429": {
            "$ref": "#/components/responses/429RateLimit"
          },
          "500": {
            "$ref": "#/components/responses/500InternalServerError"
          }
        }
      }
    },
    "/owners/{ownerId}/members/{userId}": {
      "parameters": [
        {
          "$ref": "#/components/parameters/ownerIdPathParam"
        },
        {
          "$ref": "#/components/parameters/userIdPathParam"
        }
      ],
      "patch": {
        "summary": "Update workspace member role",
        "description": "Update the role of an existing workspace member.\n",
        "operationId": "update-workspace-member",
        "tags": [
          "Workspaces"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "role"
                ],
                "properties": {
                  "role": {
                    "$ref": "#/components/schemas/teamMemberRole"
                  }
                }
              },
              "example": {
                "role": "ADMIN"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/teamMember"
                },
                "example": {
                  "userId": "usr-0r1b2c3d4e5f6g7h8i9",
                  "name": "Jane Doe",
                  "email": "[email protected]",
                  "status": "active",
                  "role": "ADMIN",
                  "mfaEnabled": true
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/400BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/401Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/403Forbidden"
          },
          "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": {
        "summary": "Remove workspace member",
        "description": "Remove a user from the specified workspace.\n",
        "operationId": "remove-workspace-member",
        "tags": [
          "Workspaces"
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "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"
          }
        }
      }
    },
    "/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",
                    "path",
                    "resources"
                  ],
                  "properties": {
                    "id": {
                      "$ref": "#/paths/~1blueprints~1%7BblueprintId%7D/parameters/0/schema"
                    },
                    "name": {
                      "type": "string"
                    },
                    "status": {
                      "$ref": "#/components/schemas/blueprintWithCursor/properties/blueprint/properties/status"
                    },
                    "autoSync": {
                      "$ref": "#/components/schemas/blueprintWithCursor/properties/blueprint/properties/autoSync"
                    },
                    "repo": {
                      "type": "string"
                    },
                    "branch": {
                      "type": "string"
                    },
                    "path": {
                      "$ref": "#/components/schemas/blueprintWithCursor/properties/blueprint/properties/path"
                    },
                    "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",
                              "key_value",
                              "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": {
                    "$ref": "#/components/schemas/blueprintWithCursor/properties/blueprint/properties/autoSync"
                  },
                  "path": {
                    "$ref": "#/components/schemas/blueprintWithCursor/properties/blueprint/properties/path"
                  }
                }
              }
            }
          }
        },
        "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/429Ra

# --- truncated at 32 KB (551 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/render/refs/heads/main/openapi/render-openapi.json