import { APIResource } from "../core/resource.js";
import * as Shared from "./shared.js";
import { WorkspacesCursorPagination } from "./shared.js";
import { APIPromise } from "../core/api-promise.js";
import { type CursorPaginationParams, PagePromise } from "../core/pagination.js";
import { RequestOptions } from "../internal/request-options.js";
/**
 * WorkspaceService manages workspaces at the ACCOUNT level.
 *  This service is responsible for creating and listing workspaces within an account.
 *  Workspaces provide organizational grouping for resources within an account.
 *
 *  Authentication: Bearer token (JWT)
 *  Scope: Account-level operations (manages workspaces themselves, not resources within workspaces)
 */
export declare class Workspaces extends APIResource {
    /**
     * Creates a new workspace for the account
     */
    create(body: WorkspaceCreateParams, options?: RequestOptions): APIPromise<Shared.Workspace>;
    /**
     * Lists all workspaces for the current account
     */
    list(query?: WorkspaceListParams | null | undefined, options?: RequestOptions): PagePromise<WorkspacesCursorPagination, Shared.Workspace>;
    /**
     * Retrieves the workspace associated with the current API token. Useful for
     * workspace-scoped tokens to identify which workspace they belong to.
     */
    get(options?: RequestOptions): APIPromise<Shared.Workspace>;
}
export interface WorkspaceSpec {
    description?: string;
}
export interface WorkspaceCreateParams {
    /**
     * CreateResourceMetadata contains the user-provided fields for creating a
     * workspace-scoped resource. Read-only fields (id, account_id, workspace_id,
     * profile_id, created_at) are excluded since they are set by the server.
     */
    metadata: Shared.CreateResourceMetadata;
    spec: WorkspaceSpec;
}
export interface WorkspaceListParams extends CursorPaginationParams {
    /**
     * When set to true you may use more of your alloted API rate-limit
     */
    includeInfo?: boolean;
    /**
     * Sort order for results (asc or desc by creation time)
     */
    sortOrder?: string;
}
export declare namespace Workspaces {
    export { type WorkspaceSpec as WorkspaceSpec, type WorkspaceCreateParams as WorkspaceCreateParams, type WorkspaceListParams as WorkspaceListParams, };
}
export { type WorkspacesCursorPagination };
//# sourceMappingURL=workspaces.d.ts.map