@zitadel/api 0.0.0

package/src/generated/model/issueChallenge201State.ts

@@ -0,0 +1,23 @@
+/**
+ * Generated by orval v8.10.0 🍺
+ * Do not edit manually.
+ * Zitadel NextGen
+ * This is the next generation of the Zitadel identity platform.
+ * OpenAPI spec version: 0.0.1
+ */
+
+/**
+ * Current state of this challenge:
+- `pending`: awaiting proof submission
+- `failed`: proof rejected (invalid credential, wrong code, etc.)
+- `expired`: challenge TTL exceeded without verification
+
+ */
+export type IssueChallenge201State =
+  (typeof IssueChallenge201State)[keyof typeof IssueChallenge201State];
+
+export const IssueChallenge201State = {
+  pending: "pending",
+  failed: "failed",
+  expired: "expired",
+} as const;

package/src/generated/model/issueChallengeBody.ts

@@ -0,0 +1,26 @@
+/**
+ * Generated by orval v8.10.0 🍺
+ * Do not edit manually.
+ * Zitadel NextGen
+ * This is the next generation of the Zitadel identity platform.
+ * OpenAPI spec version: 0.0.1
+ */
+import type { IssueChallengeBodyMethod } from "./issueChallengeBodyMethod";
+import type { IssueChallengeBodyPasskeyOptions } from "./issueChallengeBodyPasskeyOptions";
+
+/**
+ * Request to issue a factor challenge.
+
+The `method` field selects which factor to challenge. Additional fields are
+only relevant for specific methods:
+- `passkey_options` is optional and only used when `method` is `passkey`.
+- `idp_provider` is required when `method` is `idp` and must be omitted otherwise.
+  This conditional requirement is enforced server-side.
+
+ */
+export type IssueChallengeBody = {
+  /** An authentication factor method. */
+  method: IssueChallengeBodyMethod;
+  /** Optional WebAuthn ceremony options. Only relevant when `method` is `passkey`. */
+  passkey_options?: IssueChallengeBodyPasskeyOptions;
+};

package/src/generated/model/issueChallengeBodyMethod.ts

@@ -0,0 +1,19 @@
+/**
+ * Generated by orval v8.10.0 🍺
+ * Do not edit manually.
+ * Zitadel NextGen
+ * This is the next generation of the Zitadel identity platform.
+ * OpenAPI spec version: 0.0.1
+ */
+
+/**
+ * An authentication factor method.
+ */
+export type IssueChallengeBodyMethod =
+  (typeof IssueChallengeBodyMethod)[keyof typeof IssueChallengeBodyMethod];
+
+export const IssueChallengeBodyMethod = {
+  identifier: "identifier",
+  password: "password",
+  passkey: "passkey",
+} as const;

package/src/generated/model/issueChallengeBodyPasskeyOptions.ts

@@ -0,0 +1,19 @@
+/**
+ * Generated by orval v8.10.0 🍺
+ * Do not edit manually.
+ * Zitadel NextGen
+ * This is the next generation of the Zitadel identity platform.
+ * OpenAPI spec version: 0.0.1
+ */
+import type { IssueChallengeBodyPasskeyOptionsUserVerification } from "./issueChallengeBodyPasskeyOptionsUserVerification";
+
+/**
+ * Optional WebAuthn ceremony options. Only relevant when `method` is `passkey`.
+ */
+export type IssueChallengeBodyPasskeyOptions = {
+  /** Relying Party ID for WebAuthn. Optional; if not provided, the server may use a default value. */
+  rp_id?: string;
+  /** List of allowed origins for this WebAuthn challenge. Optional; if not provided, the server may use a default value. */
+  rp_origins?: string[];
+  user_verification?: IssueChallengeBodyPasskeyOptionsUserVerification;
+};

package/src/generated/model/issueChallengeBodyPasskeyOptionsUserVerification.ts

@@ -0,0 +1,16 @@
+/**
+ * Generated by orval v8.10.0 🍺
+ * Do not edit manually.
+ * Zitadel NextGen
+ * This is the next generation of the Zitadel identity platform.
+ * OpenAPI spec version: 0.0.1
+ */
+
+export type IssueChallengeBodyPasskeyOptionsUserVerification =
+  (typeof IssueChallengeBodyPasskeyOptionsUserVerification)[keyof typeof IssueChallengeBodyPasskeyOptionsUserVerification];
+
+export const IssueChallengeBodyPasskeyOptionsUserVerification = {
+  required: "required",
+  preferred: "preferred",
+  discouraged: "discouraged",
+} as const;

package/src/generated/model/issueChallengeDefault.ts

@@ -0,0 +1,59 @@
+/**
+ * Generated by orval v8.10.0 🍺
+ * Do not edit manually.
+ * Zitadel NextGen
+ * This is the next generation of the Zitadel identity platform.
+ * OpenAPI spec version: 0.0.1
+ */
+
+export type IssueChallengeDefault =
+  | ({
+      /** Stable machine-readable error code. */
+      code: string;
+      /** Human-readable explanation of the error. */
+      message: string;
+      /** Additional error-specific context. */
+      details?: { [key: string]: unknown };
+    } & {
+      code: "att.not_found";
+    })
+  | ({
+      /** Stable machine-readable error code. */
+      code: string;
+      /** Human-readable explanation of the error. */
+      message: string;
+      /** Additional error-specific context. */
+      details?: { [key: string]: unknown };
+    } & {
+      code: "att.invalid_request";
+    })
+  | ({
+      /** Stable machine-readable error code. */
+      code: string;
+      /** Human-readable explanation of the error. */
+      message: string;
+      /** Additional error-specific context. */
+      details?: { [key: string]: unknown };
+    } & {
+      code: "att.invalid_state";
+    })
+  | ({
+      /** Stable machine-readable error code. */
+      code: string;
+      /** Human-readable explanation of the error. */
+      message: string;
+      /** Additional error-specific context. */
+      details?: { [key: string]: unknown };
+    } & {
+      code: "att.already_completed";
+    })
+  | ({
+      /** Stable machine-readable error code. */
+      code: string;
+      /** Human-readable explanation of the error. */
+      message: string;
+      /** Additional error-specific context. */
+      details?: { [key: string]: unknown };
+    } & {
+      code: "internal";
+    });

package/src/generated/model/listFlowDefinitions200.ts

@@ -0,0 +1,14 @@
+/**
+ * Generated by orval v8.10.0 🍺
+ * Do not edit manually.
+ * Zitadel NextGen
+ * This is the next generation of the Zitadel identity platform.
+ * OpenAPI spec version: 0.0.1
+ */
+import type { ListFlowDefinitions200FlowDefinitionsItem } from "./listFlowDefinitions200FlowDefinitionsItem";
+
+export type ListFlowDefinitions200 = {
+  flow_definitions: ListFlowDefinitions200FlowDefinitionsItem[];
+  /** The token to retrieve the next page of results. Absent if there are no more results. */
+  next_page_token?: string | null;
+};

package/src/generated/model/listFlowDefinitions200FlowDefinitionsItem.ts

@@ -0,0 +1,34 @@
+/**
+ * Generated by orval v8.10.0 🍺
+ * Do not edit manually.
+ * Zitadel NextGen
+ * This is the next generation of the Zitadel identity platform.
+ * OpenAPI spec version: 0.0.1
+ */
+
+/**
+ * Response object for a flow definition after creation.
+
+ */
+export type ListFlowDefinitions200FlowDefinitionsItem = {
+  /** Unique identifier for the created flow definition. */
+  id: string;
+  /**
+     * Stable identifier for this flow (echoed from the request).
+
+     * @pattern ^[a-z][a-z0-9-]*$
+     */
+  name: string;
+  /** Identifier of the project this flow definition belongs to. */
+  project_id: string;
+  /** URI of the flow definition schema this definition was authored against.
+  If the schema_uri was not provided in the request, the flow definition is validated against the latest version of the schema, and the response includes the schema_uri of the latest version.
+   */
+  schema_uri: string;
+  /** Status of the flow definition. */
+  status: string;
+  /** Timestamp when the flow definition was created. */
+  created_at: string;
+  /** Timestamp when the flow definition was last updated. */
+  updated_at: string;
+};

package/src/generated/model/listFlowDefinitions400.ts

@@ -0,0 +1,20 @@
+/**
+ * Generated by orval v8.10.0 🍺
+ * Do not edit manually.
+ * Zitadel NextGen
+ * This is the next generation of the Zitadel identity platform.
+ * OpenAPI spec version: 0.0.1
+ */
+import type { ListFlowDefinitions400Details } from "./listFlowDefinitions400Details";
+
+/**
+ * Standard error payload returned for failed API requests.
+ */
+export type ListFlowDefinitions400 = {
+  /** Stable machine-readable error code. */
+  code: string;
+  /** Human-readable explanation of the error. */
+  message: string;
+  /** Additional error-specific context. */
+  details?: ListFlowDefinitions400Details;
+};

package/src/generated/model/listFlowDefinitions400Details.ts

@@ -0,0 +1,12 @@
+/**
+ * Generated by orval v8.10.0 🍺
+ * Do not edit manually.
+ * Zitadel NextGen
+ * This is the next generation of the Zitadel identity platform.
+ * OpenAPI spec version: 0.0.1
+ */
+
+/**
+ * Additional error-specific context.
+ */
+export type ListFlowDefinitions400Details = { [key: string]: unknown };

package/src/generated/model/listFlowDefinitionsDefault.ts

@@ -0,0 +1,20 @@
+/**
+ * Generated by orval v8.10.0 🍺
+ * Do not edit manually.
+ * Zitadel NextGen
+ * This is the next generation of the Zitadel identity platform.
+ * OpenAPI spec version: 0.0.1
+ */
+import type { ListFlowDefinitionsDefaultDetails } from "./listFlowDefinitionsDefaultDetails";
+
+/**
+ * Standard error payload returned for failed API requests.
+ */
+export type ListFlowDefinitionsDefault = {
+  /** Stable machine-readable error code. */
+  code: string;
+  /** Human-readable explanation of the error. */
+  message: string;
+  /** Additional error-specific context. */
+  details?: ListFlowDefinitionsDefaultDetails;
+};

package/src/generated/model/listFlowDefinitionsDefaultDetails.ts

@@ -0,0 +1,12 @@
+/**
+ * Generated by orval v8.10.0 🍺
+ * Do not edit manually.
+ * Zitadel NextGen
+ * This is the next generation of the Zitadel identity platform.
+ * OpenAPI spec version: 0.0.1
+ */
+
+/**
+ * Additional error-specific context.
+ */
+export type ListFlowDefinitionsDefaultDetails = { [key: string]: unknown };

package/src/generated/model/listFlowDefinitionsParams.ts

@@ -0,0 +1,34 @@
+/**
+ * Generated by orval v8.10.0 🍺
+ * Do not edit manually.
+ * Zitadel NextGen
+ * This is the next generation of the Zitadel identity platform.
+ * OpenAPI spec version: 0.0.1
+ */
+import type { ListFlowDefinitionsPurpose } from "./listFlowDefinitionsPurpose";
+
+export type ListFlowDefinitionsParams = {
+  /**
+   * Maximum number of items to return.
+   * @minimum 1
+   * @maximum 100
+   */
+  limit?: number;
+  /**
+ * Token for fetching the next page of results.
+Obtain this value from `next_page_token` in the previous response.
+Omit to start from the beginning.
+Its format is opaque and may change between releases.
+
+ */
+  page_token?: string;
+  /**
+   * The unique identifier of the project
+   * @pattern ^[a-zA-Z0-9_-]+$
+   */
+  project_id: string;
+  /**
+   * Filter flow definitions by purpose (e.g., registration, login).
+   */
+  purpose?: ListFlowDefinitionsPurpose;
+};

package/src/generated/model/listFlowDefinitionsPurpose.ts

@@ -0,0 +1,19 @@
+/**
+ * Generated by orval v8.10.0 🍺
+ * Do not edit manually.
+ * Zitadel NextGen
+ * This is the next generation of the Zitadel identity platform.
+ * OpenAPI spec version: 0.0.1
+ */
+
+export type ListFlowDefinitionsPurpose =
+  (typeof ListFlowDefinitionsPurpose)[keyof typeof ListFlowDefinitionsPurpose];
+
+export const ListFlowDefinitionsPurpose = {
+  login: "login",
+  register: "register",
+  recovery: "recovery",
+  profiling: "profiling",
+  reauth: "reauth",
+  link_account: "link_account",
+} as const;

package/src/generated/model/listSessions200.ts

@@ -0,0 +1,19 @@
+/**
+ * Generated by orval v8.10.0 🍺
+ * Do not edit manually.
+ * Zitadel NextGen
+ * This is the next generation of the Zitadel identity platform.
+ * OpenAPI spec version: 0.0.1
+ */
+import type { ListSessions200SessionsItem } from "./listSessions200SessionsItem";
+
+/**
+ * Paginated list of sessions.
+ */
+export type ListSessions200 = {
+  sessions: ListSessions200SessionsItem[];
+  /** Token to pass as `page_token` in the next request to fetch the following page.
+  Absent when there are no more results.
+   */
+  next_page_token?: string | null;
+};

package/src/generated/model/listSessions200SessionsItem.ts

@@ -0,0 +1,63 @@
+/**
+ * Generated by orval v8.10.0 🍺
+ * Do not edit manually.
+ * Zitadel NextGen
+ * This is the next generation of the Zitadel identity platform.
+ * OpenAPI spec version: 0.0.1
+ */
+import type { ListSessions200SessionsItemFactorsItem } from "./listSessions200SessionsItemFactorsItem";
+import type { ListSessions200SessionsItemMetadata } from "./listSessions200SessionsItemMetadata";
+import type { ListSessions200SessionsItemState } from "./listSessions200SessionsItemState";
+import type { ListSessions200SessionsItemUserAgent } from "./listSessions200SessionsItemUserAgent";
+
+/**
+ * The current state of a session.
+
+A session is the durable post-auth primitive. It accumulates verified authentication
+factors and exposes `assurance_levels[]` — the set of assurance profiles its current
+factors satisfy. Sessions are read-only from the client's perspective: factors flow
+in through `auth_attempts`.
+
+ */
+export type ListSessions200SessionsItem = {
+  /**
+   * Unique identifier for this session.
+   * @pattern ^[a-zA-Z0-9_-]+$
+   */
+  session_id: string;
+  /** @pattern ^[a-zA-Z0-9_-]+$ */
+  project_id: string;
+  /** Current lifecycle state of the session:
+  - `building`: has a user factor but is still gathering authentication factors
+  - `active`: has at least one verified authentication factor; `assurance_levels[]` may shrink as factors age
+  - `expired`: TTL elapsed
+  - `revoked`: explicitly revoked via DELETE
+   */
+  state: ListSessions200SessionsItemState;
+  /** The authenticated user. Null for anonymous sessions and until the `user`
+  factor has been verified through an `auth_attempt`.
+   */
+  user_id?: string | null;
+  /** Verified authentication factors accumulated by this session.
+  Each key is a factor type (e.g. `password`, `totp`, `passkey`).
+  Each value is a factor event object with at least `verified_at` and
+  method-specific properties (e.g. `user_verified`, `hardware` for passkeys).
+   */
+  factors: ListSessions200SessionsItemFactorsItem[];
+  /** All assurance levels whose schemas the current session factors satisfy.
+  This list shrinks as factor freshness windows expire and grows when step-up
+  auth_attempts add or refresh factors.
+  Whether any level is "enough" is determined by the request context, not the session.
+   */
+  assurance_levels?: string[];
+  /** Arbitrary key/value metadata attached to the session. */
+  metadata?: ListSessions200SessionsItemMetadata;
+  /** User agent information captured at session creation. */
+  user_agent?: ListSessions200SessionsItemUserAgent;
+  /** When this session was created. */
+  created_at: string;
+  /** When this session expires. Short TTL (10 min) for anonymous sessions;
+  reset to the full configured session TTL once the first authentication factor is written.
+   */
+  expires_at: string;
+};

package/src/generated/model/listSessions200SessionsItemFactorsItem.ts

@@ -0,0 +1,27 @@
+/**
+ * Generated by orval v8.10.0 🍺
+ * Do not edit manually.
+ * Zitadel NextGen
+ * This is the next generation of the Zitadel identity platform.
+ * OpenAPI spec version: 0.0.1
+ */
+import type { ListSessions200SessionsItemFactorsItemMethod } from "./listSessions200SessionsItemFactorsItemMethod";
+import type { ListSessions200SessionsItemFactorsItemPayload } from "./listSessions200SessionsItemFactorsItemPayload";
+
+/**
+ * A successfully verified authentication factor with verification metadata.
+Method-specific details are included in the `payload` field.
+
+ */
+export type ListSessions200SessionsItemFactorsItem = {
+  /** An authentication factor method. */
+  method: ListSessions200SessionsItemFactorsItemMethod;
+  /** When this factor was successfully verified */
+  verified_at: string;
+  /** Method-specific factor metadata. Structure depends on the `method` field.
+  - `identifier`: includes user_id
+  - `password`: no additional data
+  - `passkey`: includes credential details and verification flags
+   */
+  payload?: ListSessions200SessionsItemFactorsItemPayload;
+};

package/src/generated/model/listSessions200SessionsItemFactorsItemMethod.ts

@@ -0,0 +1,19 @@
+/**
+ * Generated by orval v8.10.0 🍺
+ * Do not edit manually.
+ * Zitadel NextGen
+ * This is the next generation of the Zitadel identity platform.
+ * OpenAPI spec version: 0.0.1
+ */
+
+/**
+ * An authentication factor method.
+ */
+export type ListSessions200SessionsItemFactorsItemMethod =
+  (typeof ListSessions200SessionsItemFactorsItemMethod)[keyof typeof ListSessions200SessionsItemFactorsItemMethod];
+
+export const ListSessions200SessionsItemFactorsItemMethod = {
+  identifier: "identifier",
+  password: "password",
+  passkey: "passkey",
+} as const;

package/src/generated/model/listSessions200SessionsItemFactorsItemPayload.ts

@@ -0,0 +1,33 @@
+/**
+ * Generated by orval v8.10.0 🍺
+ * Do not edit manually.
+ * Zitadel NextGen
+ * This is the next generation of the Zitadel identity platform.
+ * OpenAPI spec version: 0.0.1
+ */
+
+/**
+ * Method-specific factor metadata. Structure depends on the `method` field.
+- `identifier`: includes user_id
+- `password`: no additional data
+- `passkey`: includes credential details and verification flags
+
+ */
+export type ListSessions200SessionsItemFactorsItemPayload =
+  | {
+      /** @pattern ^user_[a-zA-Z0-9_-]+$ */
+      user_id: string;
+    }
+  | { [key: string]: unknown }
+  | {
+      /** The credential ID that was used */
+      credential_id: string;
+      /** Whether user verification was performed (PIN/biometric) */
+      user_verified: boolean;
+      /** Whether the credential is backup eligible (can be synced) */
+      backup_eligible?: boolean;
+      /** Whether the credential is currently backed up */
+      backup_state?: boolean;
+      /** Authenticator attachment modality */
+      authenticator_attachment?: "platform" | "cross-platform";
+    };

package/src/generated/model/listSessions200SessionsItemMetadata.ts

@@ -0,0 +1,12 @@
+/**
+ * Generated by orval v8.10.0 🍺
+ * Do not edit manually.
+ * Zitadel NextGen
+ * This is the next generation of the Zitadel identity platform.
+ * OpenAPI spec version: 0.0.1
+ */
+
+/**
+ * Arbitrary key/value metadata attached to the session.
+ */
+export type ListSessions200SessionsItemMetadata = { [key: string]: unknown } | null;

package/src/generated/model/listSessions200SessionsItemState.ts

@@ -0,0 +1,25 @@
+/**
+ * Generated by orval v8.10.0 🍺
+ * Do not edit manually.
+ * Zitadel NextGen
+ * This is the next generation of the Zitadel identity platform.
+ * OpenAPI spec version: 0.0.1
+ */
+
+/**
+ * Current lifecycle state of the session:
+- `building`: has a user factor but is still gathering authentication factors
+- `active`: has at least one verified authentication factor; `assurance_levels[]` may shrink as factors age
+- `expired`: TTL elapsed
+- `revoked`: explicitly revoked via DELETE
+
+ */
+export type ListSessions200SessionsItemState =
+  (typeof ListSessions200SessionsItemState)[keyof typeof ListSessions200SessionsItemState];
+
+export const ListSessions200SessionsItemState = {
+  building: "building",
+  active: "active",
+  expired: "expired",
+  revoked: "revoked",
+} as const;

package/src/generated/model/listSessions200SessionsItemUserAgent.ts

@@ -0,0 +1,18 @@
+/**
+ * Generated by orval v8.10.0 🍺
+ * Do not edit manually.
+ * Zitadel NextGen
+ * This is the next generation of the Zitadel identity platform.
+ * OpenAPI spec version: 0.0.1
+ */
+
+/**
+ * User agent information captured at session creation.
+ */
+export type ListSessions200SessionsItemUserAgent = {
+  /** Client-supplied device fingerprint. */
+  fingerprint?: string;
+  /** IP address of the client at session creation. */
+  ip?: string;
+  [key: string]: unknown;
+} | null;

package/src/generated/model/listSessions400.ts

@@ -0,0 +1,20 @@
+/**
+ * Generated by orval v8.10.0 🍺
+ * Do not edit manually.
+ * Zitadel NextGen
+ * This is the next generation of the Zitadel identity platform.
+ * OpenAPI spec version: 0.0.1
+ */
+import type { ListSessions400Details } from "./listSessions400Details";
+
+/**
+ * Standard error payload returned for failed API requests.
+ */
+export type ListSessions400 = {
+  /** Stable machine-readable error code. */
+  code: string;
+  /** Human-readable explanation of the error. */
+  message: string;
+  /** Additional error-specific context. */
+  details?: ListSessions400Details;
+};

package/src/generated/model/listSessions400Details.ts

@@ -0,0 +1,12 @@
+/**
+ * Generated by orval v8.10.0 🍺
+ * Do not edit manually.
+ * Zitadel NextGen
+ * This is the next generation of the Zitadel identity platform.
+ * OpenAPI spec version: 0.0.1
+ */
+
+/**
+ * Additional error-specific context.
+ */
+export type ListSessions400Details = { [key: string]: unknown };

package/src/generated/model/listSessions401.ts

@@ -0,0 +1,20 @@
+/**
+ * Generated by orval v8.10.0 🍺
+ * Do not edit manually.
+ * Zitadel NextGen
+ * This is the next generation of the Zitadel identity platform.
+ * OpenAPI spec version: 0.0.1
+ */
+import type { ListSessions401Details } from "./listSessions401Details";
+
+/**
+ * Standard error payload returned for failed API requests.
+ */
+export type ListSessions401 = {
+  /** Stable machine-readable error code. */
+  code: string;
+  /** Human-readable explanation of the error. */
+  message: string;
+  /** Additional error-specific context. */
+  details?: ListSessions401Details;
+};

package/src/generated/model/listSessions401Details.ts

@@ -0,0 +1,12 @@
+/**
+ * Generated by orval v8.10.0 🍺
+ * Do not edit manually.
+ * Zitadel NextGen
+ * This is the next generation of the Zitadel identity platform.
+ * OpenAPI spec version: 0.0.1
+ */
+
+/**
+ * Additional error-specific context.
+ */
+export type ListSessions401Details = { [key: string]: unknown };

package/src/generated/model/listSessions403.ts

@@ -0,0 +1,20 @@
+/**
+ * Generated by orval v8.10.0 🍺
+ * Do not edit manually.
+ * Zitadel NextGen
+ * This is the next generation of the Zitadel identity platform.
+ * OpenAPI spec version: 0.0.1
+ */
+import type { ListSessions403Details } from "./listSessions403Details";
+
+/**
+ * Standard error payload returned for failed API requests.
+ */
+export type ListSessions403 = {
+  /** Stable machine-readable error code. */
+  code: string;
+  /** Human-readable explanation of the error. */
+  message: string;
+  /** Additional error-specific context. */
+  details?: ListSessions403Details;
+};