@jumentix/cli-init 0.0.0

package/templates/frontend/src/contracts/openapi.json

@@ -0,0 +1,4467 @@
+{
+  "openapi": "3.1.0",
+  "info": {
+    "title": "Jumentix API",
+    "description": "`REST API` built with `Jumentix` and `Domain Designer`",
+    "termsOfService": "https://www.xpertminds.dev/terms/",
+    "contact": {
+      "email": "apiteam@xpertminds.dev"
+    },
+    "license": {
+      "name": "Unlicensed",
+      "url": "http://www.apache.org/licenses/LICENSE-2.0.html"
+    },
+    "version": "1.0.0",
+    "x-rbac": {
+      "description": "Role-to-scope matrix enforced by the backend and mirrored here for OAS-driven clients.",
+      "roles": {
+        "superadmin": [
+          "*"
+        ],
+        "admin": [
+          "access_allow",
+          "read_user",
+          "create_user",
+          "update_user",
+          "delete_user",
+          "read_organization",
+          "update_organization"
+        ],
+        "user": [
+          "access_allow",
+          "read_user"
+        ]
+      }
+    }
+  },
+  "externalDocs": {
+    "description": "Find out more about Xpertminds",
+    "url": "http://xpertminds.dev"
+  },
+  "servers": [
+    {
+      "url": "http://localhost:3000/api/1.0.0",
+      "x-service-id": "core"
+    }
+  ],
+  "x-services": [
+    {
+      "id": "core",
+      "name": "Core",
+      "kind": "core",
+      "url": "http://localhost:3000/api/1.0.0",
+      "description": "Merged Core service that serves every operation in this document (monolith)."
+    }
+  ],
+  "tags": [
+    {
+      "name": "user",
+      "description": "System users",
+      "externalDocs": {
+        "description": "Find out more",
+        "url": "http://xpertminds.dev"
+      }
+    },
+    {
+      "name": "auth",
+      "description": "API access end points"
+    },
+    {
+      "name": "organization",
+      "description": "Tenant organizations"
+    },
+    {
+      "name": "catalog",
+      "description": "Multi-user shared catalog of domain designs (JUM-491)"
+    }
+  ],
+  "paths": {
+    "/auth/login": {
+      "post": {
+        "tags": [
+          "auth"
+        ],
+        "summary": "Do login",
+        "description": "Do login",
+        "operationId": "login",
+        "requestBody": {
+          "description": "Do login in the system",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/RequestLogin"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "User did login successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/AuthorizationHeader"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid request"
+          },
+          "401": {
+            "description": "Unauthorized"
+          }
+        }
+      }
+    },
+    "/auth/logout": {
+      "post": {
+        "tags": [
+          "auth"
+        ],
+        "summary": "Do logout",
+        "description": "Do logout",
+        "operationId": "logout",
+        "requestBody": {
+          "description": "Logout of the system",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/RequestLogout"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "User did logout successfully",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "$ref": "#/components/schemas/BooleanStringResult"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid request"
+          },
+          "401": {
+            "description": "Unauthorized"
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": [
+              "access_allow"
+            ]
+          }
+        ]
+      }
+    },
+    "/auth/updateUserPassword": {
+      "post": {
+        "tags": [
+          "auth"
+        ],
+        "summary": "Update password",
+        "description": "Update password",
+        "operationId": "updateUserPassword",
+        "requestBody": {
+          "description": "Update password",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/RequestUpdatePassword"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "User did update password successfully",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "$ref": "#/components/schemas/BooleanStringResult"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid request"
+          },
+          "401": {
+            "description": "Unauthorized"
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": [
+              "access_allow"
+            ]
+          }
+        ]
+      }
+    },
+    "/auth/register": {
+      "post": {
+        "tags": [
+          "auth"
+        ],
+        "summary": "Register an account",
+        "description": "Register an account",
+        "operationId": "register",
+        "requestBody": {
+          "description": "Create a new account",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/RequestRegister"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "201": {
+            "description": "User did update password successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/User"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid request"
+          }
+        }
+      }
+    },
+    "/users": {
+      "get": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Get all users",
+        "description": "Returns a page of users. Delta sync page: sort=`updatedAt:asc,id:asc`, filter `{\"updatedAt\":{\"operator\":\"gt\",\"value\":\"<iso>\"}}`, page through `page`/`size`, set `includeDeleted=true` so tombstones travel with the cursor (`x-sync`).",
+        "operationId": "getAll",
+        "x-service": "core",
+        "x-sync": {
+          "cursorField": "updatedAt",
+          "includeDeletedParam": "includeDeleted"
+        },
+        "x-list-capabilities": {
+          "sortable": [
+            "firstName",
+            "lastName",
+            "username",
+            "organization",
+            "createdAt",
+            "updatedAt",
+            "id"
+          ],
+          "filterable": {
+            "firstName": "text",
+            "lastName": "text",
+            "username": "text",
+            "organization": "uuid",
+            "roles": "enum",
+            "createdAt": "date",
+            "updatedAt": "date"
+          },
+          "searchable": [
+            "firstName",
+            "lastName",
+            "username"
+          ],
+          "defaultSize": 30,
+          "maxSize": 100,
+          "includeDeleted": true
+        },
+        "x-metrics-capabilities": {
+          "groupable": [
+            "roles",
+            "organization"
+          ],
+          "series": [
+            "createdAt",
+            "updatedAt"
+          ]
+        },
+        "parameters": [
+          {
+            "name": "page",
+            "in": "query",
+            "description": "Page number to fetch (1-based).",
+            "required": false,
+            "schema": {
+              "type": "integer",
+              "minimum": 1,
+              "default": 1
+            }
+          },
+          {
+            "name": "size",
+            "in": "query",
+            "description": "Page size; bounded by `x-list-capabilities.maxSize`.",
+            "required": false,
+            "schema": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 100,
+              "default": 30
+            }
+          },
+          {
+            "name": "filter",
+            "in": "query",
+            "description": "Base64-encoded JSON object keyed by a field listed in `x-list-capabilities.filterable`. A scalar value means equality; an object `{ \"operator\": \"contains\" | \"eq\" | \"ne\" | \"in\" | \"gte\" | \"lte\" | \"between\", \"value\": ... }` applies that operator. Unknown fields or operators are rejected with 400.",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "maxLength": 4096
+            }
+          },
+          {
+            "name": "sort",
+            "in": "query",
+            "description": "Comma-separated `field:asc|desc` pairs, fields limited to `x-list-capabilities.sortable`. Unknown fields are rejected with 400.",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "maxLength": 256,
+              "pattern": "^[A-Za-z0-9_.]+(:(asc|desc))?(,[A-Za-z0-9_.]+(:(asc|desc))?)*$"
+            }
+          },
+          {
+            "name": "q",
+            "in": "query",
+            "description": "Case-insensitive free-text search over `x-list-capabilities.searchable`.",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "maxLength": 200
+            }
+          },
+          {
+            "name": "includeDeleted",
+            "in": "query",
+            "description": "When true, list includes tombstones (`deletedAt` set). Default false.",
+            "required": false,
+            "schema": {
+              "type": "boolean",
+              "default": false
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/UserArrayOf"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "User not found"
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": [
+              "read_user"
+            ]
+          }
+        ]
+      },
+      "post": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Add a new user to the store",
+        "description": "Add a new user to the store",
+        "operationId": "create",
+        "requestBody": {
+          "description": "Create a new user in the store",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/RequestCreateUser"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "201": {
+            "description": "User created successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/User"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid request"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "409": {
+            "description": "Conflict"
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": [
+              "create_user"
+            ]
+          }
+        ]
+      }
+    },
+    "/users/metrics": {
+      "get": {
+        "tags": [
+          "user"
+        ],
+        "summary": "User metrics",
+        "description": "Generic aggregates for User (count, groupBy, time series).",
+        "operationId": "getUsersMetrics",
+        "x-service": "core",
+        "x-metrics-capabilities": {
+          "groupable": [
+            "roles",
+            "organization"
+          ],
+          "series": [
+            "createdAt",
+            "updatedAt"
+          ]
+        },
+        "parameters": [
+          {
+            "name": "metric",
+            "in": "query",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "enum": [
+                "count",
+                "groupBy",
+                "series"
+              ]
+            }
+          },
+          {
+            "name": "field",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "interval",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "enum": [
+                "day",
+                "week",
+                "month"
+              ]
+            }
+          },
+          {
+            "name": "filter",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "maxLength": 4096
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Metrics buckets",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/EntityMetricsResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid request"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": [
+              "read_user"
+            ]
+          }
+        ]
+      }
+    },
+    "/users/{id}": {
+      "delete": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Delete user",
+        "description": "Deletes a single user",
+        "operationId": "deleteOne",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "ID of user to return",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ResourceDeleteResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "User not found"
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": [
+              "delete_user"
+            ]
+          }
+        ]
+      },
+      "put": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Update user",
+        "description": "Updates a single user",
+        "operationId": "update",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "ID of user to update",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "description": "Update an user from Store",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/RequestUpdateUser"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/User"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "User not found"
+          },
+          "409": {
+            "description": "Conflict"
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": [
+              "update_user"
+            ]
+          }
+        ]
+      },
+      "get": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Get an user by ID",
+        "description": "Returns a single user",
+        "operationId": "getOneById",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "ID of user to return",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/User"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "User not found"
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": [
+              "read_user"
+            ]
+          }
+        ]
+      }
+    },
+    "/users/{id}/updatePassword": {
+      "put": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Updates user password",
+        "description": "Updates user password",
+        "operationId": "updatePassword",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "ID of user",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "description": "Old and new password",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/RequestUpdatePassword"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/User"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "User not found"
+          },
+          "409": {
+            "description": "Conflict"
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": [
+              "update_user"
+            ]
+          }
+        ]
+      }
+    },
+    "/users/{id}/createEmail": {
+      "post": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Create email address for a given user",
+        "description": "Create email address for a given user",
+        "operationId": "createEmail",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "ID of user",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "description": "Email create data",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/RequestCreateEmail"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "201": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Email"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "User not found"
+          },
+          "409": {
+            "description": "Conflict"
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": [
+              "update_user"
+            ]
+          }
+        ]
+      }
+    },
+    "/users/{id}/updateEmail/{emailId}": {
+      "put": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Update email address for a given user",
+        "description": "Update email address for a given user",
+        "operationId": "updateEmail",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "ID of user",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "emailId",
+            "in": "path",
+            "description": "emailId to update",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "description": "Email update data",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/RequestUpdateEmail"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Email"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "Resource not found"
+          },
+          "409": {
+            "description": "Conflict"
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": [
+              "update_user"
+            ]
+          }
+        ]
+      }
+    },
+    "/users/{id}/deleteEmail/{emailId}": {
+      "delete": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Delete email address of an user",
+        "description": "Deletes email address of an user",
+        "operationId": "deleteEmail",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "ID of user",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "emailId",
+            "in": "path",
+            "description": "emailId to delete",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ResourceDeleteResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "Resource not found"
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": [
+              "delete_user"
+            ]
+          }
+        ]
+      }
+    },
+    "/users/{id}/createDocument": {
+      "post": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Create document for a given user",
+        "description": "Create document for a given user",
+        "operationId": "createDocument",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "ID of user",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "description": "Document create data",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/RequestCreateDocument"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "201": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Document"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "User not found"
+          },
+          "409": {
+            "description": "Conflict"
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": [
+              "update_user"
+            ]
+          }
+        ]
+      }
+    },
+    "/users/{id}/updateDocument/{documentId}": {
+      "put": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Update document for a given user",
+        "description": "Update document for a given user",
+        "operationId": "updateDocument",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "ID of user",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "documentId",
+            "in": "path",
+            "description": "documentId to update",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "description": "Document update data",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/RequestUpdateDocument"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Document"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "User not found"
+          },
+          "409": {
+            "description": "Conflict"
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": [
+              "update_user"
+            ]
+          }
+        ]
+      }
+    },
+    "/users/{id}/deleteDocument/{documentId}": {
+      "delete": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Delete document of an user",
+        "description": "Deletes document of an user",
+        "operationId": "deleteDocument",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "ID of user",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "documentId",
+            "in": "path",
+            "description": "documentId to delete",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ResourceDeleteResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "Resource not found"
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": [
+              "delete_user"
+            ]
+          }
+        ]
+      }
+    },
+    "/users/{id}/createPhone": {
+      "post": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Create phone address for a given user",
+        "description": "Create phone address for a given user",
+        "operationId": "createPhone",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "ID of user",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "description": "Phone create data",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/RequestCreatePhone"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "201": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Phone"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "User not found"
+          },
+          "409": {
+            "description": "Conflict"
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": [
+              "update_user"
+            ]
+          }
+        ]
+      }
+    },
+    "/users/{id}/updatePhone/{phoneId}": {
+      "put": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Update phone address for a given user",
+        "description": "Update phone address for a given user",
+        "operationId": "updatePhone",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "ID of user",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "phoneId",
+            "in": "path",
+            "description": "phoneId to update",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "description": "Phone update data",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/RequestUpdatePhone"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Phone"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "User not found"
+          },
+          "409": {
+            "description": "Conflict"
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": [
+              "update_user"
+            ]
+          }
+        ]
+      }
+    },
+    "/users/{id}/deletePhone/{phoneId}": {
+      "delete": {
+        "tags": [
+          "user"
+        ],
+        "summary": "Delete phone of an user",
+        "description": "Deletes phone of an user",
+        "operationId": "deletePhone",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "ID of user",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "phoneId",
+            "in": "path",
+            "description": "phoneId to delete",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ResourceDeleteResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "Resource not found"
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": [
+              "delete_user"
+            ]
+          }
+        ]
+      }
+    },
+    "/organizations": {
+      "get": {
+        "tags": [
+          "organization"
+        ],
+        "summary": "Get all organizations",
+        "description": "Returns a page of organizations. Delta sync page: sort=`updatedAt:asc,id:asc`, filter `{\"updatedAt\":{\"operator\":\"gt\",\"value\":\"<iso>\"}}`, page through `page`/`size`, set `includeDeleted=true` so tombstones travel with the cursor (`x-sync`).",
+        "operationId": "getAllOrganizations",
+        "x-service": "core",
+        "x-sync": {
+          "cursorField": "updatedAt",
+          "includeDeletedParam": "includeDeleted"
+        },
+        "x-list-capabilities": {
+          "sortable": [
+            "name",
+            "createdAt",
+            "updatedAt",
+            "id"
+          ],
+          "filterable": {
+            "name": "text",
+            "createdAt": "date",
+            "updatedAt": "date"
+          },
+          "searchable": [
+            "name"
+          ],
+          "defaultSize": 30,
+          "maxSize": 100,
+          "includeDeleted": true
+        },
+        "x-metrics-capabilities": {
+          "groupable": [],
+          "series": [
+            "createdAt",
+            "updatedAt"
+          ]
+        },
+        "parameters": [
+          {
+            "name": "page",
+            "in": "query",
+            "description": "Page number to fetch (1-based).",
+            "required": false,
+            "schema": {
+              "type": "integer",
+              "minimum": 1,
+              "default": 1
+            }
+          },
+          {
+            "name": "size",
+            "in": "query",
+            "description": "Page size; bounded by `x-list-capabilities.maxSize`.",
+            "required": false,
+            "schema": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 100,
+              "default": 30
+            }
+          },
+          {
+            "name": "filter",
+            "in": "query",
+            "description": "Base64-encoded JSON object keyed by a field listed in `x-list-capabilities.filterable`. A scalar value means equality; an object `{ \"operator\": \"contains\" | \"eq\" | \"ne\" | \"in\" | \"gte\" | \"lte\" | \"between\", \"value\": ... }` applies that operator. Unknown fields or operators are rejected with 400.",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "maxLength": 4096
+            }
+          },
+          {
+            "name": "sort",
+            "in": "query",
+            "description": "Comma-separated `field:asc|desc` pairs, fields limited to `x-list-capabilities.sortable`. Unknown fields are rejected with 400.",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "maxLength": 256,
+              "pattern": "^[A-Za-z0-9_.]+(:(asc|desc))?(,[A-Za-z0-9_.]+(:(asc|desc))?)*$"
+            }
+          },
+          {
+            "name": "q",
+            "in": "query",
+            "description": "Case-insensitive free-text search over `x-list-capabilities.searchable`.",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "maxLength": 200
+            }
+          },
+          {
+            "name": "includeDeleted",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "boolean",
+              "default": false
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/OrganizationArrayOf"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid request"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": [
+              "read_organization"
+            ]
+          }
+        ]
+      },
+      "post": {
+        "tags": [
+          "organization"
+        ],
+        "summary": "Add a new organization",
+        "description": "Add a new organization",
+        "operationId": "createOrganization",
+        "requestBody": {
+          "description": "Create organization payload",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/RequestCreateOrganization"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "201": {
+            "description": "Organization created successfully",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Organization"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid request"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "409": {
+            "description": "Conflict"
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": [
+              "create_organization"
+            ]
+          }
+        ]
+      }
+    },
+    "/organizations/metrics": {
+      "get": {
+        "tags": [
+          "organization"
+        ],
+        "summary": "Organization metrics",
+        "description": "Generic aggregates for Organization (count, groupBy, time series).",
+        "operationId": "getOrganizationsMetrics",
+        "x-service": "core",
+        "x-metrics-capabilities": {
+          "groupable": [],
+          "series": [
+            "createdAt",
+            "updatedAt"
+          ]
+        },
+        "parameters": [
+          {
+            "name": "metric",
+            "in": "query",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "enum": [
+                "count",
+                "groupBy",
+                "series"
+              ]
+            }
+          },
+          {
+            "name": "field",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "interval",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "enum": [
+                "day",
+                "week",
+                "month"
+              ]
+            }
+          },
+          {
+            "name": "filter",
+            "in": "query",
+            "required": false,
+            "schema": {
+              "type": "string",
+              "maxLength": 4096
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Metrics buckets",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/EntityMetricsResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid request"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": [
+              "read_organization"
+            ]
+          }
+        ]
+      }
+    },
+    "/organizations/{id}": {
+      "get": {
+        "tags": [
+          "organization"
+        ],
+        "summary": "Get organization by ID",
+        "description": "Returns a single organization",
+        "operationId": "getOrganizationById",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "Organization ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Organization"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "Organization not found"
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": [
+              "read_organization"
+            ]
+          }
+        ]
+      },
+      "put": {
+        "tags": [
+          "organization"
+        ],
+        "summary": "Update organization",
+        "description": "Updates a single organization",
+        "operationId": "updateOrganization",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "Organization ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "description": "Organization update payload",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/RequestUpdateOrganization"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Organization"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "Organization not found"
+          },
+          "409": {
+            "description": "Conflict"
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": [
+              "update_organization"
+            ]
+          }
+        ]
+      },
+      "delete": {
+        "tags": [
+          "organization"
+        ],
+        "summary": "Delete organization",
+        "description": "Deletes a single organization",
+        "operationId": "deleteOrganization",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "Organization ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ResourceDeleteResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid ID supplied"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "Organization not found"
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": [
+              "delete_organization"
+            ]
+          }
+        ]
+      }
+    },
+    "/organizations/{id}/createAddress": {
+      "post": {
+        "tags": [
+          "organization"
+        ],
+        "summary": "Create organization address entry",
+        "description": "Creates an address value object entry for an organization",
+        "operationId": "createOrganizationAddress",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "Organization ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "description": "Address create payload",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/RequestCreateAddress"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "201": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Organization"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid request"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "Organization not found"
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": [
+              "update_organization"
+            ]
+          }
+        ]
+      }
+    },
+    "/organizations/{id}/updateAddress/{addressId}": {
+      "put": {
+        "tags": [
+          "organization"
+        ],
+        "summary": "Update organization address entry",
+        "description": "Updates an address value object entry from an organization",
+        "operationId": "updateOrganizationAddress",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "Organization ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "addressId",
+            "in": "path",
+            "description": "Address entry ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "description": "Address update payload",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/RequestUpdateAddress"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Organization"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid request"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "Organization or address not found"
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": [
+              "update_organization"
+            ]
+          }
+        ]
+      }
+    },
+    "/organizations/{id}/deleteAddress/{addressId}": {
+      "delete": {
+        "tags": [
+          "organization"
+        ],
+        "summary": "Delete organization address entry",
+        "description": "Deletes an address value object entry from an organization",
+        "operationId": "deleteOrganizationAddress",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "Organization ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "addressId",
+            "in": "path",
+            "description": "Address entry ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Organization"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid request"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "Organization or address not found"
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": [
+              "update_organization"
+            ]
+          }
+        ]
+      }
+    },
+    "/organizations/{id}/createPhone": {
+      "post": {
+        "tags": [
+          "organization"
+        ],
+        "summary": "Create organization phone entry",
+        "description": "Creates a phone value object entry for an organization",
+        "operationId": "createOrganizationPhone",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "Organization ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "description": "Phone create payload",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/RequestCreatePhone"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "201": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Organization"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid request"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "Organization not found"
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": [
+              "update_organization"
+            ]
+          }
+        ]
+      }
+    },
+    "/organizations/{id}/updatePhone/{phoneId}": {
+      "put": {
+        "tags": [
+          "organization"
+        ],
+        "summary": "Update organization phone entry",
+        "description": "Updates a phone value object entry from an organization",
+        "operationId": "updateOrganizationPhone",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "Organization ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "phoneId",
+            "in": "path",
+            "description": "Phone entry ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "description": "Phone update payload",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/RequestUpdatePhone"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Organization"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid request"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "Organization or phone not found"
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": [
+              "update_organization"
+            ]
+          }
+        ]
+      }
+    },
+    "/organizations/{id}/deletePhone/{phoneId}": {
+      "delete": {
+        "tags": [
+          "organization"
+        ],
+        "summary": "Delete organization phone entry",
+        "description": "Deletes a phone value object entry from an organization",
+        "operationId": "deleteOrganizationPhone",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "Organization ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "phoneId",
+            "in": "path",
+            "description": "Phone entry ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Organization"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid request"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "Organization or phone not found"
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": [
+              "update_organization"
+            ]
+          }
+        ]
+      }
+    },
+    "/organizations/{id}/createEmail": {
+      "post": {
+        "tags": [
+          "organization"
+        ],
+        "summary": "Create organization email entry",
+        "description": "Creates an email value object entry for an organization",
+        "operationId": "createOrganizationEmail",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "Organization ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "description": "Email create payload",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/RequestCreateEmail"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "201": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Organization"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid request"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "Organization not found"
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": [
+              "update_organization"
+            ]
+          }
+        ]
+      }
+    },
+    "/organizations/{id}/updateEmail/{emailId}": {
+      "put": {
+        "tags": [
+          "organization"
+        ],
+        "summary": "Update organization email entry",
+        "description": "Updates an email value object entry from an organization",
+        "operationId": "updateOrganizationEmail",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "Organization ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "emailId",
+            "in": "path",
+            "description": "Email entry ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "description": "Email update payload",
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/RequestUpdateEmail"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Organization"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid request"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "Organization or email not found"
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": [
+              "update_organization"
+            ]
+          }
+        ]
+      }
+    },
+    "/organizations/{id}/deleteEmail/{emailId}": {
+      "delete": {
+        "tags": [
+          "organization"
+        ],
+        "summary": "Delete organization email entry",
+        "description": "Deletes an email value object entry from an organization",
+        "operationId": "deleteOrganizationEmail",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "Organization ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "emailId",
+            "in": "path",
+            "description": "Email entry ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "successful operation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Organization"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid request"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "Organization or email not found"
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": [
+              "update_organization"
+            ]
+          }
+        ]
+      }
+    }
+  },
+  "components": {
+    "schemas": {
+      "ResourceDeleteResponse": {
+        "description": "Port output object for delete operations.",
+        "required": [
+          "data"
+        ],
+        "type": "object",
+        "properties": {
+          "data": {
+            "x-label": {
+              "en": "Number",
+              "pt-BR": "Número"
+            },
+            "type": "boolean",
+            "default": false,
+            "description": "Result of request to delete resource"
+          }
+        }
+      },
+      "RequestLogin": {
+        "description": "Port input object for authentication login endpoint.",
+        "required": [
+          "username",
+          "password"
+        ],
+        "type": "object",
+        "properties": {
+          "username": {
+            "x-label": {
+              "en": "Username",
+              "pt-BR": "Usuário"
+            },
+            "type": "string",
+            "minLength": 1,
+            "example": "me@mydomain.com",
+            "description": "Username"
+          },
+          "password": {
+            "x-label": {
+              "en": "Password",
+              "pt-BR": "Senha"
+            },
+            "type": "string",
+            "description": "Password",
+            "minLength": 2,
+            "format": "password"
+          },
+          "schemaType": {
+            "x-label": {
+              "en": "Schema type",
+              "pt-BR": "Tipo de esquema"
+            },
+            "type": "string",
+            "example": "Bearer",
+            "default": "Bearer",
+            "description": "HTTP token schema type",
+            "x-hide": true,
+            "enum": [
+              "Basic",
+              "Bearer"
+            ]
+          }
+        }
+      },
+      "RequestLogout": {
+        "description": "Port input object for logout endpoint.",
+        "required": [
+          "username"
+        ],
+        "type": "object",
+        "properties": {
+          "username": {
+            "x-label": {
+              "en": "Username",
+              "pt-BR": "Usuário"
+            },
+            "type": "string",
+            "minLength": 1,
+            "example": "me@mydomain.com",
+            "description": "Username"
+          }
+        }
+      },
+      "RequestRegister": {
+        "description": "Port input object for user registration endpoint.",
+        "required": [
+          "firstName",
+          "username",
+          "password"
+        ],
+        "type": "object",
+        "properties": {
+          "firstName": {
+            "x-label": {
+              "en": "First name",
+              "pt-BR": "Nome"
+            },
+            "type": "string",
+            "minLength": 1,
+            "example": "Abraham",
+            "description": "User's first name"
+          },
+          "username": {
+            "x-label": {
+              "en": "Username",
+              "pt-BR": "Usuário"
+            },
+            "type": "string",
+            "minLength": 1,
+            "description": "Username to access the system"
+          },
+          "organization": {
+            "x-label": {
+              "en": "Organization",
+              "pt-BR": "Organização"
+            },
+            "type": "string",
+            "format": "uuid",
+            "nullable": true,
+            "description": "Organization id for tenant users (admin/user)",
+            "x-relation": {
+              "entity": "Organization",
+              "match": "id",
+              "display": "name",
+              "kind": "belongsTo"
+            }
+          },
+          "password": {
+            "x-label": {
+              "en": "Password",
+              "pt-BR": "Senha"
+            },
+            "type": "string",
+            "minLength": 8,
+            "format": "password",
+            "description": "Password to access the system"
+          }
+        }
+      },
+      "AuthorizationHeader": {
+        "description": "Port output object containing authorization header response contract.",
+        "required": [
+          "Authorization"
+        ],
+        "type": "object",
+        "properties": {
+          "Authorization": {
+            "type": "string",
+            "example": "Bearer saiudyas87dahsd8sahdas87dhas8d7hsa87dhas78dh=",
+            "description": "Authorization Header"
+          }
+        }
+      },
+      "RequestCreateUser": {
+        "description": "Port input object for user creation endpoint.",
+        "required": [
+          "firstName",
+          "username",
+          "password",
+          "emails"
+        ],
+        "type": "object",
+        "properties": {
+          "id": {
+            "x-label": {
+              "en": "ID",
+              "pt-BR": "ID"
+            },
+            "type": "string",
+            "format": "uuid",
+            "description": "Optional client-supplied uuid. Duplicate ids answer 409."
+          },
+          "firstName": {
+            "x-label": {
+              "en": "First name",
+              "pt-BR": "Nome"
+            },
+            "type": "string",
+            "minLength": 1,
+            "example": "Abraham",
+            "description": "User's first name"
+          },
+          "lastName": {
+            "x-label": {
+              "en": "Last name",
+              "pt-BR": "Sobrenome"
+            },
+            "type": "string",
+            "example": "Abraham",
+            "nullable": true,
+            "description": "User's last name"
+          },
+          "avatar": {
+            "x-label": {
+              "en": "Avatar",
+              "pt-BR": "Avatar"
+            },
+            "type": "string",
+            "maxLength": 255,
+            "example": "avatar.png",
+            "default": "avatar.png",
+            "description": "User's avatar"
+          },
+          "username": {
+            "x-label": {
+              "en": "Username",
+              "pt-BR": "Usuário"
+            },
+            "type": "string",
+            "minLength": 1,
+            "description": "Username to access the system"
+          },
+          "organization": {
+            "x-label": {
+              "en": "Organization",
+              "pt-BR": "Organização"
+            },
+            "type": "string",
+            "format": "uuid",
+            "nullable": true,
+            "description": "Organization id for tenant users (admin/user)",
+            "x-relation": {
+              "entity": "Organization",
+              "match": "id",
+              "display": "name",
+              "kind": "belongsTo"
+            }
+          },
+          "password": {
+            "x-label": {
+              "en": "Password",
+              "pt-BR": "Senha"
+            },
+            "type": "string",
+            "minLength": 8,
+            "format": "password",
+            "description": "Password to access the system"
+          },
+          "emails": {
+            "x-label": {
+              "en": "Emails",
+              "pt-BR": "E-mails"
+            },
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Email"
+            },
+            "description": "User's e-mail addresses",
+            "minItems": 1
+          },
+          "documents": {
+            "x-label": {
+              "en": "Documents",
+              "pt-BR": "Documentos"
+            },
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Document"
+            },
+            "description": "User's attached documents"
+          },
+          "phones": {
+            "x-label": {
+              "en": "Phones",
+              "pt-BR": "Telefones"
+            },
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Phone"
+            },
+            "description": "User's attached phone numbers"
+          },
+          "roles": {
+            "x-label": {
+              "en": "Roles",
+              "pt-BR": "Papéis"
+            },
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "User's access roles"
+          }
+        }
+      },
+      "RequestUpdateUser": {
+        "description": "Port input object for user update endpoint.",
+        "type": "object",
+        "required": [
+          "id"
+        ],
+        "properties": {
+          "id": {
+            "x-label": {
+              "en": "ID",
+              "pt-BR": "ID"
+            },
+            "type": "string"
+          },
+          "firstName": {
+            "x-label": {
+              "en": "First name",
+              "pt-BR": "Nome"
+            },
+            "type": "string",
+            "minLength": 1,
+            "example": "Abraham",
+            "description": "User's first name"
+          },
+          "lastName": {
+            "x-label": {
+              "en": "Last name",
+              "pt-BR": "Sobrenome"
+            },
+            "type": "string",
+            "example": "Abraham",
+            "nullable": true,
+            "description": "User's last name"
+          },
+          "avatar": {
+            "x-label": {
+              "en": "Avatar",
+              "pt-BR": "Avatar"
+            },
+            "type": "string",
+            "maxLength": 255,
+            "example": "avatar.png",
+            "default": "avatar.png",
+            "description": "User's avatar"
+          },
+          "username": {
+            "x-label": {
+              "en": "Username",
+              "pt-BR": "Usuário"
+            },
+            "type": "string",
+            "minLength": 1,
+            "description": "Username to access the system"
+          },
+          "organization": {
+            "x-label": {
+              "en": "Organization",
+              "pt-BR": "Organização"
+            },
+            "type": "string",
+            "format": "uuid",
+            "nullable": true,
+            "description": "Organization id for tenant users (admin/user)",
+            "x-relation": {
+              "entity": "Organization",
+              "match": "id",
+              "display": "name",
+              "kind": "belongsTo"
+            }
+          },
+          "emails": {
+            "x-label": {
+              "en": "Emails",
+              "pt-BR": "E-mails"
+            },
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Email"
+            },
+            "description": "User's e-mail addresses",
+            "minItems": 1
+          },
+          "documents": {
+            "x-label": {
+              "en": "Documents",
+              "pt-BR": "Documentos"
+            },
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Document"
+            },
+            "description": "User's attached documents"
+          },
+          "phones": {
+            "x-label": {
+              "en": "Phones",
+              "pt-BR": "Telefones"
+            },
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Phone"
+            },
+            "description": "User's attached phone numbers"
+          },
+          "roles": {
+            "x-label": {
+              "en": "Roles",
+              "pt-BR": "Papéis"
+            },
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "User's access roles"
+          }
+        }
+      },
+      "RequestCreateOrganization": {
+        "description": "Port input object for organization creation endpoint.",
+        "required": [
+          "name"
+        ],
+        "type": "object",
+        "properties": {
+          "id": {
+            "x-label": {
+              "en": "ID",
+              "pt-BR": "ID"
+            },
+            "type": "string",
+            "format": "uuid"
+          },
+          "name": {
+            "x-label": {
+              "en": "Name",
+              "pt-BR": "Nome"
+            },
+            "type": "string",
+            "minLength": 1
+          },
+          "address": {
+            "x-label": {
+              "en": "Addresses",
+              "pt-BR": "Endereços"
+            },
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Address"
+            }
+          },
+          "phone": {
+            "x-label": {
+              "en": "Phones",
+              "pt-BR": "Telefones"
+            },
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Phone"
+            }
+          },
+          "email": {
+            "x-label": {
+              "en": "Email",
+              "pt-BR": "E-mail"
+            },
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Email"
+            }
+          },
+          "users": {
+            "x-label": {
+              "en": "Members",
+              "pt-BR": "Membros"
+            },
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      },
+      "RequestUpdateOrganization": {
+        "description": "Port input object for organization update endpoint.",
+        "required": [
+          "id"
+        ],
+        "type": "object",
+        "properties": {
+          "id": {
+            "x-label": {
+              "en": "ID",
+              "pt-BR": "ID"
+            },
+            "type": "string",
+            "format": "uuid"
+          },
+          "name": {
+            "x-label": {
+              "en": "Name",
+              "pt-BR": "Nome"
+            },
+            "type": "string",
+            "minLength": 1
+          },
+          "address": {
+            "x-label": {
+              "en": "Addresses",
+              "pt-BR": "Endereços"
+            },
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Address"
+            }
+          },
+          "phone": {
+            "x-label": {
+              "en": "Phones",
+              "pt-BR": "Telefones"
+            },
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Phone"
+            }
+          },
+          "email": {
+            "x-label": {
+              "en": "Email",
+              "pt-BR": "E-mail"
+            },
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Email"
+            }
+          },
+          "users": {
+            "x-label": {
+              "en": "Members",
+              "pt-BR": "Membros"
+            },
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      },
+      "RequestCreatePhone": {
+        "description": "Port input object for phone create endpoint.",
+        "type": "object",
+        "required": [
+          "countryCode",
+          "localCode",
+          "number"
+        ],
+        "properties": {
+          "countryCode": {
+            "x-label": {
+              "en": "Country code",
+              "pt-BR": "Código do país"
+            },
+            "type": "string",
+            "maxLength": 4,
+            "description": "E.164 country calling code",
+            "enum": [
+              "+1",
+              "+7",
+              "+20",
+              "+27",
+              "+30",
+              "+31",
+              "+32",
+              "+33",
+              "+34",
+              "+36",
+              "+39",
+              "+40",
+              "+41",
+              "+43",
+              "+44",
+              "+45",
+              "+46",
+              "+47",
+              "+48",
+              "+49",
+              "+51",
+              "+52",
+              "+53",
+              "+54",
+              "+55",
+              "+56",
+              "+57",
+              "+58",
+              "+60",
+              "+61",
+              "+62",
+              "+63",
+              "+64",
+              "+65",
+              "+66",
+              "+81",
+              "+82",
+              "+84",
+              "+86",
+              "+90",
+              "+91",
+              "+92",
+              "+93",
+              "+94",
+              "+95",
+              "+98",
+              "+211",
+              "+212",
+              "+213",
+              "+216",
+              "+218",
+              "+220",
+              "+221",
+              "+224",
+              "+225",
+              "+226",
+              "+227",
+              "+228",
+              "+230",
+              "+233",
+              "+234",
+              "+236",
+              "+241",
+              "+243",
+              "+244",
+              "+248",
+              "+249",
+              "+251",
+              "+252",
+              "+254",
+              "+255",
+              "+256",
+              "+258",
+              "+260",
+              "+261",
+              "+263",
+              "+264",
+              "+265",
+              "+267",
+              "+268",
+              "+269",
+              "+290",
+              "+297",
+              "+298",
+              "+299",
+              "+350",
+              "+351",
+              "+352",
+              "+353",
+              "+354",
+              "+355",
+              "+356",
+              "+357",
+              "+358",
+              "+359",
+              "+370",
+              "+371",
+              "+372",
+              "+373",
+              "+374",
+              "+375",
+              "+376",
+              "+377",
+              "+380",
+              "+381",
+              "+385",
+              "+386",
+              "+387",
+              "+389",
+              "+420",
+              "+421",
+              "+423",
+              "+500",
+              "+501",
+              "+502",
+              "+503",
+              "+504",
+              "+505",
+              "+506",
+              "+507",
+              "+509",
+              "+590",
+              "+591",
+              "+592",
+              "+593",
+              "+594",
+              "+595",
+              "+597",
+              "+598",
+              "+599",
+              "+670",
+              "+673",
+              "+675",
+              "+676",
+              "+677",
+              "+678",
+              "+679",
+              "+680",
+              "+685",
+              "+687",
+              "+689",
+              "+850",
+              "+852",
+              "+853",
+              "+855",
+              "+856",
+              "+880",
+              "+886",
+              "+960",
+              "+961",
+              "+962",
+              "+963",
+              "+964",
+              "+965",
+              "+966",
+              "+968",
+              "+970",
+              "+971",
+              "+972",
+              "+973",
+              "+974",
+              "+975",
+              "+976",
+              "+977",
+              "+992",
+              "+993",
+              "+994",
+              "+995",
+              "+996",
+              "+998"
+            ]
+          },
+          "localCode": {
+            "x-label": {
+              "en": "Area code",
+              "pt-BR": "DDD"
+            },
+            "type": "string",
+            "pattern": "^\\d{2,3}$",
+            "maxLength": 3
+          },
+          "number": {
+            "x-label": {
+              "en": "Number",
+              "pt-BR": "Número"
+            },
+            "type": "string"
+          },
+          "isPrimary": {
+            "x-label": {
+              "en": "Primary",
+              "pt-BR": "Principal"
+            },
+            "type": "boolean",
+            "example": true,
+            "description": "Is this the primary User's phone number?",
+            "default": false
+          }
+        }
+      },
+      "RequestUpdatePhone": {
+        "description": "Port input object for phone update endpoint.",
+        "type": "object",
+        "required": [
+          "id"
+        ],
+        "properties": {
+          "id": {
+            "x-label": {
+              "en": "ID",
+              "pt-BR": "ID"
+            },
+            "type": "string"
+          },
+          "countryCode": {
+            "x-label": {
+              "en": "Country code",
+              "pt-BR": "Código do país"
+            },
+            "type": "string",
+            "maxLength": 4,
+            "description": "E.164 country calling code",
+            "enum": [
+              "+1",
+              "+7",
+              "+20",
+              "+27",
+              "+30",
+              "+31",
+              "+32",
+              "+33",
+              "+34",
+              "+36",
+              "+39",
+              "+40",
+              "+41",
+              "+43",
+              "+44",
+              "+45",
+              "+46",
+              "+47",
+              "+48",
+              "+49",
+              "+51",
+              "+52",
+              "+53",
+              "+54",
+              "+55",
+              "+56",
+              "+57",
+              "+58",
+              "+60",
+              "+61",
+              "+62",
+              "+63",
+              "+64",
+              "+65",
+              "+66",
+              "+81",
+              "+82",
+              "+84",
+              "+86",
+              "+90",
+              "+91",
+              "+92",
+              "+93",
+              "+94",
+              "+95",
+              "+98",
+              "+211",
+              "+212",
+              "+213",
+              "+216",
+              "+218",
+              "+220",
+              "+221",
+              "+224",
+              "+225",
+              "+226",
+              "+227",
+              "+228",
+              "+230",
+              "+233",
+              "+234",
+              "+236",
+              "+241",
+              "+243",
+              "+244",
+              "+248",
+              "+249",
+              "+251",
+              "+252",
+              "+254",
+              "+255",
+              "+256",
+              "+258",
+              "+260",
+              "+261",
+              "+263",
+              "+264",
+              "+265",
+              "+267",
+              "+268",
+              "+269",
+              "+290",
+              "+297",
+              "+298",
+              "+299",
+              "+350",
+              "+351",
+              "+352",
+              "+353",
+              "+354",
+              "+355",
+              "+356",
+              "+357",
+              "+358",
+              "+359",
+              "+370",
+              "+371",
+              "+372",
+              "+373",
+              "+374",
+              "+375",
+              "+376",
+              "+377",
+              "+380",
+              "+381",
+              "+385",
+              "+386",
+              "+387",
+              "+389",
+              "+420",
+              "+421",
+              "+423",
+              "+500",
+              "+501",
+              "+502",
+              "+503",
+              "+504",
+              "+505",
+              "+506",
+              "+507",
+              "+509",
+              "+590",
+              "+591",
+              "+592",
+              "+593",
+              "+594",
+              "+595",
+              "+597",
+              "+598",
+              "+599",
+              "+670",
+              "+673",
+              "+675",
+              "+676",
+              "+677",
+              "+678",
+              "+679",
+              "+680",
+              "+685",
+              "+687",
+              "+689",
+              "+850",
+              "+852",
+              "+853",
+              "+855",
+              "+856",
+              "+880",
+              "+886",
+              "+960",
+              "+961",
+              "+962",
+              "+963",
+              "+964",
+              "+965",
+              "+966",
+              "+968",
+              "+970",
+              "+971",
+              "+972",
+              "+973",
+              "+974",
+              "+975",
+              "+976",
+              "+977",
+              "+992",
+              "+993",
+              "+994",
+              "+995",
+              "+996",
+              "+998"
+            ]
+          },
+          "localCode": {
+            "x-label": {
+              "en": "Area code",
+              "pt-BR": "DDD"
+            },
+            "type": "string",
+            "pattern": "^\\d{2,3}$",
+            "maxLength": 3
+          },
+          "number": {
+            "x-label": {
+              "en": "Number",
+              "pt-BR": "Número"
+            },
+            "type": "string"
+          },
+          "isPrimary": {
+            "x-label": {
+              "en": "Primary",
+              "pt-BR": "Principal"
+            },
+            "type": "boolean",
+            "example": true,
+            "description": "Is this the primary User's phone number?"
+          }
+        }
+      },
+      "RequestCreateAddress": {
+        "description": "Port input object for address create endpoint.",
+        "type": "object",
+        "required": [
+          "email",
+          "type"
+        ],
+        "properties": {
+          "email": {
+            "x-label": {
+              "en": "Email",
+              "pt-BR": "E-mail"
+            },
+            "type": "string",
+            "format": "email"
+          },
+          "type": {
+            "x-label": {
+              "en": "Type",
+              "pt-BR": "Tipo"
+            },
+            "type": "string",
+            "enum": [
+              "work",
+              "home",
+              "vacation"
+            ]
+          },
+          "isPrimary": {
+            "x-label": {
+              "en": "Primary",
+              "pt-BR": "Principal"
+            },
+            "type": "boolean",
+            "default": false
+          }
+        }
+      },
+      "RequestUpdateAddress": {
+        "description": "Port input object for address update endpoint.",
+        "type": "object",
+        "required": [
+          "id"
+        ],
+        "properties": {
+          "id": {
+            "x-label": {
+              "en": "ID",
+              "pt-BR": "ID"
+            },
+            "type": "string",
+            "format": "uuid"
+          },
+          "email": {
+            "x-label": {
+              "en": "Email",
+              "pt-BR": "E-mail"
+            },
+            "type": "string",
+            "format": "email"
+          },
+          "type": {
+            "x-label": {
+              "en": "Type",
+              "pt-BR": "Tipo"
+            },
+            "type": "string",
+            "enum": [
+              "work",
+              "home",
+              "vacation"
+            ]
+          },
+          "isPrimary": {
+            "x-label": {
+              "en": "Primary",
+              "pt-BR": "Principal"
+            },
+            "type": "boolean"
+          }
+        }
+      },
+      "RequestCreateEmail": {
+        "description": "Port input object for email create endpoint.",
+        "type": "object",
+        "required": [
+          "email",
+          "type"
+        ],
+        "properties": {
+          "email": {
+            "x-label": {
+              "en": "Email",
+              "pt-BR": "E-mail"
+            },
+            "type": "string",
+            "format": "email",
+            "pattern": "^[^@\\s]+@[^@\\s]+\\.[^@\\s]+$",
+            "maxLength": 254
+          },
+          "type": {
+            "x-label": {
+              "en": "Type",
+              "pt-BR": "Tipo"
+            },
+            "type": "string",
+            "enum": [
+              "work",
+              "personal"
+            ]
+          },
+          "isPrimary": {
+            "x-label": {
+              "en": "Primary",
+              "pt-BR": "Principal"
+            },
+            "type": "boolean",
+            "example": true,
+            "description": "Is this the primary User's e-mail address?",
+            "default": false
+          }
+        }
+      },
+      "RequestUpdateEmail": {
+        "description": "Port input object for email update endpoint.",
+        "type": "object",
+        "required": [
+          "id"
+        ],
+        "properties": {
+          "id": {
+            "x-label": {
+              "en": "ID",
+              "pt-BR": "ID"
+            },
+            "type": "string"
+          },
+          "email": {
+            "x-label": {
+              "en": "Email",
+              "pt-BR": "E-mail"
+            },
+            "type": "string",
+            "format": "email",
+            "pattern": "^[^@\\s]+@[^@\\s]+\\.[^@\\s]+$",
+            "maxLength": 254
+          },
+          "type": {
+            "x-label": {
+              "en": "Type",
+              "pt-BR": "Tipo"
+            },
+            "type": "string",
+            "enum": [
+              "work",
+              "personal"
+            ]
+          },
+          "isPrimary": {
+            "x-label": {
+              "en": "Primary",
+              "pt-BR": "Principal"
+            },
+            "type": "boolean",
+            "example": true,
+            "description": "Is this the primary User's e-mail address?"
+          }
+        }
+      },
+      "RequestCreateDocument": {
+        "description": "Port input object for document create endpoint.",
+        "type": "object",
+        "required": [
+          "data",
+          "type",
+          "countryIssue"
+        ],
+        "properties": {
+          "type": {
+            "x-label": {
+              "en": "Type",
+              "pt-BR": "Tipo"
+            },
+            "type": "string",
+            "enum": [
+              "CPF",
+              "RG",
+              "SSN",
+              "passport"
+            ],
+            "example": "CPF",
+            "description": "Type of document"
+          },
+          "countryIssue": {
+            "x-label": {
+              "en": "Issuing country",
+              "pt-BR": "País emissor"
+            },
+            "type": "string",
+            "pattern": "^[A-Z]{2}$",
+            "maxLength": 2,
+            "example": "BR",
+            "description": "Country which emitted the document"
+          },
+          "data": {
+            "x-label": {
+              "en": "Number",
+              "pt-BR": "Número"
+            },
+            "type": "string",
+            "maxLength": 20
+          }
+        }
+      },
+      "RequestUpdateDocument": {
+        "description": "Port input object for document update endpoint.",
+        "type": "object",
+        "required": [
+          "id"
+        ],
+        "properties": {
+          "id": {
+            "x-label": {
+              "en": "ID",
+              "pt-BR": "ID"
+            },
+            "type": "string"
+          },
+          "type": {
+            "x-label": {
+              "en": "Type",
+              "pt-BR": "Tipo"
+            },
+            "type": "string",
+            "enum": [
+              "CPF",
+              "RG",
+              "SSN",
+              "passport"
+            ],
+            "example": "CPF",
+            "description": "Type of document"
+          },
+          "countryIssue": {
+            "x-label": {
+              "en": "Issuing country",
+              "pt-BR": "País emissor"
+            },
+            "type": "string",
+            "pattern": "^[A-Z]{2}$",
+            "maxLength": 2,
+            "example": "BR",
+            "description": "Country which emitted the document"
+          },
+          "data": {
+            "x-label": {
+              "en": "Number",
+              "pt-BR": "Número"
+            },
+            "type": "string",
+            "maxLength": 20
+          }
+        }
+      },
+      "RequestUpdatePassword": {
+        "description": "Port input object for password update endpoint.",
+        "type": "object",
+        "required": [
+          "password"
+        ],
+        "properties": {
+          "password": {
+            "x-label": {
+              "en": "Password",
+              "pt-BR": "Senha"
+            },
+            "type": "string",
+            "minLength": 8,
+            "format": "password"
+          }
+        }
+      },
+      "UserArrayOf": {
+        "description": "Port output page of users: the `result` slice selected by `page`/`size`/`filter`/`sort`/`q` plus the matching `total` (JUM-777).",
+        "type": "object",
+        "required": [
+          "result",
+          "page",
+          "size",
+          "total"
+        ],
+        "properties": {
+          "result": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/User"
+            }
+          },
+          "page": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "size": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "total": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Number of records matching the filters and search, across all pages."
+          }
+        }
+      },
+      "OrganizationArrayOf": {
+        "description": "Port output page of organizations: the `result` slice selected by `page`/`size`/`filter`/`sort`/`q` plus the matching `total` (JUM-777).",
+        "type": "object",
+        "required": [
+          "result",
+          "page",
+          "size",
+          "total"
+        ],
+        "properties": {
+          "result": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Organization"
+            }
+          },
+          "page": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "size": {
+            "type": "integer",
+            "minimum": 1
+          },
+          "total": {
+            "type": "integer",
+            "minimum": 0,
+            "description": "Number of records matching the filters and search, across all pages."
+          }
+        }
+      },
+      "Document": {
+        "description": "Value object contract for Document.",
+        "type": "object",
+        "required": [
+          "data",
+          "type"
+        ],
+        "properties": {
+          "id": {
+            "x-label": {
+              "en": "ID",
+              "pt-BR": "ID"
+            },
+            "type": "string"
+          },
+          "type": {
+            "x-label": {
+              "en": "Type",
+              "pt-BR": "Tipo"
+            },
+            "type": "string",
+            "enum": [
+              "CPF",
+              "RG",
+              "SSN",
+              "passport"
+            ],
+            "example": "CPF",
+            "description": "Type of document"
+          },
+          "countryIssue": {
+            "x-label": {
+              "en": "Issuing country",
+              "pt-BR": "País emissor"
+            },
+            "type": "string",
+            "pattern": "^[A-Z]{2}$",
+            "maxLength": 2,
+            "example": "BR",
+            "description": "Country which emitted the document"
+          },
+          "data": {
+            "x-label": {
+              "en": "Number",
+              "pt-BR": "Número"
+            },
+            "type": "string",
+            "maxLength": 20,
+            "x-validation": {
+              "description": "Format rules per document type and issuing country. CPF uses the modulo-11 checksum with two verification digits; SSN uses the US AAA-GG-SSSS layout.",
+              "rules": [
+                {
+                  "when": {
+                    "type": "CPF",
+                    "countryIssue": "BR"
+                  },
+                  "pattern": "^\\d{3}\\.?\\d{3}\\.?\\d{3}-?\\d{2}$",
+                  "mask": "000.000.000-00",
+                  "checksum": "cpf-mod11",
+                  "example": "123.456.789-09"
+                },
+                {
+                  "when": {
+                    "type": "SSN",
+                    "countryIssue": "US"
+                  },
+                  "pattern": "^\\d{3}-?\\d{2}-?\\d{4}$",
+                  "mask": "000-00-0000",
+                  "example": "123-45-6789"
+                },
+                {
+                  "when": {
+                    "type": "RG"
+                  },
+                  "pattern": "^[A-Za-z0-9.-]{4,20}$"
+                },
+                {
+                  "when": {
+                    "type": "passport"
+                  },
+                  "pattern": "^[A-Za-z0-9]{5,20}$"
+                }
+              ]
+            }
+          }
+        }
+      },
+      "Email": {
+        "description": "Value object contract for Email.",
+        "type": "object",
+        "required": [
+          "email",
+          "type"
+        ],
+        "properties": {
+          "id": {
+            "x-label": {
+              "en": "ID",
+              "pt-BR": "ID"
+            },
+            "type": "string"
+          },
+          "email": {
+            "x-label": {
+              "en": "Email",
+              "pt-BR": "E-mail"
+            },
+            "type": "string",
+            "format": "email",
+            "pattern": "^[^@\\s]+@[^@\\s]+\\.[^@\\s]+$",
+            "maxLength": 254
+          },
+          "type": {
+            "x-label": {
+              "en": "Type",
+              "pt-BR": "Tipo"
+            },
+            "type": "string",
+            "enum": [
+              "work",
+              "personal"
+            ]
+          },
+          "isPrimary": {
+            "x-label": {
+              "en": "Primary",
+              "pt-BR": "Principal"
+            },
+            "type": "boolean",
+            "example": true,
+            "description": "Is this the primary User's e-mail address?",
+            "default": false
+          }
+        }
+      },
+      "Address": {
+        "description": "Value object contract for Address.",
+        "type": "object",
+        "required": [
+          "email",
+          "type"
+        ],
+        "properties": {
+          "id": {
+            "x-label": {
+              "en": "ID",
+              "pt-BR": "ID"
+            },
+            "type": "string",
+            "format": "uuid"
+          },
+          "email": {
+            "x-label": {
+              "en": "Email",
+              "pt-BR": "E-mail"
+            },
+            "type": "string"
+          },
+          "type": {
+            "x-label": {
+              "en": "Type",
+              "pt-BR": "Tipo"
+            },
+            "type": "string",
+            "enum": [
+              "work",
+              "home",
+              "vacation"
+            ]
+          },
+          "isPrimary": {
+            "x-label": {
+              "en": "Primary",
+              "pt-BR": "Principal"
+            },
+            "type": "boolean",
+            "default": false
+          }
+        }
+      },
+      "Phone": {
+        "description": "Value object contract for Phone.",
+        "type": "object",
+        "required": [
+          "countryCode",
+          "localCode",
+          "number"
+        ],
+        "properties": {
+          "id": {
+            "x-label": {
+              "en": "ID",
+              "pt-BR": "ID"
+            },
+            "type": "string"
+          },
+          "countryCode": {
+            "x-label": {
+              "en": "Country code",
+              "pt-BR": "Código do país"
+            },
+            "type": "string",
+            "maxLength": 4,
+            "description": "E.164 country calling code",
+            "enum": [
+              "+1",
+              "+7",
+              "+20",
+              "+27",
+              "+30",
+              "+31",
+              "+32",
+              "+33",
+              "+34",
+              "+36",
+              "+39",
+              "+40",
+              "+41",
+              "+43",
+              "+44",
+              "+45",
+              "+46",
+              "+47",
+              "+48",
+              "+49",
+              "+51",
+              "+52",
+              "+53",
+              "+54",
+              "+55",
+              "+56",
+              "+57",
+              "+58",
+              "+60",
+              "+61",
+              "+62",
+              "+63",
+              "+64",
+              "+65",
+              "+66",
+              "+81",
+              "+82",
+              "+84",
+              "+86",
+              "+90",
+              "+91",
+              "+92",
+              "+93",
+              "+94",
+              "+95",
+              "+98",
+              "+211",
+              "+212",
+              "+213",
+              "+216",
+              "+218",
+              "+220",
+              "+221",
+              "+224",
+              "+225",
+              "+226",
+              "+227",
+              "+228",
+              "+230",
+              "+233",
+              "+234",
+              "+236",
+              "+241",
+              "+243",
+              "+244",
+              "+248",
+              "+249",
+              "+251",
+              "+252",
+              "+254",
+              "+255",
+              "+256",
+              "+258",
+              "+260",
+              "+261",
+              "+263",
+              "+264",
+              "+265",
+              "+267",
+              "+268",
+              "+269",
+              "+290",
+              "+297",
+              "+298",
+              "+299",
+              "+350",
+              "+351",
+              "+352",
+              "+353",
+              "+354",
+              "+355",
+              "+356",
+              "+357",
+              "+358",
+              "+359",
+              "+370",
+              "+371",
+              "+372",
+              "+373",
+              "+374",
+              "+375",
+              "+376",
+              "+377",
+              "+380",
+              "+381",
+              "+385",
+              "+386",
+              "+387",
+              "+389",
+              "+420",
+              "+421",
+              "+423",
+              "+500",
+              "+501",
+              "+502",
+              "+503",
+              "+504",
+              "+505",
+              "+506",
+              "+507",
+              "+509",
+              "+590",
+              "+591",
+              "+592",
+              "+593",
+              "+594",
+              "+595",
+              "+597",
+              "+598",
+              "+599",
+              "+670",
+              "+673",
+              "+675",
+              "+676",
+              "+677",
+              "+678",
+              "+679",
+              "+680",
+              "+685",
+              "+687",
+              "+689",
+              "+850",
+              "+852",
+              "+853",
+              "+855",
+              "+856",
+              "+880",
+              "+886",
+              "+960",
+              "+961",
+              "+962",
+              "+963",
+              "+964",
+              "+965",
+              "+966",
+              "+968",
+              "+970",
+              "+971",
+              "+972",
+              "+973",
+              "+974",
+              "+975",
+              "+976",
+              "+977",
+              "+992",
+              "+993",
+              "+994",
+              "+995",
+              "+996",
+              "+998"
+            ]
+          },
+          "localCode": {
+            "x-label": {
+              "en": "Area code",
+              "pt-BR": "DDD"
+            },
+            "type": "string",
+            "pattern": "^\\d{2,3}$",
+            "maxLength": 3
+          },
+          "number": {
+            "x-label": {
+              "en": "Number",
+              "pt-BR": "Número"
+            },
+            "type": "string",
+            "x-validation": {
+              "description": "National number format per country (countryCode selects the rule).",
+              "rules": [
+                {
+                  "when": {
+                    "countryCode": "+55"
+                  },
+                  "pattern": "^\\d{4,5}-?\\d{4}$",
+                  "mask": "00000-0000",
+                  "example": "99805-4033"
+                },
+                {
+                  "when": {
+                    "countryCode": "+1"
+                  },
+                  "pattern": "^\\d{3}-?\\d{4}$",
+                  "mask": "000-0000",
+                  "example": "555-0100"
+                }
+              ]
+            }
+          },
+          "isPrimary": {
+            "x-label": {
+              "en": "Primary",
+              "pt-BR": "Principal"
+            },
+            "type": "boolean",
+            "example": true,
+            "description": "Is this the primary User's phone number?",
+            "default": false
+          }
+        }
+      },
+      "User": {
+        "description": "Port output object for User resource.",
+        "x-primary-key": "id",
+        "x-service": "core",
+        "required": [
+          "id",
+          "createdAt",
+          "updatedAt",
+          "firstName",
+          "username",
+          "password",
+          "emails"
+        ],
+        "type": "object",
+        "properties": {
+          "id": {
+            "x-label": {
+              "en": "ID",
+              "pt-BR": "ID"
+            },
+            "type": "string",
+            "format": "uuid"
+          },
+          "firstName": {
+            "x-label": {
+              "en": "First name",
+              "pt-BR": "Nome"
+            },
+            "type": "string",
+            "minLength": 1,
+            "example": "Abraham",
+            "description": "User's first name"
+          },
+          "lastName": {
+            "x-label": {
+              "en": "Last name",
+              "pt-BR": "Sobrenome"
+            },
+            "type": "string",
+            "example": "Abraham",
+            "nullable": true,
+            "description": "User's last name"
+          },
+          "username": {
+            "x-label": {
+              "en": "Username",
+              "pt-BR": "Usuário"
+            },
+            "type": "string",
+            "minLength": 1,
+            "description": "Username to access the system"
+          },
+          "organization": {
+            "x-label": {
+              "en": "Organization",
+              "pt-BR": "Organização"
+            },
+            "type": "string",
+            "format": "uuid",
+            "nullable": true,
+            "description": "Organization id for tenant users (admin/user)",
+            "x-relation": {
+              "entity": "Organization",
+              "match": "id",
+              "display": "name",
+              "kind": "belongsTo"
+            }
+          },
+          "password": {
+            "x-label": {
+              "en": "Password",
+              "pt-BR": "Senha"
+            },
+            "type": "string",
+            "minLength": 8,
+            "format": "password",
+            "description": "Password to access the system"
+          },
+          "emails": {
+            "x-label": {
+              "en": "Emails",
+              "pt-BR": "E-mails"
+            },
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Email"
+            },
+            "description": "User's e-mail addresses",
+            "minItems": 1
+          },
+          "documents": {
+            "x-label": {
+              "en": "Documents",
+              "pt-BR": "Documentos"
+            },
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Document"
+            },
+            "description": "User's attached documents"
+          },
+          "phones": {
+            "x-label": {
+              "en": "Phones",
+              "pt-BR": "Telefones"
+            },
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Phone"
+            },
+            "description": "User's attached phone numbers"
+          },
+          "roles": {
+            "x-label": {
+              "en": "Roles",
+              "pt-BR": "Papéis"
+            },
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "User's access roles"
+          },
+          "createdAt": {
+            "x-label": {
+              "en": "Created at",
+              "pt-BR": "Criado em"
+            },
+            "type": "string",
+            "format": "date-time"
+          },
+          "updatedAt": {
+            "x-label": {
+              "en": "Updated at",
+              "pt-BR": "Atualizado em"
+            },
+            "type": "string",
+            "format": "date-time"
+          },
+          "deletedAt": {
+            "x-label": {
+              "en": "Deleted at",
+              "pt-BR": "Excluído em"
+            },
+            "type": "string",
+            "format": "date-time",
+            "nullable": true,
+            "readOnly": true,
+            "description": "Tombstone timestamp. Null while the record is alive."
+          }
+        }
+      },
+      "Organization": {
+        "description": "Port output object for Organization resource.",
+        "x-primary-key": "id",
+        "x-service": "core",
+        "required": [
+          "id",
+          "createdAt",
+          "updatedAt",
+          "name"
+        ],
+        "type": "object",
+        "properties": {
+          "id": {
+            "x-label": {
+              "en": "ID",
+              "pt-BR": "ID"
+            },
+            "type": "string",
+            "format": "uuid"
+          },
+          "name": {
+            "x-label": {
+              "en": "Name",
+              "pt-BR": "Nome"
+            },
+            "type": "string"
+          },
+          "address": {
+            "x-label": {
+              "en": "Addresses",
+              "pt-BR": "Endereços"
+            },
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Address"
+            }
+          },
+          "phone": {
+            "x-label": {
+              "en": "Phones",
+              "pt-BR": "Telefones"
+            },
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Phone"
+            }
+          },
+          "email": {
+            "x-label": {
+              "en": "Email",
+              "pt-BR": "E-mail"
+            },
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Email"
+            }
+          },
+          "users": {
+            "x-label": {
+              "en": "Members",
+              "pt-BR": "Membros"
+            },
+            "type": "array",
+            "description": "Member user ids.",
+            "x-relation": {
+              "entity": "User",
+              "match": "id",
+              "display": "username",
+              "kind": "hasMany"
+            },
+            "items": {
+              "type": "string"
+            }
+          },
+          "createdAt": {
+            "x-label": {
+              "en": "Created at",
+              "pt-BR": "Criado em"
+            },
+            "type": "string",
+            "format": "date-time"
+          },
+          "updatedAt": {
+            "x-label": {
+              "en": "Updated at",
+              "pt-BR": "Atualizado em"
+            },
+            "type": "string",
+            "format": "date-time"
+          },
+          "deletedAt": {
+            "x-label": {
+              "en": "Deleted at",
+              "pt-BR": "Excluído em"
+            },
+            "type": "string",
+            "format": "date-time",
+            "nullable": true,
+            "readOnly": true,
+            "description": "Tombstone timestamp. Null while the record is alive."
+          }
+        }
+      },
+      "EntityMetricsResponse": {
+        "description": "Generic entity metrics envelope (JUM-793).",
+        "required": [
+          "metric",
+          "buckets"
+        ],
+        "type": "object",
+        "properties": {
+          "metric": {
+            "type": "string",
+            "enum": [
+              "count",
+              "groupBy",
+              "series"
+            ]
+          },
+          "field": {
+            "type": "string"
+          },
+          "interval": {
+            "type": "string",
+            "enum": [
+              "day",
+              "week",
+              "month"
+            ]
+          },
+          "buckets": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": [
+                "key",
+                "count"
+              ],
+              "properties": {
+                "key": {
+                  "type": "string"
+                },
+                "count": {
+                  "type": "integer",
+                  "minimum": 0
+                }
+              }
+            }
+          }
+        }
+      },
+      "BooleanStringResult": {
+        "description": "Port output object for legacy text/plain success responses (`true`/`false`).",
+        "type": "string",
+        "example": true
+      }
+    },
+    "securitySchemes": {
+      "bearerAuth": {
+        "type": "http",
+        "scheme": "bearer"
+      }
+    }
+  }
+}