@meshery/schemas 1.2.14 → 1.2.16

package/dist/constructs/v1beta2/team/Team.d.ts

@@ -0,0 +1,960 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+
+export interface paths {
+  "/api/identity/orgs/{orgId}/teams": {
+    /** Gets all teams within an organization */
+    get: operations["getTeams"];
+    /** Creates a new team within an organization */
+    post: operations["createTeam"];
+  };
+  "/api/identity/orgs/{orgId}/teams/{teamId}": {
+    /** Gets a team by its ID */
+    get: operations["getTeamById"];
+    /** Updates a team's information */
+    put: operations["updateTeam"];
+    /** Deletes a team by its ID */
+    delete: operations["deleteTeam"];
+  };
+  "/api/identity/teams/{teamId}/users": {
+    /** Gets all users that belong to a team */
+    get: operations["getTeamUsers"];
+  };
+  "/api/identity/orgs/{orgId}/teams/{teamId}/users/{userId}": {
+    /** Assigns a user to a team */
+    post: operations["addUserToTeam"];
+    /** Unassigns a user from a team */
+    delete: operations["removeUserFromTeam"];
+  };
+  "/api/identity/orgs/{orgId}/teams/{teamId}/users": {
+    get: operations["listUsersNotInTeam"];
+  };
+}
+
+export interface components {
+  schemas: {
+    /** @description A Team is a group of one or more users. Teams are often used as a grouping mechanism for assigning permissions, whether in the context of an organization, a workspace, or some other domain within Meshery. Learn more at https://docs.meshery.io/concepts/logical/teams */
+    Team: {
+      /**
+       * Format: uuid
+       * @description Team ID
+       */
+      id: string;
+      /** @description Team name */
+      name: string;
+      /** @description Team description */
+      description?: string;
+      /**
+       * Format: uuid
+       * @description User ID of the owner of the team
+       */
+      owner?: string;
+      /** @description Additional metadata for the team */
+      metadata?: { [key: string]: unknown };
+      /**
+       * Format: date-time
+       * @description Timestamp when the team was created.
+       */
+      createdAt: string;
+      /**
+       * Format: date-time
+       * @description Timestamp when the team was last updated.
+       */
+      updatedAt: string;
+      /**
+       * Format: date-time
+       * @description Timestamp when the team was soft-deleted, if applicable.
+       */
+      deletedAt?: string;
+    };
+    /** @description Payload for creating a new team */
+    TeamPayload: {
+      /** @description Team name. Provide a meaningful name that represents this team. */
+      name: string;
+      /** @description A detailed description of the team's purpose and responsibilities. */
+      description?: string;
+    };
+    /** @description Payload for updating an existing team */
+    TeamUpdatePayload: {
+      /** @description Updated team name */
+      name?: string;
+      /** @description Updated team description */
+      description?: string;
+    };
+    /** @description Paginated list of teams */
+    TeamPage: {
+      /** @description Current page number of the result set. */
+      page?: number;
+      /** @description Number of items per page. */
+      page_size?: number;
+      /** @description Total number of items available. */
+      total_count?: number;
+      /** @description The teams of the teampage. */
+      teams?: {
+        /**
+         * Format: uuid
+         * @description Team ID
+         */
+        id: string;
+        /** @description Team name */
+        name: string;
+        /** @description Team description */
+        description?: string;
+        /**
+         * Format: uuid
+         * @description User ID of the owner of the team
+         */
+        owner?: string;
+        /** @description Additional metadata for the team */
+        metadata?: { [key: string]: unknown };
+        /**
+         * Format: date-time
+         * @description Timestamp when the team was created.
+         */
+        createdAt: string;
+        /**
+         * Format: date-time
+         * @description Timestamp when the team was last updated.
+         */
+        updatedAt: string;
+        /**
+         * Format: date-time
+         * @description Timestamp when the team was soft-deleted, if applicable.
+         */
+        deletedAt?: string;
+      }[];
+    };
+    /** @description Join row between users and teams. The schema name is `UsersTeamsMapping` (rather than `TeamsUsersMapping`) so that pop's tableize default produces the live DB table name `users_teams_mappings`, eliminating the need for an explicit `TableName()` helper on the generated Go struct. */
+    UsersTeamsMapping: {
+      /** Format: uuid */
+      id?: string;
+      /**
+       * Format: uuid
+       * @description Team ID
+       */
+      teamId?: string;
+      /**
+       * Format: uuid
+       * @description User ID
+       */
+      userId?: string;
+      /**
+       * Format: uuid
+       * @description Optional role assigned to this team membership. Nullable because a membership may exist without an explicit role (e.g., team-admin assignments are stamped on insert; non-owner adds may leave `role_id` null until a role is assigned). References `roles.id`.
+       */
+      roleId?: string;
+      /**
+       * Format: date-time
+       * @description Timestamp when the mapping was created.
+       */
+      createdAt?: string;
+      /**
+       * Format: date-time
+       * @description Timestamp when the mapping was last updated.
+       */
+      updatedAt?: string;
+      /**
+       * Format: date-time
+       * @description Timestamp when the mapping was soft-deleted, if applicable.
+       */
+      deletedAt?: string;
+    };
+    /** @description Paginated list of user-team mappings */
+    UsersTeamsMappingPage: {
+      /** @description Current page number of the result set. */
+      page?: number;
+      /** @description Number of items per page. */
+      page_size?: number;
+      /** @description Total number of items available. */
+      total_count?: number;
+      /** @description The user-team mappings on the current page. */
+      usersTeamsMapping?: {
+        /** Format: uuid */
+        id?: string;
+        /**
+         * Format: uuid
+         * @description Team ID
+         */
+        teamId?: string;
+        /**
+         * Format: uuid
+         * @description User ID
+         */
+        userId?: string;
+        /**
+         * Format: uuid
+         * @description Optional role assigned to this team membership. Nullable because a membership may exist without an explicit role (e.g., team-admin assignments are stamped on insert; non-owner adds may leave `role_id` null until a role is assigned). References `roles.id`.
+         */
+        roleId?: string;
+        /**
+         * Format: date-time
+         * @description Timestamp when the mapping was created.
+         */
+        createdAt?: string;
+        /**
+         * Format: date-time
+         * @description Timestamp when the mapping was last updated.
+         */
+        updatedAt?: string;
+        /**
+         * Format: date-time
+         * @description Timestamp when the mapping was soft-deleted, if applicable.
+         */
+        deletedAt?: string;
+      }[];
+    };
+    /** @description A user who is a prospective or existing team member. Returned by the "list users in team" endpoint. `joinedAt` is the first canonicalised projection field — other user fields (`id`, `firstName`, `lastName`, `email`, `avatarUrl`) continue to flow through `additionalProperties` pending migration of the user schema to the canonical-casing contract. See meshery/schemas#832 for the per-field roadmap. */
+    TeamMember: {
+      /**
+       * Format: date-time
+       * @description Timestamp when the user joined the team. Server-computed from the earliest matching row in `users_teams_mapping` for this (team, user) pair. Server-managed; clients cannot set this.
+       */
+      joinedAt?: string;
+    } & { [key: string]: unknown };
+    /** @description Paginated list of team members. */
+    TeamMembersPage: {
+      /** @description Current page number of the result set. */
+      page?: number;
+      /** @description Number of items per page. */
+      page_size?: number;
+      /** @description Total number of items available. */
+      total_count?: number;
+      /** @description The data of the teammemberspage. */
+      data?: ({
+        /**
+         * Format: date-time
+         * @description Timestamp when the user joined the team. Server-computed from the earliest matching row in `users_teams_mapping` for this (team, user) pair. Server-managed; clients cannot set this.
+         */
+        joinedAt?: string;
+      } & { [key: string]: unknown })[];
+    };
+  };
+  responses: {
+    /** ok */
+    200: {
+      content: {
+        "text/plain": string;
+      };
+    };
+    /** Invalid request body or request param */
+    400: {
+      content: {
+        "text/plain": string;
+      };
+    };
+    /** Expired JWT token used or insufficient privilege */
+    401: {
+      content: {
+        "text/plain": string;
+      };
+    };
+    /** Result not found */
+    404: {
+      content: {
+        "text/plain": string;
+      };
+    };
+    /** Internal server error */
+    500: {
+      content: {
+        "text/plain": string;
+      };
+    };
+  };
+  parameters: {
+    /** @description Team ID */
+    teamId: string;
+    /** @description Organization ID */
+    orgId: string;
+    /** @description User ID */
+    userId: string;
+    /** @description Get responses that match search param value */
+    search: string;
+    /** @description Get ordered responses */
+    order: string;
+    /** @description Get responses by page */
+    page: string;
+    /** @description Get responses by pagesize */
+    pagesize: string;
+  };
+  requestBodies: {
+    /** Body for creating a team */
+    teamPayload: {
+      content: {
+        "application/json": {
+          /** @description Team name. Provide a meaningful name that represents this team. */
+          name: string;
+          /** @description A detailed description of the team's purpose and responsibilities. */
+          description?: string;
+        };
+      };
+    };
+    /** Body for updating a team */
+    teamUpdatePayload: {
+      content: {
+        "application/json": {
+          /** @description Updated team name */
+          name?: string;
+          /** @description Updated team description */
+          description?: string;
+        };
+      };
+    };
+  };
+}
+
+export interface operations {
+  /** Gets all teams within an organization */
+  getTeams: {
+    parameters: {
+      path: {
+        /** Organization ID */
+        orgId: string;
+      };
+      query: {
+        /** Get responses that match search param value */
+        search?: string;
+        /** Get ordered responses */
+        order?: string;
+        /** Get responses by page */
+        page?: string;
+        /** Get responses by pagesize */
+        pagesize?: string;
+      };
+    };
+    responses: {
+      /** Teams */
+      200: {
+        content: {
+          "application/json": {
+            /** @description Current page number of the result set. */
+            page?: number;
+            /** @description Number of items per page. */
+            page_size?: number;
+            /** @description Total number of items available. */
+            total_count?: number;
+            /** @description The teams of the teampage. */
+            teams?: {
+              /**
+               * Format: uuid
+               * @description Team ID
+               */
+              id: string;
+              /** @description Team name */
+              name: string;
+              /** @description Team description */
+              description?: string;
+              /**
+               * Format: uuid
+               * @description User ID of the owner of the team
+               */
+              owner?: string;
+              /** @description Additional metadata for the team */
+              metadata?: { [key: string]: unknown };
+              /**
+               * Format: date-time
+               * @description Timestamp when the team was created.
+               */
+              createdAt: string;
+              /**
+               * Format: date-time
+               * @description Timestamp when the team was last updated.
+               */
+              updatedAt: string;
+              /**
+               * Format: date-time
+               * @description Timestamp when the team was soft-deleted, if applicable.
+               */
+              deletedAt?: string;
+            }[];
+          };
+        };
+      };
+      /** Expired JWT token used or insufficient privilege */
+      401: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Result not found */
+      404: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Internal server error */
+      500: {
+        content: {
+          "text/plain": string;
+        };
+      };
+    };
+  };
+  /** Creates a new team within an organization */
+  createTeam: {
+    parameters: {
+      path: {
+        /** Organization ID */
+        orgId: string;
+      };
+    };
+    responses: {
+      /** Created team */
+      201: {
+        content: {
+          "application/json": {
+            /**
+             * Format: uuid
+             * @description Team ID
+             */
+            id: string;
+            /** @description Team name */
+            name: string;
+            /** @description Team description */
+            description?: string;
+            /**
+             * Format: uuid
+             * @description User ID of the owner of the team
+             */
+            owner?: string;
+            /** @description Additional metadata for the team */
+            metadata?: { [key: string]: unknown };
+            /**
+             * Format: date-time
+             * @description Timestamp when the team was created.
+             */
+            createdAt: string;
+            /**
+             * Format: date-time
+             * @description Timestamp when the team was last updated.
+             */
+            updatedAt: string;
+            /**
+             * Format: date-time
+             * @description Timestamp when the team was soft-deleted, if applicable.
+             */
+            deletedAt?: string;
+          };
+        };
+      };
+      /** Invalid request body or request param */
+      400: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Expired JWT token used or insufficient privilege */
+      401: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Result not found */
+      404: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Internal server error */
+      500: {
+        content: {
+          "text/plain": string;
+        };
+      };
+    };
+    /** Body for creating a team */
+    requestBody: {
+      content: {
+        "application/json": {
+          /** @description Team name. Provide a meaningful name that represents this team. */
+          name: string;
+          /** @description A detailed description of the team's purpose and responsibilities. */
+          description?: string;
+        };
+      };
+    };
+  };
+  /** Gets a team by its ID */
+  getTeamById: {
+    parameters: {
+      path: {
+        /** Organization ID */
+        orgId: string;
+        /** Team ID */
+        teamId: string;
+      };
+    };
+    responses: {
+      /** Team */
+      200: {
+        content: {
+          "application/json": {
+            /**
+             * Format: uuid
+             * @description Team ID
+             */
+            id: string;
+            /** @description Team name */
+            name: string;
+            /** @description Team description */
+            description?: string;
+            /**
+             * Format: uuid
+             * @description User ID of the owner of the team
+             */
+            owner?: string;
+            /** @description Additional metadata for the team */
+            metadata?: { [key: string]: unknown };
+            /**
+             * Format: date-time
+             * @description Timestamp when the team was created.
+             */
+            createdAt: string;
+            /**
+             * Format: date-time
+             * @description Timestamp when the team was last updated.
+             */
+            updatedAt: string;
+            /**
+             * Format: date-time
+             * @description Timestamp when the team was soft-deleted, if applicable.
+             */
+            deletedAt?: string;
+          };
+        };
+      };
+      /** Invalid request body or request param */
+      400: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Expired JWT token used or insufficient privilege */
+      401: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Result not found */
+      404: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Internal server error */
+      500: {
+        content: {
+          "text/plain": string;
+        };
+      };
+    };
+  };
+  /** Updates a team's information */
+  updateTeam: {
+    parameters: {
+      path: {
+        /** Organization ID */
+        orgId: string;
+        /** Team ID */
+        teamId: string;
+      };
+    };
+    responses: {
+      /** Updated team */
+      200: {
+        content: {
+          "application/json": {
+            /**
+             * Format: uuid
+             * @description Team ID
+             */
+            id: string;
+            /** @description Team name */
+            name: string;
+            /** @description Team description */
+            description?: string;
+            /**
+             * Format: uuid
+             * @description User ID of the owner of the team
+             */
+            owner?: string;
+            /** @description Additional metadata for the team */
+            metadata?: { [key: string]: unknown };
+            /**
+             * Format: date-time
+             * @description Timestamp when the team was created.
+             */
+            createdAt: string;
+            /**
+             * Format: date-time
+             * @description Timestamp when the team was last updated.
+             */
+            updatedAt: string;
+            /**
+             * Format: date-time
+             * @description Timestamp when the team was soft-deleted, if applicable.
+             */
+            deletedAt?: string;
+          };
+        };
+      };
+      /** Invalid request body or request param */
+      400: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Expired JWT token used or insufficient privilege */
+      401: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Result not found */
+      404: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Internal server error */
+      500: {
+        content: {
+          "text/plain": string;
+        };
+      };
+    };
+    /** Body for updating a team */
+    requestBody: {
+      content: {
+        "application/json": {
+          /** @description Updated team name */
+          name?: string;
+          /** @description Updated team description */
+          description?: string;
+        };
+      };
+    };
+  };
+  /** Deletes a team by its ID */
+  deleteTeam: {
+    parameters: {
+      path: {
+        /** Organization ID */
+        orgId: string;
+        /** Team ID */
+        teamId: string;
+      };
+    };
+    responses: {
+      /** Team deleted */
+      204: never;
+      /** Invalid request body or request param */
+      400: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Expired JWT token used or insufficient privilege */
+      401: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Result not found */
+      404: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Internal server error */
+      500: {
+        content: {
+          "text/plain": string;
+        };
+      };
+    };
+  };
+  /** Gets all users that belong to a team */
+  getTeamUsers: {
+    parameters: {
+      path: {
+        /** Team ID */
+        teamId: string;
+      };
+      query: {
+        /** Get responses that match search param value */
+        search?: string;
+        /** Get ordered responses */
+        order?: string;
+        /** Get responses by page */
+        page?: string;
+        /** Get responses by pagesize */
+        pagesize?: string;
+      };
+    };
+    responses: {
+      /** Team users mapping */
+      200: {
+        content: {
+          "application/json": {
+            /** @description Current page number of the result set. */
+            page?: number;
+            /** @description Number of items per page. */
+            page_size?: number;
+            /** @description Total number of items available. */
+            total_count?: number;
+            /** @description The user-team mappings on the current page. */
+            usersTeamsMapping?: {
+              /** Format: uuid */
+              id?: string;
+              /**
+               * Format: uuid
+               * @description Team ID
+               */
+              teamId?: string;
+              /**
+               * Format: uuid
+               * @description User ID
+               */
+              userId?: string;
+              /**
+               * Format: uuid
+               * @description Optional role assigned to this team membership. Nullable because a membership may exist without an explicit role (e.g., team-admin assignments are stamped on insert; non-owner adds may leave `role_id` null until a role is assigned). References `roles.id`.
+               */
+              roleId?: string;
+              /**
+               * Format: date-time
+               * @description Timestamp when the mapping was created.
+               */
+              createdAt?: string;
+              /**
+               * Format: date-time
+               * @description Timestamp when the mapping was last updated.
+               */
+              updatedAt?: string;
+              /**
+               * Format: date-time
+               * @description Timestamp when the mapping was soft-deleted, if applicable.
+               */
+              deletedAt?: string;
+            }[];
+          };
+        };
+      };
+      /** Invalid request body or request param */
+      400: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Expired JWT token used or insufficient privilege */
+      401: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Result not found */
+      404: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Internal server error */
+      500: {
+        content: {
+          "text/plain": string;
+        };
+      };
+    };
+  };
+  /** Assigns a user to a team */
+  addUserToTeam: {
+    parameters: {
+      path: {
+        /** Organization ID */
+        orgId: string;
+        /** Team ID */
+        teamId: string;
+        /** User ID */
+        userId: string;
+      };
+    };
+    responses: {
+      /** User added to team */
+      201: {
+        content: {
+          "application/json": {
+            /** Format: uuid */
+            id?: string;
+            /**
+             * Format: uuid
+             * @description Team ID
+             */
+            teamId?: string;
+            /**
+             * Format: uuid
+             * @description User ID
+             */
+            userId?: string;
+            /**
+             * Format: uuid
+             * @description Optional role assigned to this team membership. Nullable because a membership may exist without an explicit role (e.g., team-admin assignments are stamped on insert; non-owner adds may leave `role_id` null until a role is assigned). References `roles.id`.
+             */
+            roleId?: string;
+            /**
+             * Format: date-time
+             * @description Timestamp when the mapping was created.
+             */
+            createdAt?: string;
+            /**
+             * Format: date-time
+             * @description Timestamp when the mapping was last updated.
+             */
+            updatedAt?: string;
+            /**
+             * Format: date-time
+             * @description Timestamp when the mapping was soft-deleted, if applicable.
+             */
+            deletedAt?: string;
+          };
+        };
+      };
+      /** Invalid request body or request param */
+      400: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Expired JWT token used or insufficient privilege */
+      401: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Result not found */
+      404: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Internal server error */
+      500: {
+        content: {
+          "text/plain": string;
+        };
+      };
+    };
+  };
+  /** Unassigns a user from a team */
+  removeUserFromTeam: {
+    parameters: {
+      path: {
+        /** Organization ID */
+        orgId: string;
+        /** Team ID */
+        teamId: string;
+        /** User ID */
+        userId: string;
+      };
+    };
+    responses: {
+      /** User removed from team */
+      204: never;
+      /** Invalid request body or request param */
+      400: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Expired JWT token used or insufficient privilege */
+      401: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Result not found */
+      404: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Internal server error */
+      500: {
+        content: {
+          "text/plain": string;
+        };
+      };
+    };
+  };
+  listUsersNotInTeam: {
+    parameters: {
+      path: {
+        /** Organization ID */
+        orgId: string;
+        /** Team ID */
+        teamId: string;
+      };
+      query: {
+        /** Get responses that match search param value */
+        search?: string;
+        /** Get ordered responses */
+        order?: string;
+        /** Get responses by page */
+        page?: string;
+        /** Get responses by pagesize */
+        pagesize?: string;
+      };
+    };
+    responses: {
+      /** Users not currently in the team */
+      200: {
+        content: {
+          "application/json": {
+            /** @description Current page number of the result set. */
+            page?: number;
+            /** @description Number of items per page. */
+            page_size?: number;
+            /** @description Total number of items available. */
+            total_count?: number;
+            /** @description The data of the teammemberspage. */
+            data?: ({
+              /**
+               * Format: date-time
+               * @description Timestamp when the user joined the team. Server-computed from the earliest matching row in `users_teams_mapping` for this (team, user) pair. Server-managed; clients cannot set this.
+               */
+              joinedAt?: string;
+            } & { [key: string]: unknown })[];
+          };
+        };
+      };
+      /** Invalid request body or request param */
+      400: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Expired JWT token used or insufficient privilege */
+      401: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Result not found */
+      404: {
+        content: {
+          "text/plain": string;
+        };
+      };
+      /** Internal server error */
+      500: {
+        content: {
+          "text/plain": string;
+        };
+      };
+    };
+  };
+}
+
+export interface external {}