{
  "components": {
    "schemas": {
      "Tags": {
        "properties": {
          "Tag": {
            "type": "string"
          },
          "id": {
            "format": "int64",
            "readOnly": true,
            "type": "integer"
          }
        },
        "type": "object"
      },
      "blogs": {
        "properties": {
          "id": {
            "format": "int64",
            "readOnly": true,
            "type": "integer"
          },
          "url": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "employees": {
        "properties": {
          "createdAt": {
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "email": {
            "type": "string",
            "x-goappfw-indexed": true,
            "x-goappfw-unique": true
          },
          "firstName": {
            "type": "string"
          },
          "id": {
            "format": "int64",
            "readOnly": true,
            "type": "integer"
          },
          "role": {
            "type": "string"
          }
        },
        "required": [
          "firstName"
        ],
        "type": "object"
      },
      "posts": {
        "properties": {
          "author": {
            "type": "string"
          },
          "body": {
            "type": "string"
          },
          "createdAt": {
            "format": "date-time",
            "readOnly": true,
            "type": "string"
          },
          "id": {
            "format": "int64",
            "readOnly": true,
            "type": "integer"
          },
          "title": {
            "type": "string"
          }
        },
        "required": [
          "title",
          "author"
        ],
        "type": "object"
      },
      "sdnotes": {
        "properties": {
          "body": {
            "type": "string"
          },
          "deleted_at": {
            "format": "date-time",
            "type": "string"
          },
          "id": {
            "format": "int64",
            "readOnly": true,
            "type": "integer"
          }
        },
        "required": [
          "body"
        ],
        "type": "object"
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  },
  "info": {
    "title": "goappfw API",
    "version": "0.1.0-v2s0"
  },
  "openapi": "3.0.3",
  "paths": {
    "/api/Tags": {
      "get": {
        "operationId": "list_Tags",
        "parameters": [
          {
            "description": "Page size (default 20, clamped to a maximum of 100).",
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 20,
              "maximum": 100,
              "type": "integer"
            }
          },
          {
            "description": "Offset pagination: rows to skip. Mutually exclusive with cursor.",
            "in": "query",
            "name": "offset",
            "required": false,
            "schema": {
              "minimum": 0,
              "type": "integer"
            }
          },
          {
            "description": "Sort, comma-separated: leading \"-\" for descending (\"-createdAt\") or trailing \"asc\"/\"desc\" (\"name asc\"). Only schema fields sort; unrecognized keys are ignored. Mutually exclusive with cursor (cursor mode always reads in primary-key order).",
            "in": "query",
            "name": "order",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Opaque keyset continuation token from a prior response's pagination.nextCursor/prevCursor. Mutually exclusive with offset and order.",
            "in": "query",
            "name": "cursor",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Include an exact pagination.total (runs a COUNT(*) against the filter). Total is omitted otherwise; hasMore then uses the cheap full-page heuristic.",
            "in": "query",
            "name": "withTotal",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "description": "Field selection + inline embeds, e.g. \"id,title,author(name)\".",
            "in": "query",
            "name": "select",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Comma-separated relation fields to expand inline (one expand block per named FK field).",
            "in": "query",
            "name": "expand",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Filter on id. Bare value = equality. Prefix with an operator for anything else: neq., gt., gte., lt., lte., like., in. (comma-separated values). The bare tokens is.null / is.not_null test nullability. Repeating the param forms an IN filter.",
            "in": "query",
            "name": "id",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Filter on Tag. Bare value = equality. Prefix with an operator for anything else: neq., gt., gte., lt., lte., like., in. (comma-separated values). The bare tokens is.null / is.not_null test nullability. Repeating the param forms an IN filter.",
            "in": "query",
            "name": "Tag",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "data": {
                      "properties": {
                        "items": {
                          "items": {
                            "$ref": "#/components/schemas/Tags"
                          },
                          "nullable": true,
                          "type": "array"
                        }
                      },
                      "type": "object"
                    },
                    "pagination": {
                      "properties": {
                        "hasMore": {
                          "type": "boolean"
                        },
                        "limit": {
                          "type": "integer"
                        },
                        "nextCursor": {
                          "description": "Present when more rows may follow in primary-key order.",
                          "type": "string"
                        },
                        "offset": {
                          "type": "integer"
                        },
                        "prevCursor": {
                          "description": "Present when earlier rows are reachable backward.",
                          "type": "string"
                        },
                        "total": {
                          "description": "Rows matching the filter. Present only when withTotal=true.",
                          "format": "int64",
                          "type": "integer"
                        }
                      },
                      "type": "object"
                    },
                    "status": {
                      "example": "success",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "A paginated list of Tags"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {},
          {
            "bearerAuth": []
          }
        ],
        "summary": "List Tags"
      },
      "post": {
        "operationId": "create_Tags",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Tags"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Tags"
                    },
                    "status": {
                      "example": "success",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "The created Tags"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {},
          {
            "bearerAuth": []
          }
        ],
        "summary": "Create a Tags"
      }
    },
    "/api/Tags/batch": {
      "post": {
        "operationId": "batch_Tags",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "items": {
                    "items": {
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "op": {
                          "enum": [
                            "create",
                            "update",
                            "delete"
                          ],
                          "type": "string"
                        },
                        "record": {
                          "type": "object"
                        }
                      },
                      "required": [
                        "op"
                      ],
                      "type": "object"
                    },
                    "type": "array"
                  }
                },
                "required": [
                  "items"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Per-item results + a summary (succeeded/failed counts)"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {},
          {
            "bearerAuth": []
          }
        ],
        "summary": "Run a batch of create/update/delete Tags operations atomically"
      }
    },
    "/api/Tags/subscribe": {
      "get": {
        "operationId": "subscribe_Tags",
        "responses": {
          "200": {
            "content": {
              "text/event-stream": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "A text/event-stream of create/update/delete events for Tags"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "summary": "Subscribe to Tags change events (Server-Sent Events)"
      }
    },
    "/api/Tags/{id}": {
      "delete": {
        "operationId": "delete_Tags",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Hard-delete (real DELETE FROM) on a soft-delete collection; without it the row is soft-deleted.",
            "in": "query",
            "name": "purge",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Tags"
                    },
                    "status": {
                      "example": "success",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Rows deleted"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {},
          {
            "bearerAuth": []
          }
        ],
        "summary": "Delete a Tags by id"
      },
      "get": {
        "operationId": "get_Tags",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Include the row even when soft-deleted (otherwise a soft-deleted id is 404).",
            "in": "query",
            "name": "withDeleted",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "description": "Comma-separated relation fields to expand inline (one expand block per named FK field).",
            "in": "query",
            "name": "expand",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Field selection + inline embeds, e.g. \"id,title,author(name)\".",
            "in": "query",
            "name": "select",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Tags"
                    },
                    "status": {
                      "example": "success",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "A single Tags"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {},
          {
            "bearerAuth": []
          }
        ],
        "summary": "Get a Tags by id"
      },
      "patch": {
        "operationId": "update_Tags",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Tags"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Tags"
                    },
                    "status": {
                      "example": "success",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "The updated Tags"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {},
          {
            "bearerAuth": []
          }
        ],
        "summary": "Update a Tags by id (partial)"
      }
    },
    "/api/blogs": {
      "get": {
        "operationId": "list_blogs",
        "parameters": [
          {
            "description": "Page size (default 20, clamped to a maximum of 100).",
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 20,
              "maximum": 100,
              "type": "integer"
            }
          },
          {
            "description": "Offset pagination: rows to skip. Mutually exclusive with cursor.",
            "in": "query",
            "name": "offset",
            "required": false,
            "schema": {
              "minimum": 0,
              "type": "integer"
            }
          },
          {
            "description": "Sort, comma-separated: leading \"-\" for descending (\"-createdAt\") or trailing \"asc\"/\"desc\" (\"name asc\"). Only schema fields sort; unrecognized keys are ignored. Mutually exclusive with cursor (cursor mode always reads in primary-key order).",
            "in": "query",
            "name": "order",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Opaque keyset continuation token from a prior response's pagination.nextCursor/prevCursor. Mutually exclusive with offset and order.",
            "in": "query",
            "name": "cursor",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Include an exact pagination.total (runs a COUNT(*) against the filter). Total is omitted otherwise; hasMore then uses the cheap full-page heuristic.",
            "in": "query",
            "name": "withTotal",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "description": "Field selection + inline embeds, e.g. \"id,title,author(name)\".",
            "in": "query",
            "name": "select",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Comma-separated relation fields to expand inline (one expand block per named FK field).",
            "in": "query",
            "name": "expand",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Filter on id. Bare value = equality. Prefix with an operator for anything else: neq., gt., gte., lt., lte., like., in. (comma-separated values). The bare tokens is.null / is.not_null test nullability. Repeating the param forms an IN filter.",
            "in": "query",
            "name": "id",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Filter on url. Bare value = equality. Prefix with an operator for anything else: neq., gt., gte., lt., lte., like., in. (comma-separated values). The bare tokens is.null / is.not_null test nullability. Repeating the param forms an IN filter.",
            "in": "query",
            "name": "url",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "data": {
                      "properties": {
                        "items": {
                          "items": {
                            "$ref": "#/components/schemas/blogs"
                          },
                          "nullable": true,
                          "type": "array"
                        }
                      },
                      "type": "object"
                    },
                    "pagination": {
                      "properties": {
                        "hasMore": {
                          "type": "boolean"
                        },
                        "limit": {
                          "type": "integer"
                        },
                        "nextCursor": {
                          "description": "Present when more rows may follow in primary-key order.",
                          "type": "string"
                        },
                        "offset": {
                          "type": "integer"
                        },
                        "prevCursor": {
                          "description": "Present when earlier rows are reachable backward.",
                          "type": "string"
                        },
                        "total": {
                          "description": "Rows matching the filter. Present only when withTotal=true.",
                          "format": "int64",
                          "type": "integer"
                        }
                      },
                      "type": "object"
                    },
                    "status": {
                      "example": "success",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "A paginated list of blogs"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {},
          {
            "bearerAuth": []
          }
        ],
        "summary": "List blogs"
      },
      "post": {
        "operationId": "create_blogs",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/blogs"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/blogs"
                    },
                    "status": {
                      "example": "success",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "The created blogs"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {},
          {
            "bearerAuth": []
          }
        ],
        "summary": "Create a blogs"
      }
    },
    "/api/blogs/batch": {
      "post": {
        "operationId": "batch_blogs",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "items": {
                    "items": {
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "op": {
                          "enum": [
                            "create",
                            "update",
                            "delete"
                          ],
                          "type": "string"
                        },
                        "record": {
                          "type": "object"
                        }
                      },
                      "required": [
                        "op"
                      ],
                      "type": "object"
                    },
                    "type": "array"
                  }
                },
                "required": [
                  "items"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Per-item results + a summary (succeeded/failed counts)"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {},
          {
            "bearerAuth": []
          }
        ],
        "summary": "Run a batch of create/update/delete blogs operations atomically"
      }
    },
    "/api/blogs/subscribe": {
      "get": {
        "operationId": "subscribe_blogs",
        "responses": {
          "200": {
            "content": {
              "text/event-stream": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "A text/event-stream of create/update/delete events for blogs"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "summary": "Subscribe to blogs change events (Server-Sent Events)"
      }
    },
    "/api/blogs/{id}": {
      "delete": {
        "operationId": "delete_blogs",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Hard-delete (real DELETE FROM) on a soft-delete collection; without it the row is soft-deleted.",
            "in": "query",
            "name": "purge",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/blogs"
                    },
                    "status": {
                      "example": "success",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Rows deleted"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {},
          {
            "bearerAuth": []
          }
        ],
        "summary": "Delete a blogs by id"
      },
      "get": {
        "operationId": "get_blogs",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Include the row even when soft-deleted (otherwise a soft-deleted id is 404).",
            "in": "query",
            "name": "withDeleted",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "description": "Comma-separated relation fields to expand inline (one expand block per named FK field).",
            "in": "query",
            "name": "expand",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Field selection + inline embeds, e.g. \"id,title,author(name)\".",
            "in": "query",
            "name": "select",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/blogs"
                    },
                    "status": {
                      "example": "success",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "A single blogs"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {},
          {
            "bearerAuth": []
          }
        ],
        "summary": "Get a blogs by id"
      },
      "patch": {
        "operationId": "update_blogs",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/blogs"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/blogs"
                    },
                    "status": {
                      "example": "success",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "The updated blogs"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {},
          {
            "bearerAuth": []
          }
        ],
        "summary": "Update a blogs by id (partial)"
      }
    },
    "/api/employees": {
      "get": {
        "operationId": "list_employees",
        "parameters": [
          {
            "description": "Page size (default 20, clamped to a maximum of 100).",
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 20,
              "maximum": 100,
              "type": "integer"
            }
          },
          {
            "description": "Offset pagination: rows to skip. Mutually exclusive with cursor.",
            "in": "query",
            "name": "offset",
            "required": false,
            "schema": {
              "minimum": 0,
              "type": "integer"
            }
          },
          {
            "description": "Sort, comma-separated: leading \"-\" for descending (\"-createdAt\") or trailing \"asc\"/\"desc\" (\"name asc\"). Only schema fields sort; unrecognized keys are ignored. Mutually exclusive with cursor (cursor mode always reads in primary-key order).",
            "in": "query",
            "name": "order",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Opaque keyset continuation token from a prior response's pagination.nextCursor/prevCursor. Mutually exclusive with offset and order.",
            "in": "query",
            "name": "cursor",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Include an exact pagination.total (runs a COUNT(*) against the filter). Total is omitted otherwise; hasMore then uses the cheap full-page heuristic.",
            "in": "query",
            "name": "withTotal",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "description": "Field selection + inline embeds, e.g. \"id,title,author(name)\".",
            "in": "query",
            "name": "select",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Comma-separated relation fields to expand inline (one expand block per named FK field).",
            "in": "query",
            "name": "expand",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Filter on id. Bare value = equality. Prefix with an operator for anything else: neq., gt., gte., lt., lte., like., in. (comma-separated values). The bare tokens is.null / is.not_null test nullability. Repeating the param forms an IN filter.",
            "in": "query",
            "name": "id",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Filter on firstName. Bare value = equality. Prefix with an operator for anything else: neq., gt., gte., lt., lte., like., in. (comma-separated values). The bare tokens is.null / is.not_null test nullability. Repeating the param forms an IN filter.",
            "in": "query",
            "name": "firstName",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Filter on email. Bare value = equality. Prefix with an operator for anything else: neq., gt., gte., lt., lte., like., in. (comma-separated values). The bare tokens is.null / is.not_null test nullability. Repeating the param forms an IN filter.",
            "in": "query",
            "name": "email",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Filter on role. Bare value = equality. Prefix with an operator for anything else: neq., gt., gte., lt., lte., like., in. (comma-separated values). The bare tokens is.null / is.not_null test nullability. Repeating the param forms an IN filter.",
            "in": "query",
            "name": "role",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Filter on createdAt. Bare value = equality. Prefix with an operator for anything else: neq., gt., gte., lt., lte., like., in. (comma-separated values). The bare tokens is.null / is.not_null test nullability. Repeating the param forms an IN filter.",
            "in": "query",
            "name": "createdAt",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "data": {
                      "properties": {
                        "items": {
                          "items": {
                            "$ref": "#/components/schemas/employees"
                          },
                          "nullable": true,
                          "type": "array"
                        }
                      },
                      "type": "object"
                    },
                    "pagination": {
                      "properties": {
                        "hasMore": {
                          "type": "boolean"
                        },
                        "limit": {
                          "type": "integer"
                        },
                        "nextCursor": {
                          "description": "Present when more rows may follow in primary-key order.",
                          "type": "string"
                        },
                        "offset": {
                          "type": "integer"
                        },
                        "prevCursor": {
                          "description": "Present when earlier rows are reachable backward.",
                          "type": "string"
                        },
                        "total": {
                          "description": "Rows matching the filter. Present only when withTotal=true.",
                          "format": "int64",
                          "type": "integer"
                        }
                      },
                      "type": "object"
                    },
                    "status": {
                      "example": "success",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "A paginated list of employees"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {},
          {
            "bearerAuth": []
          }
        ],
        "summary": "List employees"
      },
      "post": {
        "operationId": "create_employees",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/employees"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/employees"
                    },
                    "status": {
                      "example": "success",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "The created employees"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {},
          {
            "bearerAuth": []
          }
        ],
        "summary": "Create a employees"
      }
    },
    "/api/employees/batch": {
      "post": {
        "operationId": "batch_employees",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "items": {
                    "items": {
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "op": {
                          "enum": [
                            "create",
                            "update",
                            "delete"
                          ],
                          "type": "string"
                        },
                        "record": {
                          "type": "object"
                        }
                      },
                      "required": [
                        "op"
                      ],
                      "type": "object"
                    },
                    "type": "array"
                  }
                },
                "required": [
                  "items"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Per-item results + a summary (succeeded/failed counts)"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {},
          {
            "bearerAuth": []
          }
        ],
        "summary": "Run a batch of create/update/delete employees operations atomically"
      }
    },
    "/api/employees/subscribe": {
      "get": {
        "operationId": "subscribe_employees",
        "responses": {
          "200": {
            "content": {
              "text/event-stream": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "A text/event-stream of create/update/delete events for employees"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "summary": "Subscribe to employees change events (Server-Sent Events)"
      }
    },
    "/api/employees/{id}": {
      "delete": {
        "operationId": "delete_employees",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Hard-delete (real DELETE FROM) on a soft-delete collection; without it the row is soft-deleted.",
            "in": "query",
            "name": "purge",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/employees"
                    },
                    "status": {
                      "example": "success",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Rows deleted"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {},
          {
            "bearerAuth": []
          }
        ],
        "summary": "Delete a employees by id"
      },
      "get": {
        "operationId": "get_employees",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Include the row even when soft-deleted (otherwise a soft-deleted id is 404).",
            "in": "query",
            "name": "withDeleted",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "description": "Comma-separated relation fields to expand inline (one expand block per named FK field).",
            "in": "query",
            "name": "expand",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Field selection + inline embeds, e.g. \"id,title,author(name)\".",
            "in": "query",
            "name": "select",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/employees"
                    },
                    "status": {
                      "example": "success",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "A single employees"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {},
          {
            "bearerAuth": []
          }
        ],
        "summary": "Get a employees by id"
      },
      "patch": {
        "operationId": "update_employees",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/employees"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/employees"
                    },
                    "status": {
                      "example": "success",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "The updated employees"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {},
          {
            "bearerAuth": []
          }
        ],
        "summary": "Update a employees by id (partial)"
      }
    },
    "/api/files": {
      "get": {
        "operationId": "list_files",
        "parameters": [
          {
            "description": "Only keys starting with this prefix.",
            "in": "query",
            "name": "prefix",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Page size (default 100, clamped to 1000). There is no offset — key listing is cursor-only.",
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 100,
              "maximum": 1000,
              "type": "integer"
            }
          },
          {
            "description": "Opaque continuation token from a prior response's pagination.nextCursor (backend-issued, not the records list's PK cursor).",
            "in": "query",
            "name": "cursor",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Include pagination.total: catalog rows under the prefix. Eventually-exact — the reconciler adopts bypass uploads and drops confirmed ghosts on its pass — so it can briefly disagree with items (backend truth).",
            "in": "query",
            "name": "withTotal",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "data": {
                      "properties": {
                        "items": {
                          "items": {
                            "properties": {
                              "contentType": {
                                "type": "string"
                              },
                              "createdAt": {
                                "description": "Catalog registration time; present when a catalog is attached.",
                                "type": "string"
                              },
                              "key": {
                                "type": "string"
                              },
                              "size": {
                                "type": "integer"
                              }
                            },
                            "type": "object"
                          },
                          "type": "array"
                        }
                      },
                      "type": "object"
                    },
                    "pagination": {
                      "properties": {
                        "hasMore": {
                          "description": "True exactly when nextCursor is present.",
                          "type": "boolean"
                        },
                        "limit": {
                          "type": "integer"
                        },
                        "nextCursor": {
                          "description": "Backend-issued continuation token; absent on the last page.",
                          "type": "string"
                        },
                        "offset": {
                          "description": "Always 0 — the shared envelope shape carries it; files listing is cursor-only, there is no offset to report.",
                          "type": "integer"
                        },
                        "total": {
                          "description": "Catalog rows under the prefix (eventually-exact — see withTotal). Present only when withTotal=true.",
                          "format": "int64",
                          "type": "integer"
                        }
                      },
                      "type": "object"
                    },
                    "status": {
                      "example": "success",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "A cursor-paged list of files under the prefix"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "summary": "List files"
      },
      "post": {
        "operationId": "upload_file",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "contentType": {
                    "type": "string"
                  },
                  "data": {
                    "format": "byte",
                    "type": "string"
                  },
                  "key": {
                    "type": "string"
                  }
                },
                "required": [
                  "key",
                  "data"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "The uploaded file's metadata"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "507": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "summary": "Upload a file"
      }
    },
    "/api/files/usage": {
      "get": {
        "operationId": "files_usage",
        "responses": {
          "200": {
            "description": "Usage totals; free* fields are null when uncapped"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "summary": "Storage usage for the resolved tenant"
      }
    },
    "/api/files/{key}": {
      "delete": {
        "operationId": "delete_file",
        "parameters": [
          {
            "in": "path",
            "name": "key",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Deleted"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "summary": "Delete a file by key"
      },
      "get": {
        "operationId": "download_file",
        "parameters": [
          {
            "in": "path",
            "name": "key",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The raw object bytes"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "summary": "Download a file by key"
      }
    },
    "/api/posts": {
      "get": {
        "operationId": "list_posts",
        "parameters": [
          {
            "description": "Page size (default 20, clamped to a maximum of 100).",
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 20,
              "maximum": 100,
              "type": "integer"
            }
          },
          {
            "description": "Offset pagination: rows to skip. Mutually exclusive with cursor.",
            "in": "query",
            "name": "offset",
            "required": false,
            "schema": {
              "minimum": 0,
              "type": "integer"
            }
          },
          {
            "description": "Sort, comma-separated: leading \"-\" for descending (\"-createdAt\") or trailing \"asc\"/\"desc\" (\"name asc\"). Only schema fields sort; unrecognized keys are ignored. Mutually exclusive with cursor (cursor mode always reads in primary-key order).",
            "in": "query",
            "name": "order",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Opaque keyset continuation token from a prior response's pagination.nextCursor/prevCursor. Mutually exclusive with offset and order.",
            "in": "query",
            "name": "cursor",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Include an exact pagination.total (runs a COUNT(*) against the filter). Total is omitted otherwise; hasMore then uses the cheap full-page heuristic.",
            "in": "query",
            "name": "withTotal",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "description": "Field selection + inline embeds, e.g. \"id,title,author(name)\".",
            "in": "query",
            "name": "select",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Comma-separated relation fields to expand inline (one expand block per named FK field).",
            "in": "query",
            "name": "expand",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Filter on id. Bare value = equality. Prefix with an operator for anything else: neq., gt., gte., lt., lte., like., in. (comma-separated values). The bare tokens is.null / is.not_null test nullability. Repeating the param forms an IN filter.",
            "in": "query",
            "name": "id",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Filter on title. Bare value = equality. Prefix with an operator for anything else: neq., gt., gte., lt., lte., like., in. (comma-separated values). The bare tokens is.null / is.not_null test nullability. Repeating the param forms an IN filter.",
            "in": "query",
            "name": "title",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Filter on body. Bare value = equality. Prefix with an operator for anything else: neq., gt., gte., lt., lte., like., in. (comma-separated values). The bare tokens is.null / is.not_null test nullability. Repeating the param forms an IN filter.",
            "in": "query",
            "name": "body",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Filter on author. Bare value = equality. Prefix with an operator for anything else: neq., gt., gte., lt., lte., like., in. (comma-separated values). The bare tokens is.null / is.not_null test nullability. Repeating the param forms an IN filter.",
            "in": "query",
            "name": "author",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Filter on createdAt. Bare value = equality. Prefix with an operator for anything else: neq., gt., gte., lt., lte., like., in. (comma-separated values). The bare tokens is.null / is.not_null test nullability. Repeating the param forms an IN filter.",
            "in": "query",
            "name": "createdAt",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "data": {
                      "properties": {
                        "items": {
                          "items": {
                            "$ref": "#/components/schemas/posts"
                          },
                          "nullable": true,
                          "type": "array"
                        }
                      },
                      "type": "object"
                    },
                    "pagination": {
                      "properties": {
                        "hasMore": {
                          "type": "boolean"
                        },
                        "limit": {
                          "type": "integer"
                        },
                        "nextCursor": {
                          "description": "Present when more rows may follow in primary-key order.",
                          "type": "string"
                        },
                        "offset": {
                          "type": "integer"
                        },
                        "prevCursor": {
                          "description": "Present when earlier rows are reachable backward.",
                          "type": "string"
                        },
                        "total": {
                          "description": "Rows matching the filter. Present only when withTotal=true.",
                          "format": "int64",
                          "type": "integer"
                        }
                      },
                      "type": "object"
                    },
                    "status": {
                      "example": "success",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "A paginated list of posts"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {},
          {
            "bearerAuth": []
          }
        ],
        "summary": "List posts"
      },
      "post": {
        "operationId": "create_posts",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/posts"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/posts"
                    },
                    "status": {
                      "example": "success",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "The created posts"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {},
          {
            "bearerAuth": []
          }
        ],
        "summary": "Create a posts"
      }
    },
    "/api/posts/batch": {
      "post": {
        "operationId": "batch_posts",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "items": {
                    "items": {
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "op": {
                          "enum": [
                            "create",
                            "update",
                            "delete"
                          ],
                          "type": "string"
                        },
                        "record": {
                          "type": "object"
                        }
                      },
                      "required": [
                        "op"
                      ],
                      "type": "object"
                    },
                    "type": "array"
                  }
                },
                "required": [
                  "items"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Per-item results + a summary (succeeded/failed counts)"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {},
          {
            "bearerAuth": []
          }
        ],
        "summary": "Run a batch of create/update/delete posts operations atomically"
      }
    },
    "/api/posts/subscribe": {
      "get": {
        "operationId": "subscribe_posts",
        "responses": {
          "200": {
            "content": {
              "text/event-stream": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "A text/event-stream of create/update/delete events for posts"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "summary": "Subscribe to posts change events (Server-Sent Events)"
      }
    },
    "/api/posts/{id}": {
      "delete": {
        "operationId": "delete_posts",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Hard-delete (real DELETE FROM) on a soft-delete collection; without it the row is soft-deleted.",
            "in": "query",
            "name": "purge",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/posts"
                    },
                    "status": {
                      "example": "success",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Rows deleted"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {},
          {
            "bearerAuth": []
          }
        ],
        "summary": "Delete a posts by id"
      },
      "get": {
        "operationId": "get_posts",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Include the row even when soft-deleted (otherwise a soft-deleted id is 404).",
            "in": "query",
            "name": "withDeleted",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "description": "Comma-separated relation fields to expand inline (one expand block per named FK field).",
            "in": "query",
            "name": "expand",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Field selection + inline embeds, e.g. \"id,title,author(name)\".",
            "in": "query",
            "name": "select",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/posts"
                    },
                    "status": {
                      "example": "success",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "A single posts"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {},
          {
            "bearerAuth": []
          }
        ],
        "summary": "Get a posts by id"
      },
      "patch": {
        "operationId": "update_posts",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/posts"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/posts"
                    },
                    "status": {
                      "example": "success",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "The updated posts"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {},
          {
            "bearerAuth": []
          }
        ],
        "summary": "Update a posts by id (partial)"
      }
    },
    "/api/sdnotes": {
      "get": {
        "operationId": "list_sdnotes",
        "parameters": [
          {
            "description": "Page size (default 20, clamped to a maximum of 100).",
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 20,
              "maximum": 100,
              "type": "integer"
            }
          },
          {
            "description": "Offset pagination: rows to skip. Mutually exclusive with cursor.",
            "in": "query",
            "name": "offset",
            "required": false,
            "schema": {
              "minimum": 0,
              "type": "integer"
            }
          },
          {
            "description": "Sort, comma-separated: leading \"-\" for descending (\"-createdAt\") or trailing \"asc\"/\"desc\" (\"name asc\"). Only schema fields sort; unrecognized keys are ignored. Mutually exclusive with cursor (cursor mode always reads in primary-key order).",
            "in": "query",
            "name": "order",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Opaque keyset continuation token from a prior response's pagination.nextCursor/prevCursor. Mutually exclusive with offset and order.",
            "in": "query",
            "name": "cursor",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Include an exact pagination.total (runs a COUNT(*) against the filter). Total is omitted otherwise; hasMore then uses the cheap full-page heuristic.",
            "in": "query",
            "name": "withTotal",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "description": "Field selection + inline embeds, e.g. \"id,title,author(name)\".",
            "in": "query",
            "name": "select",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Comma-separated relation fields to expand inline (one expand block per named FK field).",
            "in": "query",
            "name": "expand",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Include soft-deleted rows.",
            "in": "query",
            "name": "withDeleted",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "description": "Filter on id. Bare value = equality. Prefix with an operator for anything else: neq., gt., gte., lt., lte., like., in. (comma-separated values). The bare tokens is.null / is.not_null test nullability. Repeating the param forms an IN filter.",
            "in": "query",
            "name": "id",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Filter on body. Bare value = equality. Prefix with an operator for anything else: neq., gt., gte., lt., lte., like., in. (comma-separated values). The bare tokens is.null / is.not_null test nullability. Repeating the param forms an IN filter.",
            "in": "query",
            "name": "body",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Filter on deleted_at. Bare value = equality. Prefix with an operator for anything else: neq., gt., gte., lt., lte., like., in. (comma-separated values). The bare tokens is.null / is.not_null test nullability. Repeating the param forms an IN filter.",
            "in": "query",
            "name": "deleted_at",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "data": {
                      "properties": {
                        "items": {
                          "items": {
                            "$ref": "#/components/schemas/sdnotes"
                          },
                          "nullable": true,
                          "type": "array"
                        }
                      },
                      "type": "object"
                    },
                    "pagination": {
                      "properties": {
                        "hasMore": {
                          "type": "boolean"
                        },
                        "limit": {
                          "type": "integer"
                        },
                        "nextCursor": {
                          "description": "Present when more rows may follow in primary-key order.",
                          "type": "string"
                        },
                        "offset": {
                          "type": "integer"
                        },
                        "prevCursor": {
                          "description": "Present when earlier rows are reachable backward.",
                          "type": "string"
                        },
                        "total": {
                          "description": "Rows matching the filter. Present only when withTotal=true.",
                          "format": "int64",
                          "type": "integer"
                        }
                      },
                      "type": "object"
                    },
                    "status": {
                      "example": "success",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "A paginated list of sdnotes"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {},
          {
            "bearerAuth": []
          }
        ],
        "summary": "List sdnotes"
      },
      "post": {
        "operationId": "create_sdnotes",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/sdnotes"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/sdnotes"
                    },
                    "status": {
                      "example": "success",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "The created sdnotes"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {},
          {
            "bearerAuth": []
          }
        ],
        "summary": "Create a sdnotes"
      }
    },
    "/api/sdnotes/batch": {
      "post": {
        "operationId": "batch_sdnotes",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "items": {
                    "items": {
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "op": {
                          "enum": [
                            "create",
                            "update",
                            "delete"
                          ],
                          "type": "string"
                        },
                        "record": {
                          "type": "object"
                        }
                      },
                      "required": [
                        "op"
                      ],
                      "type": "object"
                    },
                    "type": "array"
                  }
                },
                "required": [
                  "items"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Per-item results + a summary (succeeded/failed counts)"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {},
          {
            "bearerAuth": []
          }
        ],
        "summary": "Run a batch of create/update/delete sdnotes operations atomically"
      }
    },
    "/api/sdnotes/subscribe": {
      "get": {
        "operationId": "subscribe_sdnotes",
        "responses": {
          "200": {
            "content": {
              "text/event-stream": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "A text/event-stream of create/update/delete events for sdnotes"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "summary": "Subscribe to sdnotes change events (Server-Sent Events)"
      }
    },
    "/api/sdnotes/{id}": {
      "delete": {
        "operationId": "delete_sdnotes",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Hard-delete (real DELETE FROM) on a soft-delete collection; without it the row is soft-deleted.",
            "in": "query",
            "name": "purge",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/sdnotes"
                    },
                    "status": {
                      "example": "success",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Rows deleted"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {},
          {
            "bearerAuth": []
          }
        ],
        "summary": "Delete a sdnotes by id"
      },
      "get": {
        "operationId": "get_sdnotes",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Include the row even when soft-deleted (otherwise a soft-deleted id is 404).",
            "in": "query",
            "name": "withDeleted",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "description": "Comma-separated relation fields to expand inline (one expand block per named FK field).",
            "in": "query",
            "name": "expand",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Field selection + inline embeds, e.g. \"id,title,author(name)\".",
            "in": "query",
            "name": "select",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/sdnotes"
                    },
                    "status": {
                      "example": "success",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "A single sdnotes"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {},
          {
            "bearerAuth": []
          }
        ],
        "summary": "Get a sdnotes by id"
      },
      "patch": {
        "operationId": "update_sdnotes",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/sdnotes"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/sdnotes"
                    },
                    "status": {
                      "example": "success",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "The updated sdnotes"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {},
          {
            "bearerAuth": []
          }
        ],
        "summary": "Update a sdnotes by id (partial)"
      }
    },
    "/api/sdnotes/{id}/restore": {
      "post": {
        "operationId": "restore_sdnotes",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/sdnotes"
                    },
                    "status": {
                      "example": "success",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "The restored sdnotes"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "errors": {
                      "items": {
                        "properties": {
                          "code": {
                            "type": "integer"
                          },
                          "data": {
                            "type": "object"
                          },
                          "msg": {
                            "type": "string"
                          }
                        },
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "status": {
                      "example": "failure",
                      "type": "string"
                    }
                  },
                  "type": "object"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [
          {},
          {
            "bearerAuth": []
          }
        ],
        "summary": "Restore a soft-deleted sdnotes"
      }
    }
  }
}