{
  "openapi": "3.0.3",
  "info": {
    "title": "Momentic Analytics API",
    "version": "1.0.0",
    "description": "Read completed runs and run groups from Momentic analytics."
  },
  "servers": [
    {
      "url": "https://api.momentic.ai"
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "tags": [
    {
      "name": "Analytics"
    }
  ],
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer"
      }
    },
    "schemas": {
      "ExternalRunsResponse": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "status": {
                  "type": "string",
                  "enum": ["PASSED", "FAILED", "CANCELLED"]
                },
                "trigger": {
                  "type": "string",
                  "enum": ["WEBHOOK", "CRON", "MANUAL", "CLI"]
                },
                "executionType": {
                  "anyOf": [
                    {
                      "type": "string",
                      "enum": ["WEB"]
                    },
                    {
                      "type": "string",
                      "enum": ["ANDROID", "IOS"]
                    }
                  ]
                },
                "testId": {
                  "type": "string"
                },
                "testName": {
                  "type": "string"
                },
                "description": {
                  "nullable": true,
                  "type": "string"
                },
                "directory": {
                  "nullable": true,
                  "type": "string"
                },
                "environmentName": {
                  "nullable": true,
                  "type": "string"
                },
                "labels": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "gitBranchName": {
                  "nullable": true,
                  "type": "string"
                },
                "gitCommitSha": {
                  "nullable": true,
                  "type": "string"
                },
                "gitCommitShaShort": {
                  "nullable": true,
                  "type": "string"
                },
                "githubRepository": {
                  "nullable": true,
                  "type": "string"
                },
                "gitlabProjectPath": {
                  "nullable": true,
                  "type": "string"
                },
                "cliVersion": {
                  "nullable": true,
                  "type": "string"
                },
                "pipelineId": {
                  "nullable": true,
                  "type": "string"
                },
                "createdAt": {
                  "type": "string",
                  "format": "date-time"
                },
                "startedAt": {
                  "type": "string",
                  "format": "date-time"
                },
                "finishedAt": {
                  "type": "string",
                  "format": "date-time"
                },
                "flake": {
                  "type": "boolean"
                },
                "attempts": {
                  "type": "number"
                },
                "quarantined": {
                  "type": "boolean"
                },
                "quarantinedReason": {
                  "nullable": true,
                  "type": "string"
                },
                "failureReason": {
                  "nullable": true,
                  "type": "string"
                }
              },
              "required": [
                "id",
                "status",
                "trigger",
                "executionType",
                "testId",
                "testName",
                "description",
                "directory",
                "environmentName",
                "labels",
                "gitBranchName",
                "gitCommitSha",
                "gitCommitShaShort",
                "githubRepository",
                "gitlabProjectPath",
                "cliVersion",
                "pipelineId",
                "createdAt",
                "startedAt",
                "finishedAt",
                "flake",
                "attempts",
                "quarantined",
                "quarantinedReason",
                "failureReason"
              ],
              "additionalProperties": false
            }
          },
          "pagination": {
            "type": "object",
            "properties": {
              "pageSize": {
                "type": "integer",
                "minimum": 1,
                "maximum": 100
              },
              "hasMore": {
                "type": "boolean"
              },
              "nextCursor": {
                "nullable": true,
                "type": "string"
              },
              "total": {
                "nullable": true,
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              }
            },
            "required": ["pageSize", "hasMore", "nextCursor", "total"],
            "additionalProperties": false
          }
        },
        "required": ["data", "pagination"],
        "additionalProperties": false
      },
      "ExternalRunGroupsResponse": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "status": {
                  "type": "string",
                  "enum": ["PASSED", "FAILED", "CANCELLED"]
                },
                "trigger": {
                  "type": "string",
                  "enum": ["WEBHOOK", "CRON", "MANUAL", "CLI"]
                },
                "createdAt": {
                  "type": "string",
                  "format": "date-time"
                },
                "startedAt": {
                  "type": "string",
                  "format": "date-time"
                },
                "finishedAt": {
                  "type": "string",
                  "format": "date-time"
                },
                "gitBranchName": {
                  "nullable": true,
                  "type": "string"
                },
                "gitCommitSha": {
                  "nullable": true,
                  "type": "string"
                },
                "gitCommitShaShort": {
                  "nullable": true,
                  "type": "string"
                },
                "githubRepository": {
                  "nullable": true,
                  "type": "string"
                },
                "gitlabProjectPath": {
                  "nullable": true,
                  "type": "string"
                },
                "pipelineId": {
                  "nullable": true,
                  "type": "string"
                },
                "ciProvider": {
                  "nullable": true,
                  "type": "string"
                },
                "cliVersion": {
                  "nullable": true,
                  "type": "string"
                },
                "suite": {
                  "nullable": true,
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    }
                  },
                  "required": ["id", "name"],
                  "additionalProperties": false
                },
                "localSuiteName": {
                  "nullable": true,
                  "type": "string"
                },
                "labels": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "runCounts": {
                  "type": "object",
                  "properties": {
                    "total": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991
                    },
                    "passed": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991
                    },
                    "failed": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991
                    },
                    "cancelled": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991
                    }
                  },
                  "required": ["total", "passed", "failed", "cancelled"],
                  "additionalProperties": false
                }
              },
              "required": [
                "id",
                "status",
                "trigger",
                "createdAt",
                "startedAt",
                "finishedAt",
                "gitBranchName",
                "gitCommitSha",
                "gitCommitShaShort",
                "githubRepository",
                "gitlabProjectPath",
                "pipelineId",
                "ciProvider",
                "cliVersion",
                "suite",
                "localSuiteName",
                "labels",
                "runCounts"
              ],
              "additionalProperties": false
            }
          },
          "pagination": {
            "type": "object",
            "properties": {
              "pageSize": {
                "type": "integer",
                "minimum": 1,
                "maximum": 100
              },
              "hasMore": {
                "type": "boolean"
              },
              "nextCursor": {
                "nullable": true,
                "type": "string"
              },
              "total": {
                "nullable": true,
                "type": "integer",
                "minimum": 0,
                "maximum": 9007199254740991
              }
            },
            "required": ["pageSize", "hasMore", "nextCursor", "total"],
            "additionalProperties": false
          }
        },
        "required": ["data", "pagination"],
        "additionalProperties": false
      }
    }
  },
  "paths": {
    "/v1/runs": {
      "get": {
        "summary": "List runs",
        "description": "List completed runs with filters and pagination.",
        "operationId": "listRuns",
        "tags": ["Analytics"],
        "parameters": [
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "Page size, up to 100.",
            "schema": {
              "type": "integer",
              "default": 20,
              "minimum": 1,
              "maximum": 100
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from a previous response's pagination.nextCursor. Omit for the first page.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "includeTotal",
            "in": "query",
            "required": false,
            "description": "Include the exact total match count in the response. Off by default to avoid an extra aggregation. Accepts true, false, 1, or 0.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "startDate",
            "in": "query",
            "required": false,
            "description": "Start of the window. Defaults to 30 days before endDate. Must be before endDate. The window may not exceed 92 days.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "endDate",
            "in": "query",
            "required": false,
            "description": "End of the window. Defaults to now.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": false,
            "description": "Completed run statuses. Comma-separated.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": ["PASSED", "FAILED", "CANCELLED"]
              }
            }
          },
          {
            "name": "trigger",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": false,
            "description": "Run trigger values. Comma-separated.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": ["WEBHOOK", "CRON", "MANUAL", "CLI"]
              }
            }
          },
          {
            "name": "gitBranchName",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": false,
            "description": "Git branch name filter. Comma-separated.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "githubRepository",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": false,
            "description": "GitHub repository filter. Comma-separated.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "gitlabProjectPath",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": false,
            "description": "GitLab project path filter. Comma-separated.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "gitCommitSha",
            "in": "query",
            "required": false,
            "description": "Exact commit SHA filter.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cliVersion",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": false,
            "description": "CLI version filter. Comma-separated.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "label",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": false,
            "description": "Labels attached to the run. Comma-separated.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "environment",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": false,
            "description": "Environment name filter. Comma-separated.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "executionType",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": false,
            "description": "Run platform filter. Comma-separated.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": ["WEB", "IOS", "ANDROID"]
              }
            }
          },
          {
            "name": "testId",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": false,
            "description": "Test ID filter. Comma-separated.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "testNameContains",
            "in": "query",
            "required": false,
            "description": "Substring match on test name.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "directory",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": false,
            "description": "Directory filter. Matches the directory and its subdirectories. Comma-separated.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "quarantined",
            "in": "query",
            "required": false,
            "description": "Quarantined run filter. Accepts true, false, 1, or 0.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "recovered",
            "in": "query",
            "required": false,
            "description": "Filter for runs that passed after a failure recovery attempt. Implies PASSED status when true, so do not combine with status=FAILED. Accepts true, false, 1, or 0.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "healed",
            "in": "query",
            "required": false,
            "description": "Auto-heal filter. Accepts true, false, 1, or 0.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "onlyCIRuns",
            "in": "query",
            "required": false,
            "description": "CI-only run filter. Accepts true, false, 1, or 0.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExternalRunsResponse"
                },
                "example": {
                  "data": [
                    {
                      "id": "run_01J9D90XPXMA4T0TSN76VFQ2K8",
                      "status": "PASSED",
                      "trigger": "WEBHOOK",
                      "executionType": "WEB",
                      "testId": "checkout-flow",
                      "testName": "Checkout flow",
                      "description": "Covers the purchase path",
                      "directory": "e2e/checkout",
                      "environmentName": "production",
                      "labels": ["smoke", "checkout"],
                      "gitBranchName": "main",
                      "gitCommitSha": "8d8b7f5c0c2d5d2a0c8c4d6b9a1a2b3c4d5e6f70",
                      "gitCommitShaShort": "8d8b7f5",
                      "githubRepository": "momentic-ai/storefront",
                      "gitlabProjectPath": null,
                      "cliVersion": "1.24.0",
                      "pipelineId": "build_1827",
                      "createdAt": "2026-07-01T12:00:00.000Z",
                      "startedAt": "2026-07-01T12:00:10.000Z",
                      "finishedAt": "2026-07-01T12:02:14.000Z",
                      "flake": false,
                      "attempts": 0,
                      "quarantined": false,
                      "quarantinedReason": null,
                      "failureReason": null
                    }
                  ],
                  "pagination": {
                    "pageSize": 20,
                    "hasMore": false,
                    "nextCursor": null,
                    "total": null
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid query parameters, cursor, or date window.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": ["error"],
                  "additionalProperties": false
                },
                "example": {
                  "error": "Invalid cursor."
                }
              }
            }
          },
          "401": {
            "description": "Missing or malformed authentication credentials.",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string"
                },
                "example": "Missing token"
              },
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": ["error"],
                  "additionalProperties": false
                },
                "examples": {
                  "missingApiKey": {
                    "value": {
                      "error": "Missing API key"
                    }
                  },
                  "missingUserContext": {
                    "value": {
                      "error": "Missing userId and orgId."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "The API key is invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": ["error"],
                  "additionalProperties": false
                },
                "example": {
                  "error": "Invalid API key"
                }
              }
            }
          },
          "429": {
            "description": "The organization's request rate limit was exceeded.",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "text/html": {
                "schema": {
                  "type": "string"
                },
                "example": "Too many requests, please try again later."
              }
            }
          },
          "500": {
            "description": "Unexpected server error or request timeout.",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string"
                },
                "examples": {
                  "unexpectedError": {
                    "value": "Oops! Something went wrong with our servers. Our engineers have been notified and we're on it."
                  },
                  "timeout": {
                    "value": "Timed out"
                  }
                }
              }
            }
          },
          "503": {
            "description": "API key validation is temporarily unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": ["error"],
                  "additionalProperties": false
                },
                "example": {
                  "error": "We encountered a temporary error validating your API key."
                }
              }
            }
          },
          "529": {
            "description": "The database is overloaded. Avoid automatic retries.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": ["error"],
                  "additionalProperties": false
                },
                "example": {
                  "error": "The database is overloaded. Please try again later."
                }
              }
            }
          }
        }
      }
    },
    "/v1/run-groups": {
      "get": {
        "summary": "List run groups",
        "description": "List completed run groups with filters and pagination.",
        "operationId": "listRunGroups",
        "tags": ["Analytics"],
        "parameters": [
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "description": "Page size, up to 100.",
            "schema": {
              "type": "integer",
              "default": 20,
              "minimum": 1,
              "maximum": 100
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque keyset cursor from a previous response's pagination.nextCursor. Omit for the first page.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "includeTotal",
            "in": "query",
            "required": false,
            "description": "Include the exact total match count in the response. Off by default to avoid an extra aggregation. Accepts true, false, 1, or 0.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "startDate",
            "in": "query",
            "required": false,
            "description": "Start of the window. Defaults to 30 days before endDate. Must be before endDate. The window may not exceed 92 days.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "endDate",
            "in": "query",
            "required": false,
            "description": "End of the window. Defaults to now.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": false,
            "description": "Completed run group statuses. Comma-separated.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": ["PASSED", "FAILED", "CANCELLED"]
              }
            }
          },
          {
            "name": "trigger",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": false,
            "description": "Run trigger values. Comma-separated.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": ["WEBHOOK", "CRON", "MANUAL", "CLI"]
              }
            }
          },
          {
            "name": "gitBranchName",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": false,
            "description": "Git branch name filter. Comma-separated.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "githubRepository",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": false,
            "description": "GitHub repository filter. Comma-separated.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "gitlabProjectPath",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": false,
            "description": "GitLab project path filter. Comma-separated.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "gitCommitSha",
            "in": "query",
            "required": false,
            "description": "Exact commit SHA filter.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cliVersion",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": false,
            "description": "CLI version filter. Comma-separated.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "label",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": false,
            "description": "Labels attached to the run group. Comma-separated.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "executionType",
            "in": "query",
            "required": false,
            "style": "form",
            "explode": false,
            "description": "Run platform filter. Comma-separated.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "enum": ["WEB", "IOS", "ANDROID"]
              }
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExternalRunGroupsResponse"
                },
                "example": {
                  "data": [
                    {
                      "id": "run_group_01J9D90XPXMA4T0TSN76VFQ2K8",
                      "status": "FAILED",
                      "trigger": "WEBHOOK",
                      "createdAt": "2026-07-01T12:00:00.000Z",
                      "startedAt": "2026-07-01T12:00:10.000Z",
                      "finishedAt": "2026-07-01T12:05:14.000Z",
                      "gitBranchName": "main",
                      "gitCommitSha": "8d8b7f5c0c2d5d2a0c8c4d6b9a1a2b3c4d5e6f70",
                      "gitCommitShaShort": "8d8b7f5",
                      "githubRepository": "momentic-ai/storefront",
                      "gitlabProjectPath": null,
                      "pipelineId": "build_1827",
                      "ciProvider": "github",
                      "cliVersion": "1.24.0",
                      "suite": {
                        "id": "suite_checkout",
                        "name": "Checkout"
                      },
                      "localSuiteName": null,
                      "labels": ["smoke", "checkout"],
                      "runCounts": {
                        "total": 4,
                        "passed": 3,
                        "failed": 1,
                        "cancelled": 0
                      }
                    }
                  ],
                  "pagination": {
                    "pageSize": 20,
                    "hasMore": false,
                    "nextCursor": null,
                    "total": null
                  }
                }
              }
            }
          },
          "400": {
            "description": "Invalid query parameters, cursor, or date window.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": ["error"],
                  "additionalProperties": false
                },
                "example": {
                  "error": "Invalid cursor."
                }
              }
            }
          },
          "401": {
            "description": "Missing or malformed authentication credentials.",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string"
                },
                "example": "Missing token"
              },
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": ["error"],
                  "additionalProperties": false
                },
                "examples": {
                  "missingApiKey": {
                    "value": {
                      "error": "Missing API key"
                    }
                  },
                  "missingUserContext": {
                    "value": {
                      "error": "Missing userId and orgId."
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "The API key is invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": ["error"],
                  "additionalProperties": false
                },
                "example": {
                  "error": "Invalid API key"
                }
              }
            }
          },
          "429": {
            "description": "The organization's request rate limit was exceeded.",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before retrying.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "text/html": {
                "schema": {
                  "type": "string"
                },
                "example": "Too many requests, please try again later."
              }
            }
          },
          "500": {
            "description": "Unexpected server error or request timeout.",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string"
                },
                "examples": {
                  "unexpectedError": {
                    "value": "Oops! Something went wrong with our servers. Our engineers have been notified and we're on it."
                  },
                  "timeout": {
                    "value": "Timed out"
                  }
                }
              }
            }
          },
          "503": {
            "description": "API key validation is temporarily unavailable.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": ["error"],
                  "additionalProperties": false
                },
                "example": {
                  "error": "We encountered a temporary error validating your API key."
                }
              }
            }
          },
          "529": {
            "description": "The database is overloaded. Avoid automatic retries.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "string"
                    }
                  },
                  "required": ["error"],
                  "additionalProperties": false
                },
                "example": {
                  "error": "The database is overloaded. Please try again later."
                }
              }
            }
          }
        }
      }
    }
  }
}