@unkey/api/src/models/components/v2keysremoverolesresponsebody.ts

Developer-friendly & type-safe Typescript SDK specifically catered to leverage *@unkey/api* API.

/*
 * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
 */

import * as z from "zod/v3";
import { safeParse } from "../../lib/schemas.js";
import { Result as SafeParseResult } from "../../types/fp.js";
import { SDKValidationError } from "../errors/sdkvalidationerror.js";
import { Meta, Meta$inboundSchema } from "./meta.js";
import { Role, Role$inboundSchema } from "./role.js";

export type V2KeysRemoveRolesResponseBody = {
  /**
   * Metadata object included in every API response. This provides context about the request and is essential for debugging, audit trails, and support inquiries. The `requestId` is particularly important when troubleshooting issues with the Unkey support team.
   */
  meta: Meta;
  /**
   * Complete list of all roles directly assigned to the key after the removal operation completes.
   *
   * @remarks
   *
   * The response includes:
   * - The remaining roles still assigned to the key (after removing the specified roles)
   * - Both ID and name for each role for easy reference
   *
   * Important notes:
   * - The response reflects the current state after the removal operation
   * - An empty array indicates the key now has no roles assigned
   * - This only shows direct role assignments
   * - Role permissions are not expanded in this response - use keys.getKey for full details
   * - Changes take effect immediately for new verifications but cached sessions may retain old permissions briefly
   */
  data: Array<Role>;
};

/** @internal */
export const V2KeysRemoveRolesResponseBody$inboundSchema: z.ZodType<
  V2KeysRemoveRolesResponseBody,
  z.ZodTypeDef,
  unknown
> = z.object({
  meta: Meta$inboundSchema,
  data: z.array(Role$inboundSchema),
});

export function v2KeysRemoveRolesResponseBodyFromJSON(
  jsonString: string,
): SafeParseResult<V2KeysRemoveRolesResponseBody, SDKValidationError> {
  return safeParse(
    jsonString,
    (x) => V2KeysRemoveRolesResponseBody$inboundSchema.parse(JSON.parse(x)),
    `Failed to parse 'V2KeysRemoveRolesResponseBody' from JSON`,
  );
}