openai 6.35.0 → 6.36.0

package/resources/admin/organization/users/roles.d.ts

@@ -0,0 +1,156 @@
+import { APIResource } from "../../../../core/resource.js";
+import * as RolesAPI from "../roles.js";
+import * as UsersAPI from "./users.js";
+import { APIPromise } from "../../../../core/api-promise.js";
+import { NextCursorPage, type NextCursorPageParams, PagePromise } from "../../../../core/pagination.js";
+import { RequestOptions } from "../../../../internal/request-options.js";
+export declare class Roles extends APIResource {
+    /**
+     * Assigns an organization role to a user within the organization.
+     *
+     * @example
+     * ```ts
+     * const role =
+     *   await client.admin.organization.users.roles.create(
+     *     'user_id',
+     *     { role_id: 'role_id' },
+     *   );
+     * ```
+     */
+    create(userID: string, body: RoleCreateParams, options?: RequestOptions): APIPromise<RoleCreateResponse>;
+    /**
+     * Lists the organization roles assigned to a user within the organization.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const roleListResponse of client.admin.organization.users.roles.list(
+     *   'user_id',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(userID: string, query?: RoleListParams | null | undefined, options?: RequestOptions): PagePromise<RoleListResponsesPage, RoleListResponse>;
+    /**
+     * Unassigns an organization role from a user within the organization.
+     *
+     * @example
+     * ```ts
+     * const role =
+     *   await client.admin.organization.users.roles.delete(
+     *     'role_id',
+     *     { user_id: 'user_id' },
+     *   );
+     * ```
+     */
+    delete(roleID: string, params: RoleDeleteParams, options?: RequestOptions): APIPromise<RoleDeleteResponse>;
+}
+export type RoleListResponsesPage = NextCursorPage<RoleListResponse>;
+/**
+ * Role assignment linking a user to a role.
+ */
+export interface RoleCreateResponse {
+    /**
+     * Always `user.role`.
+     */
+    object: 'user.role';
+    /**
+     * Details about a role that can be assigned through the public Roles API.
+     */
+    role: RolesAPI.Role;
+    /**
+     * Represents an individual `user` within an organization.
+     */
+    user: UsersAPI.OrganizationUser;
+}
+/**
+ * Detailed information about a role assignment entry returned when listing
+ * assignments.
+ */
+export interface RoleListResponse {
+    /**
+     * Identifier for the role.
+     */
+    id: string;
+    /**
+     * When the role was created.
+     */
+    created_at: number | null;
+    /**
+     * Identifier of the actor who created the role.
+     */
+    created_by: string | null;
+    /**
+     * User details for the actor that created the role, when available.
+     */
+    created_by_user_obj: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * Description of the role.
+     */
+    description: string | null;
+    /**
+     * Arbitrary metadata stored on the role.
+     */
+    metadata: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * Name of the role.
+     */
+    name: string;
+    /**
+     * Permissions associated with the role.
+     */
+    permissions: Array<string>;
+    /**
+     * Whether the role is predefined by OpenAI.
+     */
+    predefined_role: boolean;
+    /**
+     * Resource type the role applies to.
+     */
+    resource_type: string;
+    /**
+     * When the role was last updated.
+     */
+    updated_at: number | null;
+}
+/**
+ * Confirmation payload returned after unassigning a role.
+ */
+export interface RoleDeleteResponse {
+    /**
+     * Whether the assignment was removed.
+     */
+    deleted: boolean;
+    /**
+     * Identifier for the deleted assignment, such as `group.role.deleted` or
+     * `user.role.deleted`.
+     */
+    object: string;
+}
+export interface RoleCreateParams {
+    /**
+     * Identifier of the role to assign.
+     */
+    role_id: string;
+}
+export interface RoleListParams extends NextCursorPageParams {
+    /**
+     * Sort order for the returned organization roles.
+     */
+    order?: 'asc' | 'desc';
+}
+export interface RoleDeleteParams {
+    /**
+     * The ID of the user to modify.
+     */
+    user_id: string;
+}
+export declare namespace Roles {
+    export { type RoleCreateResponse as RoleCreateResponse, type RoleListResponse as RoleListResponse, type RoleDeleteResponse as RoleDeleteResponse, type RoleListResponsesPage as RoleListResponsesPage, type RoleCreateParams as RoleCreateParams, type RoleListParams as RoleListParams, type RoleDeleteParams as RoleDeleteParams, };
+}
+//# sourceMappingURL=roles.d.ts.map

package/resources/admin/organization/users/roles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.d.ts","sourceRoot":"","sources":["../../../../src/resources/admin/organization/users/roles.ts"],"names":[],"mappings":"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"}

package/resources/admin/organization/users/roles.js

@@ -0,0 +1,65 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Roles = void 0;
+const resource_1 = require("../../../../core/resource.js");
+const pagination_1 = require("../../../../core/pagination.js");
+const path_1 = require("../../../../internal/utils/path.js");
+class Roles extends resource_1.APIResource {
+    /**
+     * Assigns an organization role to a user within the organization.
+     *
+     * @example
+     * ```ts
+     * const role =
+     *   await client.admin.organization.users.roles.create(
+     *     'user_id',
+     *     { role_id: 'role_id' },
+     *   );
+     * ```
+     */
+    create(userID, body, options) {
+        return this._client.post((0, path_1.path) `/organization/users/${userID}/roles`, {
+            body,
+            ...options,
+            __security: { adminAPIKeyAuth: true },
+        });
+    }
+    /**
+     * Lists the organization roles assigned to a user within the organization.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const roleListResponse of client.admin.organization.users.roles.list(
+     *   'user_id',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(userID, query = {}, options) {
+        return this._client.getAPIList((0, path_1.path) `/organization/users/${userID}/roles`, (pagination_1.NextCursorPage), { query, ...options, __security: { adminAPIKeyAuth: true } });
+    }
+    /**
+     * Unassigns an organization role from a user within the organization.
+     *
+     * @example
+     * ```ts
+     * const role =
+     *   await client.admin.organization.users.roles.delete(
+     *     'role_id',
+     *     { user_id: 'user_id' },
+     *   );
+     * ```
+     */
+    delete(roleID, params, options) {
+        const { user_id } = params;
+        return this._client.delete((0, path_1.path) `/organization/users/${user_id}/roles/${roleID}`, {
+            ...options,
+            __security: { adminAPIKeyAuth: true },
+        });
+    }
+}
+exports.Roles = Roles;
+//# sourceMappingURL=roles.js.map

package/resources/admin/organization/users/roles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.js","sourceRoot":"","sources":["../../../../src/resources/admin/organization/users/roles.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,2DAAwD;AAIxD,+DAAqG;AAErG,6DAAuD;AAEvD,MAAa,KAAM,SAAQ,sBAAW;IACpC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,MAAc,EAAE,IAAsB,EAAE,OAAwB;QACrE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,uBAAuB,MAAM,QAAQ,EAAE;YAClE,IAAI;YACJ,GAAG,OAAO;YACV,UAAU,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;SACtC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,IAAI,CACF,MAAc,EACd,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAC5B,IAAA,WAAI,EAAA,uBAAuB,MAAM,QAAQ,EACzC,CAAA,2BAAgC,CAAA,EAChC,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,EAAE,CAC7D,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,MAAc,EAAE,MAAwB,EAAE,OAAwB;QACvE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,uBAAuB,OAAO,UAAU,MAAM,EAAE,EAAE;YAC/E,GAAG,OAAO;YACV,UAAU,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;SACtC,CAAC,CAAC;IACL,CAAC;CACF;AAjED,sBAiEC"}

package/resources/admin/organization/users/roles.mjs

@@ -0,0 +1,61 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../../../core/resource.mjs";
+import { NextCursorPage } from "../../../../core/pagination.mjs";
+import { path } from "../../../../internal/utils/path.mjs";
+export class Roles extends APIResource {
+    /**
+     * Assigns an organization role to a user within the organization.
+     *
+     * @example
+     * ```ts
+     * const role =
+     *   await client.admin.organization.users.roles.create(
+     *     'user_id',
+     *     { role_id: 'role_id' },
+     *   );
+     * ```
+     */
+    create(userID, body, options) {
+        return this._client.post(path `/organization/users/${userID}/roles`, {
+            body,
+            ...options,
+            __security: { adminAPIKeyAuth: true },
+        });
+    }
+    /**
+     * Lists the organization roles assigned to a user within the organization.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const roleListResponse of client.admin.organization.users.roles.list(
+     *   'user_id',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(userID, query = {}, options) {
+        return this._client.getAPIList(path `/organization/users/${userID}/roles`, (NextCursorPage), { query, ...options, __security: { adminAPIKeyAuth: true } });
+    }
+    /**
+     * Unassigns an organization role from a user within the organization.
+     *
+     * @example
+     * ```ts
+     * const role =
+     *   await client.admin.organization.users.roles.delete(
+     *     'role_id',
+     *     { user_id: 'user_id' },
+     *   );
+     * ```
+     */
+    delete(roleID, params, options) {
+        const { user_id } = params;
+        return this._client.delete(path `/organization/users/${user_id}/roles/${roleID}`, {
+            ...options,
+            __security: { adminAPIKeyAuth: true },
+        });
+    }
+}
+//# sourceMappingURL=roles.mjs.map

package/resources/admin/organization/users/roles.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.mjs","sourceRoot":"","sources":["../../../../src/resources/admin/organization/users/roles.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAIf,EAAE,cAAc,EAA0C;OAE1D,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,KAAM,SAAQ,WAAW;IACpC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,MAAc,EAAE,IAAsB,EAAE,OAAwB;QACrE,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,uBAAuB,MAAM,QAAQ,EAAE;YAClE,IAAI;YACJ,GAAG,OAAO;YACV,UAAU,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;SACtC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,IAAI,CACF,MAAc,EACd,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAC5B,IAAI,CAAA,uBAAuB,MAAM,QAAQ,EACzC,CAAA,cAAgC,CAAA,EAChC,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,EAAE,CAC7D,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,MAAc,EAAE,MAAwB,EAAE,OAAwB;QACvE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,uBAAuB,OAAO,UAAU,MAAM,EAAE,EAAE;YAC/E,GAAG,OAAO;YACV,UAAU,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE;SACtC,CAAC,CAAC;IACL,CAAC;CACF"}

package/resources/admin/organization/users/users.d.mts

@@ -0,0 +1,185 @@
+import { APIResource } from "../../../../core/resource.mjs";
+import * as RolesAPI from "./roles.mjs";
+import { RoleCreateParams, RoleCreateResponse, RoleDeleteParams, RoleDeleteResponse, RoleListParams, RoleListResponse, RoleListResponsesPage, Roles } from "./roles.mjs";
+import { APIPromise } from "../../../../core/api-promise.mjs";
+import { ConversationCursorPage, type ConversationCursorPageParams, PagePromise } from "../../../../core/pagination.mjs";
+import { RequestOptions } from "../../../../internal/request-options.mjs";
+export declare class Users extends APIResource {
+    roles: RolesAPI.Roles;
+    /**
+     * Retrieves a user by their identifier.
+     *
+     * @example
+     * ```ts
+     * const organizationUser =
+     *   await client.admin.organization.users.retrieve('user_id');
+     * ```
+     */
+    retrieve(userID: string, options?: RequestOptions): APIPromise<OrganizationUser>;
+    /**
+     * Modifies a user's role in the organization.
+     *
+     * @example
+     * ```ts
+     * const organizationUser =
+     *   await client.admin.organization.users.update('user_id');
+     * ```
+     */
+    update(userID: string, body: UserUpdateParams, options?: RequestOptions): APIPromise<OrganizationUser>;
+    /**
+     * Lists all of the users in the organization.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const organizationUser of client.admin.organization.users.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query?: UserListParams | null | undefined, options?: RequestOptions): PagePromise<OrganizationUsersPage, OrganizationUser>;
+    /**
+     * Deletes a user from the organization.
+     *
+     * @example
+     * ```ts
+     * const user = await client.admin.organization.users.delete(
+     *   'user_id',
+     * );
+     * ```
+     */
+    delete(userID: string, options?: RequestOptions): APIPromise<UserDeleteResponse>;
+}
+export type OrganizationUsersPage = ConversationCursorPage<OrganizationUser>;
+/**
+ * Represents an individual `user` within an organization.
+ */
+export interface OrganizationUser {
+    /**
+     * The identifier, which can be referenced in API endpoints
+     */
+    id: string;
+    /**
+     * The Unix timestamp (in seconds) of when the user was added.
+     */
+    added_at: number;
+    /**
+     * The object type, which is always `organization.user`
+     */
+    object: 'organization.user';
+    /**
+     * The Unix timestamp (in seconds) of the user's last API key usage.
+     */
+    api_key_last_used_at?: number | null;
+    /**
+     * The Unix timestamp (in seconds) of when the user was created.
+     */
+    created?: number;
+    /**
+     * The developer persona metadata for the user.
+     */
+    developer_persona?: string | null;
+    /**
+     * The email address of the user
+     */
+    email?: string | null;
+    /**
+     * Whether this is the organization's default user.
+     */
+    is_default?: boolean;
+    /**
+     * Whether the user is an authorized purchaser for Scale Tier.
+     */
+    is_scale_tier_authorized_purchaser?: boolean | null;
+    /**
+     * Whether the user is managed through SCIM.
+     */
+    is_scim_managed?: boolean;
+    /**
+     * Whether the user is a service account.
+     */
+    is_service_account?: boolean;
+    /**
+     * The name of the user
+     */
+    name?: string | null;
+    /**
+     * Projects associated with the user, if included.
+     */
+    projects?: OrganizationUser.Projects | null;
+    /**
+     * `owner` or `reader`
+     */
+    role?: string | null;
+    /**
+     * The technical level metadata for the user.
+     */
+    technical_level?: string | null;
+    /**
+     * Nested user details.
+     */
+    user?: OrganizationUser.User;
+}
+export declare namespace OrganizationUser {
+    /**
+     * Projects associated with the user, if included.
+     */
+    interface Projects {
+        data: Array<Projects.Data>;
+        object: 'list';
+    }
+    namespace Projects {
+        interface Data {
+            id?: string | null;
+            name?: string | null;
+            role?: string | null;
+        }
+    }
+    /**
+     * Nested user details.
+     */
+    interface User {
+        id: string;
+        object: 'user';
+        banned?: boolean | null;
+        banned_at?: number | null;
+        email?: string | null;
+        enabled?: boolean | null;
+        name?: string | null;
+        picture?: string | null;
+    }
+}
+export interface UserDeleteResponse {
+    id: string;
+    deleted: boolean;
+    object: 'organization.user.deleted';
+}
+export interface UserUpdateParams {
+    /**
+     * Developer persona metadata.
+     */
+    developer_persona?: string | null;
+    /**
+     * `owner` or `reader`
+     */
+    role?: string | null;
+    /**
+     * Role ID to assign to the user.
+     */
+    role_id?: string | null;
+    /**
+     * Technical level metadata.
+     */
+    technical_level?: string | null;
+}
+export interface UserListParams extends ConversationCursorPageParams {
+    /**
+     * Filter by the email address of users.
+     */
+    emails?: Array<string>;
+}
+export declare namespace Users {
+    export { type OrganizationUser as OrganizationUser, type UserDeleteResponse as UserDeleteResponse, type OrganizationUsersPage as OrganizationUsersPage, type UserUpdateParams as UserUpdateParams, type UserListParams as UserListParams, };
+    export { Roles as Roles, type RoleCreateResponse as RoleCreateResponse, type RoleListResponse as RoleListResponse, type RoleDeleteResponse as RoleDeleteResponse, type RoleListResponsesPage as RoleListResponsesPage, type RoleCreateParams as RoleCreateParams, type RoleListParams as RoleListParams, type RoleDeleteParams as RoleDeleteParams, };
+}
+//# sourceMappingURL=users.d.mts.map

package/resources/admin/organization/users/users.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.d.mts","sourceRoot":"","sources":["../../../../src/resources/admin/organization/users/users.ts"],"names":[],"mappings":"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"}

package/resources/admin/organization/users/users.d.ts

@@ -0,0 +1,185 @@
+import { APIResource } from "../../../../core/resource.js";
+import * as RolesAPI from "./roles.js";
+import { RoleCreateParams, RoleCreateResponse, RoleDeleteParams, RoleDeleteResponse, RoleListParams, RoleListResponse, RoleListResponsesPage, Roles } from "./roles.js";
+import { APIPromise } from "../../../../core/api-promise.js";
+import { ConversationCursorPage, type ConversationCursorPageParams, PagePromise } from "../../../../core/pagination.js";
+import { RequestOptions } from "../../../../internal/request-options.js";
+export declare class Users extends APIResource {
+    roles: RolesAPI.Roles;
+    /**
+     * Retrieves a user by their identifier.
+     *
+     * @example
+     * ```ts
+     * const organizationUser =
+     *   await client.admin.organization.users.retrieve('user_id');
+     * ```
+     */
+    retrieve(userID: string, options?: RequestOptions): APIPromise<OrganizationUser>;
+    /**
+     * Modifies a user's role in the organization.
+     *
+     * @example
+     * ```ts
+     * const organizationUser =
+     *   await client.admin.organization.users.update('user_id');
+     * ```
+     */
+    update(userID: string, body: UserUpdateParams, options?: RequestOptions): APIPromise<OrganizationUser>;
+    /**
+     * Lists all of the users in the organization.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const organizationUser of client.admin.organization.users.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query?: UserListParams | null | undefined, options?: RequestOptions): PagePromise<OrganizationUsersPage, OrganizationUser>;
+    /**
+     * Deletes a user from the organization.
+     *
+     * @example
+     * ```ts
+     * const user = await client.admin.organization.users.delete(
+     *   'user_id',
+     * );
+     * ```
+     */
+    delete(userID: string, options?: RequestOptions): APIPromise<UserDeleteResponse>;
+}
+export type OrganizationUsersPage = ConversationCursorPage<OrganizationUser>;
+/**
+ * Represents an individual `user` within an organization.
+ */
+export interface OrganizationUser {
+    /**
+     * The identifier, which can be referenced in API endpoints
+     */
+    id: string;
+    /**
+     * The Unix timestamp (in seconds) of when the user was added.
+     */
+    added_at: number;
+    /**
+     * The object type, which is always `organization.user`
+     */
+    object: 'organization.user';
+    /**
+     * The Unix timestamp (in seconds) of the user's last API key usage.
+     */
+    api_key_last_used_at?: number | null;
+    /**
+     * The Unix timestamp (in seconds) of when the user was created.
+     */
+    created?: number;
+    /**
+     * The developer persona metadata for the user.
+     */
+    developer_persona?: string | null;
+    /**
+     * The email address of the user
+     */
+    email?: string | null;
+    /**
+     * Whether this is the organization's default user.
+     */
+    is_default?: boolean;
+    /**
+     * Whether the user is an authorized purchaser for Scale Tier.
+     */
+    is_scale_tier_authorized_purchaser?: boolean | null;
+    /**
+     * Whether the user is managed through SCIM.
+     */
+    is_scim_managed?: boolean;
+    /**
+     * Whether the user is a service account.
+     */
+    is_service_account?: boolean;
+    /**
+     * The name of the user
+     */
+    name?: string | null;
+    /**
+     * Projects associated with the user, if included.
+     */
+    projects?: OrganizationUser.Projects | null;
+    /**
+     * `owner` or `reader`
+     */
+    role?: string | null;
+    /**
+     * The technical level metadata for the user.
+     */
+    technical_level?: string | null;
+    /**
+     * Nested user details.
+     */
+    user?: OrganizationUser.User;
+}
+export declare namespace OrganizationUser {
+    /**
+     * Projects associated with the user, if included.
+     */
+    interface Projects {
+        data: Array<Projects.Data>;
+        object: 'list';
+    }
+    namespace Projects {
+        interface Data {
+            id?: string | null;
+            name?: string | null;
+            role?: string | null;
+        }
+    }
+    /**
+     * Nested user details.
+     */
+    interface User {
+        id: string;
+        object: 'user';
+        banned?: boolean | null;
+        banned_at?: number | null;
+        email?: string | null;
+        enabled?: boolean | null;
+        name?: string | null;
+        picture?: string | null;
+    }
+}
+export interface UserDeleteResponse {
+    id: string;
+    deleted: boolean;
+    object: 'organization.user.deleted';
+}
+export interface UserUpdateParams {
+    /**
+     * Developer persona metadata.
+     */
+    developer_persona?: string | null;
+    /**
+     * `owner` or `reader`
+     */
+    role?: string | null;
+    /**
+     * Role ID to assign to the user.
+     */
+    role_id?: string | null;
+    /**
+     * Technical level metadata.
+     */
+    technical_level?: string | null;
+}
+export interface UserListParams extends ConversationCursorPageParams {
+    /**
+     * Filter by the email address of users.
+     */
+    emails?: Array<string>;
+}
+export declare namespace Users {
+    export { type OrganizationUser as OrganizationUser, type UserDeleteResponse as UserDeleteResponse, type OrganizationUsersPage as OrganizationUsersPage, type UserUpdateParams as UserUpdateParams, type UserListParams as UserListParams, };
+    export { Roles as Roles, type RoleCreateResponse as RoleCreateResponse, type RoleListResponse as RoleListResponse, type RoleDeleteResponse as RoleDeleteResponse, type RoleListResponsesPage as RoleListResponsesPage, type RoleCreateParams as RoleCreateParams, type RoleListParams as RoleListParams, type RoleDeleteParams as RoleDeleteParams, };
+}
+//# sourceMappingURL=users.d.ts.map

package/resources/admin/organization/users/users.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../../../src/resources/admin/organization/users/users.ts"],"names":[],"mappings":"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"}