v2-schema.graphql

directive @oneOf on INPUT_OBJECT

schema @link(url: "https://specs.apollo.dev/federation/v2.7", import: ["@external", "@key", "@shareable"]) {
  query: Query
  mutation: Mutation
  subscription: Subscription
}

"""Added in UNRELEASED. Input for accepting a role invitation."""
input AcceptRoleInvitationInput {
  invitationId: UUID!
}

"""Added in 25.16.0. An access token for model deployment."""
type AccessToken implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """The access token."""
  token: String!

  """The creation timestamp of the access token."""
  createdAt: DateTime!

  """The expiration timestamp of the access token."""
  expiresAt: DateTime
}

"""Added in 25.16.0. Connection for access tokens."""
type AccessTokenConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [AccessTokenEdge!]!
  count: Int!
}

"""An edge in a connection."""
type AccessTokenEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: AccessToken!
}

"""Added in 25.16.0. """
input AccessTokenFilter {
  token: StringFilter = null
  expiresAt: DateTimeFilter = null
  createdAt: DateTimeFilter = null
  AND: [AccessTokenFilter!] = null
  OR: [AccessTokenFilter!] = null
  NOT: [AccessTokenFilter!] = null
}

"""Added in 25.16.0. """
input AccessTokenOrderBy {
  field: AccessTokenOrderField!
  direction: OrderDirection! = DESC
}

enum AccessTokenOrderField {
  CREATED_AT
}

"""
Added in 25.19.0. Input for activating a revision to be the current revision.
"""
input ActivateRevisionInput {
  deploymentId: ID!
  revisionId: ID!
}

"""Added in 25.19.0. Result of activating a revision."""
type ActivateRevisionPayload {
  """The deployment with the activated revision"""
  deployment: ModelDeployment!

  """ID of the previously active revision"""
  previousRevisionId: ID

  """ID of the newly activated revision"""
  activatedRevisionId: ID!

  """The deployment policy applied during activation"""
  deploymentPolicy: DeploymentPolicy!
}

"""
Added in 26.4.0. Active resource usage overview for a domain or project. Shows the currently occupied resource slots and the number of active sessions.
"""
type ActiveResourceOverview {
  """Resource slots currently occupied"""
  slots: ResourceSlot!

  """Number of active sessions"""
  sessionCount: Int!
}

"""
Added in 25.19.0. This enum represents the activeness status of a replica, indicating whether the deployment is currently active and able to serve requests.
"""
enum ActivenessStatus {
  ACTIVE
  INACTIVE
}

"""Added in 25.19.0. """
input AddRevisionInput {
  """
  Added in 26.4.2. DeploymentRevisionPreset ID. When specified, preset values are used as defaults and can be overridden by explicitly provided fields.
  """
  revisionPresetId: UUID = null
  deploymentId: ID!

  """Cluster configuration"""
  clusterConfig: ClusterConfigInput = null

  """Resource configuration"""
  resourceConfig: ResourceConfigInput = null

  """Container image"""
  image: ImageInput = null

  """Runtime configuration"""
  modelRuntimeConfig: ModelRuntimeConfigInput = null

  """Model mount configuration"""
  modelMountConfig: ModelMountConfigInput!

  """
  Added in 26.4.2. Model definition to override the default values generated by the server
  """
  modelDefinition: ModelDefinitionInput = null

  """Extra vfolder mounts"""
  extraMounts: [ExtraVFolderMountInput!] = null

  """
  Added in UNRELEASED. Additional options for the add revision operation.
  """
  options: AddRevisionOptions = null
}

"""Added in 26.4.2. Options for the add_model_revision mutation."""
input AddRevisionOptions {
  """
  When true, automatically activate the newly added revision immediately after creation.
  """
  autoActivate: Boolean! = false
}

"""Added in 25.19.0. Payload for adding a revision."""
type AddRevisionPayload {
  """Added revision"""
  revision: ModelRevision!
}

"""Added in 26.4.2. Admin input for creating a keypair for a user."""
input AdminCreateKeypairInput {
  """UUID of the target user."""
  userId: UUID!

  """Name of the resource policy to assign."""
  resourcePolicy: String!

  """Whether the keypair should be active."""
  isActive: Boolean! = true

  """Whether the keypair has admin privileges."""
  isAdmin: Boolean! = false

  """API rate limit (requests per minute)."""
  rateLimit: Int! = 30000
}

"""
Added in 26.4.2. Payload returned after admin creates a keypair. The secret_key is only shown once.
"""
type AdminCreateKeypairPayload {
  """The newly created keypair."""
  keypair: KeyPairGQL!

  """The secret key. Only returned at creation time."""
  secretKey: String!
}

"""Added in 26.4.2. Payload returned after admin deletes a keypair."""
type AdminDeleteKeypairPayload {
  """The access key of the deleted keypair."""
  accessKey: String!
}

"""
Added in 26.4.2. Payload returned after admin clears a user's SSH keypair.
"""
type AdminDeleteSSHKeypairPayload {
  """Access key whose SSH keypair was cleared."""
  accessKey: String!
}

"""
Added in 26.4.2. Input for admin querying effective assignable resources for a specific user.
"""
input AdminEffectiveResourceAllocationV2Input {
  """Target user ID."""
  userId: UUID!

  """Project ID to check allocation for."""
  projectId: UUID!

  """Resource group name to check allocation for."""
  resourceGroupName: String!
}

"""Added in 26.4.2. Payload returned by admin SSH keypair lookup."""
type AdminGetSSHKeypairPayload {
  """SSH keypair public information."""
  keypair: SSHKeypairNode!
}

"""
Added in 26.4.3. Payload for admin bulk revision refresh mutation result.
"""
type AdminRefreshDeploymentRevisionsPayload {
  """Per-deployment refresh outcomes (partial success by design)"""
  results: [RevisionRefreshResult!]!
}

"""
Added in 26.4.2. Admin input for registering (overwriting) a user's SSH keypair.
"""
input AdminRegisterSSHKeypairInput {
  """Access key whose SSH keypair will be replaced."""
  accessKey: String!

  """PEM-encoded SSH public key."""
  sshPublicKey: String!

  """PEM-encoded SSH private key."""
  sshPrivateKey: String!
}

"""
Added in 26.4.2. Payload returned after admin registers a user's SSH keypair.
"""
type AdminRegisterSSHKeypairPayload {
  """Access key whose SSH keypair was updated."""
  accessKey: String!
}

"""Added in 26.4.2. Admin input for updating a keypair."""
input AdminUpdateKeypairInput {
  """Access key of the keypair to update."""
  accessKey: String!

  """New active state."""
  isActive: Boolean = null

  """New admin privilege state."""
  isAdmin: Boolean = null

  """New resource policy name."""
  resourcePolicy: String = null

  """New API rate limit."""
  rateLimit: Int = null
}

"""Added in 26.4.2. Payload returned after admin updates a keypair."""
type AdminUpdateKeypairPayload {
  """The updated keypair."""
  keypair: KeyPairGQL!
}

"""Added in 26.1.0. Filter options for querying agents"""
input AgentFilter {
  id: StringFilter = null
  status: AgentStatusFilter = null
  schedulable: Boolean = null
  scalingGroup: StringFilter = null
  AND: [AgentFilter!] = null
  OR: [AgentFilter!] = null
  NOT: [AgentFilter!] = null
}

"""Added in 26.1.0. Network-related information for an agent."""
type AgentNetworkInfo {
  """Logical region where the agent is deployed."""
  region: String!

  """
  Network address and port where the agent can be reached (format: "host:port"). Used by the manager to communicate with the agent.
  """
  addr: String!
}

"""Added in 26.1.0. Options for ordering agents"""
input AgentOrderBy {
  field: AgentOrderField!
  direction: OrderDirection! = ASC
}

"""Added in 26.1.0. Order by specification for agents"""
enum AgentOrderField {
  ID
  STATUS
  FIRST_CONTACT
  SCALING_GROUP
  SCHEDULABLE
}

"""Added in 26.1.0. Permissions related to agent operations"""
enum AgentPermission {
  READ_ATTRIBUTE
  UPDATE_ATTRIBUTE
  CREATE_COMPUTE_SESSION
  CREATE_SERVICE
}

"""
Added in 25.15.0. Hardware resource capacity, usage, and availability of an agent.
"""
type AgentResource {
  """
  Total hardware resource capacity available on the agent. Expressed as a JSON object containing resource slots.
  """
  capacity: JSON!

  """
  Total amount of resources currently consumed by running and scheduled sessions.
  """
  used: JSON!

  """
  Available resources for scheduling new compute sessions (capacity - used).
  """
  free: JSON!
}

"""Added in 26.3.0. Relay-style connection for per-slot agent resources."""
type AgentResourceConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [AgentResourceSlotEdge!]!
  count: Int!
}

"""
Added in 26.3.0. Per-slot resource capacity and usage entry for an agent.
Represents one row from the agent_resources table.
"""
type AgentResourceSlot implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """Resource slot identifier (e.g., 'cpu', 'mem', 'cuda.device')."""
  slotName: String!

  """Total hardware resource capacity for this slot on the agent."""
  capacity: Decimal!

  """
  Amount of this slot currently consumed by running and scheduled sessions.
  """
  used: Decimal!
}

"""An edge in a connection."""
type AgentResourceSlotEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: AgentResourceSlot!
}

"""Added in 26.3.0. Filter criteria for querying agent resource slots."""
input AgentResourceSlotFilter {
  slotName: StringFilter = null
  agentId: StringFilter = null
  AND: [AgentResourceSlotFilter!] = null
  OR: [AgentResourceSlotFilter!] = null
  NOT: [AgentResourceSlotFilter!] = null
}

"""Added in 26.3.0. Ordering specification for agent resource slots."""
input AgentResourceSlotOrderBy {
  field: AgentResourceSlotOrderField!
  direction: OrderDirection! = ASC
}

"""Added in 26.3.0. Fields available for ordering agent resource slots."""
enum AgentResourceSlotOrderField {
  SLOT_NAME
  CAPACITY
  USED
}

"""Added in 25.15.0. Aggregated resource statistics for an agent."""
type AgentStats {
  """
  Total hardware resource capacity, usage, and availability across all agents.
  """
  totalResource: AgentResource!
}

enum AgentStatusEnum {
  ALIVE
  LOST
  RESTARTING
  TERMINATED
}

"""
Added in 24.09.0. Filter options for agent status within AgentFilter.
It includes options to filter whether agent status is in a specific list or equals a specific value.
"""
input AgentStatusFilter {
  """The in  field."""
  in: [AgentStatusEnum!] = null
  equals: AgentStatusEnum = null
}

"""Added in 26.1.0. Status and lifecycle information for an agent."""
type AgentStatusInfo {
  """
  Current operational status of the agent. One of: ALIVE, LOST, TERMINATED, RESTARTING.
  """
  status: AgentStatusEnum!

  """Timestamp when the agent last changed its status."""
  statusChanged: DateTime

  """Timestamp when the agent first registered with the manager."""
  firstContact: DateTime

  """
  Timestamp when the agent was marked as lost or unreachable. Null if the agent has never been lost or is currently alive.
  """
  lostAt: DateTime

  """
  Indicates whether the agent is available for scheduling new compute sessions.
  """
  schedulable: Boolean!
}

"""Added in 26.1.0. System and configuration information for an agent."""
type AgentSystemInfo {
  """
  Hardware architecture of the agent's host system (e.g., "x86_64", "aarch64"). Used to match compute sessions with compatible container images.
  """
  architecture: String!

  """
  Version string of the Backend.AI agent software running on this node. Follows semantic versioning (e.g., "26.1.0").
  """
  version: String!

  """Legacy configuration flag, no longer actively used in the system."""
  autoTerminateAbusingKernel: Boolean!

  """
  List of compute plugin metadata supported by this agent. Typed as Any because this field holds a nested GQL type (ComputePluginsGQL).
  """
  computePlugins: ComputePlugins!
}

"""Added in 26.1.0. Strawberry-based Agent type replacing AgentNode."""
type AgentV2 implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """
  Hardware resource capacity, usage, and availability information. Contains capacity (total), used (occupied by sessions), and free (available) resource slots including CPU cores, memory, accelerators (GPUs, TPUs), and other compute resources.
  """
  resourceInfo: AgentResource!

  """
  Current operational status and lifecycle timestamps. Includes the agent's status (ALIVE, LOST, etc.), status change history, initial registration time, and schedulability state.
  """
  statusInfo: AgentStatusInfo!

  """
  System configuration and software version information. Contains the host architecture, agent software version, and available compute plugins for accelerators and specialized hardware.
  """
  systemInfo: AgentSystemInfo!

  """
  Network location and connectivity information. Provides the agent's region and network address for manager-to-agent communication.
  """
  networkInfo: AgentNetworkInfo!

  """
  List of permissions the current authenticated user has on this agent. Determines which operations (read attributes, create sessions, etc.) the user can perform on this specific agent based on RBAC policies.
  """
  permissions: [AgentPermission!]!

  """
  Name of the scaling group this agent belongs to. Scaling groups are logical collections of agents used for resource scheduling, quota management, and workload isolation across different user groups or projects.
  """
  scalingGroup: String!

  """Added in 26.1.0. Load the container count for this agent."""
  containerCount: Int

  """
  Added in 26.2.0. List of kernels running on this agent with pagination support.
  """
  kernels(filter: KernelV2Filter = null, orderBy: [KernelV2OrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): KernelV2Connection

  """
  Added in 26.3.0. List of sessions running on this agent with pagination support.
  """
  sessions(filter: SessionV2Filter = null, orderBy: [SessionV2OrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): SessionV2Connection

  """Added in 26.3.0. Per-slot resource capacity and usage for this agent."""
  resourceSlots(filter: AgentResourceSlotFilter = null, orderBy: [AgentResourceSlotOrderBy!] = null, first: Int = null, after: String = null, last: Int = null, before: String = null, limit: Int = null, offset: Int = null): AgentResourceConnection
}

"""
Added in 26.1.0. Relay-style connection type for paginated lists of agents.
"""
type AgentV2Connection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [AgentV2Edge!]!
  count: Int!
}

"""An edge in a connection."""
type AgentV2Edge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: AgentV2!
}

"""
Added in 26.4.2. An allocated resource slot entry on a deployment revision or preset.
"""
type AllocatedResourceSlot {
  """Resource slot identifier (e.g., 'cpu', 'mem', 'cuda.device')."""
  slotName: String!

  """Allocated quantity for this resource slot."""
  quantity: Decimal!
}

"""Added in 26.4.2. Filter for allocated resource slots."""
input AllocatedResourceSlotFilter {
  """Filter by slot name."""
  slotName: StringFilter = null

  """Logical AND of multiple filter conditions."""
  AND: [AllocatedResourceSlotFilter!] = null

  """Logical OR of multiple filter conditions."""
  OR: [AllocatedResourceSlotFilter!] = null

  """Logical NOT of filter conditions."""
  NOT: [AllocatedResourceSlotFilter!] = null
}

"""Added in 26.4.2. Order by specification for allocated resource slots."""
input AllocatedResourceSlotOrderBy {
  """Field to order by."""
  field: AllocatedResourceSlotOrderField!

  """Order direction."""
  direction: OrderDirection! = ASC
}

"""
Added in 26.4.2. Fields available for ordering allocated resource slots.
"""
enum AllocatedResourceSlotOrderField {
  SLOT_NAME
  QUANTITY
  RANK
}

"""Added in 26.4.2. Payload containing allowed domain names."""
type AllowedDomainsPayload {
  """Allowed domain names."""
  items: [String!]!
}

"""Added in 26.4.2. Payload containing allowed project IDs."""
type AllowedProjectsPayload {
  """Allowed project IDs."""
  items: [UUID!]!
}

"""Added in 26.4.2. Payload containing allowed resource group names."""
type AllowedResourceGroupsPayload {
  """Allowed resource group names."""
  items: [String!]!
}

"""Added in 25.16.0. App configuration data."""
type AppConfig {
  """Additional configuration data."""
  extraConfig: JSON!
}

"""
Added in 24.09.0. Input for approving an artifact revision.

Admin-only operation to approve artifact revisions for general use.
"""
input ApproveArtifactInput {
  artifactRevisionId: ID!
}

"""
Added in 25.14.0. Response payload for artifact revision approval operations. Contains the approved artifact revision. Admin-only operation.
"""
type ApproveArtifactPayload {
  """Approved artifact revision."""
  artifactRevision: ArtifactRevision!
}

"""
Added in 25.14.0. An artifact represents AI models, packages, images, or other resources that can be stored, managed, and used within Backend.AI. Artifacts are discovered through scanning external registries and can have multiple revisions. Each artifact contains metadata and references to its source registry. Key concepts: Type (MODEL, PACKAGE, or IMAGE), Availability (ALIVE or DELETED), Source (original external registry where it was discovered).
"""
type Artifact implements Node {
  """The Globally Unique ID of this object"""
  id: ID!
  name: String!
  type: ArtifactType!
  description: String
  registry: SourceInfo!
  source: SourceInfo!
  readonly: Boolean!
  extra: JSON
  scannedAt: DateTime!
  updatedAt: DateTime!
  availability: ArtifactAvailability!

  """The revisions of this entity."""
  revisions(filter: ArtifactRevisionFilter = null, orderBy: [ArtifactRevisionOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): ArtifactRevisionConnection
}

enum ArtifactAvailability {
  ALIVE
  DELETED
}

"""
Added in 25.14.0. Paginated connection for artifacts with total count information. Used for relay-style pagination with cursor-based navigation.
"""
type ArtifactConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [ArtifactEdge!]!
  count: Int!
}

"""An edge in a connection."""
type ArtifactEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: Artifact!
}

"""
Added in 25.14.0. Filter options for artifacts based on various criteria such as type, name, registry,
source, and availability status.

Supports logical operations (AND, OR, NOT) for complex filtering scenarios.
"""
input ArtifactFilter {
  type: [ArtifactType!] = null
  name: StringFilter = null
  registry: StringFilter = null
  source: StringFilter = null
  availability: [ArtifactAvailability!] = null
  AND: [ArtifactFilter!] = null
  OR: [ArtifactFilter!] = null
  NOT: [ArtifactFilter!] = null
}

"""
Added in 25.14.0. Payload for artifact import progress subscription events. Provides real-time updates during the artifact import process, including progress percentage and current status.
"""
type ArtifactImportProgressUpdatedPayload {
  """Artifact revision ID."""
  artifactId: ID!

  """Import progress as a percentage."""
  progress: Float!

  """Current import status."""
  status: ArtifactStatus!
}

"""
Added in 24.09.0. Specifies the field and direction for ordering artifacts in queries.
"""
input ArtifactOrderBy {
  field: ArtifactOrderField!
  direction: OrderDirection! = ASC
}

enum ArtifactOrderField {
  NAME
  TYPE
  SIZE
  SCANNED_AT
  UPDATED_AT
}

"""Added in 25.14.0. Artifact registry node."""
type ArtifactRegistry {
  """Internal identifier of the artifact registry metadata record."""
  id: ID!

  """Identifier of the actual registry implementation."""
  registryId: ID!

  """Name of the artifact registry."""
  name: String!

  """Type of the artifact registry."""
  type: ArtifactRegistryType!
}

"""
Added in 25.15.0. Represents common metadata for an artifact registry. All artifact registry nodes expose that information regardless of type.
"""
type ArtifactRegistryMeta implements Node {
  """The Globally Unique ID of this object"""
  id: ID!
  name: String!
  registryId: ID!
  type: ArtifactRegistryType!
  url: String!
}

"""
Added in 25.15.0. Relay-style connection for paginated artifact registry meta queries.
"""
type ArtifactRegistryMetaConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [ArtifactRegistryMetaEdge!]!
  count: Int!
}

"""An edge in a connection."""
type ArtifactRegistryMetaEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: ArtifactRegistryMeta!
}

enum ArtifactRegistryType {
  HUGGINGFACE
  RESERVOIR
}

enum ArtifactRemoteStatus {
  SCANNED
  AVAILABLE
  FAILED
}

"""
Added in 25.14.0. A specific version/revision of an artifact containing the actual file data. Artifact revisions progress through different statuses: SCANNED (discovered in external registry, metadata only), PULLING (currently downloading from external source), PULLED (downloaded to temporary storage), AVAILABLE (ready for use by users). Contains version information, file size, README content, and timestamps. Most HuggingFace models only have a 'main' revision.
"""
type ArtifactRevision implements Node {
  """The Globally Unique ID of this object"""
  id: ID!
  status: ArtifactStatus!

  """
  Added in 25.15.0. Remote synchronization status of the artifact revision.
  """
  remoteStatus: ArtifactRemoteStatus
  version: String!
  readme: String
  size: ByteSize
  createdAt: DateTime
  updatedAt: DateTime

  """
  Added in 25.17.0. Digest at the time of import. None for models that have not been imported.
  """
  digest: String

  """
  Added in 25.17.0. Verification result containing malware scan results from all verifiers. None if not yet verified.
  """
  verificationResult: ArtifactVerificationResult

  """The artifact of this entity."""
  artifact: Artifact
}

"""
Added in 25.14.0. Paginated connection for artifact revisions with total count information. Used for relay-style pagination with cursor-based navigation.
"""
type ArtifactRevisionConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [ArtifactRevisionEdge!]!
  count: Int!
}

"""An edge in a connection."""
type ArtifactRevisionEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: ArtifactRevision!
}

"""
Added in 25.14.0. Filter options for artifact revisions based on status, version, artifact ID, and file size.

Supports logical operations (AND, OR, NOT) for complex filtering scenarios.
"""
input ArtifactRevisionFilter {
  status: ArtifactRevisionStatusFilter = null

  """Added in 25.16.0. Filter by remote synchronization status."""
  remoteStatus: ArtifactRevisionRemoteStatusFilter = null
  version: StringFilter = null

  """The artifact id field."""
  artifactId: UUIDFilter = null
  size: IntFilter = null
  AND: [ArtifactRevisionFilter!] = null
  OR: [ArtifactRevisionFilter!] = null
  NOT: [ArtifactRevisionFilter!] = null
}

"""
Added in 25.14.0. Represents a background task for importing an artifact revision. Contains the task ID for monitoring progress and the associated artifact revision being imported from external registries.
"""
type ArtifactRevisionImportTask {
  """Background task ID."""
  taskId: ID

  """Artifact revision data."""
  artifactRevision: ArtifactRevision!
}

"""
Added in 24.09.0. Specifies the field and direction for ordering artifact revisions in queries.
"""
input ArtifactRevisionOrderBy {
  field: ArtifactRevisionOrderField!
  direction: OrderDirection! = ASC
}

enum ArtifactRevisionOrderField {
  VERSION
  SIZE
  CREATED_AT
  UPDATED_AT
  STATUS
}

"""Added in 25.16.0. """
input ArtifactRevisionRemoteStatusFilter {
  """The in  field."""
  in: [ArtifactRemoteStatus!] = null
  equals: ArtifactRemoteStatus = null
}

"""
Added in 24.09.0. Filter for artifact revision status. Supports exact match or inclusion in a list of statuses.
"""
input ArtifactRevisionStatusFilter {
  """The in  field."""
  in: [ArtifactStatus!] = null
  equals: ArtifactStatus = null
}

enum ArtifactStatus {
  SCANNED
  PULLING
  PULLED
  VERIFYING
  NEEDS_APPROVAL
  AVAILABLE
  FAILED
  REJECTED
}

"""
Added in 24.09.0. Input for subscribing to artifact status change notifications.

Used with artifact_status_changed subscription to receive real-time updates
when artifact revision statuses change.
"""
input ArtifactStatusChangedInput {
  artifactRevisionIds: [ID!]!
}

"""
Added in 25.14.0. Payload for artifact status change subscription events. Provides real-time notifications when artifact revision statuses change during import, cleanup, or other operations.
"""
type ArtifactStatusChangedPayload {
  """Updated artifact revision."""
  artifactRevision: ArtifactRevision!
}

enum ArtifactType {
  MODEL
  PACKAGE
  IMAGE
}

"""
Added in 25.17.0. Complete verification result containing results from all configured verifiers. Artifacts undergo malware scanning through multiple verifiers after being imported. This type aggregates results from all verifiers that were run on the artifact.
"""
type ArtifactVerificationResult {
  """Results from each verifier that scanned the artifact."""
  verifiers: [ArtifactVerifierResultEntry!]!
}

"""
Added in 26.1.0. A collection of metadata from an artifact verifier. Contains key-value pairs providing additional information about the verification.
"""
type ArtifactVerifierMetadata {
  """List of metadata entries."""
  entries: [ArtifactVerifierMetadataEntry!]!
}

"""
Added in 26.1.0. A single key-value entry representing metadata from an artifact verifier. Contains additional information about the verification process.
"""
type ArtifactVerifierMetadataEntry {
  """The key identifier for this metadata entry."""
  key: String!

  """The value for this metadata entry."""
  value: String!
}

"""
Added in 25.17.0. Result from a single malware verifier containing scan results and metadata. Each verifier scans the artifact for potential security issues and reports findings including infected file count, scan time, and any errors encountered.
"""
type ArtifactVerifierResult {
  """Whether the verification completed successfully."""
  success: Boolean!

  """Number of infected or suspicious files detected."""
  infectedCount: Int!

  """Timestamp when verification started."""
  scannedAt: DateTime!

  """Time taken to complete verification in seconds."""
  scanTime: Float!

  """Total number of files scanned."""
  scannedCount: Int!

  """Additional metadata from the verifier."""
  metadata: ArtifactVerifierMetadata!

  """Fatal error message if the verifier failed to complete."""
  error: String
}

"""
Added in 25.17.0. Entry for a single verifier's result in the verification results. Associates a verifier name with its scan results.
"""
type ArtifactVerifierResultEntry {
  """Name of the verifier."""
  name: String!

  """Scan result from this verifier."""
  result: ArtifactVerifierResult!
}

"""Added in 26.3.0. Input for assigning a role to a user"""
input AssignRoleInput {
  userId: UUID!
  roleId: UUID!
  projectId: UUID
}

"""Added in 24.09.0. Filter criteria for querying audit logs."""
input AuditLogFilter {
  entityType: StringFilter = null
  entityId: StringFilter = null
  operation: StringFilter = null
  status: AuditLogStatusFilter = null
  createdAt: DateTimeFilter = null
  triggeredBy: StringFilter = null
  AND: [AuditLogFilter!] = null
  OR: [AuditLogFilter!] = null
  NOT: [AuditLogFilter!] = null
}

"""Added in 24.09.0. Ordering specification for audit logs."""
input AuditLogOrderBy {
  field: AuditLogOrderField!
  direction: OrderDirection! = DESC
}

"""Added in 26.3.0. Fields available for ordering audit logs."""
enum AuditLogOrderField {
  CREATED_AT
  ENTITY_TYPE
  OPERATION
  STATUS
}

"""
Added in UNRELEASED. Scope for the scoped audit log query. All items are OR'd; raises an error if every field is empty.
"""
input AuditLogScope {
  """Entity-tagged scope items."""
  entity: [EntityTypeScope!] = null

  """Actor UUIDs (matches audit_logs.triggered_by)."""
  triggeredUser: [UUIDScope!] = null
}

"""Added in 26.3.0. Status of an audit log entry."""
enum AuditLogStatus {
  SUCCESS
  ERROR
  UNKNOWN
  RUNNING
}

"""Added in 24.09.0. Filter for audit log status field."""
input AuditLogStatusFilter {
  equals: AuditLogStatus = null

  """The in  field."""
  in: [AuditLogStatus!] = null

  """Excludes exact status match."""
  notEquals: AuditLogStatus = null
  notIn: [AuditLogStatus!] = null
}

"""
Added in 26.3.0. Represents an audit log entry tracking system operations.
"""
type AuditLogV2 implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """UUID of the action that generated this log."""
  actionId: UUID!

  """Type of entity this log relates to."""
  entityType: String!

  """Operation performed (create, update, delete, etc.)."""
  operation: String!

  """ID of the affected entity, if applicable."""
  entityId: String

  """Timestamp when the audit log was created."""
  createdAt: DateTime!

  """Request ID that triggered this operation."""
  requestId: String

  """UUID string of the user who triggered the action."""
  triggeredBy: String

  """Human-readable description of the operation."""
  description: String!

  """Duration of the operation as a string representation."""
  duration: String

  """Status of the operation."""
  status: AuditLogStatus!

  """
  The user who triggered this audit log entry, resolved from triggered_by UUID.
  """
  user: UserV2
}

"""Added in 26.3.0. Connection type for paginated audit log results."""
type AuditLogV2Connection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [AuditLogV2Edge!]!

  """Total number of audit log entries matching the query."""
  count: Int!
}

"""An edge in a connection."""
type AuditLogV2Edge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: AuditLogV2!
}

"""Added in 25.1.0. Metric source for auto-scaling rules"""
enum AutoScalingMetricSource {
  KERNEL
  INFERENCE_FRAMEWORK
  PROMETHEUS
}

"""Added in 25.19.0. An auto-scaling rule for a model deployment."""
type AutoScalingRule implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """The source of the scaling metric (e.g. KERNEL, INFERENCE_FRAMEWORK)."""
  metricSource: AutoScalingMetricSource!

  """The metric name field."""
  metricName: String!

  """The minimum threshold for scaling (e.g. 0.5)."""
  minThreshold: Decimal

  """The maximum threshold for scaling (e.g. 21.0)."""
  maxThreshold: Decimal

  """The step size for scaling (e.g. 1)."""
  stepSize: Int!

  """The time window in seconds for scaling (e.g. 60)."""
  timeWindow: Int!

  """The minimum number of replicas (e.g. 1)."""
  minReplicas: Int

  """The maximum number of replicas (e.g. 10)."""
  maxReplicas: Int

  """
  Added in 26.4.2. The Prometheus query preset ID for PROMETHEUS metric source.
  """
  prometheusQueryPresetId: ID
  createdAt: DateTime!
  lastTriggeredAt: DateTime

  """
  Added in 26.4.3. The Prometheus query preset used for metric-based auto-scaling.
  """
  queryPreset: QueryDefinition
}

"""Added in 25.19.0. Connection for auto-scaling rules."""
type AutoScalingRuleConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [AutoScalingRuleEdge!]!
  count: Int!
}

"""An edge in a connection."""
type AutoScalingRuleEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: AutoScalingRule!
}

"""Added in 25.19.0. """
input AutoScalingRuleFilter {
  createdAt: DateTimeFilter = null
  lastTriggeredAt: NullableDateTimeFilter = null
  AND: [AutoScalingRuleFilter!] = null
  OR: [AutoScalingRuleFilter!] = null
  NOT: [AutoScalingRuleFilter!] = null
}

"""Added in 25.19.0. """
input AutoScalingRuleOrderBy {
  field: AutoScalingRuleOrderField!
  direction: OrderDirection! = DESC
}

enum AutoScalingRuleOrderField {
  CREATED_AT
}

"""Added in 24.3.0. Background task event payload."""
type BackgroundTaskEventPayload {
  """UUID of the background task."""
  taskId: ID!

  """Type of the background task event."""
  eventType: BgtaskEventType!

  """Human-readable message for this event."""
  message: String!

  """Current progress value. Only populated for UPDATED events."""
  currentProgress: Float

  """Total progress value. Only populated for UPDATED events."""
  totalProgress: Float
}

"""Added in 24.3.0. Type of background task event"""
enum BgtaskEventType {
  UPDATED
  DONE
  CANCELLED
  FAILED
}

"""
Added in 26.4.2. Binary size with both raw bytes and human-readable format.
"""
type BinarySizeInfo {
  """Size in bytes."""
  value: Int!

  """Size in human-readable format (e.g., '1g', '512m')."""
  display: String!
}

"""
Added in 26.4.2. Binary size input accepting bytes integer or human-readable string.
"""
input BinarySizeInput {
  """
  Size as bytes integer or human-readable format (e.g., '536870912', '512m', '1g').
  """
  expr: String!
}

"""Added in 25.19.0. Configuration for blue-green deployment strategy."""
input BlueGreenConfigInput {
  autoPromote: Boolean! = false
  promoteDelaySeconds: Int! = 0
}

"""
Added in UNRELEASED. Failure detail for a single permission entry in bulk add
"""
type BulkAddRolePermissionFailureInfo {
  """Role ID of the failed entry"""
  roleId: UUID!

  """Scope element type of the failed entry"""
  scopeType: String!

  """Scope element ID of the failed entry"""
  scopeId: String!

  """Entity element type of the failed entry"""
  entityType: String!

  """Operation type of the failed entry"""
  operation: String!

  """Error message describing the failure"""
  message: String!
}

"""
Added in UNRELEASED. Input for bulk-inserting scoped permissions across one or more roles
"""
input BulkAddRolePermissionsInput {
  permissions: [CreatePermissionInput!]!
}

"""Added in UNRELEASED. Payload for bulk role-permission insertion"""
type BulkAddRolePermissionsPayload {
  """Successfully inserted permission rows"""
  items: [Permission!]!

  """Permission entries that failed to insert"""
  failed: [BulkAddRolePermissionFailureInfo!]!
}

"""
Added in 26.3.0. Error information for a failed user in bulk role assignment.
"""
type BulkAssignRoleError {
  """UUID of the user that failed"""
  userId: UUID!

  """Error message describing the failure"""
  message: String!
}

"""Added in 26.3.0. Input for bulk assigning a role to multiple users"""
input BulkAssignRoleInput {
  roleId: UUID!
  userIds: [UUID!]!
  projectId: UUID
}

"""Added in 26.3.0. Payload for bulk role assignment mutation."""
type BulkAssignRolePayload {
  """Successfully created role assignments"""
  assigned: [RoleAssignment!]!

  """Users that failed to be assigned"""
  failed: [BulkAssignRoleError!]!
}

"""Added in 26.2.0. Error information for a failed user in bulk creation."""
type BulkCreateUserV2Error {
  """Original position in the input list."""
  index: Int!

  """Username of the user that failed."""
  username: String!

  """Email of the user that failed."""
  email: String!

  """Error message describing the failure."""
  message: String!
}

"""
Added in 26.2.0. Input for bulk creating multiple users. Each user has individual specifications.
"""
input BulkCreateUserV2Input {
  """List of user creation inputs."""
  users: [CreateUserV2Input!]!
}

"""Added in 26.2.0. Payload for bulk user creation mutation."""
type BulkCreateUsersV2Payload {
  """List of successfully created users."""
  createdUsers: [UserV2!]!

  """List of errors for users that failed to create."""
  failed: [BulkCreateUserV2Error!]!
}

"""
Added in UNRELEASED. Error information for a model card that failed during bulk deletion.
"""
type BulkDeleteModelCardV2Error {
  """UUID of the model card that failed to delete."""
  cardId: UUID!

  """Error message describing the failure."""
  message: String!
}

"""Added in UNRELEASED. Input for bulk-deleting multiple model cards."""
input BulkDeleteModelCardsV2Input {
  """List of model card UUIDs to delete."""
  ids: [UUID!]!

  """Options for the delete operation."""
  options: DeleteModelCardV2Options = null
}

"""Added in UNRELEASED. Payload for bulk model card deletion."""
type BulkDeleteModelCardsV2Payload {
  """UUIDs of model cards that were successfully deleted."""
  successes: [UUID!]!

  """List of errors for model cards that failed to delete."""
  failed: [BulkDeleteModelCardV2Error!]!
}

"""Added in 26.4.2. Input for soft-deleting multiple virtual folders."""
input BulkDeleteVFoldersV2Input {
  """List of VFolder UUIDs to soft-delete."""
  ids: [UUID!]!
}

"""Added in 26.4.2. Payload for bulk virtual folder soft-deletion."""
type BulkDeleteVFoldersV2Payload {
  """Number of virtual folders successfully soft-deleted."""
  deletedCount: Int!
}

"""Added in 26.3.0. Error information for a failed user in bulk purge."""
type BulkPurgeUserV2Error {
  """UUID of the user that failed to purge."""
  userId: UUID!

  """Error message describing the failure."""
  message: String!
}

"""
Added in 26.3.0. Input for permanently deleting multiple users. This action is irreversible.
"""
input BulkPurgeUsersV2Input {
  """List of user UUIDs to purge."""
  userIds: [UUID!]!

  """Options for the purge operation."""
  options: BulkPurgeUsersV2Options = null
}

"""Added in 26.3.0. Options for bulk user purge operation."""
input BulkPurgeUsersV2Options {
  """
  If true, migrate shared virtual folders to the admin user before purging.
  """
  purgeSharedVfolders: Boolean! = false

  """If true, delegate endpoint ownership to the admin user before purging."""
  delegateEndpointOwnership: Boolean! = false
}

"""Added in 26.3.0. Payload for bulk user permanent deletion mutation."""
type BulkPurgeUsersV2Payload {
  """Number of users successfully purged."""
  purgedCount: Int!

  """List of errors for users that failed to purge."""
  failed: [BulkPurgeUserV2Error!]!
}

"""
Added in UNRELEASED. Failure detail for a single vfolder in a bulk purge.
"""
type BulkPurgeVFolderV2Error {
  """UUID of the vfolder that failed to purge."""
  vfolderId: UUID!

  """Error message describing the failure."""
  message: String!
}

"""
Added in 26.4.2. Input for permanently purging multiple virtual folders.
"""
input BulkPurgeVFoldersV2Input {
  """List of VFolder UUIDs to purge."""
  ids: [UUID!]!

  """
  Added in UNRELEASED. Optional behavior flags applied to every vfolder in the batch. Defaults to all-false when omitted.
  """
  options: PurgeVFolderOptionsInput
}

"""Added in 26.4.2. Payload for bulk virtual folder purge."""
type BulkPurgeVFoldersV2Payload {
  """Number of virtual folders successfully purged."""
  purgedCount: Int!

  """List of errors for vfolders that failed to purge."""
  failed: [BulkPurgeVFolderV2Error!]!
}

"""
Added in UNRELEASED. Failure detail for a single permission ID in bulk remove
"""
type BulkRemoveRolePermissionFailureInfo {
  """Permission row ID that failed to delete"""
  permissionId: UUID!

  """Error message describing the failure"""
  message: String!
}

"""
Added in UNRELEASED. Input for bulk-deleting permission rows by primary key
"""
input BulkRemoveRolePermissionsInput {
  permissionIds: [UUID!]!
}

"""Added in UNRELEASED. Payload for bulk role-permission deletion"""
type BulkRemoveRolePermissionsPayload {
  """Successfully deleted permission rows"""
  items: [Permission!]!

  """Permission IDs that failed to delete"""
  failed: [BulkRemoveRolePermissionFailureInfo!]!
}

"""
Added in 26.3.0. Error information for a failed user in bulk role revocation.
"""
type BulkRevokeRoleError {
  """UUID of the user that failed"""
  userId: UUID!

  """Error message describing the failure"""
  message: String!
}

"""Added in 26.3.0. Input for bulk revoking a role from multiple users"""
input BulkRevokeRoleInput {
  roleId: UUID!
  userIds: [UUID!]!
}

"""Added in 26.3.0. Payload for bulk role revocation mutation."""
type BulkRevokeRolePayload {
  """Successfully revoked role assignments"""
  revoked: [RoleAssignment!]!

  """Users that failed to be revoked"""
  failed: [BulkRevokeRoleError!]!
}

"""Added in 26.3.0. Error information for a failed user in bulk update."""
type BulkUpdateUserV2Error {
  """UUID of the user that failed to update."""
  userId: UUID!

  """Error message describing the failure."""
  message: String!
}

"""
Added in 26.3.0. Input for bulk updating multiple users. Each user has individual update specifications.
"""
input BulkUpdateUserV2Input {
  """List of user update inputs."""
  users: [BulkUpdateUserV2ItemInput!]!
}

"""
Added in 26.3.0. Input for a single user update within a bulk operation. Pairs a user ID with the fields to update.
"""
input BulkUpdateUserV2ItemInput {
  """UUID of the user to update."""
  userId: UUID!

  """Fields to update for this user."""
  input: UpdateUserV2Input!
}

"""Added in 26.3.0. Payload for bulk user update mutation."""
type BulkUpdateUsersV2Payload {
  """List of successfully updated users."""
  updatedUsers: [UserV2!]!

  """List of errors for users that failed to update."""
  failed: [BulkUpdateUserV2Error!]!
}

"""
Added in 26.1.0. Input for bulk upserting domain fair share weights. Allows updating multiple domains in a single transaction.
"""
input BulkUpsertDomainFairShareWeightInput {
  """Name of the scaling group (resource group) for all fair shares."""
  resourceGroupName: String!

  """List of domain weight updates to apply."""
  inputs: [DomainWeightInputItem!]!
}

"""
Added in 26.1.0. Payload for bulk domain fair share weight upsert mutation.
"""
type BulkUpsertDomainFairShareWeightPayload {
  """Number of records upserted"""
  upsertedCount: Int!
}

"""
Added in 26.1.0. Input for bulk upserting project fair share weights. Allows updating multiple projects in a single transaction.
"""
input BulkUpsertProjectFairShareWeightInput {
  """Name of the scaling group (resource group) for all fair shares."""
  resourceGroupName: String!

  """List of project weight updates to apply."""
  inputs: [ProjectWeightInputItem!]!
}

"""
Added in 26.1.0. Payload for bulk project fair share weight upsert mutation.
"""
type BulkUpsertProjectFairShareWeightPayload {
  """Number of records upserted"""
  upsertedCount: Int!
}

"""
Added in 26.1.0. Input for bulk upserting user fair share weights. Allows updating multiple users in a single transaction.
"""
input BulkUpsertUserFairShareWeightInput {
  """Name of the scaling group (resource group) for all fair shares."""
  resourceGroupName: String!

  """List of user weight updates to apply."""
  inputs: [UserWeightInputItem!]!
}

"""
Added in 26.1.0. Payload for bulk user fair share weight upsert mutation.
"""
type BulkUpsertUserFairShareWeightPayload {
  """Number of records upserted"""
  upsertedCount: Int!
}

scalar ByteSize

"""
Added in 24.09.0. Input for canceling an in-progress artifact import operation.

Stops the download process and reverts the artifact revision status back to SCANNED.
"""
input CancelArtifactInput {
  artifactRevisionId: ID!
}

"""
Added in 25.14.0. Response payload for canceling artifact import operations. Contains the artifact revision whose import was canceled, reverting its status back to SCANNED.
"""
type CancelImportArtifactPayload {
  """Artifact revision with cancelled import."""
  artifactRevision: ArtifactRevision!
}

"""Added in UNRELEASED. Input for canceling a role invitation."""
input CancelRoleInvitationInput {
  invitationId: UUID!
}

"""Added in 26.3.0. Filter input for querying query preset categories."""
input CategoryFilter {
  """Filter by name."""
  name: StringFilter = null
}

"""Added in 26.3.0. Specifies ordering for query preset category results."""
input CategoryOrderBy {
  """The field to order by."""
  field: CategoryOrderField!

  """Sort direction."""
  direction: OrderDirection! = DESC
}

"""
Added in 26.3.0. Fields available for ordering query preset category results.
"""
enum CategoryOrderField {
  NAME
  CREATED_AT
}

"""Added in 26.4.2. Payload containing preset availability check results."""
type CheckPresetAvailabilityPayloadV2 {
  """Resource presets with availability status."""
  presets: [PresetAvailabilityV2!]!
}

"""
Added in 26.4.2. Input for checking which resource presets are available.
"""
input CheckPresetAvailabilityV2Input {
  """Project ID to check availability for."""
  projectId: UUID!

  """Resource group name to check availability for."""
  resourceGroupName: String!
}

"""Added in 26.4.2. Choice item."""
type ChoiceItem {
  """Option value."""
  value: String!

  """Display label."""
  label: String!
}

"""Added in 26.4.2. Select/radio UI config."""
type ChoiceOption {
  """List of choices."""
  items: [ChoiceItem!]!
}

"""
Added in 24.09.0. Input for cleaning up stored artifact revision data.

Removes downloaded files from storage and transitions the artifact revision
back to SCANNED status, freeing up storage space.
"""
input CleanupArtifactRevisionsInput {
  artifactRevisionIds: [ID!]!
}

"""
Added in 25.14.0. Response payload for artifact revision cleanup operations. Contains the cleaned artifact revisions that have had their stored data removed, transitioning them back to SCANNED status to free storage space.
"""
type CleanupArtifactRevisionsPayload {
  """Cleaned up artifact revisions."""
  artifactRevisions: ArtifactRevisionConnection!
}

"""Added in 26.4.2. Input for cloning a virtual folder."""
input CloneVFolderV2Input {
  """Name for the cloned vfolder."""
  name: String!

  """Project ID for the cloned vfolder. If omitted, cloned as user-owned."""
  projectId: UUID = null

  """Target storage host for the clone."""
  host: String = null
}

"""Added in 26.4.2. Payload returned after cloning a virtual folder."""
type CloneVFolderV2Payload {
  """Cloned virtual folder"""
  vfolder: VFolder!

  """Background task ID for the clone operation"""
  bgtaskId: String!
}

"""
Added in 25.19.0. Cluster configuration for model deployment replicas. Defines the clustering mode and number of replicas.
"""
type ClusterConfig {
  mode: ClusterMode!
  size: Int!
}

"""Added in 25.19.0. """
input ClusterConfigInput {
  mode: ClusterMode!
  size: Int!
}

"""Added in 25.19.0. Cluster mode for compute sessions and deployments."""
enum ClusterMode {
  SINGLE_NODE
  MULTI_NODE
}

"""
Added in 26.1.0. A single compute plugin entry representing one plugin and its metadata.
"""
type ComputePluginEntry {
  """
  Name of the compute plugin (e.g., 'cuda', 'rocm', 'tpu'). This identifier corresponds to the accelerator or resource type supported by the agent.
  """
  pluginName: String!

  """
  Plugin value as a JSON-encoded string containing plugin-specific information. The content varies by plugin type and may include version or configuration details.
  """
  value: String!
}

"""
Added in 26.1.0. A collection of compute plugins available on an agent. Each entry specifies a plugin name and its associated metadata.
"""
type ComputePlugins {
  """
  List of compute plugins. Each entry contains a plugin name and its metadata.
  """
  entries: [ComputePluginEntry!]!
}

extend type ComputeSessionNode @key(fields: "id") {
  id: ID! @external
}

"""
Added in 26.2.0. Scope for querying images within a specific container registry.
"""
input ContainerRegistryScope {
  """UUID of the container registry to scope the query to."""
  registryId: UUID!
}

"""Added in 26.4.0. Container registry type."""
enum ContainerRegistryType {
  DOCKER
  HARBOR
  HARBOR2
  GITHUB
  GITLAB
  ECR
  ECR_PUB
  LOCAL
  OCP
}

"""Added in 26.4.2. Filter by container registry type."""
input ContainerRegistryTypeFilter {
  equals: ContainerRegistryType = null
  notEquals: ContainerRegistryType = null
  in_: [ContainerRegistryType!] = null
  notIn: [ContainerRegistryType!] = null
}

"""Added in 26.4.0. Container registry node."""
type ContainerRegistryV2 implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """URL of the container registry"""
  url: String!

  """Name of the container registry"""
  registryName: String!

  """Type of the container registry"""
  type: ContainerRegistryType!

  """Project or namespace within the registry"""
  project: String

  """Username for registry authentication"""
  username: String

  """Masked password for registry authentication"""
  password: String

  """Whether SSL verification is enabled"""
  sslVerify: Boolean

  """Whether this registry is globally accessible"""
  isGlobal: Boolean

  """Extra metadata for the container registry"""
  extra: JSON
}

"""Added in 26.4.2. Paginated connection for container registries."""
type ContainerRegistryV2Connection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [ContainerRegistryV2Edge!]!

  """Total number of matching registries."""
  count: Int!
}

"""An edge in a connection."""
type ContainerRegistryV2Edge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: ContainerRegistryV2!
}

"""Added in 26.4.2. Filter for container registries."""
input ContainerRegistryV2Filter {
  registryName: StringFilter = null
  type: ContainerRegistryTypeFilter = null
  isGlobal: Boolean = null
}

"""Added in 26.4.2. Ordering specification for container registries."""
input ContainerRegistryV2OrderBy {
  """Field to order by."""
  field: ContainerRegistryV2OrderField! = REGISTRY_NAME

  """Sort direction."""
  direction: OrderDirection! = ASC
}

"""Added in 26.4.2. Fields available for ordering container registries."""
enum ContainerRegistryV2OrderField {
  REGISTRY_NAME
  URL
  TYPE
  IS_GLOBAL
}

"""
Added in 25.16.0. Input for creating an access token for a model deployment.
"""
input CreateAccessTokenInput {
  """The ID of the model deployment for which the access token is created."""
  modelDeploymentId: ID!

  """
  The expiration timestamp of the access token. Required — callers must decide the token lifetime themselves.
  """
  expiresAt: DateTime!
}

"""Added in 25.16.0. Payload for creating an access token."""
type CreateAccessTokenPayload {
  """Created access token"""
  accessToken: AccessToken!
}

"""Added in 25.19.0. Input for creating an auto-scaling rule."""
input CreateAutoScalingRuleInput {
  modelDeploymentId: ID!
  metricSource: AutoScalingMetricSource!
  metricName: String!
  minThreshold: Decimal
  maxThreshold: Decimal
  stepSize: Int!
  timeWindow: Int!
  minReplicas: Int
  maxReplicas: Int
  prometheusQueryPresetId: ID = null
}

"""Added in 25.19.0. Payload for creating an auto-scaling rule."""
type CreateAutoScalingRulePayload {
  """Created auto-scaling rule"""
  rule: AutoScalingRule!
}

"""Added in 26.3.0. Input for creating a new query preset category."""
input CreateCategoryInput {
  """Human-readable category name (must be unique)."""
  name: String!

  """Optional category description."""
  description: String = null
}

"""
Added in 26.3.0. Payload returned after creating a query preset category.
"""
type CreateCategoryPayload {
  """Created category."""
  category: QueryPresetCategory!
}

"""Added in 26.4.2. Input for creating a container registry."""
input CreateContainerRegistryInputGQL {
  """URL of the container registry."""
  url: String!

  """Unique name of the container registry."""
  registryName: String!

  """Type of the container registry."""
  type: ContainerRegistryType!

  """Project or namespace."""
  project: String = null

  """Username for authentication."""
  username: String = null

  """Password for authentication."""
  password: String = null

  """Whether to verify SSL."""
  sslVerify: Boolean = null

  """Whether globally accessible."""
  isGlobal: Boolean = null

  """Extra metadata."""
  extra: JSON = null
}

"""
Added in 26.4.2. Payload for container registry create/update mutations.
"""
type CreateContainerRegistryPayloadGQL {
  """Created container registry."""
  registry: ContainerRegistryV2!
}

"""Added in 25.19.0. """
input CreateDeploymentInput {
  metadata: ModelDeploymentMetadataInput!
  networkAccess: ModelDeploymentNetworkAccessInput!
  defaultDeploymentStrategy: DeploymentStrategyInput!
  replicaCount: Int!
  initialRevision: CreateRevisionInput = null
}

"""Added in 25.19.0. Payload for creating a model deployment."""
type CreateDeploymentPayload {
  """Created deployment"""
  deployment: ModelDeployment!
}

"""Added in 26.4.2. Create deployment revision preset input."""
input CreateDeploymentRevisionPresetInput {
  """Runtime variant ID."""
  runtimeVariantId: UUID!

  """Preset name."""
  name: String!

  """Default open_to_public for deployments created from this preset."""
  openToPublic: Boolean = null

  """Default replica count for deployments created from this preset."""
  replicaCount: Int!

  """
  Default revision history limit for deployments created from this preset.
  """
  revisionHistoryLimit: Int = null

  """Default deployment strategy for deployments created from this preset."""
  deploymentStrategy: PresetDeploymentStrategyInput!

  """Added in UNRELEASED. Container image to run the inference server."""
  imageId: UUID!

  """
  Added in UNRELEASED. Detailed explanation of when and why to use this preset configuration.
  """
  description: String = null

  """
  Added in UNRELEASED. Parsed model definition specifying health checks, ports, and service configuration for the inference endpoint.
  """
  modelDefinition: ModelDefinitionInput = null

  """
  Added in UNRELEASED. Resource slot allocations (e.g. cpu, mem, cuda.device).
  """
  resourceSlots: [ResourceSlotEntryInput!] = null

  """
  Added in UNRELEASED. Additional resource options such as shared memory (shmem) size.
  """
  resourceOpts: [ResourceOptsEntryInput!] = null

  """
  Added in UNRELEASED. Deployment topology mode (single-node or multi-node).
  """
  clusterMode: ClusterMode!

  """Added in UNRELEASED. Number of worker nodes in the cluster."""
  clusterSize: Int!

  """
  Added in UNRELEASED. Command to start the inference server process inside the container.
  """
  startupCommand: String = null

  """
  Added in UNRELEASED. Script executed before the main process starts (e.g. to download model weights).
  """
  bootstrapScript: String = null

  """
  Added in UNRELEASED. Environment variables injected into the inference container.
  """
  environ: [EnvironEntryInput!] = null

  """
  Added in UNRELEASED. Runtime variant preset values applied when using this deployment preset.
  """
  presetValues: [DeploymentRevisionPresetValueEntryInput!] = null
}

"""Added in 26.4.2. Create deployment revision preset payload."""
type CreateDeploymentRevisionPresetPayloadGQL {
  """The created preset."""
  preset: DeploymentRevisionPreset!
}

"""Added in 26.4.2. Input for creating a new domain."""
input CreateDomainInputGQL {
  """Domain name. Must be unique across the system."""
  name: String!

  """Optional description."""
  description: String = null

  """Whether the domain is active."""
  isActive: Boolean! = true

  """Allowed Docker registry URLs."""
  allowedDockerRegistries: [String!] = null

  """External integration identifier."""
  integrationName: String = null
}

"""Added in 26.4.2. Input for creating a file download session."""
input CreateDownloadSessionV2Input {
  """File path to download."""
  path: String!

  """Whether to archive the file for download."""
  archive: Boolean! = false
}

"""Added in 26.4.2. Payload returned after creating a download session."""
type CreateDownloadSessionV2Payload {
  """Download session token"""
  token: String!

  """Download URL"""
  url: String!
}

"""Added in 25.14.0. """
input CreateHuggingFaceRegistryInput {
  name: String!
  url: String!
  token: String = null
}

"""Added in 25.14.0. Payload for creating a HuggingFace registry."""
type CreateHuggingFaceRegistryPayload {
  """Created HuggingFace registry"""
  huggingfaceRegistry: HuggingFaceRegistry!
}

"""Added in 26.4.2. Input for creating a keypair resource policy."""
input CreateKeypairResourcePolicyInputGQL {
  """Policy name. Must be unique."""
  name: String!

  """Default for unspecified resource slots (LIMITED or UNLIMITED)."""
  defaultForUnspecified: String!

  """Total resource slot limits."""
  totalResourceSlots: [ResourceSlotEntryInput!]!

  """Maximum session lifetime in seconds."""
  maxSessionLifetime: Int!

  """Maximum concurrent sessions."""
  maxConcurrentSessions: Int!

  """Maximum containers per session."""
  maxContainersPerSession: Int!

  """Idle timeout in seconds."""
  idleTimeout: Int!

  """Maximum pending sessions. Null means unlimited."""
  maxPendingSessionCount: Int = null

  """Maximum pending session resource slots."""
  maxPendingSessionResourceSlots: [ResourceSlotEntryInput!] = null

  """Maximum concurrent SFTP sessions."""
  maxConcurrentSftpSessions: Int! = 1

  """Allowed vfolder host permissions."""
  allowedVfolderHosts: [VFolderHostPermissionEntryInput!]!
}

"""
Added in 26.4.2. Payload for keypair resource policy create/update mutations.
"""
type CreateKeypairResourcePolicyPayloadGQL {
  """Created keypair resource policy."""
  keypairResourcePolicy: KeypairResourcePolicyV2!
}

"""Added in 26.4.2. Input for creating a new login client type."""
input CreateLoginClientTypeInput {
  """Unique login client type name."""
  name: String!

  """Optional description shown to administrators."""
  description: String = null
}

"""Added in 26.4.2. Payload for login client type creation."""
type CreateLoginClientTypePayload {
  """Created login client type."""
  loginClientType: LoginClientType!
}

"""Added in 26.4.2. Create model card payload."""
type CreateModelCardPayloadGQL {
  """The created model card."""
  modelCard: ModelCardV2!
}

"""Added in 26.4.2. Create model card input."""
input CreateModelCardV2Input {
  """Model card name."""
  name: String!

  """VFolder ID."""
  vfolderId: UUID!

  """MODEL_STORE project UUID where the model card belongs."""
  modelStoreProjectId: UUID!

  """Domain name."""
  domainName: String = null

  """Author."""
  author: String = null

  """Model title."""
  title: String = null

  """Model version."""
  modelVersion: String = null

  """Description."""
  description: String = null

  """ML task."""
  task: String = null

  """Category."""
  category: String = null

  """Architecture."""
  architecture: String = null

  """Frameworks."""
  framework: [String!] = null

  """Labels."""
  label: [String!] = null

  """License."""
  license: String = null

  """README content."""
  readme: String = null

  """Access level (public or internal)."""
  accessLevel: ModelCardV2AccessLevel! = INTERNAL
}

"""Added in 24.09.0. Input for creating a notification channel"""
input CreateNotificationChannelInput {
  name: String!
  description: String = null
  channelType: NotificationChannelType!
  spec: NotificationChannelSpecInput!
  enabled: Boolean! = true
}

"""Added in 26.3.0. Payload for create notification channel mutation."""
type CreateNotificationChannelPayload {
  """Created notification channel"""
  channel: NotificationChannel!
}

"""Added in 24.09.0. Input for creating a notification rule"""
input CreateNotificationRuleInput {
  name: String!
  description: String = null

  """The rule type field."""
  ruleType: NotificationRuleType!
  channelId: ID!
  messageTemplate: String!
  enabled: Boolean! = true
}

"""Added in 26.3.0. Payload for create notification rule mutation."""
type CreateNotificationRulePayload {
  """Created notification rule"""
  rule: NotificationRule!
}

"""Added in 25.14.0. """
input CreateObjectStorageInput {
  name: String!
  host: String!
  accessKey: String!
  secretKey: String!
  endpoint: String!
  region: String!
}

"""Added in 25.14.0. Payload for creating an object storage."""
type CreateObjectStoragePayload {
  """Created object storage"""
  objectStorage: ObjectStorage!
}

"""Added in 26.3.0. Input for creating a scoped permission"""
input CreatePermissionInput {
  roleId: UUID!
  scopeType: RBACElementType!
  scopeId: String!
  entityType: RBACElementType!
  operation: OperationType!
}

"""Added in 26.4.2. Input for creating a new project."""
input CreateProjectInputGQL {
  """Project name. Must be unique within the domain."""
  name: String!

  """Name of the domain this project belongs to."""
  domainName: String!

  """Optional description."""
  description: String = null

  """External integration identifier."""
  integrationName: String = null

  """Name of the resource policy to apply."""
  resourcePolicy: String = null
}

"""Added in 26.4.2. Input for creating a project resource policy."""
input CreateProjectResourcePolicyInputGQL {
  """Policy name. Must be unique."""
  name: String!

  """Maximum vfolders a project can have."""
  maxVfolderCount: Int!

  """Maximum quota scope size (e.g., '1g', '536870912')."""
  maxQuotaScopeSize: BinarySizeInput!

  """Maximum networks a project can create. -1 means unlimited."""
  maxNetworkCount: Int!
}

"""
Added in 26.4.2. Payload for project resource policy create/update mutations.
"""
type CreateProjectResourcePolicyPayloadGQL {
  """Created project resource policy."""
  projectResourcePolicy: ProjectResourcePolicyV2!
}

"""Added in 26.3.0. Input for creating a new query definition."""
input CreateQueryDefinitionInput {
  """Human-readable identifier (must be unique)."""
  name: String!

  """Human-readable description."""
  description: String = null

  """Sort rank."""
  rank: Int! = 0

  """Category UUID."""
  categoryId: UUID = null

  """Prometheus metric name."""
  metricName: String!

  """PromQL template with {labels}, {window}, {group_by} placeholders."""
  queryTemplate: String!

  """Default time window."""
  timeWindow: String = null

  """Query definition options including filter and group labels."""
  options: QueryDefinitionOptionsInput!
}

"""Added in 26.3.0. Payload returned after creating a query definition."""
type CreateQueryDefinitionPayload {
  """Created query definition."""
  preset: QueryDefinition!
}

"""Added in 25.14.0. """
input CreateReservoirRegistryInput {
  name: String!
  endpoint: String!
  accessKey: String!
  secretKey: String!
  apiVersion: String!
}

"""Added in 25.14.0. Payload for creating a reservoir registry."""
type CreateReservoirRegistryPayload {
  """Created Reservoir registry"""
  reservoir: ReservoirRegistry!
}

"""Added in 26.4.2. Input for creating a new resource group."""
input CreateResourceGroupInput {
  """Resource group name."""
  name: String!

  """Domain to create the resource group in."""
  domainName: String!

  """Optional description."""
  description: String = null
}

"""Added in 26.4.2. Payload for resource group creation."""
type CreateResourceGroupPayloadGQL {
  """Created resource group."""
  resourceGroup: ResourceGroup!
}

"""Added in 26.4.2. Payload for resource preset creation."""
type CreateResourcePresetPayloadGQL {
  """Created resource preset."""
  resourcePreset: ResourcePresetV2!
}

"""Added in 26.4.2. Input for creating a new resource preset."""
input CreateResourcePresetV2Input {
  """Resource preset name."""
  name: String!

  """Resource slot allocations."""
  resourceSlots: [ResourceSlotEntryInput!]!

  """Shared memory size (e.g., expr: '512m' or '536870912')."""
  sharedMemory: BinarySizeInput = null

  """Resource group name. If null, the preset is global."""
  resourceGroupName: String = null
}

"""
Added in 25.19.0. Input for specifying revision configuration within a deployment.
"""
input CreateRevisionInput {
  """
  Added in 26.4.2. DeploymentRevisionPreset ID. When specified, preset values are used as defaults and can be overridden by explicitly provided fields.
  """
  revisionPresetId: UUID = null
  clusterConfig: ClusterConfigInput!
  resourceConfig: ResourceConfigInput!
  image: ImageInput!
  modelRuntimeConfig: ModelRuntimeConfigInput!
  modelMountConfig: ModelMountConfigInput!

  """
  Added in 26.4.2. Model definition to override the default values generated by the server
  """
  modelDefinition: ModelDefinitionInput = null

  """Extra vfolder mounts"""
  extraMounts: [ExtraVFolderMountInput!] = null
}

"""Added in 26.3.0. Input for creating a role"""
input CreateRoleInput {
  name: String!
  description: String = null
  source: RoleSource! = CUSTOM
  scopes: [ScopeInput!] = null
}

"""Added in UNRELEASED. Input for creating role invitations."""
input CreateRoleInvitationInput {
  roleId: UUID!
  emails: [String!]!
}

"""Added in UNRELEASED. Payload for role invitation creation."""
type CreateRoleInvitationPayload {
  """List of created role invitations."""
  items: [RoleInvitation!]!
}

"""Added in 26.4.2. Input for creating a runtime variant."""
input CreateRuntimeVariantInput {
  """
  Unique short identifier for the runtime engine (e.g., 'vllm', 'sglang').
  """
  name: String!

  """Human-readable description of the runtime engine."""
  description: String = null
}

"""Added in 26.4.2. Payload for runtime variant creation."""
type CreateRuntimeVariantPayloadGQL {
  """The created runtime variant."""
  runtimeVariant: RuntimeVariant!
}

"""Added in 26.4.2. Create preset input."""
input CreateRuntimeVariantPresetInput {
  """The runtime variant this preset belongs to."""
  runtimeVariantId: UUID!

  """Human-readable name of the configurable parameter."""
  name: String!

  """Detailed explanation of what this parameter controls."""
  description: String = null

  """
  How the value is applied: 'env' for environment variable, 'args' for command-line argument.
  """
  presetTarget: PresetTarget!

  """
  Data type for validation (e.g., 'str', 'int', 'float', 'bool', 'flag').
  """
  valueType: PresetValueType!

  """The default value shown to users when creating a deployment."""
  defaultValue: String = null

  """
  For 'env' target, the environment variable name; for 'args' target, the CLI flag name.
  """
  key: String!
}

"""Added in 26.4.2. Create preset payload."""
type CreateRuntimeVariantPresetPayloadGQL {
  """The created preset."""
  preset: RuntimeVariantPreset!
}

"""Added in 26.4.2. Session types allowed for user-initiated creation."""
enum CreateSessionType {
  INTERACTIVE
  BATCH
}

"""Added in 26.4.2. Input for creating a file upload session."""
input CreateUploadSessionV2Input {
  """File path to upload to."""
  path: String!

  """File size in bytes."""
  size: Int!
}

"""Added in 26.4.2. Payload returned after creating an upload session."""
type CreateUploadSessionV2Payload {
  """Upload session token"""
  token: String!

  """Upload URL"""
  url: String!
}

"""Added in 26.4.2. Input for creating a user resource policy."""
input CreateUserResourcePolicyInputGQL {
  """Policy name. Must be unique."""
  name: String!

  """Maximum vfolders a user can create."""
  maxVfolderCount: Int!

  """
  Added in 26.4.2. Maximum number of concurrent authenticated login sessions per user. Null means unlimited. Distinct from keypair_resource_policies.max_concurrent_sessions which caps compute sessions.
  """
  maxConcurrentLogins: Int = null

  """Maximum quota scope size (e.g., '1g', '536870912')."""
  maxQuotaScopeSize: BinarySizeInput!

  """Maximum sessions per model session."""
  maxSessionCountPerModelSession: Int!

  """Maximum customized images a user can create."""
  maxCustomizedImageCount: Int!
}

"""
Added in 26.4.2. Payload for user resource policy create/update mutations.
"""
type CreateUserResourcePolicyPayloadGQL {
  """Created user resource policy."""
  userResourcePolicy: UserResourcePolicyV2!
}

"""
Added in 26.2.0. Input for creating a new user. Required fields: email, username, password, domain_name, need_password_change, status, role.
"""
input CreateUserV2Input {
  """User's email address. Must be unique across the system."""
  email: String!

  """Unique username for login."""
  username: String!

  """Initial password for the user."""
  password: String!

  """Domain to assign the user to."""
  domainName: String!

  """If true, user must change password on first login."""
  needPasswordChange: Boolean!

  """Initial account status."""
  status: UserStatusV2!

  """User role determining access permissions."""
  role: UserRoleV2!

  """User's full display name."""
  fullName: String = null

  """Optional description or notes about the user."""
  description: String = null

  """List of project (group) IDs to assign the user to."""
  groupIds: [UUID!] = null

  """Allowed client IP addresses or CIDR ranges."""
  allowedClientIp: [String!] = null

  """Whether to enable TOTP two-factor authentication."""
  totpActivated: Boolean! = false

  """Name of the user resource policy to apply."""
  resourcePolicy: String! = "default"

  """Whether this user can create sudo sessions."""
  sudoSessionEnabled: Boolean! = false

  """User ID (UID) for container processes."""
  containerUid: Int = null

  """Primary group ID (GID) for container processes."""
  containerMainGid: Int = null

  """Supplementary group IDs for container processes."""
  containerGids: [Int!] = null
}

"""Added in 26.2.0. Payload for user creation mutation."""
type CreateUserV2Payload {
  """The newly created user."""
  user: UserV2!
}

"""Added in 25.16.0. Input for creating VFS storage"""
input CreateVFSStorageInput {
  name: String!
  host: String!
  basePath: String!
}

"""Added in 25.16.0. Payload for creating VFS storage."""
type CreateVFSStoragePayload {
  """Created VFS storage"""
  vfsStorage: VFSStorage!
}

"""
Added in UNRELEASED. Scope-agnostic body for vfolder creation. The owning scope is supplied as a separate mutation argument.
"""
input CreateVFolderInScopeInput {
  """VFolder name."""
  name: String!

  """Storage host for the vfolder."""
  host: String = null

  """Usage mode of the vfolder."""
  usageMode: VFolderUsageMode! = GENERAL

  """Default mount permission of the vfolder."""
  permission: VFolderMountPermission! = READ_WRITE

  """Whether the vfolder is cloneable."""
  cloneable: Boolean! = false
}

"""Added in 26.4.2. Input for creating a new virtual folder."""
input CreateVFolderV2Input {
  """VFolder name."""
  name: String!

  """Project ID for project-owned vfolder."""
  projectId: UUID = null

  """Storage host for the vfolder."""
  host: String = null

  """Usage mode of the vfolder (general, model, data)."""
  usageMode: String! = "general"

  """Default permission of the vfolder (ro, rw, wd)."""
  permission: String! = "rw"

  """Whether the vfolder is cloneable."""
  cloneable: Boolean! = false
}

"""Added in 26.4.2. Payload returned after creating a virtual folder."""
type CreateVFolderV2Payload {
  """Created virtual folder"""
  vfolder: VFolder!
}

"""Date (isoformat)"""
scalar Date

"""
Added in 24.09.0. Filter for date fields (not datetime) supporting range and equality operations.
"""
input DateFilter {
  before: Date = null
  after: Date = null
  equals: Date = null
  notEquals: Date = null
}

"""Date with time (isoformat)"""
scalar DateTime

"""
Added in 24.09.0. Filter for datetime fields supporting range and equality operations.
"""
input DateTimeFilter {
  before: DateTime = null
  after: DateTime = null
  equals: DateTime = null
  notEquals: DateTime = null
}

"""Decimal (fixed-point)"""
scalar Decimal

"""
Added in UNRELEASED. A single (handler_name, options) entry response for session handler options.
"""
type DefaultSessionHandlerOptionsEntryInfo {
  """Phase timeout in seconds; `null` means unbounded for this entry."""
  timeoutSec: Int

  """
  Per-phase retry budget; `null` means the retry limit is disabled (`give_up` never fires for this handler).
  """
  maxRetryCount: Int

  """Handler identifier matching `SessionLifecycleHandler.name()`."""
  handlerName: String!
}

"""
Added in UNRELEASED. A single (handler_name, options) entry for session handler options.
"""
input DefaultSessionHandlerOptionsEntryInput {
  handlerName: String!
  timeoutSec: Int = null
  maxRetryCount: Int = null
}

"""
Added in UNRELEASED. Per-handler scheduler policy snapshot for session handler options.
"""
type DefaultSessionHandlerOptionsInfo {
  """Phase timeout in seconds; `null` means unbounded for this entry."""
  timeoutSec: Int

  """
  Per-phase retry budget; `null` means the retry limit is disabled (`give_up` never fires for this handler).
  """
  maxRetryCount: Int
}

"""
Added in UNRELEASED. Per-handler scheduler policy fields for session handler options.
"""
input DefaultSessionHandlerOptionsInput {
  timeoutSec: Int = null
  maxRetryCount: Int = null
}

"""Added in UNRELEASED. Session handler-options policy response."""
type DefaultSessionHandlerOptionsPolicyInfo {
  """
  Fallback per-handler policy applied to handlers not listed in `by_handler`.
  """
  default: DefaultSessionHandlerOptionsInfo!

  """Per-handler overrides."""
  byHandler: [DefaultSessionHandlerOptionsEntryInfo!]!
}

"""
Added in UNRELEASED. Session handler-options input (timeout + retry, handler-keyed).
"""
input DefaultSessionHandlerOptionsPolicyInput {
  default: DefaultSessionHandlerOptionsInput = null
  byHandler: [DefaultSessionHandlerOptionsEntryInput!] = null
}

"""Added in UNRELEASED. Baseline kernel execution spec response."""
type DefaultSessionKernelExecutionSpecInfo {
  """Container image identifier, or `null` if not resolved."""
  imageId: String

  """Quantitative resource request entries."""
  resources: [ResourceSlotEntry!]

  """Qualitative resource hints."""
  resourceOpts: DefaultSessionResourceOptsInfo

  """Command executed after kernel bootstrap."""
  startupCommand: String

  """Shell script executed before `startup_command`."""
  bootstrapScript: String

  """Earliest start time for the kernel."""
  startsAt: DateTime

  """Soft deadline for BATCH-session user payload."""
  batchTimeoutSec: Int
}

"""
Added in UNRELEASED. Baseline kernel execution spec input used as the resource-group default.
"""
input DefaultSessionKernelExecutionSpecInput {
  imageId: String = null
  resources: [ResourceSlotEntryInput!] = null
  resourceOpts: DefaultSessionResourceOptsInput = null
  startupCommand: String = null
  bootstrapScript: String = null
  startsAt: DateTime = null
  batchTimeoutSec: Int = null
}

"""Added in UNRELEASED. Resource-group default session options response."""
type DefaultSessionOptionsInfo {
  """Default scheduling priority."""
  priority: Int!

  """Default preemption flag."""
  isPreemptible: Boolean!

  """Default cluster mode."""
  clusterMode: String!

  """
  Resource-group fallback `failure_policy`; applied to each kernel group whose `failure_policy` and the session's `default_failure_policy` are both unset.
  """
  defaultFailurePolicy: SessionFailurePolicy!

  """
  Baseline kernel execution spec. `null` if the resource group does not pre-configure one.
  """
  defaultKernelExecutionSpec: DefaultSessionKernelExecutionSpecInfo

  """Default handler-keyed scheduler policy (timeout + retry)."""
  handlerOptions: DefaultSessionHandlerOptionsPolicyInfo!

  """Default agent selection policy."""
  agentSelectionPolicy: SessionAgentSelectionPolicy!
}

"""
Added in UNRELEASED. Resource-group default session options input payload.
"""
input DefaultSessionOptionsInput {
  priority: Int = null
  isPreemptible: Boolean = null
  clusterMode: String = null
  defaultFailurePolicy: SessionFailurePolicy = null
  defaultKernelExecutionSpec: DefaultSessionKernelExecutionSpecInput = null
  handlerOptions: DefaultSessionHandlerOptionsPolicyInput = null
  agentSelectionPolicy: SessionAgentSelectionPolicy = null
}

"""Added in UNRELEASED. Qualitative resource hints response."""
type DefaultSessionResourceOptsInfo {
  """
  Shared-memory size as a human-readable string (e.g. '64m'). `null` means 'use the runtime default'.
  """
  shmem: String
}

"""
Added in UNRELEASED. Qualitative resource hints for session-level defaults (shared memory, ...).
"""
input DefaultSessionResourceOptsInput {
  shmem: BinarySizeInput = null
}

"""
Added in 24.09.0. Input type for delegated import of artifact revisions from a reservoir registry's remote registry.
Used to specify which artifact revisions should be imported from the remote registry source
into the local reservoir registry storage.
"""
input DelegateImportArtifactsInput {
  """List of artifact revision IDs of delegatee artifact registry"""
  artifactRevisionIds: [ID!]!

  """ID of the reservoir registry to delegate the import request to"""
  delegatorReservoirId: ID = null

  """The artifact type field."""
  artifactType: ArtifactType = null

  """The delegatee target field."""
  delegateeTarget: DelegateeTarget = null

  """
  Added in 26.1.0. Options controlling import behavior such as forcing re-download.
  """
  options: ImportArtifactsOptionsGQL = null
}

"""
Added in 25.15.0. Response payload for delegated artifact import operation. Contains the imported artifact revisions and associated background tasks. The tasks can be monitored to track the progress of the import operation.
"""
type DelegateImportArtifactsPayload {
  """
  List of imported artifact revisions from the reservoir registry's remote registry.
  """
  artifactRevisions: ArtifactRevisionConnection!

  """List of background tasks created for importing the artifact revisions."""
  tasks: [ArtifactRevisionImportTask!]!
}

"""
Added in 24.09.0. Input type for delegated scanning of artifacts from a delegatee reservoir registry's remote registry.
"""
input DelegateScanArtifactsInput {
  """ID of the reservoir registry to delegate the scan request to"""
  delegatorReservoirId: ID = null

  """Target delegatee reservoir registry and its remote registry to scan"""
  delegateeTarget: DelegateeTarget = null

  """The limit field."""
  limit: Int!

  """Filter artifacts by type (e.g., model, image, package)"""
  artifactType: ArtifactType = null

  """Search term to filter artifacts by name or description"""
  search: String = null
}

"""
Added in 25.15.0. Response payload for delegated artifact scanning operation. Contains the list of artifacts discovered during the scan of a reservoir registry's remote registry. These artifacts are now available for import or direct use.
"""
type DelegateScanArtifactsPayload {
  """List of artifacts discovered during the delegated scan."""
  artifacts: [Artifact!]!
}

"""Added in 25.15.0. """
input DelegateeTarget {
  delegateeReservoirId: ID!
  targetRegistryId: ID!
}

"""Added in UNRELEASED. Input for deleting an access token."""
input DeleteAccessTokenInput {
  """The ID of the access token to delete."""
  id: ID!
}

"""Added in UNRELEASED. Payload for deleting an access token."""
type DeleteAccessTokenPayload {
  """ID of the deleted access token"""
  id: UUID!
}

"""
Added in 24.09.0. Input for soft-deleting artifacts from the system.

Marks artifacts as deleted without permanently removing them.
Deleted artifacts can be restored using restore_artifacts.
"""
input DeleteArtifactsInput {
  artifactIds: [ID!]!
}

"""
Added in 25.15.0. Response payload for artifact deletion operations. Contains the artifacts that were soft-deleted. These can be restored later.
"""
type DeleteArtifactsPayload {
  """List of soft-deleted artifacts."""
  artifacts: [Artifact!]!
}

"""Added in 25.16.0. Input for deleting an auto-scaling rule"""
input DeleteAutoScalingRuleInput {
  id: ID!
}

"""Added in 25.19.0. Payload for deleting an auto-scaling rule."""
type DeleteAutoScalingRulePayload {
  """ID of the deleted auto-scaling rule"""
  id: ID!
}

"""
Added in 26.3.0. Payload returned after deleting a query preset category.
"""
type DeleteCategoryPayload {
  """Deleted category ID"""
  id: UUID!
}

"""Added in 26.4.2. Payload for container registry deletion."""
type DeleteContainerRegistryPayloadGQL {
  """ID of the deleted container registry."""
  id: String!
}

"""Added in 25.19.0. """
input DeleteDeploymentInput {
  id: ID!
}

"""Added in 25.19.0. Payload for deleting a model deployment."""
type DeleteDeploymentPayload {
  """ID of the deleted deployment"""
  id: ID!
}

"""Added in 26.4.2. Delete deployment revision preset payload."""
type DeleteDeploymentRevisionPresetPayloadGQL {
  """ID of the deleted preset."""
  id: UUID!
}

"""Added in 25.16.0. Input for deleting domain-level app configuration"""
input DeleteDomainConfigInput {
  domainName: String!
}

"""
Added in 25.16.0. Payload returned after deleting domain-level app configuration. Indicates whether the deletion was successful.
"""
type DeleteDomainConfigPayload {
  """Whether the deletion was successful."""
  deleted: Boolean!
}

"""Added in 26.4.2. Payload for domain deletion mutation."""
type DeleteDomainPayloadGQL {
  """Whether the deletion was successful."""
  deleted: Boolean!
}

"""Added in 26.4.2. Input for deleting files inside a virtual folder."""
input DeleteFilesV2Input {
  """List of file paths to delete."""
  files: [String!]!

  """Whether to delete directories recursively."""
  recursive: Boolean! = false
}

"""
Added in 26.4.2. Payload returned after deleting files in a virtual folder.
"""
type DeleteFilesV2Payload {
  """Background task ID for the deletion operation"""
  bgtaskId: String!
}

"""Added in 25.14.0. """
input DeleteHuggingFaceRegistryInput {
  id: ID!
}

"""Added in 25.14.0. Payload for deleting a HuggingFace registry."""
type DeleteHuggingFaceRegistryPayload {
  """ID of the deleted HuggingFace registry"""
  id: UUID!
}

"""Added in 26.4.2. Payload for keypair resource policy deletion."""
type DeleteKeypairResourcePolicyPayloadGQL {
  """Name of the deleted keypair resource policy."""
  name: String!
}

"""Added in 26.4.2. Payload for login client type deletion."""
type DeleteLoginClientTypePayload {
  """UUID of the deleted login client type."""
  id: String!
}

"""Added in 26.4.2. Delete model card payload."""
type DeleteModelCardPayloadGQL {
  """ID of the deleted model card."""
  id: UUID!
}

"""Added in UNRELEASED. Options for the model card delete operation."""
input DeleteModelCardV2Options {
  """
  If true, also soft-delete (move to trash) the model VFolder(s) associated with the deleted model card(s).
  """
  deleteAssociatedVfolder: Boolean! = false
}

"""Added in 24.09.0. Input for deleting a notification channel"""
input DeleteNotificationChannelInput {
  id: ID!
}

"""Added in 26.3.0. Payload for delete notification channel mutation."""
type DeleteNotificationChannelPayload {
  """ID of the deleted notification channel"""
  id: UUID!
}

"""Added in 24.09.0. Input for deleting a notification rule"""
input DeleteNotificationRuleInput {
  id: ID!
}

"""Added in 26.3.0. Payload for delete notification rule mutation."""
type DeleteNotificationRulePayload {
  """ID of the deleted notification rule"""
  id: UUID!
}

"""Added in 25.14.0. """
input DeleteObjectStorageInput {
  id: ID!
}

"""Added in 25.14.0. Payload for deleting an object storage."""
type DeleteObjectStoragePayload {
  """ID of the deleted object storage"""
  id: UUID!
}

"""Added in 26.3.0. Input for deleting a scoped permission"""
input DeletePermissionInput {
  id: UUID!
}

"""Added in 26.3.0. Payload for delete permission mutation."""
type DeletePermissionPayload {
  """ID of the deleted permission"""
  id: UUID!
}

"""Added in 26.4.2. Payload for project deletion mutation."""
type DeleteProjectPayloadGQL {
  """Whether the deletion was successful."""
  deleted: Boolean!
}

"""Added in 26.4.2. Payload for project resource policy deletion."""
type DeleteProjectResourcePolicyPayloadGQL {
  """Name of the deleted project resource policy."""
  name: String!
}

"""Added in 26.3.0. Payload returned after deleting a query definition."""
type DeleteQueryDefinitionPayload {
  """Deleted query definition ID"""
  id: UUID!
}

"""Added in 25.14.0. """
input DeleteReservoirRegistryInput {
  id: ID!
}

"""Added in 25.14.0. Payload for deleting a reservoir registry."""
type DeleteReservoirRegistryPayload {
  """ID of the deleted Reservoir registry"""
  id: UUID!
}

"""Added in 26.4.2. Payload for resource group deletion."""
type DeleteResourceGroupPayloadGQL {
  """Name of the deleted resource group."""
  id: String!
}

"""Added in 26.4.2. Payload for resource preset deletion."""
type DeleteResourcePresetPayloadGQL {
  """UUID of the deleted resource preset."""
  id: String!
}

"""Added in 26.3.0. Input for soft-deleting a role"""
input DeleteRoleInput {
  id: UUID!
}

"""Added in 26.3.0. Payload for delete role mutation."""
type DeleteRolePayload {
  """ID of the deleted role"""
  id: UUID!
}

"""Added in 26.4.2. Payload for runtime variant deletion."""
type DeleteRuntimeVariantPayloadGQL {
  """ID of the deleted runtime variant."""
  id: UUID!
}

"""Added in 26.4.2. Delete preset payload."""
type DeleteRuntimeVariantPresetPayloadGQL {
  """ID of the deleted preset."""
  id: UUID!
}

"""Added in 26.4.2. Input for deleting multiple runtime variants."""
input DeleteRuntimeVariantsInput {
  """List of runtime variant UUIDs to delete."""
  ids: [UUID!]!
}

"""Added in 26.4.2. Payload for bulk runtime variant deletion."""
type DeleteRuntimeVariantsPayloadGQL {
  """Number of runtime variants successfully deleted."""
  deletedCount: Int!
}

"""
Added in 24.09.0. Input for deleting user-level app configuration.
If user_id is not provided, the current user's configuration will be deleted.
"""
input DeleteUserConfigInput {
  userId: ID = null
}

"""
Added in 25.16.0. Payload returned after deleting user-level app configuration. Indicates whether the deletion was successful.
"""
type DeleteUserConfigPayload {
  """Whether the deletion was successful."""
  deleted: Boolean!
}

"""Added in 26.4.2. Payload for user resource policy deletion."""
type DeleteUserResourcePolicyPayloadGQL {
  """Name of the deleted user resource policy."""
  name: String!
}

"""Added in 26.2.0. Payload for single user soft-delete mutation."""
type DeleteUserV2Payload {
  """Whether the deletion was successful."""
  success: Boolean!
}

"""
Added in 26.2.0. Input for soft-deleting multiple users. Soft delete changes user status to DELETED but preserves data.
"""
input DeleteUsersV2Input {
  """List of user UUIDs to soft-delete."""
  userIds: [UUID!]!
}

"""Added in 26.2.0. Payload for bulk user soft-delete mutation."""
type DeleteUsersV2Payload {
  """Number of users successfully soft-deleted."""
  deletedCount: Int!
}

"""Added in 25.16.0. Input for deleting VFS storage"""
input DeleteVFSStorageInput {
  id: ID!
}

"""Added in 25.16.0. Payload for deleting VFS storage."""
type DeleteVFSStoragePayload {
  """ID of the deleted VFS storage"""
  id: UUID!
}

"""
Added in 26.4.2. Payload returned after soft-deleting a virtual folder.
"""
type DeleteVFolderV2Payload {
  """ID of the deleted virtual folder"""
  id: UUID!
}

"""Added in 26.4.2. Input for deploying a model card as a new deployment."""
input DeployModelCardV2Input {
  """Target project UUID for the deployment."""
  projectId: UUID!

  """Deployment revision preset UUID."""
  revisionPresetId: UUID!

  """Resource group name."""
  resourceGroup: String!

  """Number of replicas."""
  desiredReplicaCount: Int! = 1

  """Override open_to_public. Defaults to the preset value, then False."""
  openToPublic: Boolean = null

  """
  Override replica_count. Defaults to the preset value, then desired_replica_count.
  """
  replicaCount: Int = null

  """
  Override revision_history_limit. Defaults to the preset value, then 10.
  """
  revisionHistoryLimit: Int = null

  """Override deployment strategy. Defaults to the preset value, then none."""
  deploymentStrategy: PresetDeploymentStrategyInput = null
}

"""Added in 26.4.2. Result of deploying a model card."""
type DeployModelCardV2Payload {
  """ID of the created deployment."""
  deploymentId: UUID!

  """Name of the created deployment."""
  deploymentName: String!
}

"""
Added in 26.4.2. Input for deploying a model VFolder as a new deployment.
"""
input DeployVFolderV2Input {
  """Target project UUID for the deployment."""
  projectId: UUID!

  """Deployment revision preset UUID."""
  revisionPresetId: UUID!

  """Resource group name."""
  resourceGroup: String!

  """Number of replicas."""
  desiredReplicaCount: Int! = 1

  """Override open_to_public. Defaults to the preset value, then False."""
  openToPublic: Boolean = null

  """
  Override replica_count. Defaults to the preset value, then desired_replica_count.
  """
  replicaCount: Int = null

  """
  Override revision_history_limit. Defaults to the preset value, then 10.
  """
  revisionHistoryLimit: Int = null

  """Override deployment strategy. Defaults to the preset value, then none."""
  deploymentStrategy: PresetDeploymentStrategyInput = null
}

"""Added in 26.4.2. Payload for deploying a model VFolder."""
type DeployVFolderV2Payload {
  """ID of the created deployment."""
  deploymentId: UUID!

  """Name of the created deployment."""
  deploymentName: String!
}

"""Added in 25.19.0. """
input DeploymentFilter {
  name: StringFilter = null
  status: DeploymentStatusFilter = null
  openToPublic: Boolean = null
  tags: StringFilter = null
  endpointUrl: StringFilter = null

  """Added in 26.4.3. Filter by domain name."""
  domainName: StringFilter = null

  """Added in 26.4.3. Filter by project ID."""
  projectId: UUIDFilter = null

  """Added in 26.4.3. Filter by resource group name."""
  resourceGroup: StringFilter = null

  """Added in 26.4.3. Filter by the user who created the deployment."""
  createdUserId: UUIDFilter = null

  """Added in 26.4.3. Filter by deployment creation datetime."""
  createdAt: DateTimeFilter = null

  """
  Added in 26.4.3. Filter by deployment destruction datetime. Supports IS NULL / IS NOT NULL.
  """
  destroyedAt: NullableDateTimeFilter = null
  AND: [DeploymentFilter!] = null
  OR: [DeploymentFilter!] = null
  NOT: [DeploymentFilter!] = null
}

"""Added in UNRELEASED. Deployment handler-options policy response."""
type DeploymentHandlerOptionsInfoGQL {
  """Fallback per-handler policy."""
  default: HandlerOptionsInfoGQL!

  """Per-handler overrides."""
  byHandler: [HandlerOptionsEntryInfoGQL!]!
}

"""Added in UNRELEASED. Deployment handler-options policy input."""
input DeploymentHandlerOptionsInput {
  default: HandlerOptionsInput = null
  byHandler: [HandlerOptionsEntryInput!] = null
}

"""Added in 26.3.0. Deployment history record."""
type DeploymentHistory implements Node {
  """The Globally Unique ID of this object"""
  id: ID!
  deploymentId: ID!
  phase: String!
  fromStatus: String
  toStatus: String
  result: SchedulingResult!
  errorCode: String
  message: String
  subSteps: [SubStepResultGQL!]!
  attempts: Int!
  createdAt: DateTime!
  updatedAt: DateTime!

  """
  Added in UNRELEASED. Handler category that produced this row. ``lifecycle`` for monotonic lifecycle transitions; ``scaling`` for replica-reconcile transitions; ``health`` is reserved.
  """
  category: String!

  """Added in 26.4.3. The deployment this history record belongs to."""
  deployment: ModelDeployment
}

"""Added in 26.3.0. Deployment history connection."""
type DeploymentHistoryConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [DeploymentHistoryEdge!]!
  count: Int!
}

"""An edge in a connection."""
type DeploymentHistoryEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: DeploymentHistory!
}

"""Added in 24.09.0. Filter for deployment history"""
input DeploymentHistoryFilter {
  id: UUIDFilter = null
  deploymentId: UUIDFilter = null
  phase: StringFilter = null
  fromStatus: [String!] = null
  toStatus: [String!] = null
  result: SchedulingResultFilter = null
  errorCode: StringFilter = null
  message: StringFilter = null
  createdAt: DateTimeFilter = null
  updatedAt: DateTimeFilter = null
  AND: [DeploymentHistoryFilter!] = null
  OR: [DeploymentHistoryFilter!] = null
  NOT: [DeploymentHistoryFilter!] = null
}

"""Added in 24.09.0. Order by specification for deployment history"""
input DeploymentHistoryOrderBy {
  field: DeploymentHistoryOrderField!
  direction: OrderDirection! = DESC
}

"""Added in 26.3.0. Fields available for ordering deployment history"""
enum DeploymentHistoryOrderField {
  CREATED_AT
  UPDATED_AT
}

"""
Added in UNRELEASED. Sub-step within a deployment's current lifecycle phase. ``None`` when the deployment is not in a sub-step-bearing phase.
"""
enum DeploymentLifecycleSubStep {
  DEPLOYING_PROVISIONING
  DEPLOYING_ROLLING_BACK
  DEPLOYING_COMPLETED
}

"""Added in UNRELEASED. Deployment options payload response."""
type DeploymentOptionsInfoGQL {
  """Handler-keyed scheduler policy (timeout + retry)."""
  handlerOptions: DeploymentHandlerOptionsInfoGQL!
}

"""Added in UNRELEASED. Deployment options payload input."""
input DeploymentOptionsInput {
  handlerOptions: DeploymentHandlerOptionsInput!
}

"""Added in 25.19.0. """
input DeploymentOrderBy {
  field: DeploymentOrderField!
  direction: OrderDirection! = DESC
}

enum DeploymentOrderField {
  NAME
  CREATED_AT
  DESTROYED_AT
  DOMAIN
  PROJECT
  RESOURCE_GROUP
  TAG
}

"""Added in 25.19.0. Deployment policy configuration."""
type DeploymentPolicy implements Node {
  """The Globally Unique ID of this object"""
  id: ID!
  strategySpec: DeploymentStrategySpec!
  createdAt: DateTime!
  updatedAt: DateTime!
}

"""
Added in 26.4.2. A reusable deployment configuration template. Users select a preset when deploying a model to automatically populate resource allocation, execution settings, and runtime-specific parameters. Each preset is designed for a specific runtime variant and captures the full configuration needed to launch an inference service.
"""
type DeploymentRevisionPreset implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """The runtime variant this preset is designed for (e.g., vLLM, SGLang)."""
  runtimeVariantId: UUID!

  """Display name of this deployment configuration template."""
  name: String!

  """Detailed explanation of when and why to use this preset configuration."""
  description: String

  """
  Display ordering among presets of the same runtime variant, with lower values shown first.
  """
  rank: Int!

  """
  Cluster topology settings defining single-node or multi-node deployment.
  """
  cluster: PresetClusterSpec!

  """Compute resource allocation including CPU, memory, and accelerators."""
  resource: PresetResourceAllocation!

  """
  Container execution configuration including image, startup command, and environment.
  """
  execution: PresetExecutionSpec!

  """
  Deployment-level default values (open_to_public, replica_count, revision_history_limit, deployment_strategy) provided by this preset.
  """
  deploymentDefaults: PresetDeploymentDefaults!

  """
  Parsed model definition specifying health checks, ports, and service configuration for the inference endpoint.
  """
  modelDefinition: ModelDefinition

  """
  List of runtime variant preset values applied when using this deployment preset to auto-configure runtime parameters.
  """
  presetValues: [DeploymentRevisionPresetValueEntry!]!

  """Timestamp when this deployment preset was created."""
  createdAt: DateTime!

  """Timestamp of the last modification to this deployment preset."""
  updatedAt: DateTime

  """Added in 26.4.3. The runtime variant this preset is designed for."""
  runtimeVariant: RuntimeVariant

  """Added in 26.4.2. Resource slot allocations for this preset."""
  resourceSlots(filter: AllocatedResourceSlotFilter = null, orderBy: [AllocatedResourceSlotOrderBy!] = null): [AllocatedResourceSlot!]
}

"""Added in 26.4.2. Paginated list of deployment revision presets."""
type DeploymentRevisionPresetConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [DeploymentRevisionPresetEdge!]!
  count: Int!
}

"""An edge in a connection."""
type DeploymentRevisionPresetEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: DeploymentRevisionPreset!
}

"""
Added in 26.4.2. A single environment variable key-value pair injected into the inference container when a deployment revision preset is applied.
"""
type DeploymentRevisionPresetEnvironEntry {
  """Environment variable key."""
  key: String!

  """Environment variable value."""
  value: String!
}

"""Added in 26.4.2. Filter for deployment revision presets."""
input DeploymentRevisionPresetFilter {
  """Added in UNRELEASED. Filter by preset ID."""
  id: UUIDFilter = null

  """Name filter."""
  name: StringFilter = null

  """Variant ID filter."""
  runtimeVariantId: UUIDFilter = null
}

"""Added in 26.4.2. Order specification for deployment revision presets."""
input DeploymentRevisionPresetOrderBy {
  """Field to order by."""
  field: DeploymentRevisionPresetOrderField!

  """ASC or DESC."""
  direction: String! = "ASC"
}

"""Added in 26.4.2. Order fields for deployment revision presets."""
enum DeploymentRevisionPresetOrderField {
  NAME
  RANK
  CREATED_AT
}

"""
Added in 26.4.2. A mapping of a runtime variant preset to a specific value, used to auto-configure runtime parameters when this deployment preset is applied.
"""
type DeploymentRevisionPresetValueEntry {
  """Runtime variant preset ID."""
  presetId: UUID!

  """Value for this preset."""
  value: String!
}

"""
Added in UNRELEASED. A mapping of a runtime variant preset to a concrete value, used to auto-configure runtime parameters when this deployment preset is applied.
"""
input DeploymentRevisionPresetValueEntryInput {
  """The runtime variant preset that this value applies to."""
  presetId: UUID!

  """The concrete value to set for the referenced preset parameter."""
  value: String!
}

"""Added in 24.09.0. Scope for deployment scheduling history query"""
input DeploymentScope {
  """Deployment ID to get history for"""
  deploymentId: UUID!
}

"""
Added in 25.19.0. This enum represents the deployment status of a model deployment, indicating its current state.
"""
enum DeploymentStatus {
  PENDING
  SCALING
  DEPLOYING
  READY
  STOPPING
  STOPPED
}

"""Added in 25.19.0. Payload for deployment status changed event."""
type DeploymentStatusChangedPayload {
  """The deployment whose status changed"""
  deployment: ModelDeployment!
}

"""Added in 25.19.0. """
input DeploymentStatusFilter {
  """The in  field."""
  in: [DeploymentStatus!] = null
  equals: DeploymentStatus = null

  """Excludes statuses in the list."""
  notIn: [DeploymentStatus!] = null

  """Excludes exact status match."""
  notEquals: DeploymentStatus = null
}

"""
Added in 25.19.0. Represents the deployment strategy configuration that determines how updates are rolled out to replicas (e.g., rolling update, blue-green).
"""
type DeploymentStrategyGQL {
  type: DeploymentStrategyType!
}

"""
Added in 25.19.0. Deployment strategy configuration with discriminator pattern.
"""
input DeploymentStrategyInput {
  type: DeploymentStrategyType!
  rollingUpdate: RollingUpdateConfigInput = null
  blueGreen: BlueGreenConfigInput = null
}

"""
Added in 25.19.0. Base interface for deployment strategy specifications.
"""
interface DeploymentStrategySpec {
  strategy: DeploymentStrategyType!
}

"""
Added in 25.19.0. This enum represents the deployment strategy type of a model deployment, indicating the strategy used for deployment.
"""
enum DeploymentStrategyType {
  ROLLING
  BLUE_GREEN
}

"""
Added in 26.2.0. Basic domain information. Contains identity and descriptive fields for the domain.
"""
type DomainBasicInfo {
  """Domain name (primary key)."""
  name: String!

  """Optional description of the domain."""
  description: String

  """External system integration identifier."""
  integrationName: String
}

"""
Added in 26.1.0. Domain-level fair share data representing scheduling priority for an entire domain. The fair share factor determines resource allocation relative to other domains.
"""
type DomainFairShare implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """Name of the scaling group this fair share belongs to."""
  resourceGroupName: String!

  """Name of the domain this fair share is calculated for."""
  domainName: String!

  """Fair share specification parameters used for calculation."""
  spec: FairShareSpec!

  """Snapshot of the most recent fair share calculation results."""
  calculationSnapshot: FairShareCalculationSnapshot!

  """Timestamp when this record was created."""
  createdAt: DateTime!

  """Timestamp when this record was last updated."""
  updatedAt: DateTime!

  """
  Added in 26.2.0. The domain entity associated with this fair share record.
  """
  domain: DomainV2

  """
  Added in 26.2.0. The resource group associated with this fair share record.
  """
  resourceGroup: ResourceGroup
}

"""
Added in 26.1.0. Paginated connection for domain fair share records. Provides relay-style cursor-based pagination for efficient traversal of domain fair share data. Use 'edges' to access individual records with cursor information, or 'nodes' for direct data access.
"""
type DomainFairShareConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [DomainFairShareEdge!]!

  """Total number of domain fair share records matching the query criteria."""
  count: Int!
}

"""
Added in 26.2.0. Nested filter for domain entity fields in domain fair share queries. Allows filtering by domain properties such as active status.
"""
input DomainFairShareDomainNestedFilter {
  """Filter by domain active status."""
  isActive: Boolean = null
}

"""An edge in a connection."""
type DomainFairShareEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: DomainFairShare!
}

"""
Added in 26.1.0. Filter input for querying domain fair shares. Supports filtering by scaling group and domain name with various string matching operations. Multiple filters can be combined using AND, OR, and NOT logical operators.
"""
input DomainFairShareFilter {
  """
  Filter by scaling group name. Scaling groups define resource pool boundaries where domains compete for resources. Supports equals, contains, startsWith, and endsWith operations.
  """
  resourceGroup: StringFilter = null

  """
  Filter by domain name. Domains are organizational units containing projects and users. Supports equals, contains, startsWith, and endsWith operations.
  """
  domainName: StringFilter = null

  """
  Added in 26.2.0. Nested filter for domain entity properties. Allows filtering by domain active status.
  """
  domain: DomainFairShareDomainNestedFilter = null

  """Combine multiple filters with AND logic. All conditions must match."""
  AND: [DomainFairShareFilter!] = null

  """
  Combine multiple filters with OR logic. At least one condition must match.
  """
  OR: [DomainFairShareFilter!] = null

  """
  Negate the specified filters. Records matching these conditions will be excluded.
  """
  NOT: [DomainFairShareFilter!] = null
}

"""
Added in 26.1.0. Specifies ordering for domain fair share query results. Combine field selection with direction to sort results. Default direction is DESC (descending).
"""
input DomainFairShareOrderBy {
  """
  The field to order by. See DomainFairShareOrderField for available options.
  """
  field: DomainFairShareOrderField!

  """
  Sort direction. ASC for ascending (lowest first), DESC for descending (highest first). For fair_share_factor, ASC shows highest priority domains first.
  """
  direction: OrderDirection! = DESC
}

"""
Added in 26.1.0. Fields available for ordering domain fair share query results. FAIR_SHARE_FACTOR: Order by the calculated fair share factor (0-1 range, lower = higher priority). DOMAIN_NAME: Order alphabetically by domain name. CREATED_AT: Order by record creation timestamp. DOMAIN_IS_ACTIVE: Order by domain active status.
"""
enum DomainFairShareOrderField {
  FAIR_SHARE_FACTOR
  DOMAIN_NAME
  CREATED_AT
  DOMAIN_IS_ACTIVE
}

"""Added in 24.09.0. """
input DomainFairShareScope {
  """Resource group to filter fair shares by."""
  resourceGroupName: String!
}

"""
Added in 26.2.0. Domain lifecycle information. Contains activation status and timestamp tracking.
"""
type DomainLifecycleInfo {
  """
  Whether the domain is active. Inactive domains cannot create new projects or perform operations.
  """
  isActive: Boolean!

  """Timestamp when the domain was created."""
  createdAt: DateTime!

  """Timestamp when the domain was last modified."""
  modifiedAt: DateTime!
}

extend type DomainNode @key(fields: "id") {
  id: ID! @external
}

"""Added in 26.4.2. Payload for domain mutation responses."""
type DomainPayloadGQL {
  """The domain entity."""
  domain: DomainV2!
}

"""
Added in 26.2.0. Nested filter for projects belonging to a domain. Filters domains that have at least one project matching all specified conditions.
"""
input DomainProjectNestedFilter {
  name: StringFilter = null
  isActive: Boolean = null
}

"""
Added in 26.2.0. Scope for querying projects within a specific domain. Used to restrict project queries to a particular domain context.
"""
input DomainProjectV2Scope {
  """
  Domain name to scope the query. Only projects belonging to this domain will be returned.
  """
  domainName: String!
}

"""
Added in 26.2.0. Domain container registry configuration. Contains allowed container registry URLs for this domain.
"""
type DomainRegistryInfo {
  """
  List of allowed container registry URLs. Empty list means no restrictions on registry access.
  """
  allowedDockerRegistries: [String!]!
}

"""Added in 26.4.2. Payload for domain resource allocation query."""
type DomainResourceAllocationV2 {
  """Domain resource usage."""
  domain: ScopeResourceUsageV2!
}

"""
Added in 26.1.0. Domain-level usage bucket representing aggregated resource consumption for a specific time period. Usage buckets store historical data used to calculate fair share factors.
"""
type DomainUsageBucket implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """Name of the domain this usage bucket belongs to."""
  domainName: String!

  """Name of the scaling group this usage was recorded in."""
  resourceGroupName: String!

  """Metadata about the usage measurement period and timestamps."""
  metadata: UsageBucketMetadata!

  """
  Aggregated resource usage during this period. Contains the total compute resources consumed by all workloads in this domain during the measurement period (cpu cores, memory bytes, accelerator usage).
  """
  resourceUsage: ResourceSlot!

  """
  Snapshot of total available capacity in the scaling group at the end of this period. Used as a reference to calculate relative usage and fair share factors.
  """
  capacitySnapshot: ResourceSlot!

  """
  Added in 26.2.0. Average daily resource usage during this period. Calculated as resource_usage divided by bucket duration in days. For each resource type, this represents the average amount consumed per day. Units match the resource type (e.g., CPU cores, memory bytes).
  """
  averageDailyUsage: ResourceSlot

  """
  Added in 26.2.0. Usage ratio against total available capacity for each resource. Calculated as resource_usage divided by capacity_snapshot. Represents the fraction of total capacity consumed (resource-seconds / resource). The result is in seconds, where 86400 means full utilization for one day. Values can exceed this if usage exceeds capacity.
  """
  usageCapacityRatio: ResourceSlot

  """
  Added in 26.1.0. Project usage buckets belonging to this domain. Returns paginated project-level usage history for all projects in this domain within the same scaling group.
  """
  projectUsageBuckets(filter: ProjectUsageBucketFilter = null, orderBy: [ProjectUsageBucketOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): ProjectUsageBucketConnection
}

"""
Added in 26.1.0. Paginated connection for domain usage bucket records. Provides relay-style cursor-based pagination for browsing historical usage data by time period. Use 'edges' to access individual records with cursor information, or 'nodes' for direct data access.
"""
type DomainUsageBucketConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [DomainUsageBucketEdge!]!

  """
  Total number of domain usage bucket records matching the query criteria.
  """
  count: Int!
}

"""An edge in a connection."""
type DomainUsageBucketEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: DomainUsageBucket!
}

"""
Added in 26.1.0. Filter input for querying domain usage bucket records. Usage buckets contain historical resource consumption data aggregated by time period. Multiple filters can be combined using AND, OR, and NOT logical operators.
"""
input DomainUsageBucketFilter {
  """
  Filter by scaling group name. Scaling groups define where usage was recorded. Supports equals, contains, startsWith, and endsWith operations.
  """
  resourceGroup: StringFilter = null

  """
  Filter by domain name. This filters usage buckets for a specific domain. Supports equals, contains, startsWith, and endsWith operations.
  """
  domainName: StringFilter = null

  """Filter by usage measurement period start date."""
  periodStart: DateFilter = null

  """Filter by usage measurement period end date."""
  periodEnd: DateFilter = null

  """Combine multiple filters with AND logic. All conditions must match."""
  AND: [DomainUsageBucketFilter!] = null

  """
  Combine multiple filters with OR logic. At least one condition must match.
  """
  OR: [DomainUsageBucketFilter!] = null

  """
  Negate the specified filters. Records matching these conditions will be excluded.
  """
  NOT: [DomainUsageBucketFilter!] = null
}

"""
Added in 26.1.0. Specifies ordering for domain usage bucket query results. Combine field selection with direction to sort results. Default direction is DESC (most recent first).
"""
input DomainUsageBucketOrderBy {
  """
  The field to order by. See UsageBucketOrderField for available options.
  """
  field: UsageBucketOrderField!

  """
  Sort direction. ASC for chronological order (oldest first), DESC for reverse chronological order (most recent first).
  """
  direction: OrderDirection! = DESC
}

"""Added in 24.09.0. """
input DomainUsageScope {
  """Resource group to filter usage buckets by."""
  resourceGroupName: String!
}

"""
Added in 26.2.0. Nested filter for users belonging to a domain. Filters domains that have at least one user matching all specified conditions.
"""
input DomainUserNestedFilter {
  username: StringFilter = null
  email: StringFilter = null
  isActive: Boolean = null
}

"""
Added in 26.2.0. Scope for querying users within a specific domain. Used to restrict user queries to a particular domain context.
"""
input DomainUserV2Scope {
  """
  Domain name to scope the user query. Only users belonging to this domain will be returned.
  """
  domainName: String!
}

"""
Added in 26.2.0. Domain entity with structured field groups. Formerly DomainNode. Provides comprehensive domain information organized into logical categories: basic_info (identity), registry (container registries), and lifecycle (status/timestamps). All fields use typed structures instead of JSON scalars. Resource allocation and storage permissions are provided through separate dedicated APIs.
"""
type DomainV2 implements Node @key(fields: "id") {
  """The Globally Unique ID of this object"""
  id: ID!

  """Basic domain information including name and description."""
  basicInfo: DomainBasicInfo!

  """Container registry configuration."""
  registry: DomainRegistryInfo!

  """Lifecycle information including activation status and timestamps."""
  lifecycle: DomainLifecycleInfo!

  """
  Fair share record for this domain in the specified resource group. Returns the scheduling priority configuration for this domain. Always returns an object, even if no explicit configuration exists (in which case default values are used).
  """
  fairShare(scope: DomainFairShareScope!): DomainFairShare

  """
  Added in 26.4.0. Active resource usage overview for this domain. Returns the currently occupied resource slots and the number of active sessions.
  """
  activeResourceOverview: ActiveResourceOverview

  """
  Usage buckets for this domain, filtered by resource group. Returns aggregated resource usage statistics over time.
  """
  usageBuckets(scope: DomainUsageScope!, filter: DomainUsageBucketFilter = null, orderBy: [DomainUsageBucketOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): DomainUsageBucketConnection

  """Projects belonging to this domain."""
  projects(filter: ProjectV2Filter = null, orderBy: [ProjectV2OrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): ProjectV2Connection

  """Users belonging to this domain."""
  users(filter: UserV2Filter = null, orderBy: [UserV2OrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): UserV2Connection
}

"""
Added in 26.2.0. Paginated connection for domain records. Provides relay-style cursor-based pagination for efficient traversal of domain data. Use 'edges' to access individual records with cursor information, or 'nodes' for direct data access.
"""
type DomainV2Connection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [DomainV2Edge!]!

  """Total number of domain records matching the query criteria."""
  count: Int!
}

"""An edge in a connection."""
type DomainV2Edge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: DomainV2!
}

"""
Added in 26.2.0. Filter input for querying domains. Supports filtering by name, description, active status, timestamps, and nested project/user filters. Multiple filters can be combined using AND, OR, and NOT logical operators.
"""
input DomainV2Filter {
  name: StringFilter = null
  description: StringFilter = null
  isActive: Boolean = null
  createdAt: DateTimeFilter = null
  modifiedAt: DateTimeFilter = null
  project: DomainProjectNestedFilter = null
  user: DomainUserNestedFilter = null
  AND: [DomainV2Filter!] = null
  OR: [DomainV2Filter!] = null
  NOT: [DomainV2Filter!] = null
}

"""
Added in 26.2.0. Specifies ordering for domain query results. Combine field selection with direction to sort results. Default direction is DESC (descending).
"""
input DomainV2OrderBy {
  field: DomainV2OrderField! = CREATED_AT
  direction: OrderDirection! = DESC
}

"""
Added in 26.2.0. Fields available for ordering domain query results. CREATED_AT: Order by creation timestamp. MODIFIED_AT: Order by last modification timestamp. NAME: Order by domain name alphabetically. IS_ACTIVE: Order by active status. PROJECT_NAME: Order by project name (MIN aggregation). USER_USERNAME: Order by username (MIN aggregation). USER_EMAIL: Order by user email (MIN aggregation).
"""
enum DomainV2OrderField {
  CREATED_AT
  MODIFIED_AT
  NAME
  IS_ACTIVE
  PROJECT_NAME
  USER_USERNAME
  USER_EMAIL
}

"""
Added in 26.1.0. Input item for a single domain weight in bulk upsert. Represents one domain's weight configuration.
"""
input DomainWeightInputItem {
  """Name of the domain to update weight for."""
  domainName: String!

  """
  Priority weight multiplier. Higher weight = higher priority allocation ratio. Set to null to use resource group's default_weight.
  """
  weight: Decimal = null
}

"""Added in 26.4.2. Breakdown of resource allocation by scope."""
type EffectiveBreakdownV2 {
  """Keypair resource policy limits."""
  keypair: ScopeResourceUsageV2!

  """
  Project resource limits. Null when group_resource_visibility is disabled.
  """
  project: ScopeResourceUsageV2

  """Domain resource limits."""
  domain: ScopeResourceUsageV2!

  """Resource group physical resources. Null when hide_agents is enabled."""
  resourceGroup: ResourceGroupUsageV2
}

"""
Added in 26.4.2. Effective assignable resources considering all scope constraints.
"""
type EffectiveResourceAllocationV2 {
  """Effective assignable resources (minimum across all scopes)."""
  assignable: [ResourceLimitEntry!]!

  """Per-scope breakdown of resource limits and usage."""
  breakdown: EffectiveBreakdownV2!
}

"""Added in 26.4.2. Input for querying effective assignable resources."""
input EffectiveResourceAllocationV2Input {
  """Project ID to check allocation for."""
  projectId: UUID!

  """Resource group name to check allocation for."""
  resourceGroupName: String!
}

"""Added in 24.09.0. Input for email message settings"""
input EmailMessageInput {
  fromEmail: String!
  toEmails: [String!]!
  subjectTemplate: String = null
}

"""Added in 24.09.0. Input for email notification channel configuration"""
input EmailSpecInput {
  smtp: SMTPConnectionInput!
  message: EmailMessageInput!
  auth: SMTPAuthInput = null
}

"""Added in 26.4.2. Input for creating a new compute session."""
input EnqueueSessionInput {
  """Session name."""
  sessionName: String!

  """Session type."""
  sessionType: CreateSessionType!

  """Image UUID."""
  imageId: ID!

  """Resource slot allocations."""
  resourceEntries: [SessionResourceSlotEntryInput!]!

  """Scaling group name."""
  resourceGroup: String = null

  """Additional resource options."""
  resourceOpts: SessionResourceOptsInput = null

  """Cluster mode."""
  clusterMode: SessionClusterMode! = SINGLE_NODE

  """Number of containers."""
  clusterSize: Int! = 1

  """Virtual folder mounts."""
  mounts: [SessionMountItemInput!] = null

  """Environment variables."""
  environ: JSON = null

  """Ports to pre-open."""
  preopenPorts: [Int!] = null

  """Bootstrap script."""
  bootstrapScript: String = null

  """Scheduling priority (0-100)."""
  priority: Int! = 10

  """Whether preemptible."""
  isPreemptible: Boolean! = true

  """Dependent session IDs."""
  dependencies: [ID!] = null

  """Designated agent IDs."""
  agentList: [String!] = null

  """Network UUID to attach."""
  attachNetwork: ID = null

  """User-defined tag."""
  tag: String = null

  """Webhook URL."""
  callbackUrl: String = null

  """Batch configuration."""
  batch: SessionBatchConfigInput = null

  """Project UUID."""
  projectId: ID = null
}

"""Added in 26.4.2. Payload returned after creating a session."""
type EnqueueSessionPayload {
  """Created session details."""
  session: SessionV2!
}

"""Added in 26.4.2. Entity with its allowed actions within a scope."""
type EntityActionInfo {
  """Entity element type"""
  entityType: RBACElementType!

  """Valid operations for this entity in the given scope"""
  actions: [OperationInfo!]!
}

"""Added in 26.3.0. Entity connection."""
type EntityConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [EntityRefEdge!]!
  count: Int!
}

"""Added in 26.3.0. Filter for entity associations"""
input EntityFilter {
  entityType: RBACElementTypeFilter = null
  entityId: StringFilter = null
  AND: [EntityFilter!] = null
  OR: [EntityFilter!] = null
  NOT: [EntityFilter!] = null
}

union EntityNode = UserV2 | ProjectV2 | DomainV2 | VirtualFolderNode | ImageV2 | ComputeSessionNode | SessionV2 | Artifact | ArtifactRegistry | AppConfig | NotificationChannel | NotificationRule | ModelDeployment | ResourceGroup | ContainerRegistryV2 | ArtifactRevision | Role

"""Added in 26.4.2. Valid entity-operation combination for RBAC actions."""
type EntityOperationCombination {
  """Entity element type"""
  entityType: RBACElementType!

  """Valid operations for this entity"""
  operations: [OperationInfo!]!
}

"""Added in 26.3.0. Order by specification for entity associations"""
input EntityOrderBy {
  field: EntityOrderField!
  direction: OrderDirection! = DESC
}

"""Added in 26.3.0. Entity ordering field"""
enum EntityOrderField {
  ENTITY_TYPE
  REGISTERED_AT
}

"""
Added in 26.3.0. Entity reference from the association_scopes_entities table.
"""
type EntityRef implements Node {
  """The Globally Unique ID of this object"""
  id: ID!
  scopeType: RBACElementType!
  scopeId: String!
  entityType: RBACElementType!
  entityId: String!
  registeredAt: DateTime!

  """The resolved entity object."""
  entity: EntityNode

  """
  Added in 26.4.3. The resolved scope object in which the entity is registered.
  """
  scope: EntityNode
}

"""An edge in a connection."""
type EntityRefEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: EntityRef!
}

"""
Added in 26.2.0. Common timestamp fields for entity lifecycle tracking. Reusable across different entity types.
"""
type EntityTimestamps {
  """Timestamp when this entity was created."""
  createdAt: DateTime

  """Timestamp when this entity was last modified."""
  modifiedAt: DateTime
}

"""
Added in UNRELEASED. Entity reference parametrized by RBAC element type.
"""
input EntityTypeScope {
  """RBAC element type of the entity."""
  entityType: RBACElementType!

  """ID of the entity."""
  entityId: String!
}

"""
Added in UNRELEASED. A single environment variable entry with key and value.
"""
input EnvironEntryInput {
  """Environment variable key (e.g., 'CUDA_VISIBLE_DEVICES')."""
  key: String!

  """Environment variable value."""
  value: String!
}

"""
Added in 26.1.0. A single environment variable entry with name and value.
"""
type EnvironmentVariableEntry {
  name: String!
  value: String!
}

"""
Added in 26.1.0. A single environment variable entry with name and value.
"""
input EnvironmentVariableEntryInput {
  """Environment variable name (e.g., CUDA_VISIBLE_DEVICES)."""
  name: String!

  """Environment variable value."""
  value: String!
}

"""Added in 26.1.0. A collection of environment variable entries."""
type EnvironmentVariables {
  entries: [EnvironmentVariableEntry!]!
}

"""Added in 26.1.0. A collection of environment variable entries."""
input EnvironmentVariablesInput {
  """List of environment variable entries."""
  entries: [EnvironmentVariableEntryInput!]!
}

"""Added in 26.3.0. Options for executing a query definition."""
input ExecuteQueryDefinitionOptionsInput {
  """Label key-value pairs to filter by."""
  filterLabels: [MetricLabelEntryInput!] = null

  """Label keys to group results by."""
  groupLabels: [String!] = null
}

"""
Added in 25.19.0. An extra virtual folder mount attached to a model revision.
"""
type ExtraVFolderMountInfoGQL {
  """The vfolder of this entity."""
  vfolder: VirtualFolderNode
  vfolderId: ID!
  mountDestination: String

  """
  The concrete permission snapshot fixed at revision-write time. ``INHERIT`` policies are resolved against the vfolder's current permission at that point, so this value is immutable and does not change when the vfolder's permission later changes. ``None`` when the caller left it unset to inherit the vfolder's stored permission at session-creation time (task #83).
  """
  mountPerm: MountPermission!

  """
  Added in UNRELEASED. Subpath within the vfolder. ``None`` means the vfolder root.
  """
  subpath: String
}

"""Added in 25.19.0. """
input ExtraVFolderMountInput {
  vfolderId: ID!
  mountDestination: String

  """
  Added in UNRELEASED. Subpath within the vfolder. ``null`` (default) mounts the vfolder root.
  """
  subpath: String = null
}

"""
Added in 26.1.0. Snapshot of the most recent fair share calculation results. Contains the computed fair share factor and the intermediate values used in the calculation.
"""
type FairShareCalculationSnapshot {
  """
  Added in 26.2.0. Average daily decayed resource usage during the lookback period. Calculated as total_decayed_usage divided by lookback duration in days. For each resource type, this represents the average decayed amount consumed per day. Units match the resource type (e.g., CPU cores, memory bytes).
  """
  averageDailyDecayedUsage: ResourceSlot

  """Computed fair share factor (0-1 range)"""
  fairShareFactor: Decimal!

  """Sum of decayed historical usage"""
  totalDecayedUsage: ResourceSlot!

  """Single scalar representing weighted consumption"""
  normalizedUsage: Decimal!

  """Start date of the lookback window"""
  lookbackStart: Date!

  """End date of the lookback window"""
  lookbackEnd: Date!

  """Timestamp when calculation was performed"""
  lastCalculatedAt: DateTime!
}

"""
Added in 26.1.0. Fair share calculation configuration for a resource group. Defines parameters for computing fair share factors across domains, projects, and users.
"""
type FairShareScalingGroupSpec {
  """Half-life for exponential decay in days"""
  halfLifeDays: Int!

  """Total lookback period in days"""
  lookbackDays: Int!

  """Granularity of decay buckets in days"""
  decayUnitDays: Int!

  """Default weight for entities without explicit weight"""
  defaultWeight: Decimal!

  """Weights for each resource type"""
  resourceWeights: [ResourceWeightEntry!]!
}

"""
Added in 26.1.0. Configuration parameters that control how fair share factors are calculated. These parameters determine the decay rate, lookback period, and resource weighting for usage aggregation.
"""
type FairShareSpec {
  """
  Effective weight for this entity. Always the resolved value (either the explicitly set weight or the resource group's default_weight).
  """
  weight: Decimal!

  """
  Whether this entity uses the resource group's default_weight. True means no explicit weight was set.
  """
  usesDefault: Boolean!

  """Half-life for exponential decay in days"""
  halfLifeDays: Int!

  """Total lookback period in days"""
  lookbackDays: Int!

  """Granularity of decay buckets in days"""
  decayUnitDays: Int!

  """Weights for each resource type with default indicators"""
  resourceWeights: [ResourceWeightEntry!]!
}

"""Added in 25.14.0. """
input GetPresignedDownloadURLInput {
  artifactRevisionId: ID!
  key: String!
  expiration: Int = null
}

"""
Added in 25.14.0. Payload for presigned download URL generation result.
"""
type GetPresignedDownloadURLPayload {
  """Presigned URL for downloading"""
  presignedUrl: String!
}

"""Added in 25.14.0. """
input GetPresignedUploadURLInput {
  artifactRevisionId: ID!
  key: String!
}

"""Added in 25.14.0. Payload for presigned upload URL generation result."""
type GetPresignedUploadURLPayload {
  """Presigned URL for uploading"""
  presignedUrl: String!

  """Additional fields required for the upload request"""
  fields: String!
}

extend type GroupNode @key(fields: "id") {
  id: ID! @external
}

"""
Added in UNRELEASED. A single (handler_name, options) entry response for deployment handler options.
"""
type HandlerOptionsEntryInfoGQL {
  """Phase timeout in seconds; `null` means unbounded for this entry."""
  timeoutSec: Int

  """
  Per-phase retry budget; `null` means the retry limit is disabled (`give_up` never fires for this handler).
  """
  maxRetryCount: Int

  """Handler identifier matching `SessionLifecycleHandler.name()`."""
  handlerName: String!
}

"""
Added in UNRELEASED. A single (handler_name, options) entry for deployment handler options.
"""
input HandlerOptionsEntryInput {
  handlerName: String!
  timeoutSec: Int = null
  maxRetryCount: Int = null
}

"""
Added in UNRELEASED. Per-handler scheduler policy snapshot for deployment handler options.
"""
type HandlerOptionsInfoGQL {
  """Phase timeout in seconds; `null` means unbounded for this entry."""
  timeoutSec: Int

  """
  Per-phase retry budget; `null` means the retry limit is disabled (`give_up` never fires for this handler).
  """
  maxRetryCount: Int
}

"""
Added in UNRELEASED. Per-handler scheduler policy fields for deployment handler options.
"""
input HandlerOptionsInput {
  timeoutSec: Int = null
  maxRetryCount: Int = null
}

"""Added in 25.14.0. HuggingFace registry node."""
type HuggingFaceRegistry implements Node {
  """The Globally Unique ID of this object"""
  id: ID!
  url: String!
  name: String!
  token: String
}

"""
Added in 25.14.0. Relay-style connection for paginated HuggingFace registry queries.
"""
type HuggingFaceRegistryConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [HuggingFaceRegistryEdge!]!

  """The count of this entity."""
  count: Int!
}

"""An edge in a connection."""
type HuggingFaceRegistryEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: HuggingFaceRegistry!
}

"""
Added in 26.3.0. Nested filter for aliases belonging to an image. Filters images that have at least one alias matching all specified conditions.
"""
input ImageAliasNestedFilter {
  """
  Filter by alias string. Supports equals, contains, startsWith, and endsWith.
  """
  alias: StringFilter = null
}

"""Added in 25.19.0. """
input ImageInput {
  id: ID!
}

extend type ImageNode @key(fields: "id") {
  id: ID! @external
}

"""
Added in 26.2.0. Represents a container image in Backend.AI. Images are container specifications that define the runtime environment for compute sessions. Each image has identity information, metadata, resource requirements, and permission settings. This is the V2 implementation using Strawberry GraphQL with Relay-style connections as part of BEP-1010 migration.
"""
type ImageV2 implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """Image identity information (name, architecture)."""
  identity: ImageV2IdentityInfo!

  """Image metadata (labels, digest, size, status, created_at)."""
  metadata: ImageV2MetadataInfo!

  """Runtime requirements (supported_accelerators)."""
  requirements: ImageV2RequirementsInfo!

  """Permission info for the current user. May be null."""
  permission: ImageV2PermissionInfo

  """UUID of the container registry where this image is stored."""
  registryId: UUID!

  """
  Added in 26.3.0. Timestamp of the most recent session created with this image. Returns null if the image has never been used.
  """
  lastUsed: DateTime

  """Added in 26.2.0. Aliases for this image."""
  aliases(filter: ImageV2AliasFilter = null, orderBy: [ImageV2AliasOrderByGQL!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null): ImageV2AliasConnection
}

"""
Added in 26.2.0. Represents an alias for a container image. Aliases provide alternative names for images.
"""
type ImageV2Alias implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """The alias string for the image."""
  alias: String!
}

"""
Added in 26.2.0. Relay-style connection for paginated image alias queries. Includes total count for pagination UI.
"""
type ImageV2AliasConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [ImageV2AliasEdge!]!

  """Total count of aliases matching the query."""
  count: Int!
}

"""An edge in a connection."""
type ImageV2AliasEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: ImageV2Alias!
}

"""
Added in 26.2.0. Filter options for image aliases. Supports filtering by alias string and image ID.
"""
input ImageV2AliasFilter {
  alias: StringFilter = null

  """Added in 26.4.0. Filter by image ID."""
  imageId: UUIDFilter = null
  AND: [ImageV2AliasFilter!] = null
  OR: [ImageV2AliasFilter!] = null
  NOT: [ImageV2AliasFilter!] = null
}

"""
Added in 26.2.0. Specifies the field and direction for ordering image aliases in queries.
"""
input ImageV2AliasOrderByGQL {
  field: ImageV2AliasOrderField!
  direction: OrderDirection! = ASC
}

"""Added in 26.2.0. Fields available for ordering image alias queries."""
enum ImageV2AliasOrderField {
  ALIAS
}

"""
Added in 26.2.0. Relay-style connection for paginated image queries. Includes total count for pagination UI.
"""
type ImageV2Connection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [ImageV2Edge!]!

  """Total count of images matching the query."""
  count: Int!
}

"""An edge in a connection."""
type ImageV2Edge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: ImageV2!
}

"""
Added in 26.2.0. Filter options for images based on various criteria such as status, name, and architecture. Supports logical operations (AND, OR, NOT) for complex filtering scenarios.
"""
input ImageV2Filter {
  status: ImageV2StatusFilter = null
  name: StringFilter = null
  architecture: StringFilter = null

  """Added in UNRELEASED. Filter by image UUID."""
  id: UUIDFilter = null

  """Added in 26.4.0. Filter by container registry ID."""
  registryId: UUIDFilter = null

  """Added in 26.3.0. Filter by nested alias conditions."""
  alias: ImageAliasNestedFilter = null

  """Added in 26.3.0. Filter by last used datetime (before/after)."""
  lastUsed: DateTimeFilter = null
  AND: [ImageV2Filter!] = null
  OR: [ImageV2Filter!] = null
  NOT: [ImageV2Filter!] = null
}

"""
Added in 26.2.0. Identity information for an image. Contains the canonical name, namespace, and architecture.
"""
type ImageV2IdentityInfo {
  """Full canonical name of the image."""
  canonicalName: String!

  """Image namespace/path within the registry."""
  namespace: String!

  """CPU architecture."""
  architecture: String!
}

"""
Added in 26.2.0. A key-value pair representing a Docker label on the image. Labels contain metadata about the image such as maintainer, version, etc.
"""
type ImageV2LabelEntry {
  key: String!
  value: String!
}

"""
Added in 26.2.0. Metadata information for an image. Contains tags, labels, digest, size, status, and creation timestamp.
"""
type ImageV2MetadataInfo {
  """Config digest for verification."""
  digest: String

  """Image size in bytes."""
  sizeBytes: Int!

  """Image creation timestamp."""
  createdAt: DateTime

  """Timestamp of the most recent session created with this image."""
  lastUsedAt: DateTime

  """Parsed tag components."""
  tags: [ImageV2TagEntry!]!

  """Docker labels."""
  labels: [ImageV2LabelEntry!]!

  """Image status (ALIVE or DELETED)."""
  status: ImageV2Status!
}

"""
Added in 26.2.0. Specifies the field and direction for ordering images in queries.
"""
input ImageV2OrderByGQL {
  field: ImageV2OrderField!
  direction: OrderDirection! = ASC
}

"""Added in 26.2.0. Fields available for ordering image queries."""
enum ImageV2OrderField {
  NAME
  CREATED_AT
  LAST_USED
}

"""Added in 26.2.0. Permission types for image operations."""
enum ImageV2Permission {
  READ_ATTRIBUTE
  UPDATE_ATTRIBUTE
  CREATE_CONTAINER
  FORGET_IMAGE
}

"""
Added in 26.2.0. Permission information for an image. Contains the list of permissions the current user has on this image.
"""
type ImageV2PermissionInfo {
  """List of permissions the user has on this image"""
  permissions: [ImageV2Permission!]!
}

"""
Added in 26.2.0. Runtime requirements information for an image. Contains resource limits and supported accelerators.
"""
type ImageV2RequirementsInfo {
  """List of supported accelerator types."""
  supportedAccelerators: [String!]!

  """Resource slot limits with string min/max values."""
  resourceLimits: [ImageV2ResourceLimit!]!
}

"""
Added in 26.2.0. Resource limit specification for an image. Defines minimum and maximum values for a resource slot.
"""
type ImageV2ResourceLimit {
  key: String!
  min: String!
  max: String!
}

"""Added in 26.2.0. Scope for querying aliases within a specific image."""
input ImageV2Scope {
  """UUID of the image to scope the query to."""
  imageId: UUID!
}

"""Added in 26.2.0. Status of an image in the system."""
enum ImageV2Status {
  ALIVE
  DELETED
}

"""
Added in 26.3.0. Filter for image status with equality and membership operators.
"""
input ImageV2StatusFilter {
  """Matches images with this exact status."""
  equals: ImageV2Status = null

  """Matches images whose status is in this list."""
  in: [ImageV2Status!] = null

  """Excludes images with this exact status."""
  notEquals: ImageV2Status = null

  """Excludes images whose status is in this list."""
  notIn: [ImageV2Status!] = null
}

"""
Added in 26.2.0. A key-value pair representing a parsed tag component. Tags are extracted from the image reference (e.g., py311, cuda12.1).
"""
type ImageV2TagEntry {
  key: String!
  value: String!
}

"""
Added in 24.09.0. Input for importing scanned artifact revisions from external registries.

Downloads artifact files from the external source and transitions them through:
SCANNED → PULLING → PULLED → AVAILABLE status progression.
"""
input ImportArtifactsInput {
  artifactRevisionIds: [ID!]!

  """Added in 26.1.0. Target vfolder ID to store the imported artifacts."""
  vfolderId: ID = null

  """
  Added in 26.1.0. Options controlling import behavior such as forcing re-download.
  """
  options: ImportArtifactsOptionsGQL = null
}

"""
Added in 24.09.0. Options for importing artifact revisions.

Controls import behavior such as forcing re-download regardless of digest freshness.
"""
input ImportArtifactsOptionsGQL {
  """Force re-download regardless of digest freshness check."""
  force: Boolean! = false
}

"""
Added in 25.14.0. Response payload for artifact import operations. Contains the imported artifact revisions and their associated background tasks. Tasks can be monitored to track the import progress from SCANNED to AVAILABLE status.
"""
type ImportArtifactsPayload {
  """List of imported artifact revisions."""
  artifactRevisions: ArtifactRevisionConnection!

  """List of import tasks created."""
  tasks: [ArtifactRevisionImportTask!]!
}

"""
Added in 24.09.0. Filter for integer fields supporting equality and comparison operations.
"""
input IntFilter {
  equals: Int = null
  notEquals: Int = null
  greaterThan: Int = null
  greaterThanOrEqual: Int = null
  lessThan: Int = null
  lessThanOrEqual: Int = null
}

"""
Added in 26.4.2. Input for a rolling-update budget value (oneOf).
Provide exactly one of 'count' (absolute replica count) or 'percent' (0.0-1.0 fraction).
"""
input IntOrPercentInput @oneOf {
  count: Int
  percent: Float
}

"""
Added in 26.2.0. Payload returned after issuing a new keypair. The secret_key is only shown once.
"""
type IssueMyKeypairPayload {
  """The newly created keypair."""
  keypair: KeyPairGQL!

  """
  The newly generated secret key. This value is only returned at creation time.
  """
  secretKey: String!
}

"""
The `JSON` scalar type represents JSON values as specified by [ECMA-404](https://ecma-international.org/wp-content/uploads/ECMA-404_2nd_edition_december_2017.pdf).
"""
scalar JSON @specifiedBy(url: "https://ecma-international.org/wp-content/uploads/ECMA-404_2nd_edition_december_2017.pdf")

"""
Added in 26.3.0. Per-slot resource allocation entry for a kernel.
Represents one row from the resource_allocations table.
"""
type KernelResourceAllocation implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """Resource slot identifier (e.g., 'cpu', 'mem', 'cuda.device')."""
  slotName: String!

  """Amount of this resource slot originally requested for the kernel."""
  requested: Decimal!

  """Amount currently used. May be null if not yet measured."""
  used: Decimal
}

"""An edge in a connection."""
type KernelResourceAllocationEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: KernelResourceAllocation!
}

"""
Added in 26.3.0. Filter criteria for querying kernel resource allocations.
"""
input KernelResourceAllocationFilter {
  slotName: StringFilter = null
  AND: [KernelResourceAllocationFilter!] = null
  OR: [KernelResourceAllocationFilter!] = null
  NOT: [KernelResourceAllocationFilter!] = null
}

"""
Added in 26.3.0. Ordering specification for kernel resource allocations.
"""
input KernelResourceAllocationOrderBy {
  field: KernelResourceAllocationOrderField!
  direction: OrderDirection! = ASC
}

"""
Added in 26.3.0. Fields available for ordering kernel resource allocations.
"""
enum KernelResourceAllocationOrderField {
  SLOT_NAME
  REQUESTED
  USED
}

"""
Added in 26.2.0. Represents a kernel (compute container) in Backend.AI.
"""
type KernelV2 implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """
  The UUID of the image used by this kernel. Null if the image has been purged.
  """
  imageId: ID

  """Startup command executed when the kernel starts."""
  startupCommand: String

  """Information about the session this kernel belongs to."""
  sessionInfo: KernelV2SessionInfo!

  """User and ownership information."""
  userInfo: KernelV2UserInfo!

  """Network configuration and exposed ports."""
  network: KernelV2NetworkInfo!

  """Cluster configuration for distributed computing."""
  cluster: KernelV2ClusterInfo!

  """Resource allocation and agent information."""
  resource: KernelV2ResourceInfo!

  """Lifecycle status and timestamps."""
  lifecycle: KernelV2LifecycleInfo!

  """Added in 26.2.0. The agent running this kernel."""
  agent: AgentV2

  """Added in 26.4.3. The image used by this kernel."""
  image: ImageV2

  """Added in 26.2.0. The user who owns this kernel."""
  user: UserV2

  """Added in 26.2.0. The project this kernel belongs to."""
  project: ProjectV2

  """Added in 26.2.0. The domain this kernel belongs to."""
  domain: DomainV2

  """Added in 26.2.0. The resource group this kernel is assigned to."""
  resourceGroup: ResourceGroup

  """Added in 26.3.0. The session this kernel belongs to."""
  session: SessionV2

  """Added in 26.3.0. Per-slot resource allocation for this kernel."""
  resourceAllocations(filter: KernelResourceAllocationFilter = null, orderBy: [KernelResourceAllocationOrderBy!] = null, first: Int = null, after: String = null, last: Int = null, before: String = null, limit: Int = null, offset: Int = null): ResourceAllocationConnection
}

"""
Added in 26.2.0. Cluster configuration for a kernel in distributed sessions.
"""
type KernelV2ClusterInfo {
  """The role of this kernel in the cluster (e.g., main, sub)."""
  clusterRole: String!

  """The index of this kernel within the cluster (0-based)."""
  clusterIdx: Int!

  """The local rank of this kernel for distributed computing."""
  localRank: Int!

  """The hostname assigned to this kernel within the cluster network."""
  clusterHostname: String!
}

"""Added in 26.2.0. Connection type for paginated kernel results."""
type KernelV2Connection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [KernelV2Edge!]!
  count: Int!
}

"""An edge in a connection."""
type KernelV2Edge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: KernelV2!
}

"""Added in 26.2.0. Filter criteria for querying kernels."""
input KernelV2Filter {
  id: UUIDFilter = null
  status: KernelV2StatusFilter = null
  sessionId: UUIDFilter = null
  AND: [KernelV2Filter!] = null
  OR: [KernelV2Filter!] = null
  NOT: [KernelV2Filter!] = null
}

"""Added in 26.2.0. Lifecycle and status information for a kernel."""
type KernelV2LifecycleInfo {
  """Current status of the kernel."""
  status: KernelV2Status!

  """The result of the kernel execution."""
  result: SessionV2Result!

  """Timestamp when the kernel was created."""
  createdAt: DateTime

  """Timestamp when the kernel was terminated."""
  terminatedAt: DateTime

  """Scheduled start time for the kernel, if applicable."""
  startsAt: DateTime
}

"""Added in 26.2.0. Network configuration for a kernel."""
type KernelV2NetworkInfo {
  """
  Collection of service ports exposed by this kernel. Typed as Any because this field holds a nested GQL type (ServicePortsGQL).
  """
  servicePorts: ServicePorts

  """List of ports that are pre-opened for this kernel."""
  preopenPorts: [Int!]
}

"""Added in 26.2.0. Ordering specification for kernels."""
input KernelV2OrderBy {
  field: KernelV2OrderField!
  direction: OrderDirection! = DESC
}

"""Added in 26.2.0. Fields available for ordering kernels."""
enum KernelV2OrderField {
  CREATED_AT
  TERMINATED_AT
  STATUS
  CLUSTER_MODE
  CLUSTER_HOSTNAME
  CLUSTER_IDX
}

"""Added in 26.2.0. Resource allocation information for a kernel."""
type KernelV2ResourceInfo {
  """
  The ID of the agent running this kernel. Null if not yet assigned or hidden.
  """
  agentId: String

  """The resource group (scaling group) this kernel is assigned to."""
  resourceGroupName: String

  """The container ID on the agent."""
  containerId: String

  """
  Resource allocation with requested and used slots. Typed as Any because this field holds a nested GQL type (ResourceAllocationGQL).
  """
  allocation: ResourceAllocation!

  """
  The fractional resource shares occupied by this kernel. Typed as Any because this field holds a nested GQL type (ResourceSlotGQL).
  """
  shares: ResourceSlot!

  """
  Additional resource options and configurations. Typed as Any because this field holds a nested GQL type (ResourceOptsGQL).
  """
  resourceOpts: ResourceOpts
}

"""Added in 26.2.0. Information about the session this kernel belongs to."""
type KernelV2SessionInfo {
  """The unique identifier of the session this kernel belongs to."""
  sessionId: UUID!

  """The creation ID used when creating the session."""
  creationId: String

  """The name of the session."""
  name: String

  """The type of session (interactive, batch, inference, system)."""
  sessionType: SessionTypes!
}

"""Added in 26.2.0. Status of a kernel in its lifecycle."""
enum KernelV2Status {
  PENDING
  SCHEDULED
  PREPARING
  PREPARED
  CREATING
  RUNNING
  TERMINATING
  TERMINATED
  CANCELLED
}

"""Added in 26.2.0. Filter for kernel status."""
input KernelV2StatusFilter {
  equals: KernelV2Status = null

  """The in  field."""
  in: [KernelV2Status!] = null

  """Excludes exact status match."""
  notEquals: KernelV2Status = null
  notIn: [KernelV2Status!] = null
}

"""Added in 26.2.0. User and ownership information for a kernel."""
type KernelV2UserInfo {
  """The UUID of the user who owns this kernel."""
  userId: UUID

  """The access key used to create this kernel."""
  accessKey: String

  """The domain this kernel belongs to."""
  domainName: String

  """The group (project) ID this kernel belongs to."""
  groupId: UUID
}

"""
Added in 26.4.2. Paginated connection for keypair records. Provides relay-style cursor-based pagination. Use 'edges' to access individual records with cursor information.
"""
type KeyPairConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [KeyPairGQLEdge!]!

  """Total number of keypair records matching the query criteria."""
  count: Int!
}

"""
Added in 26.4.2. Keypair entity representing an API access key. The access_key field serves as the unique identifier. Secret key and private SSH key are excluded for security reasons.
"""
type KeyPairGQL implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """The access key string."""
  accessKey: String!

  """Whether the keypair is currently active."""
  isActive: Boolean

  """Whether the keypair has admin privileges."""
  isAdmin: Boolean

  """Timestamp when the keypair was created."""
  createdAt: DateTime

  """Timestamp when the keypair was last modified."""
  modifiedAt: DateTime

  """Timestamp when the keypair was last used for an API call."""
  lastUsed: DateTime

  """API rate limit (requests per minute)."""
  rateLimit: Int!

  """Total number of API queries made with this keypair."""
  numQueries: Int!

  """Name of the resource policy assigned to this keypair."""
  resourcePolicy: String!

  """The SSH public key associated with this keypair."""
  sshPublicKey: String

  """UUID of the user who owns this keypair."""
  userId: UUID!

  """Added in 26.4.3. The user who owns this keypair."""
  user: UserV2
}

"""An edge in a connection."""
type KeyPairGQLEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: KeyPairGQL!
}

"""
Added in 26.4.2. Filter input for keypair queries. Supports filtering by active state, admin flag, and access key. Multiple filters can be combined using AND, OR, and NOT logical operators.
"""
input KeypairFilter {
  isActive: Boolean = null
  isAdmin: Boolean = null
  accessKey: StringFilter = null
  resourcePolicy: StringFilter = null
  createdAt: DateTimeFilter = null
  lastUsed: DateTimeFilter = null
  AND: [KeypairFilter!] = null
  OR: [KeypairFilter!] = null
  NOT: [KeypairFilter!] = null
}

"""
Added in 26.4.2. Specifies ordering for keypair query results. Default direction is DESC.
"""
input KeypairOrderBy {
  field: KeypairOrderField! = CREATED_AT
  direction: OrderDirection! = DESC
}

"""
Added in 26.4.2. Fields available for ordering keypair query results. CREATED_AT: Order by creation timestamp. LAST_USED: Order by last used timestamp. ACCESS_KEY: Order by access key alphabetically. IS_ACTIVE: Order by active status.
"""
enum KeypairOrderField {
  CREATED_AT
  LAST_USED
  ACCESS_KEY
  IS_ACTIVE
  RESOURCE_POLICY
}

"""Added in 26.4.2. Payload for keypair resource allocation query."""
type KeypairResourceAllocationV2 {
  """Keypair resource usage."""
  keypair: ScopeResourceUsageV2!
}

"""
Added in 26.4.2. Keypair resource policy defining session and storage limits for API keypairs.
"""
type KeypairResourcePolicyV2 implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """Policy name."""
  name: String!

  """Timestamp when the policy was created."""
  createdAt: DateTime

  """
  Default resource allocation for unspecified slots (LIMITED or UNLIMITED).
  """
  defaultForUnspecified: String!

  """Total resource slot limits for sessions."""
  totalResourceSlots: [ResourceLimitEntry!]!

  """Maximum session lifetime in seconds."""
  maxSessionLifetime: Int!

  """Maximum concurrent sessions allowed."""
  maxConcurrentSessions: Int!

  """Maximum pending sessions. Null means unlimited."""
  maxPendingSessionCount: Int

  """Maximum resource slots for pending sessions. Null means unlimited."""
  maxPendingSessionResourceSlots: [ResourceLimitEntry!]

  """Maximum concurrent SFTP sessions allowed."""
  maxConcurrentSftpSessions: Int!

  """Maximum containers allowed per session."""
  maxContainersPerSession: Int!

  """Idle timeout for sessions in seconds."""
  idleTimeout: Int!

  """Allowed vfolder host permissions."""
  allowedVfolderHosts: [VFolderHostPermissionEntry!]!
}

"""Added in 26.4.2. Paginated connection for keypair resource policies."""
type KeypairResourcePolicyV2Connection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [KeypairResourcePolicyV2Edge!]!

  """Total number of matching policies."""
  count: Int!
}

"""An edge in a connection."""
type KeypairResourcePolicyV2Edge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: KeypairResourcePolicyV2!
}

"""Added in 26.4.2. Filter for keypair resource policies."""
input KeypairResourcePolicyV2Filter {
  name: StringFilter = null
  createdAt: DateTimeFilter = null
  maxSessionLifetime: IntFilter = null
  maxConcurrentSessions: IntFilter = null
  maxContainersPerSession: IntFilter = null
  idleTimeout: IntFilter = null
  maxConcurrentSftpSessions: IntFilter = null
  maxPendingSessionCount: IntFilter = null
}

"""Added in 26.4.2. Ordering specification for keypair resource policies."""
input KeypairResourcePolicyV2OrderBy {
  """Field to order by."""
  field: KeypairResourcePolicyV2OrderField! = CREATED_AT

  """Sort direction."""
  direction: OrderDirection! = DESC
}

"""
Added in 26.4.2. Fields available for ordering keypair resource policies.
"""
enum KeypairResourcePolicyV2OrderField {
  NAME
  CREATED_AT
  MAX_SESSION_LIFETIME
  MAX_CONCURRENT_SESSIONS
  MAX_CONTAINERS_PER_SESSION
  IDLE_TIMEOUT
  MAX_CONCURRENT_SFTP_SESSIONS
  MAX_PENDING_SESSION_COUNT
}

"""Added in 26.4.2. Input for listing files in a virtual folder."""
input ListFilesV2Input {
  """Directory path to list files from."""
  path: String!
}

"""
Added in 26.4.2. Payload returned after listing files in a virtual folder.
"""
type ListFilesV2Payload {
  """List of file entries"""
  items: [VFolderFileEntryV2!]!
}

"""
Added in 25.19.0. This enum represents the liveness status of a replica, indicating whether the deployment is currently running and able to serve requests.
"""
enum LivenessStatus {
  NOT_CHECKED
  HEALTHY
  UNHEALTHY
  DEGRADED
}

"""Added in 26.4.2. Result of a login attempt."""
enum LoginAttemptResult {
  SUCCESS
  FAILED_INVALID_CREDENTIALS
  FAILED_USER_INACTIVE
  FAILED_BLOCKED
  FAILED_PASSWORD_EXPIRED
  FAILED_REJECTED_BY_HOOK
  FAILED_SESSION_ALREADY_EXISTS
  LOGOUT
  REVOKED_BY_ADMIN
  REVOKED_BY_USER
  EVICTED
  EXPIRED
}

"""
Added in 26.4.2. A registered login client type that the auth flow can attribute sessions to.
"""
type LoginClientType implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """Unique login client type name (e.g. 'core', 'webui')."""
  name: String!

  """Optional administrator-facing description."""
  description: String
}

"""Added in 26.4.2. Paginated connection for login client type records."""
type LoginClientTypeConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [LoginClientTypeEdge!]!

  """Total number of login client type records matching the query criteria."""
  count: Int!
}

"""An edge in a connection."""
type LoginClientTypeEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: LoginClientType!
}

"""Added in 26.4.2. Filter input for querying login client types."""
input LoginClientTypeFilter {
  """Filter by name."""
  name: StringFilter = null

  """Filter by description."""
  description: StringFilter = null

  """Filter by creation datetime."""
  createdAt: DateTimeFilter = null

  """Filter by last modification datetime."""
  modifiedAt: DateTimeFilter = null
}

"""Added in 26.4.2. Specifies ordering for login client type results."""
input LoginClientTypeOrderBy {
  """The field to order by."""
  field: LoginClientTypeOrderField!

  """Sort direction."""
  direction: OrderDirection! = DESC
}

"""
Added in 26.4.2. Fields available for ordering login client type results.
"""
enum LoginClientTypeOrderField {
  NAME
  CREATED_AT
  MODIFIED_AT
}

"""Added in 26.4.2. Filter criteria for querying login history."""
input LoginHistoryFilter {
  domainName: StringFilter = null
  result: LoginHistoryResultFilter = null
  createdAt: DateTimeFilter = null
  AND: [LoginHistoryFilter!] = null
  OR: [LoginHistoryFilter!] = null
  NOT: [LoginHistoryFilter!] = null
}

"""Added in 26.4.2. Ordering specification for login history."""
input LoginHistoryOrderBy {
  field: LoginHistoryOrderField!
  direction: OrderDirection! = DESC
}

"""Added in 26.4.2. Fields available for ordering login history."""
enum LoginHistoryOrderField {
  CREATED_AT
  RESULT
  DOMAIN_NAME
}

"""Added in 26.4.2. Filter for login attempt result field."""
input LoginHistoryResultFilter {
  equals: LoginAttemptResult = null

  """The in field."""
  in: [LoginAttemptResult!] = null

  """Excludes exact result match."""
  notEquals: LoginAttemptResult = null
  notIn: [LoginAttemptResult!] = null
}

"""
Added in 26.4.2. Represents a login history entry tracking user authentication attempts.
"""
type LoginHistoryV2 implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """UUID of the user who attempted to log in."""
  userId: UUID!

  """Domain name of the user at the time of the attempt."""
  domainName: String!

  """Result of the login attempt."""
  result: LoginAttemptResult!

  """Detailed reason for the login failure."""
  failReason: String

  """Timestamp when the login attempt occurred."""
  createdAt: DateTime!

  """Added in 26.4.3. The user who attempted to log in."""
  user: UserV2

  """Added in 26.4.3. The domain at the time of the login attempt."""
  domain: DomainV2
}

"""Added in 26.4.2. Connection type for paginated login history results."""
type LoginHistoryV2Connection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [LoginHistoryV2Edge!]!

  """Total number of login history entries matching the query."""
  count: Int!
}

"""An edge in a connection."""
type LoginHistoryV2Edge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: LoginHistoryV2!
}

"""Added in 26.4.2. Filter criteria for querying login sessions."""
input LoginSessionFilter {
  userId: UUIDFilter = null
  status: LoginSessionStatusFilter = null
  accessKey: StringFilter = null
  createdAt: DateTimeFilter = null
  lastAccessedAt: DateTimeFilter = null
  AND: [LoginSessionFilter!] = null
  OR: [LoginSessionFilter!] = null
  NOT: [LoginSessionFilter!] = null
}

"""Added in 26.4.2. Ordering specification for login sessions."""
input LoginSessionOrderBy {
  field: LoginSessionOrderField!
  direction: OrderDirection! = DESC
}

"""Added in 26.4.2. Fields available for ordering login sessions."""
enum LoginSessionOrderField {
  CREATED_AT
  STATUS
  LAST_ACCESSED_AT
}

"""Added in 26.4.2. Status of a login session."""
enum LoginSessionStatus {
  ACTIVE
  INVALIDATED
  REVOKED
}

"""Added in 26.4.2. Filter for login session status field."""
input LoginSessionStatusFilter {
  equals: LoginSessionStatus = null

  """The in field."""
  in: [LoginSessionStatus!] = null

  """Excludes exact status match."""
  notEquals: LoginSessionStatus = null
  notIn: [LoginSessionStatus!] = null
}

"""
Added in 26.4.2. Represents a login session entry tracking user authentication sessions.
"""
type LoginSessionV2 implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """UUID of the user who owns the session."""
  userId: UUID!

  """Access key associated with the session."""
  accessKey: String!

  """Current status of the login session."""
  status: LoginSessionStatus!

  """Timestamp when the session was created."""
  createdAt: DateTime!

  """Timestamp when the session was last accessed."""
  lastAccessedAt: DateTime

  """Timestamp when the session was invalidated."""
  invalidatedAt: DateTime

  """Added in 26.4.3. The user who owns this login session."""
  user: UserV2
}

"""Added in 26.4.2. Connection type for paginated login session results."""
type LoginSessionV2Connection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [LoginSessionV2Edge!]!

  """Total number of login sessions matching the query."""
  count: Int!
}

"""An edge in a connection."""
type LoginSessionV2Edge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: LoginSessionV2!
}

"""Added in 26.3.0. Key-value label entry from Prometheus result."""
type MetricLabelEntry {
  """Label key"""
  key: String!

  """Label value"""
  value: String!
}

"""Added in 26.3.0. Key-value label entry for queries."""
input MetricLabelEntryInput {
  """Label key."""
  key: String!

  """Label value."""
  value: String!
}

"""
Added in 26.4.2. Input for creating directories inside a virtual folder.
"""
input MkdirV2Input {
  """Directory path(s) to create."""
  path: [String!]!

  """Create parent directories if needed."""
  parents: Boolean! = true

  """Do not raise error if directory exists."""
  existOk: Boolean! = false
}

"""
Added in 26.4.2. Payload returned after creating directories in a virtual folder.
"""
type MkdirV2Payload {
  """List of created directory paths"""
  results: [String!]!
}

"""
Added in 26.4.2. Scope for querying available presets that satisfy a model card's resource requirements.
"""
input ModelCardAvailablePresetsScope {
  """Model card UUID to check resource requirements against."""
  modelCardId: UUID!
}

"""
Added in 26.4.2. Represents a registered AI model with metadata extracted from model-definition.yaml. A model card links to a VFolder containing the actual model files and belongs to a MODEL_STORE type project for access control scoping.
"""
type ModelCardV2 implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """Display name of the registered model."""
  name: String!

  """
  The VFolder that stores the actual model files, weights, and configuration.
  """
  vfolderId: UUID!

  """
  The domain this model card belongs to, used for access control scoping.
  """
  domainName: String!

  """
  The MODEL_STORE type project this model card is associated with for access control.
  """
  projectId: UUID!

  """The user who registered this model card."""
  creatorId: UUID!

  """
  Model metadata including authorship, classification, framework info, and licensing extracted from model-definition.yaml.
  """
  metadata: ModelCardV2Metadata!

  """
  Minimum resource requirements for serving this model. Each entry maps a resource slot (e.g. 'cpu', 'cuda.shares') to its minimum required quantity. Used to filter compatible deployment revision presets via `available_presets`.
  """
  minResource: [ModelCardV2ResourceSlotEntry!]

  """
  README content from the model VFolder, typically containing usage instructions and model documentation.
  """
  readme: String

  """Access level of the model card (public or internal)."""
  accessLevel: ModelCardV2AccessLevel!

  """Timestamp when this model card was registered."""
  createdAt: DateTime!

  """Timestamp of the last modification to this model card."""
  updatedAt: DateTime

  """
  The VFolder that stores this model card's files. Resolved through a DataLoader so that listing many model cards does not trigger N+1 fetches.
  """
  vfolder: VFolder

  """Added in 26.4.3. The domain this model card belongs to."""
  domain: DomainV2

  """Added in 26.4.3. The project this model card belongs to."""
  project: ProjectV2

  """Added in 26.4.3. The user who created this model card."""
  creator: UserV2

  """
  Deployment revision presets that satisfy this model card's minimum resource requirements. Equivalent to the root `model_card_available_presets` query but scoped to this card.
  """
  availablePresets(filter: DeploymentRevisionPresetFilter = null, orderBy: [DeploymentRevisionPresetOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): DeploymentRevisionPresetConnection
}

"""Added in 26.4.2. Access level for model cards."""
enum ModelCardV2AccessLevel {
  PUBLIC
  INTERNAL
}

"""Added in 26.4.2. Paginated list of model cards."""
type ModelCardV2Connection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [ModelCardV2Edge!]!
  count: Int!
}

"""An edge in a connection."""
type ModelCardV2Edge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: ModelCardV2!
}

"""Added in 26.4.2. Filter for model cards."""
input ModelCardV2Filter {
  """Name filter."""
  name: StringFilter = null

  """Domain filter."""
  domainName: StringFilter = null

  """Project filter."""
  projectId: UUIDFilter = null

  """
  Filter by the storage host backing the model card's VFolder. Matches via an EXISTS subquery against the VFolder host column.
  """
  storageHost: StringFilter = null

  """Combine nested filters with logical AND."""
  AND: [ModelCardV2Filter!] = null

  """Combine nested filters with logical OR."""
  OR: [ModelCardV2Filter!] = null

  """Negate the combined result of nested filters."""
  NOT: [ModelCardV2Filter!] = null
}

"""
Added in 26.4.2. Metadata extracted from the model-definition.yaml file in the model VFolder. Contains authorship, classification, and framework information used for discovery and compatibility checks.
"""
type ModelCardV2Metadata {
  author: String
  title: String
  modelVersion: String
  description: String
  task: String
  category: String
  architecture: String
  framework: [String!]!
  label: [String!]!
  license: String
}

"""Added in 26.4.2. Order specification."""
input ModelCardV2OrderBy {
  """Field to order by."""
  field: ModelCardV2OrderField!

  """ASC or DESC."""
  direction: String! = "ASC"
}

"""Added in 26.4.2. Order fields for model cards."""
enum ModelCardV2OrderField {
  NAME
  CREATED_AT
}

"""
Added in 26.4.2. A single resource requirement entry for a model card. The quantity is represented as a string because model card requirements are descriptive (display/matching) rather than arithmetic.
"""
type ModelCardV2ResourceSlotEntry {
  """Resource type name."""
  resourceType: String!

  """Resource quantity."""
  quantity: String!
}

"""
Added in 26.4.2. Configuration for a single model in the model definition.
"""
type ModelConfig {
  """Name of the model."""
  name: String!

  """Path to the model file."""
  modelPath: String!

  """Configuration for the model service."""
  service: ModelServiceConfig

  """Metadata about the model."""
  metadata: ModelMetadata
}

"""
Added in 26.4.0. Configuration for a single model within a model definition.
"""
input ModelConfigInput {
  """Name of the model."""
  name: String = null

  """Path to the model file."""
  modelPath: String = null

  """Configuration for the model service."""
  service: ModelServiceConfigInput = null

  """Metadata about the model."""
  metadata: ModelMetadataInput = null
}

"""
Added in 26.4.2. Model definition containing one or more model entries.
"""
type ModelDefinition {
  """List of models in the model definition."""
  models: [ModelConfig!]!
}

"""
Added in 26.4.0. Model definition containing a list of model configurations.
"""
input ModelDefinitionInput {
  """List of models in the model definition."""
  models: [ModelConfigInput!] = null
}

"""
Added in 25.19.0. Represents a model deployment in Backend.AI. A deployment is a long-running inference service that exposes a trained model via HTTP endpoints. Deployments manage the lifecycle of model replicas, handle traffic routing, and provide auto-scaling capabilities based on configured rules.
"""
type ModelDeployment implements Node {
  """The Globally Unique ID of this object"""
  id: ID!
  metadata: ModelDeploymentMetadata!
  networkAccess: ModelDeploymentNetworkAccess!
  currentRevisionId: ID
  deployingRevisionId: ID
  defaultDeploymentStrategy: DeploymentStrategyGQL!
  replicaState: ReplicaState!
  createdUserId: ID!
  options: DeploymentOptionsInfoGQL!

  """
  Added in UNRELEASED. Replica scaling axis, orthogonal to ``metadata.status`` (lifecycle). ``SCALING`` while the replica reconciler is adjusting replica count; ``STABLE`` once holding at the desired count.
  """
  scalingState: ScalingState!

  """
  Added in UNRELEASED. Sub-step within the current lifecycle phase. ``None`` when the deployment is not in a sub-step-bearing phase.
  """
  subStep: DeploymentLifecycleSubStep

  """
  Added in 26.4.3. The current active revision of this deployment, resolved via DataLoader.
  """
  currentRevision: ModelRevision

  """
  Added in 26.4.3. The revision currently being deployed (in progress, not yet active), resolved via DataLoader.
  """
  deployingRevision: ModelRevision

  """
  Added in 26.4.3. The user who created this deployment, resolved via DataLoader.
  """
  creator: UserV2

  """Added in 25.19.0. Deployment policy configuration."""
  deploymentPolicy: DeploymentPolicy

  """The revision history of this entity."""
  revisionHistory(filter: ModelRevisionFilter = null, orderBy: [ModelRevisionOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): ModelRevisionConnection

  """The replicas of this entity."""
  replicas(filter: ReplicaFilter = null, orderBy: [ReplicaOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): ModelReplicaConnection

  """The auto scaling rules of this entity."""
  autoScalingRules(filter: AutoScalingRuleFilter = null, orderBy: [AutoScalingRuleOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): AutoScalingRuleConnection

  """The access tokens of this entity."""
  accessTokens(filter: AccessTokenFilter = null, orderBy: [AccessTokenOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): AccessTokenConnection
}

"""Added in 25.19.0. Connection for model deployments."""
type ModelDeploymentConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [ModelDeploymentEdge!]!
  count: Int!
}

"""An edge in a connection."""
type ModelDeploymentEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: ModelDeployment!
}

"""
Added in 25.19.0. Contains metadata information for a model deployment including its name, status, tags, and timestamps. Also provides access to the associated project and domain.
"""
type ModelDeploymentMetadata {
  """
  Added in UNRELEASED. The resource group this deployment runs in, resolved via DataLoader.
  """
  resourceGroup: ResourceGroup

  """The project of this entity."""
  project: GroupNode @deprecated(reason: "Use project_v2 instead.")

  """
  Added in 26.4.3. The project this deployment belongs to, resolved via DataLoader.
  """
  projectV2: ProjectV2

  """The domain of this entity."""
  domain: DomainNode @deprecated(reason: "Use domain_v2 instead.")

  """
  Added in 26.4.3. The domain this deployment belongs to, resolved via DataLoader.
  """
  domainV2: DomainV2
  projectId: ID!
  domainName: String!
  name: String!
  status: DeploymentStatus!
  tags: [String!]!
  resourceGroupName: String!
  createdAt: DateTime!
  updatedAt: DateTime!
}

"""Added in 25.19.0. """
input ModelDeploymentMetadataInput {
  projectId: ID!
  domainName: String!
  resourceGroupName: String!
  name: String = null
  tags: [String!] = null
}

"""
Added in 25.19.0. Provides network access configuration for a model deployment, including the endpoint URL, preferred domain name, and public access settings. Also manages access tokens for authentication.
"""
type ModelDeploymentNetworkAccess {
  endpointUrl: String
  preferredDomainName: String
  openToPublic: Boolean!
}

"""Added in 25.19.0. """
input ModelDeploymentNetworkAccessInput {
  preferredDomainName: String = null
  openToPublic: Boolean! = false
}

"""Added in 26.4.2. Health check configuration for a model service."""
type ModelHealthCheck {
  """Interval in seconds between health checks."""
  interval: Float!

  """Path to check for health status."""
  path: String!

  """Maximum number of retries for health check."""
  maxRetries: Int!

  """Maximum time in seconds to wait for a health check response."""
  maxWaitTime: Float!

  """Expected HTTP status code for a healthy response."""
  expectedStatusCode: Int!

  """Initial delay in seconds before the first health check."""
  initialDelay: Float!
}

"""Added in 26.4.0. Health check configuration for a model service."""
input ModelHealthCheckInput {
  """Interval in seconds between health checks."""
  interval: Float = null

  """Path to check for health status."""
  path: String = null

  """Maximum number of retries for health check."""
  maxRetries: Int = null

  """Maximum time in seconds to wait for a health check response."""
  maxWaitTime: Float = null

  """Expected HTTP status code for a healthy response."""
  expectedStatusCode: Int = null

  """Initial delay in seconds before the first health check."""
  initialDelay: Float = null
}

"""Added in 26.4.2. Metadata describing a model entry."""
type ModelMetadata {
  """Author of the model."""
  author: String

  """Title of the model."""
  title: String

  """Version identifier of the model."""
  version: JSON

  """Creation date of the model."""
  created: String

  """Last modification date of the model."""
  lastModified: String

  """Description of the model."""
  description: String

  """Task type of the model."""
  task: String

  """Category of the model."""
  category: String

  """Architecture metadata for the model."""
  architecture: String

  """Frameworks used by the model."""
  framework: [String!]

  """Labels attached to the model."""
  label: [String!]

  """License of the model."""
  license: String

  """Minimum resource requirements for the model."""
  minResource: JSON
}

"""
Added in 26.4.0. Metadata about a model such as author, title, and resource requirements.
"""
input ModelMetadataInput {
  """Author of the model."""
  author: String = null

  """Title of the model."""
  title: String = null

  """Version of the model."""
  version: String = null

  """Creation date of the model."""
  created: String = null

  """Last modified date of the model."""
  lastModified: String = null

  """Description of the model."""
  description: String = null

  """Task type of the model."""
  task: String = null

  """Category of the model."""
  category: String = null

  """Architecture of the model."""
  architecture: String = null

  """Frameworks used by the model."""
  framework: [String!] = null

  """Labels for the model."""
  label: [String!] = null

  """License of the model."""
  license: String = null

  """Minimum resource requirements for the model."""
  minResource: JSON = null
}

"""
Added in 25.19.0. Configuration for mounting the model data into the inference container. Specifies the virtual folder, mount destination, and model definition path.
"""
type ModelMountConfig {
  """The vfolder of this entity."""
  vfolder: VirtualFolderNode
  vfolderId: ID!
  mountDestination: String!
  definitionPath: String!

  """
  Added in UNRELEASED. Subpath within the model vfolder. ``None`` means the vfolder root.
  """
  subpath: String
}

"""Added in 25.19.0. """
input ModelMountConfigInput {
  vfolderId: ID!
  mountDestination: String!
  definitionPath: String = null

  """
  Added in UNRELEASED. Subpath within the model vfolder. ``null`` (default) mounts the vfolder root.
  """
  subpath: String = null
}

"""
Added in 25.19.0. A single replica instance of a model deployment. Each replica runs in a separate compute session and serves inference requests. Replicas have health status indicators (readiness, liveness, activeness).
"""
type ModelReplica implements Node {
  """The Globally Unique ID of this object"""
  id: ID!
  sessionId: ID
  revisionId: ID!

  """Whether the replica has been checked and its health state."""
  readinessStatus: ReadinessStatus!

  """Whether the replica is currently running and able to serve requests."""
  livenessStatus: LivenessStatus!

  """Whether the replica is actively receiving traffic."""
  activenessStatus: ActivenessStatus!

  """
  Added in UNRELEASED. Provisioning status of the replica (mirrors the underlying route status).
  """
  status: ReplicaStatus!

  """Added in UNRELEASED. Traffic status of the replica."""
  trafficStatus: TrafficStatus!

  """Added in UNRELEASED. Health check status of the replica."""
  healthStatus: ReplicaHealthStatus!

  """Timestamp when the replica was created."""
  createdAt: DateTime!

  """
  The session associated with the replica. Can be null if the replica is still provisioning.
  """
  session: ComputeSessionNode @deprecated(reason: "Use session_v2 instead.")

  """
  Added in 26.4.3. The compute session running this replica, resolved via DataLoader.
  """
  sessionV2: SessionV2

  """The revision of this entity."""
  revision: ModelRevision
}

"""
Added in 25.19.0. A Relay-style connection for paginated access to model replicas. Includes total count for UI pagination display.
"""
type ModelReplicaConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [ModelReplicaEdge!]!
  count: Int!
}

"""An edge in a connection."""
type ModelReplicaEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: ModelReplica!
}

"""
Added in 25.19.0. Represents a versioned configuration snapshot of a model deployment. Each revision captures the complete configuration including cluster settings, resource allocations, runtime configuration, and model mount settings. Revisions enable version control and rollback capabilities for deployments.
"""
type ModelRevision implements Node {
  """The Globally Unique ID of this object"""
  id: ID!
  imageId: ID!

  """
  Added in UNRELEASED. Per-deployment sequential revision number assigned at insert time (UNIQUE per deployment). Use this to surface 'Revision #N' labels and to order revisions client-side.
  """
  revisionNumber: Int!

  """Cluster configuration for replica distribution."""
  clusterConfig: ClusterConfig!

  """Compute resource allocation settings."""
  resourceConfig: ResourceConfig!

  """Runtime configuration for the inference framework."""
  modelRuntimeConfig: ModelRuntimeConfig!

  """Model data mount configuration."""
  modelMountConfig: ModelMountConfig

  """Added in 26.4.2. Resolved model definition stored for this revision."""
  modelDefinition: ModelDefinition

  """Additional volume folder mounts."""
  extraMounts: [ExtraVFolderMountInfoGQL!]!

  """
  Added in UNRELEASED. ID of the deployment-level preset that produced this revision. ``None`` when the revision was created without a preset, when the originating preset row has since been deleted (SET NULL FK), or for legacy rows that predate this field.
  """
  revisionPresetId: UUID

  """
  Added in UNRELEASED. ID of the parent deployment that owns this revision. Exposed alongside the resolved ``deployment`` node so clients can navigate without re-fetching.
  """
  deploymentId: ID!

  """Timestamp when the revision was created."""
  createdAt: DateTime!

  """The image of this entity."""
  image: ImageNode @deprecated(reason: "Use image_v2 instead.")

  """
  Added in 26.4.3. The container image used by this revision, resolved via DataLoader.
  """
  imageV2: ImageV2

  """
  Added in UNRELEASED. The deployment-level preset that produced this revision, resolved via DataLoader. ``None`` when the revision was created without a preset, when the originating preset row has since been deleted (SET NULL FK), or for legacy rows that predate this field.
  """
  revisionPreset: DeploymentRevisionPreset

  """
  Added in UNRELEASED. The parent deployment owning this revision, resolved via DataLoader.
  """
  deployment: ModelDeployment

  """Added in 26.4.2. Resource slot allocations for this revision."""
  resourceSlots(filter: AllocatedResourceSlotFilter = null, orderBy: [AllocatedResourceSlotOrderBy!] = null): [AllocatedResourceSlot!]
}

"""Added in 25.19.0. Connection for model revisions."""
type ModelRevisionConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [ModelRevisionEdge!]!
  count: Int!
}

"""An edge in a connection."""
type ModelRevisionEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: ModelRevision!
}

"""Added in 25.19.0. """
input ModelRevisionFilter {
  revisionNumber: IntFilter = null
  deploymentId: ID = null

  """Added in 26.4.3. Filter by container image ID."""
  imageId: UUIDFilter = null

  """Added in 26.4.3. Filter by model VFolder ID."""
  modelVfolderId: UUIDFilter = null

  """Added in 26.4.3. Filter by resource group name."""
  resourceGroup: StringFilter = null

  """Added in 26.4.3. Filter by cluster mode (SINGLE_NODE / MULTI_NODE)."""
  clusterMode: StringFilter = null

  """Added in 26.4.3. Filter by revision creation datetime."""
  createdAt: DateTimeFilter = null
  AND: [ModelRevisionFilter!] = null
  OR: [ModelRevisionFilter!] = null
  NOT: [ModelRevisionFilter!] = null
}

"""Added in 25.19.0. """
input ModelRevisionOrderBy {
  field: ModelRevisionOrderField!
  direction: OrderDirection! = DESC
}

"""Added in 25.19.0. Fields available for ordering model revisions."""
enum ModelRevisionOrderField {
  REVISION_NUMBER
  CREATED_AT
  RESOURCE_GROUP
  CLUSTER_MODE
  RUNTIME_VARIANT_NAME
}

"""
Added in 25.19.0. Runtime configuration for the inference framework. Includes the runtime variant, framework-specific configuration, and environment variables.
"""
type ModelRuntimeConfig {
  """
  Added in UNRELEASED. The runtime variant referenced by this runtime config.
  """
  runtimeVariant: RuntimeVariant
  runtimeVariantId: UUID!
  inferenceRuntimeConfig: JSON
  environ: EnvironmentVariables
}

"""Added in 25.19.0. """
input ModelRuntimeConfigInput {
  runtimeVariantId: UUID!

  """Environment variables for the service."""
  environ: EnvironmentVariablesInput = null
}

"""Added in 26.4.2. Service configuration for a model entry."""
type ModelServiceConfig {
  """
  List of pre-start actions to execute before starting the model service.
  """
  preStartActions: [PreStartAction!]!

  """Command to start the model service."""
  startCommand: [String!]

  """Shell configured for the model service."""
  shell: String!

  """Port number for the model service."""
  port: Int!

  """Health check configuration for the model service."""
  healthCheck: ModelHealthCheck
}

"""
Added in 26.4.0. Service configuration for a model, including startup command and health check.
"""
input ModelServiceConfigInput {
  """
  List of pre-start actions to execute before starting the model service.
  """
  preStartActions: [PreStartActionInput!] = null

  """Command to start the model service."""
  startCommand: [String!] = null

  """Shell configured for the model service."""
  shell: String = null

  """Port number for the model service."""
  port: Int = null

  """Health check configuration for the model service."""
  healthCheck: ModelHealthCheckInput = null
}

"""
Added in 24.09.0. Specifies a target model for scanning operations.

Used to identify specific models in external registries for detailed scanning.
If revision is not specified, defaults to 'main' revision.
"""
input ModelTarget {
  modelId: String!
  revision: String = null
}

"""Added in 26.3.0. Input for modifying an existing query definition."""
input ModifyQueryDefinitionInput {
  """New name."""
  name: String

  """New description."""
  description: String

  """New sort rank."""
  rank: Int

  """New category UUID."""
  categoryId: UUID

  """New metric name."""
  metricName: String

  """New PromQL template."""
  queryTemplate: String

  """New default time window."""
  timeWindow: String

  """New query definition options."""
  options: ModifyQueryDefinitionOptionsInput
}

"""Added in 26.3.0. Options for modifying an existing query definition."""
input ModifyQueryDefinitionOptionsInput {
  """Allowed filter label keys."""
  filterLabels: [String!] = null

  """Allowed group-by label keys."""
  groupLabels: [String!] = null
}

"""Added in 26.3.0. Payload returned after modifying a query definition."""
type ModifyQueryDefinitionPayload {
  """Updated query definition."""
  preset: QueryDefinition!
}

"""
Added in 25.19.0. This enum represents the permission level for a mounted volume. It can be ro, rw, wd
"""
enum MountPermission {
  READ_ONLY
  READ_WRITE
  RW_DELETE
}

"""Added in 26.4.2. Input for moving a file inside a virtual folder."""
input MoveFileV2Input {
  """Source file path."""
  src: String!

  """Destination file path."""
  dst: String!
}

"""
Added in 26.4.2. Payload returned after moving a file in a virtual folder.
"""
type MoveFileV2Payload {
  """Source path that was moved"""
  src: String!

  """Destination path"""
  dst: String!
}

type Mutation {
  """
  Added in 25.14.0. Scan external registries to discover available artifacts. Searches HuggingFace or Reservoir registries for artifacts matching the specified criteria and registers them in the system with SCANNED status. The artifacts become available for import but are not downloaded until explicitly imported. This is the first step in the artifact workflow: Scan → Import → Use
  """
  scanArtifacts(input: ScanArtifactsInput!): ScanArtifactsPayload

  """
  Added in 25.14.0. Perform detailed scanning of specific models. Unlike the general scan_artifacts operation, this performs immediate detailed scanning of specified models including README content and file sizes. Returns artifact revisions with complete metadata ready for use
  """
  scanArtifactModels(input: ScanArtifactModelsInput!): ScanArtifactModelsPayload

  """
  Added in 25.14.0. Import scanned artifact revisions from external registries. Downloads the actual files for the specified artifact revisions, transitioning them from SCANNED → PULLING → VERIFYING → AVAILABLE status. Returns background tasks that can be monitored for import progress. Once AVAILABLE, artifacts can be used by users in their sessions
  """
  importArtifacts(input: ImportArtifactsInput!): ImportArtifactsPayload

  """
  Added in 25.16.0. Create or update user-level app configuration. The provided extra_config object will completely replace the existing configuration; existing keys not present in the new extra_config will be removed. These settings will override domain-level settings when configurations are merged for this user. If user_id is not provided, the current user's configuration will be updated. Users can only modify their own configuration, but admins can modify any user's configuration
  """
  upsertUserAppConfig(input: UpsertUserConfigInput!): UpsertUserConfigPayload

  """
  Added in 25.16.0. Delete user-level app configuration. After deletion, the user will still receive domain-level configuration values when configurations are merged, as domain settings remain unaffected. If user_id is not provided, the current user's configuration will be deleted. Users can only delete their own configuration, but admins can delete any user's configuration
  """
  deleteUserAppConfig(input: DeleteUserConfigInput!): DeleteUserConfigPayload

  """
  Added in 25.15.0. Triggers artifact scanning on a remote reservoir registry. This mutation instructs a reservoir-type registry to initiate a scan of artifacts from its associated remote reservoir registry source. The scan process will discover and catalog artifacts available in the remote reservoir, making them accessible through the local reservoir registry. Requirements: - The delegator registry must be of type 'reservoir' - The delegator reservoir registry must have a valid remote registry configuration
  """
  delegateScanArtifacts(input: DelegateScanArtifactsInput!): DelegateScanArtifactsPayload

  """
  Added in 25.15.0. Trigger import of artifact revisions from a remote reservoir registry. This mutation instructs a reservoir-type registry to import specific artifact revisions that were previously discovered during a scan from its remote registry. Note that this operation does not import the artifacts directly into the local registry, but only into the delegator reservoir's storage. Requirements: - The delegator registry must be of type 'reservoir' - The delegator registry must have a valid remote registry configuration
  """
  delegateImportArtifacts(input: DelegateImportArtifactsInput!): DelegateImportArtifactsPayload

  """
  Added in 25.14.0. Update artifact metadata properties. Modifies artifact metadata such as readonly status and description. This operation does not affect the actual artifact files or revisions
  """
  updateArtifact(input: UpdateArtifactInput!): UpdateArtifactPayload

  """
  Added in 25.15.0. Soft-delete artifacts from the system. Marks artifacts as deleted without permanently removing them. Deleted artifacts can be restored using the restore_artifacts mutation
  """
  deleteArtifacts(input: DeleteArtifactsInput!): DeleteArtifactsPayload

  """
  Added in 25.15.0. Restore previously deleted artifacts. Reverses the soft-delete operation, making the artifacts available again for use in the system
  """
  restoreArtifacts(input: RestoreArtifactsInput!): RestoreArtifactsPayload

  """
  Added in 25.14.0. Clean up stored artifact revision data to free storage space. Removes the downloaded files for the specified artifact revisions and transitions them back to SCANNED status. The metadata remains, allowing the artifacts to be re-imported later if needed. Use this operation to manage storage usage by removing unused artifacts
  """
  cleanupArtifactRevisions(input: CleanupArtifactRevisionsInput!): CleanupArtifactRevisionsPayload

  """
  Added in 25.14.0. Cancel an in-progress artifact import operation. Stops the download process for the specified artifact revision and reverts its status back to SCANNED. The partially downloaded data is cleaned up
  """
  cancelImportArtifact(input: CancelArtifactInput!): CancelImportArtifactPayload

  """Added in 26.4.2. Create a new container registry (admin only)."""
  adminCreateContainerRegistryV2(input: CreateContainerRegistryInputGQL!): CreateContainerRegistryPayloadGQL

  """Added in 26.4.2. Update a container registry (admin only)."""
  adminUpdateContainerRegistryV2(input: UpdateContainerRegistryInputGQL!): UpdateContainerRegistryPayloadGQL

  """Added in 26.4.2. Delete a container registry (admin only)."""
  adminDeleteContainerRegistryV2(id: String!): DeleteContainerRegistryPayloadGQL

  """Added in 25.16.0. Create model deployment."""
  createModelDeployment(input: CreateDeploymentInput!): CreateDeploymentPayload

  """Added in 25.16.0. Update model deployment."""
  updateModelDeployment(input: UpdateDeploymentInput!): UpdateDeploymentPayload

  """Added in 25.16.0. Delete model deployment."""
  deleteModelDeployment(input: DeleteDeploymentInput!): DeleteDeploymentPayload

  """
  Added in 25.16.0. Force syncs up-to-date replica information. In normal situations this will be automatically handled by Backend.AI schedulers.
  """
  syncReplicas(input: SyncReplicaInput!): SyncReplicaPayload

  """Added in 25.16.0. Add model revision."""
  addModelRevision(input: AddRevisionInput!): AddRevisionPayload

  """
  Added in 26.4.3. Rebuild and activate a fresh revision for every active deployment (superadmin). Used to repair deployments whose current revision has stale or missing model_definition after backing store migrations.
  """
  adminRefreshDeploymentRevisions: AdminRefreshDeploymentRevisionsPayload

  """
  Added in 26.4.2. Create or update the deployment policy for a given deployment (upsert semantics). If the deployment already has a policy, it is replaced entirely with the new configuration
  """
  updateDeploymentPolicy(input: UpdateDeploymentPolicyInput!): UpdateDeploymentPolicyPayload

  """Added in 26.4.2. Create a new notification channel (admin only)"""
  adminCreateNotificationChannel(input: CreateNotificationChannelInput!): CreateNotificationChannelPayload

  """Added in 26.4.2. Update a notification channel (admin only)"""
  adminUpdateNotificationChannel(input: UpdateNotificationChannelInput!): UpdateNotificationChannelPayload

  """Added in 26.4.2. Delete a notification channel (admin only)"""
  adminDeleteNotificationChannel(input: DeleteNotificationChannelInput!): DeleteNotificationChannelPayload

  """Added in 26.4.2. Validate a notification channel (admin only)"""
  adminValidateNotificationChannel(input: ValidateNotificationChannelInput!): ValidateNotificationChannelPayload

  """Added in 26.4.2. Create a new notification rule (admin only)"""
  adminCreateNotificationRule(input: CreateNotificationRuleInput!): CreateNotificationRulePayload

  """Added in 26.4.2. Update a notification rule (admin only)"""
  adminUpdateNotificationRule(input: UpdateNotificationRuleInput!): UpdateNotificationRulePayload

  """Added in 26.4.2. Delete a notification rule (admin only)"""
  adminDeleteNotificationRule(input: DeleteNotificationRuleInput!): DeleteNotificationRulePayload

  """Added in 26.4.2. Validate a notification rule (admin only)"""
  adminValidateNotificationRule(input: ValidateNotificationRuleInput!): ValidateNotificationRulePayload

  """
  Added in 26.2.0. Create or update domain-level app configuration (admin only). The provided extra_config object will completely replace the existing configuration; existing keys not present in the new extra_config will be removed. All users in this domain will be affected by these settings when their configurations are merged, unless they have user-level configurations that override specific keys
  """
  adminUpsertDomainAppConfig(input: UpsertDomainConfigInput!): UpsertDomainConfigPayload

  """
  Added in 26.2.0. Delete domain-level app configuration (admin only). All users in this domain may be affected by this deletion. After deletion, users will only receive their user-level configurations when configurations are merged, with no domain-level defaults
  """
  adminDeleteDomainAppConfig(input: DeleteDomainConfigInput!): DeleteDomainConfigPayload

  """Added in 26.4.2. Create a new notification channel"""
  createNotificationChannel(input: CreateNotificationChannelInput!): CreateNotificationChannelPayload @deprecated(reason: "Use admin_create_notification_channel instead. This API will be removed after v26.3.0. See BEP-1041 for migration guide.")

  """Added in 26.4.2. Update a notification channel"""
  updateNotificationChannel(input: UpdateNotificationChannelInput!): UpdateNotificationChannelPayload @deprecated(reason: "Use admin_update_notification_channel instead. This API will be removed after v26.3.0. See BEP-1041 for migration guide.")

  """Added in 26.4.2. Delete a notification channel"""
  deleteNotificationChannel(input: DeleteNotificationChannelInput!): DeleteNotificationChannelPayload @deprecated(reason: "Use admin_delete_notification_channel instead. This API will be removed after v26.3.0. See BEP-1041 for migration guide.")

  """Added in 26.4.2. Validate a notification channel"""
  validateNotificationChannel(input: ValidateNotificationChannelInput!): ValidateNotificationChannelPayload @deprecated(reason: "Use admin_validate_notification_channel instead. This API will be removed after v26.3.0. See BEP-1041 for migration guide.")

  """Added in 26.4.2. Create a new notification rule"""
  createNotificationRule(input: CreateNotificationRuleInput!): CreateNotificationRulePayload @deprecated(reason: "Use admin_create_notification_rule instead. This API will be removed after v26.3.0. See BEP-1041 for migration guide.")

  """Added in 26.4.2. Update a notification rule"""
  updateNotificationRule(input: UpdateNotificationRuleInput!): UpdateNotificationRulePayload @deprecated(reason: "Use admin_update_notification_rule instead. This API will be removed after v26.3.0. See BEP-1041 for migration guide.")

  """Added in 26.4.2. Delete a notification rule"""
  deleteNotificationRule(input: DeleteNotificationRuleInput!): DeleteNotificationRulePayload @deprecated(reason: "Use admin_delete_notification_rule instead. This API will be removed after v26.3.0. See BEP-1041 for migration guide.")

  """Added in 26.4.2. Validate a notification rule"""
  validateNotificationRule(input: ValidateNotificationRuleInput!): ValidateNotificationRulePayload @deprecated(reason: "Use admin_validate_notification_rule instead. This API will be removed after v26.3.0. See BEP-1041 for migration guide.")

  """
  Added in 25.16.0. Create or update domain-level app configuration. The provided extra_config object will completely replace the existing configuration; existing keys not present in the new extra_config will be removed. All users in this domain will be affected by these settings when their configurations are merged, unless they have user-level configurations that override specific keys. Requires admin privileges
  """
  upsertDomainAppConfig(input: UpsertDomainConfigInput!): UpsertDomainConfigPayload @deprecated(reason: "Use admin_upsert_domain_app_config instead. This API will be removed after v26.3.0. See BEP-1041 for migration guide.")

  """
  Added in 25.16.0. Delete domain-level app configuration. All users in this domain may be affected by this deletion. After deletion, users will only receive their user-level configurations when configurations are merged, with no domain-level defaults. Requires admin privileges
  """
  deleteDomainAppConfig(input: DeleteDomainConfigInput!): DeleteDomainConfigPayload @deprecated(reason: "Use admin_delete_domain_app_config instead. This API will be removed after v26.3.0. See BEP-1041 for migration guide.")

  """Added in 25.14.0. Create an object storage."""
  createObjectStorage(input: CreateObjectStorageInput!): CreateObjectStoragePayload

  """Added in 25.14.0. Update an object storage."""
  updateObjectStorage(input: UpdateObjectStorageInput!): UpdateObjectStoragePayload

  """Added in 25.16.0. Create auto scaling rule."""
  createAutoScalingRule(input: CreateAutoScalingRuleInput!): CreateAutoScalingRulePayload

  """Added in 25.16.0. Update auto scaling rule."""
  updateAutoScalingRule(input: UpdateAutoScalingRuleInput!): UpdateAutoScalingRulePayload

  """Added in 25.16.0. Delete auto scaling rule."""
  deleteAutoScalingRule(input: DeleteAutoScalingRuleInput!): DeleteAutoScalingRulePayload

  """Added in 25.14.0. Delete an object storage."""
  deleteObjectStorage(input: DeleteObjectStorageInput!): DeleteObjectStoragePayload

  """Added in 25.16.0. Create a new VFS storage"""
  createVFSStorage(input: CreateVFSStorageInput!): CreateVFSStoragePayload

  """Added in 25.16.0. Update an existing VFS storage"""
  updateVFSStorage(input: UpdateVFSStorageInput!): UpdateVFSStoragePayload

  """Added in 25.16.0. Delete a VFS storage"""
  deleteVFSStorage(input: DeleteVFSStorageInput!): DeleteVFSStoragePayload

  """Added in 25.15.0. Registers a new namespace within a storage"""
  registerStorageNamespace(input: RegisterStorageNamespaceInput!): RegisterStorageNamespacePayload

  """Added in 25.15.0. Unregisters an existing namespace from a storage"""
  unregisterStorageNamespace(input: UnregisterStorageNamespaceInput!): UnregisterStorageNamespacePayload

  """Added in 25.14.0. Create huggingface registry."""
  createHuggingfaceRegistry(input: CreateHuggingFaceRegistryInput!): CreateHuggingFaceRegistryPayload

  """Added in 25.14.0. Update huggingface registry."""
  updateHuggingfaceRegistry(input: UpdateHuggingFaceRegistryInput!): UpdateHuggingFaceRegistryPayload

  """Added in 25.14.0. Delete huggingface registry."""
  deleteHuggingfaceRegistry(input: DeleteHuggingFaceRegistryInput!): DeleteHuggingFaceRegistryPayload

  """Added in 25.14.0. Create reservoir registry."""
  createReservoirRegistry(input: CreateReservoirRegistryInput!): CreateReservoirRegistryPayload

  """Added in 25.14.0. Update reservoir registry."""
  updateReservoirRegistry(input: UpdateReservoirRegistryInput!): UpdateReservoirRegistryPayload

  """Added in 25.14.0. Delete reservoir registry."""
  deleteReservoirRegistry(input: DeleteReservoirRegistryInput!): DeleteReservoirRegistryPayload

  """Added in 25.14.0. Get a presigned download URL."""
  getPresignedDownloadUrl(input: GetPresignedDownloadURLInput!): GetPresignedDownloadURLPayload

  """Added in 25.14.0. Get a presigned upload URL."""
  getPresignedUploadUrl(input: GetPresignedUploadURLInput!): GetPresignedUploadURLPayload

  """
  Added in 25.14.0. Approve an artifact revision for general use. Admin-only operation to approve artifact revisions, typically used in environments with approval workflows for artifact deployment
  """
  approveArtifactRevision(input: ApproveArtifactInput!): ApproveArtifactPayload

  """
  Added in 25.14.0. Reject an artifact revision, preventing its use. Admin-only operation to reject artifact revisions, typically used in environments with approval workflows for artifact deployment
  """
  rejectArtifactRevision(input: RejectArtifactInput!): RejectArtifactPayload

  """Added in 25.16.0. Create access token."""
  createAccessToken(input: CreateAccessTokenInput!): CreateAccessTokenPayload

  """Added in UNRELEASED. Delete access token."""
  deleteAccessToken(input: DeleteAccessTokenInput!): DeleteAccessTokenPayload

  """
  Added in 25.19.0. Activate a specific revision to be the current revision
  """
  activateDeploymentRevision(input: ActivateRevisionInput!): ActivateRevisionPayload

  """Added in 25.19.0. Update the traffic status of a route"""
  updateRouteTrafficStatus(input: UpdateRouteTrafficStatusInput!): UpdateRouteTrafficStatusPayload

  """
  Added in 26.2.0. Upsert domain fair share weight (admin only). Creates a new record if it doesn't exist, or updates the weight if it does
  """
  adminUpsertDomainFairShareWeight(input: UpsertDomainFairShareWeightInput!): UpsertDomainFairShareWeightPayload

  """
  Added in 26.2.0. Upsert project fair share weight (admin only). Creates a new record if it doesn't exist, or updates the weight if it does
  """
  adminUpsertProjectFairShareWeight(input: UpsertProjectFairShareWeightInput!): UpsertProjectFairShareWeightPayload

  """
  Added in 26.2.0. Upsert user fair share weight (admin only). Creates a new record if it doesn't exist, or updates the weight if it does
  """
  adminUpsertUserFairShareWeight(input: UpsertUserFairShareWeightInput!): UpsertUserFairShareWeightPayload

  """
  Added in 26.2.0. Bulk upsert domain fair share weights (admin only). Creates new records if they don't exist, or updates weights if they do
  """
  adminBulkUpsertDomainFairShareWeight(input: BulkUpsertDomainFairShareWeightInput!): BulkUpsertDomainFairShareWeightPayload

  """
  Added in 26.2.0. Bulk upsert project fair share weights (admin only). Creates new records if they don't exist, or updates weights if they do
  """
  adminBulkUpsertProjectFairShareWeight(input: BulkUpsertProjectFairShareWeightInput!): BulkUpsertProjectFairShareWeightPayload

  """
  Added in 26.2.0. Bulk upsert user fair share weights (admin only). Creates new records if they don't exist, or updates weights if they do
  """
  adminBulkUpsertUserFairShareWeight(input: BulkUpsertUserFairShareWeightInput!): BulkUpsertUserFairShareWeightPayload

  """
  Added in 26.1.0. Upsert domain fair share weight (superadmin only). Creates a new record if it doesn't exist, or updates the weight if it does
  """
  upsertDomainFairShareWeight(input: UpsertDomainFairShareWeightInput!): UpsertDomainFairShareWeightPayload @deprecated(reason: "Use admin_upsert_domain_fair_share_weight instead. This API will be removed after v26.3.0. See BEP-1041 for migration guide.")

  """
  Added in 26.1.0. Upsert project fair share weight (superadmin only). Creates a new record if it doesn't exist, or updates the weight if it does
  """
  upsertProjectFairShareWeight(input: UpsertProjectFairShareWeightInput!): UpsertProjectFairShareWeightPayload @deprecated(reason: "Use admin_upsert_project_fair_share_weight instead. This API will be removed after v26.3.0. See BEP-1041 for migration guide.")

  """
  Added in 26.1.0. Upsert user fair share weight (superadmin only). Creates a new record if it doesn't exist, or updates the weight if it does
  """
  upsertUserFairShareWeight(input: UpsertUserFairShareWeightInput!): UpsertUserFairShareWeightPayload @deprecated(reason: "Use admin_upsert_user_fair_share_weight instead. This API will be removed after v26.3.0. See BEP-1041 for migration guide.")

  """
  Added in 26.1.0. Bulk upsert domain fair share weights (superadmin only). Creates new records if they don't exist, or updates weights if they do
  """
  bulkUpsertDomainFairShareWeight(input: BulkUpsertDomainFairShareWeightInput!): BulkUpsertDomainFairShareWeightPayload @deprecated(reason: "Use admin_bulk_upsert_domain_fair_share_weight instead. This API will be removed after v26.3.0. See BEP-1041 for migration guide.")

  """
  Added in 26.1.0. Bulk upsert project fair share weights (superadmin only). Creates new records if they don't exist, or updates weights if they do
  """
  bulkUpsertProjectFairShareWeight(input: BulkUpsertProjectFairShareWeightInput!): BulkUpsertProjectFairShareWeightPayload @deprecated(reason: "Use admin_bulk_upsert_project_fair_share_weight instead. This API will be removed after v26.3.0. See BEP-1041 for migration guide.")

  """
  Added in 26.1.0. Bulk upsert user fair share weights (superadmin only). Creates new records if they don't exist, or updates weights if they do
  """
  bulkUpsertUserFairShareWeight(input: BulkUpsertUserFairShareWeightInput!): BulkUpsertUserFairShareWeightPayload @deprecated(reason: "Use admin_bulk_upsert_user_fair_share_weight instead. This API will be removed after v26.3.0. See BEP-1041 for migration guide.")

  """
  Added in 26.2.0. Update fair share configuration for a resource group (admin only). Only provided fields are updated; others retain their existing values. Resource weights are validated against capacity - only resource types available in the scaling group's capacity can be specified.
  """
  adminUpdateResourceGroupFairShareSpec(input: UpdateResourceGroupFairShareSpecInput!): UpdateResourceGroupFairShareSpecPayload

  """
  Added in 26.2.0. Update resource group configuration (admin only). Only provided fields are updated; others retain their existing values. Supports all configuration fields except fair_share (use separate mutation).
  """
  adminUpdateResourceGroup(input: UpdateResourceGroupInput!): UpdateResourceGroupPayload

  """Added in 26.4.2. Create a new resource group (admin only)."""
  adminCreateResourceGroupV2(input: CreateResourceGroupInput!): CreateResourceGroupPayloadGQL

  """Added in 26.4.2. Delete a resource group (admin only)."""
  adminDeleteResourceGroupV2(name: String!): DeleteResourceGroupPayloadGQL

  """
  Added in 26.4.2. Update allowed resource groups for a domain (admin only).
  """
  adminUpdateAllowedResourceGroupsForDomainV2(input: UpdateAllowedResourceGroupsForDomainInput!): AllowedResourceGroupsPayload

  """
  Added in 26.4.2. Update allowed resource groups for a project (admin only).
  """
  adminUpdateAllowedResourceGroupsForProjectV2(input: UpdateAllowedResourceGroupsForProjectInput!): AllowedResourceGroupsPayload

  """
  Added in 26.4.2. Update allowed domains for a resource group (admin only).
  """
  adminUpdateAllowedDomainsForResourceGroupV2(input: UpdateAllowedDomainsForResourceGroupInput!): AllowedDomainsPayload

  """
  Added in 26.4.2. Update allowed projects for a resource group (admin only).
  """
  adminUpdateAllowedProjectsForResourceGroupV2(input: UpdateAllowedProjectsForResourceGroupInput!): AllowedProjectsPayload

  """
  Added in UNRELEASED. Fully replace a resource group's ``default_deployment_options`` (admin only). Replace semantics — the supplied payload is the complete new value. New deployments created in this resource group snapshot the new default; existing deployments are not affected.
  """
  replaceResourceGroupDefaultDeploymentOptions(input: ReplaceResourceGroupDefaultDeploymentOptionsInput!): ReplaceResourceGroupDefaultDeploymentOptionsPayload

  """
  Added in UNRELEASED. Fully replace a resource group's ``default_session_options`` (admin only). Replace semantics — the supplied payload is the complete new value. New sessions created in this resource group consult the new default via the scheduling controller's options resolver at enqueue time; already-enqueued sessions keep the frozen options they were enqueued with.
  """
  replaceResourceGroupDefaultSessionOptions(input: ReplaceResourceGroupDefaultSessionOptionsInput!): ReplaceResourceGroupDefaultSessionOptionsPayload

  """
  Added in 26.2.0. Update fair share configuration for a resource group (superadmin only). Only provided fields are updated; others retain their existing values. Resource weights are validated against capacity - only resource types available in the scaling group's capacity can be specified.
  """
  updateResourceGroupFairShareSpec(input: UpdateResourceGroupFairShareSpecInput!): UpdateResourceGroupFairShareSpecPayload @deprecated(reason: "Use admin_update_resource_group_fair_share_spec instead. This API will be removed after v26.3.0. See BEP-1041 for migration guide.")

  """
  Added in 26.4.2. Create a new domain (admin only). Requires superadmin privileges.
  """
  adminCreateDomainV2(input: CreateDomainInputGQL!): DomainPayloadGQL

  """
  Added in 26.4.2. Update a domain (admin only). Requires superadmin privileges. Only provided fields will be updated.
  """
  adminUpdateDomainV2(domainName: String!, input: UpdateDomainInputGQL!): DomainPayloadGQL

  """
  Added in 26.4.2. Soft-delete a domain (admin only). Requires superadmin privileges.
  """
  adminDeleteDomainV2(domainName: String!): DeleteDomainPayloadGQL

  """
  Added in 26.4.2. Permanently purge a domain and all associated data (admin only). Requires superadmin privileges.
  """
  adminPurgeDomainV2(domainName: String!): PurgeDomainPayloadGQL

  """
  Added in 26.4.2. Create a new project (admin only). Requires superadmin privileges.
  """
  adminCreateProjectV2(input: CreateProjectInputGQL!): ProjectPayloadGQL

  """
  Added in 26.4.2. Update a project (admin only). Requires superadmin privileges. Only provided fields will be updated.
  """
  adminUpdateProjectV2(projectId: UUID!, input: UpdateProjectInputGQL!): ProjectPayloadGQL

  """
  Added in 26.4.2. Soft-delete a project (admin only). Requires superadmin privileges.
  """
  adminDeleteProjectV2(projectId: UUID!): DeleteProjectPayloadGQL

  """
  Added in 26.4.2. Permanently purge a project and all associated data (admin only). Requires superadmin privileges.
  """
  adminPurgeProjectV2(projectId: UUID!): PurgeProjectPayloadGQL

  """
  Added in 26.4.2. Unassign users from a project. RBAC validates project admin permission.
  """
  unassignUsersFromProjectV2(projectId: UUID!, input: UnassignUsersFromProjectInput!): UnassignUsersFromProjectPayload

  """
  Added in 26.2.0. Create a new user (admin only). Requires superadmin privileges. Automatically creates a default keypair for the user
  """
  adminCreateUserV2(input: CreateUserV2Input!): CreateUserV2Payload

  """
  Added in 26.2.0. Create multiple users in bulk (admin only). Requires superadmin privileges. Each user has individual specifications
  """
  adminBulkCreateUsersV2(input: BulkCreateUserV2Input!): BulkCreateUsersV2Payload

  """
  Added in 26.3.0. Update multiple users in bulk (admin only). Requires superadmin privileges. Each user has individual update specifications
  """
  adminBulkUpdateUsersV2(input: BulkUpdateUserV2Input!): BulkUpdateUsersV2Payload

  """
  Added in 26.3.0. Update a user's information (admin only). Requires superadmin privileges. Only provided fields will be updated
  """
  adminUpdateUserV2(userId: UUID!, input: UpdateUserV2Input!): UpdateUserV2Payload

  """
  Added in 26.2.0. Update the current user's information. Users can only update their own profile. Some fields may be restricted based on user role
  """
  updateUserV2(input: UpdateUserV2Input!): UpdateUserV2Payload

  """
  Added in 26.2.0. Soft-delete a user (admin only). Requires superadmin privileges. Sets the user status to DELETED but preserves data
  """
  adminDeleteUserV2(userId: UUID!): DeleteUserV2Payload

  """
  Added in 26.2.0. Soft-delete multiple users (admin only). Requires superadmin privileges. Sets user status to DELETED but preserves data
  """
  adminDeleteUsersV2(input: DeleteUsersV2Input!): DeleteUsersV2Payload

  """
  Added in 26.2.0. Permanently delete a user and all associated data (admin only). Requires superadmin privileges. This action is IRREVERSIBLE. All user data, sessions, and resources will be deleted
  """
  adminPurgeUserV2(input: PurgeUserV2Input!): PurgeUserV2Payload

  """
  Added in 26.3.0. Permanently delete multiple users in bulk (admin only). Requires superadmin privileges. This action is IRREVERSIBLE. All user data will be deleted
  """
  adminBulkPurgeUsersV2(input: BulkPurgeUsersV2Input!): BulkPurgeUsersV2Payload

  """
  Added in 26.4.2. Issue a new keypair for the current user. Settings (resource_policy, rate_limit, is_admin) are inherited from the main keypair. The secret_key is only returned at creation time.
  """
  issueMyKeypair: IssueMyKeypairPayload

  """
  Added in 26.4.2. Revoke a keypair owned by the current user. The main access key cannot be revoked — switch it first.
  """
  revokeMyKeypair(input: RevokeMyKeypairInput!): RevokeMyKeypairPayload

  """
  Added in 26.4.2. Switch the main access key for the current user. The target keypair must be active and owned by the user.
  """
  switchMyMainAccessKey(input: SwitchMyMainAccessKeyInput!): SwitchMyMainAccessKeyPayload

  """
  Added in 26.4.2. Update a keypair owned by the current user (e.g. toggle active state). The keypair must be owned by the current user.
  """
  updateMyKeypair(input: UpdateMyKeypairInput!): UpdateMyKeypairPayload

  """
  Added in 26.4.2. Admin creates a keypair for a specified user. The secret_key is only returned at creation time.
  """
  adminCreateKeypairV2(input: AdminCreateKeypairInput!): AdminCreateKeypairPayload

  """
  Added in 26.4.2. Admin updates a keypair (e.g. toggle active state, change resource policy).
  """
  adminUpdateKeypairV2(input: AdminUpdateKeypairInput!): AdminUpdateKeypairPayload

  """
  Added in 26.4.2. Admin deletes a keypair by access key. Cannot delete a main access key.
  """
  adminDeleteKeypairV2(accessKey: String!): AdminDeleteKeypairPayload

  """Added in 26.4.2. Admin registers (overwrites) a user's SSH keypair."""
  adminRegisterSshKeypairV2(input: AdminRegisterSSHKeypairInput!): AdminRegisterSSHKeypairPayload

  """Added in 26.4.2. Admin clears a user's SSH keypair."""
  adminDeleteSshKeypairV2(accessKey: String!): AdminDeleteSSHKeypairPayload

  """Added in 26.4.2. Revoke a login session. (admin only)"""
  adminRevokeLoginSession(sessionId: UUID!): RevokeLoginSessionPayload

  """Added in 26.4.2. Revoke a login session owned by the current user."""
  myRevokeLoginSession(sessionId: UUID!): RevokeLoginSessionPayload

  """
  Added in 26.4.2. Clear the failed-login rate limit block for a user. (admin only)
  """
  adminUnblockUser(username: String!): UnblockUserPayload

  """
  Added in 26.4.0. Update the current user's allowed client IP list. Set allowed_client_ip to null to remove all IP restrictions. When force is false, the operation fails if the current request IP would be excluded by the new allowlist (lockout prevention)
  """
  updateMyAllowedClientIp(input: UpdateMyAllowedClientIPInput!): UpdateMyAllowedClientIPPayload

  """Added in 26.3.0. Create a new query definition (admin only)"""
  adminCreatePrometheusQueryPreset(input: CreateQueryDefinitionInput!): CreateQueryDefinitionPayload

  """Added in 26.3.0. Modify an existing query definition (admin only)."""
  adminModifyPrometheusQueryPreset(id: ID!, input: ModifyQueryDefinitionInput!): ModifyQueryDefinitionPayload

  """Added in 26.3.0. Delete a query definition (admin only)"""
  adminDeletePrometheusQueryPreset(id: ID!): DeleteQueryDefinitionPayload

  """Added in 26.3.0. Create a new query preset category (admin only)."""
  adminCreatePrometheusQueryPresetCategory(input: CreateCategoryInput!): CreateCategoryPayload

  """Added in 26.3.0. Delete a query preset category (admin only)."""
  adminDeletePrometheusQueryPresetCategory(id: ID!): DeleteCategoryPayload

  """Added in 26.3.0. Create a new role (admin only)."""
  adminCreateRole(input: CreateRoleInput!): Role

  """Added in 26.3.0. Update an existing role (admin only)."""
  adminUpdateRole(input: UpdateRoleInput!): Role

  """Added in 26.3.0. Soft-delete a role (admin only)."""
  adminDeleteRole(input: DeleteRoleInput!): DeleteRolePayload

  """Added in 26.3.0. Permanently remove a role (admin only)."""
  adminPurgeRole(input: PurgeRoleInput!): PurgeRolePayload

  """Added in 26.3.0. Create a scoped permission (admin only)."""
  adminCreatePermission(input: CreatePermissionInput!): Permission

  """Added in 26.3.0. Update a scoped permission (admin only)."""
  adminUpdatePermission(input: UpdatePermissionInput!): Permission

  """Added in 26.3.0. Delete a scoped permission (admin only)."""
  adminDeletePermission(input: DeletePermissionInput!): DeletePermissionPayload

  """Added in 26.3.0. Assign a role to a user (admin only)."""
  adminAssignRole(input: AssignRoleInput!): RoleAssignment

  """Added in 26.3.0. Revoke a role from a user (admin only)."""
  adminRevokeRole(input: RevokeRoleInput!): RoleAssignment

  """Added in 26.3.0. Bulk assign a role to multiple users (admin only)."""
  adminBulkAssignRole(input: BulkAssignRoleInput!): BulkAssignRolePayload

  """Added in 26.3.0. Bulk revoke a role from multiple users (admin only)."""
  adminBulkRevokeRole(input: BulkRevokeRoleInput!): BulkRevokeRolePayload

  """
  Added in UNRELEASED. Bulk-insert scoped permission rows across one or more roles (admin only).
  """
  adminBulkAddRolePermissions(input: BulkAddRolePermissionsInput!): BulkAddRolePermissionsPayload

  """
  Added in UNRELEASED. Bulk-delete permission rows by primary key (admin only).
  """
  adminBulkRemoveRolePermissions(input: BulkRemoveRolePermissionsInput!): BulkRemoveRolePermissionsPayload

  """
  Added in UNRELEASED. Replace one role's entire scoped-permission set (admin only).
  """
  adminReplaceRolePermissions(input: ReplaceRolePermissionsInput!): ReplaceRolePermissionsPayload

  """Added in UNRELEASED. Create role invitations by email."""
  createRoleInvitation(input: CreateRoleInvitationInput!): CreateRoleInvitationPayload

  """Added in UNRELEASED. Accept a pending role invitation."""
  acceptRoleInvitation(input: AcceptRoleInvitationInput!): RoleInvitation

  """Added in UNRELEASED. Reject a pending role invitation."""
  rejectRoleInvitation(input: RejectRoleInvitationInput!): RoleInvitation

  """Added in UNRELEASED. Cancel a pending role invitation (admin only)."""
  adminCancelRoleInvitation(input: CancelRoleInvitationInput!): RoleInvitation

  """Added in 26.4.2. Create a new keypair resource policy (admin only)."""
  adminCreateKeypairResourcePolicyV2(input: CreateKeypairResourcePolicyInputGQL!): CreateKeypairResourcePolicyPayloadGQL

  """
  Added in 26.4.2. Update a keypair resource policy (admin only). Only provided fields will be updated.
  """
  adminUpdateKeypairResourcePolicyV2(name: String!, input: UpdateKeypairResourcePolicyInputGQL!): UpdateKeypairResourcePolicyPayloadGQL

  """Added in 26.4.2. Delete a keypair resource policy (admin only)."""
  adminDeleteKeypairResourcePolicyV2(name: String!): DeleteKeypairResourcePolicyPayloadGQL

  """Added in 26.4.2. Create a new user resource policy (admin only)."""
  adminCreateUserResourcePolicyV2(input: CreateUserResourcePolicyInputGQL!): CreateUserResourcePolicyPayloadGQL

  """
  Added in 26.4.2. Update a user resource policy (admin only). Only provided fields will be updated.
  """
  adminUpdateUserResourcePolicyV2(name: String!, input: UpdateUserResourcePolicyInputGQL!): UpdateUserResourcePolicyPayloadGQL

  """Added in 26.4.2. Delete a user resource policy (admin only)."""
  adminDeleteUserResourcePolicyV2(name: String!): DeleteUserResourcePolicyPayloadGQL

  """Added in 26.4.2. Create a new project resource policy (admin only)."""
  adminCreateProjectResourcePolicyV2(input: CreateProjectResourcePolicyInputGQL!): CreateProjectResourcePolicyPayloadGQL

  """
  Added in 26.4.2. Update a project resource policy (admin only). Only provided fields will be updated.
  """
  adminUpdateProjectResourcePolicyV2(name: String!, input: UpdateProjectResourcePolicyInputGQL!): UpdateProjectResourcePolicyPayloadGQL

  """Added in 26.4.2. Delete a project resource policy (admin only)."""
  adminDeleteProjectResourcePolicyV2(name: String!): DeleteProjectResourcePolicyPayloadGQL

  """Added in 26.4.2. Create a new resource preset (admin only)."""
  adminCreateResourcePresetV2(input: CreateResourcePresetV2Input!): CreateResourcePresetPayloadGQL

  """Added in 26.4.2. Update a resource preset (admin only)."""
  adminUpdateResourcePresetV2(input: UpdateResourcePresetV2Input!): UpdateResourcePresetPayloadGQL

  """Added in 26.4.2. Delete a resource preset (admin only)."""
  adminDeleteResourcePresetV2(id: UUID!): DeleteResourcePresetPayloadGQL

  """Added in 26.4.2. Create a new login client type (super admin only)."""
  adminCreateLoginClientType(input: CreateLoginClientTypeInput!): CreateLoginClientTypePayload

  """Added in 26.4.2. Update a login client type (super admin only)."""
  adminUpdateLoginClientType(id: UUID!, input: UpdateLoginClientTypeInput!): UpdateLoginClientTypePayload

  """Added in 26.4.2. Delete a login client type (super admin only)."""
  adminDeleteLoginClientType(id: UUID!): DeleteLoginClientTypePayload

  """Added in 26.4.2. Create a new runtime variant (superadmin only)."""
  adminCreateRuntimeVariant(input: CreateRuntimeVariantInput!): CreateRuntimeVariantPayloadGQL

  """Added in 26.4.2. Update a runtime variant (superadmin only)."""
  adminUpdateRuntimeVariant(input: UpdateRuntimeVariantInput!): UpdateRuntimeVariantPayloadGQL

  """Added in 26.4.2. Delete a runtime variant (superadmin only)."""
  adminDeleteRuntimeVariant(id: UUID!): DeleteRuntimeVariantPayloadGQL

  """Added in 26.4.2. Delete multiple runtime variants (superadmin only)."""
  adminDeleteRuntimeVariants(input: DeleteRuntimeVariantsInput!): DeleteRuntimeVariantsPayloadGQL

  """Added in 26.4.2. Create a runtime variant preset (superadmin only)."""
  adminCreateRuntimeVariantPreset(input: CreateRuntimeVariantPresetInput!): CreateRuntimeVariantPresetPayloadGQL

  """Added in 26.4.2. Update a runtime variant preset (superadmin only)."""
  adminUpdateRuntimeVariantPreset(input: UpdateRuntimeVariantPresetInput!): UpdateRuntimeVariantPresetPayloadGQL

  """Added in 26.4.2. Delete a runtime variant preset (superadmin only)."""
  adminDeleteRuntimeVariantPreset(id: UUID!): DeleteRuntimeVariantPresetPayloadGQL

  """Added in 26.4.2. Create a deployment revision preset (admin only)."""
  adminCreateDeploymentRevisionPreset(input: CreateDeploymentRevisionPresetInput!): CreateDeploymentRevisionPresetPayloadGQL

  """Added in 26.4.2. Update a deployment revision preset (admin only)."""
  adminUpdateDeploymentRevisionPreset(input: UpdateDeploymentRevisionPresetInput!): UpdateDeploymentRevisionPresetPayloadGQL

  """Added in 26.4.2. Delete a deployment revision preset (admin only)."""
  adminDeleteDeploymentRevisionPreset(id: UUID!): DeleteDeploymentRevisionPresetPayloadGQL

  """Added in 26.4.2. Create a model card (admin only)."""
  adminCreateModelCardV2(input: CreateModelCardV2Input!): CreateModelCardPayloadGQL

  """Added in 26.4.2. Update a model card (admin only)."""
  adminUpdateModelCardV2(input: UpdateModelCardV2Input!): UpdateModelCardPayloadGQL

  """Added in 26.4.2. Delete a model card (admin only)."""
  adminDeleteModelCardV2(id: UUID!, options: DeleteModelCardV2Options = null): DeleteModelCardPayloadGQL

  """
  Added in UNRELEASED. Bulk-delete model cards (admin only) with per-card partial-failure reporting.
  """
  adminBulkDeleteModelCardsV2(input: BulkDeleteModelCardsV2Input!): BulkDeleteModelCardsV2Payload

  """
  Added in 26.4.2. Scan a MODEL_STORE project and upsert model cards from vfolder model-definition.yaml files.
  """
  scanProjectModelCardsV2(projectId: UUID!): ScanProjectModelCardsV2Payload

  """
  Added in 26.4.2. Deploy a model card by creating a deployment with a revision preset.
  """
  deployModelCardV2(cardId: UUID!, input: DeployModelCardV2Input!): DeployModelCardV2Payload

  """Added in 26.4.2. Create a new virtual folder."""
  createVfolderV2(input: CreateVFolderV2Input!): CreateVFolderV2Payload

  """
  Added in UNRELEASED. Create a virtual folder owned by the specified project. Requires project-scoped CREATE permission.
  """
  createVFolderInProject(projectId: UUID!, input: CreateVFolderInScopeInput!): CreateVFolderV2Payload

  """Added in 26.4.2. Soft-delete a virtual folder (move to trash)."""
  deleteVfolderV2(vfolderId: UUID!): DeleteVFolderV2Payload

  """Added in 26.4.2. Permanently purge a virtual folder."""
  purgeVfolderV2(vfolderId: UUID!, options: PurgeVFolderOptionsInput = null): PurgeVFolderV2Payload

  """
  Added in UNRELEASED. Restore a trashed virtual folder. RBAC enforced via scope chain.
  """
  restoreVFolder(vfolderId: UUID!): RestoreVFolderPayload

  """Added in 26.4.2. Deploy a deployment directly from a model VFolder."""
  deployVfolderV2(vfolderId: UUID!, input: DeployVFolderV2Input!): DeployVFolderV2Payload

  """Added in 26.4.2. Soft-delete multiple virtual folders."""
  bulkDeleteVfoldersV2(input: BulkDeleteVFoldersV2Input!): BulkDeleteVFoldersV2Payload

  """Added in 26.4.2. Permanently purge multiple virtual folders."""
  bulkPurgeVfoldersV2(input: BulkPurgeVFoldersV2Input!): BulkPurgeVFoldersV2Payload

  """Added in 26.4.2. Clone a virtual folder."""
  cloneVfolderV2(vfolderId: UUID!, input: CloneVFolderV2Input!): CloneVFolderV2Payload

  """Added in 26.4.2. List files in a virtual folder."""
  vfolderListFilesV2(vfolderId: UUID!, input: ListFilesV2Input!): ListFilesV2Payload

  """Added in 26.4.2. Create directories inside a virtual folder."""
  vfolderMkdirV2(vfolderId: UUID!, input: MkdirV2Input!): MkdirV2Payload

  """Added in 26.4.2. Move a file within a virtual folder."""
  vfolderMoveFileV2(vfolderId: UUID!, input: MoveFileV2Input!): MoveFileV2Payload

  """Added in 26.4.2. Delete files inside a virtual folder."""
  vfolderDeleteFilesV2(vfolderId: UUID!, input: DeleteFilesV2Input!): DeleteFilesV2Payload

  """Added in 26.4.2. Create an upload session for a virtual folder."""
  vfolderCreateUploadSessionV2(vfolderId: UUID!, input: CreateUploadSessionV2Input!): CreateUploadSessionV2Payload

  """Added in 26.4.2. Create a download session for a virtual folder."""
  vfolderCreateDownloadSessionV2(vfolderId: UUID!, input: CreateDownloadSessionV2Input!): CreateDownloadSessionV2Payload

  """Added in 26.4.2. Enqueue a new compute session."""
  enqueueSession(input: EnqueueSessionInput!): EnqueueSessionPayload

  """
  Added in UNRELEASED. Terminate one or more sessions by ID. Per-session RBAC permission is enforced by the bulk validator; any denial fails the whole request.
  """
  terminateSessionsV2(sessionIds: [ID!]!, forced: Boolean! = false): TerminateSessionsPayload
}

"""
Added in 26.4.2. Query result returning the current client's IP address.
"""
type MyClientIp {
  """The client's IP address as seen by the server"""
  clientIp: String!
}

"""
Added in 26.4.2. Payload listing storage hosts the current user is allowed to use.
"""
type MyStorageHostPermissionsPayload {
  """Storage hosts the current user is allowed to use."""
  items: [StorageHostPermission!]!
}

"""An object with a Globally Unique ID"""
interface Node {
  """The Globally Unique ID of this object"""
  id: ID!
}

"""Added in 26.3.0. Notification channel."""
type NotificationChannel implements Node {
  """The Globally Unique ID of this object"""
  id: ID!
  name: String!
  description: String
  channelType: NotificationChannelType!
  spec: NotificationChannelSpec!
  enabled: Boolean!
  createdAt: DateTime!
}

"""Added in 26.3.0. Notification channel connection."""
type NotificationChannelConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [NotificationChannelEdge!]!
  count: Int!
}

"""An edge in a connection."""
type NotificationChannelEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: NotificationChannel!
}

"""Added in 24.09.0. Filter for notification channels"""
input NotificationChannelFilter {
  name: StringFilter = null
  channelType: NotificationChannelTypeFilter = null
  enabled: Boolean = null
  AND: [NotificationChannelFilter!] = null
  OR: [NotificationChannelFilter!] = null
  NOT: [NotificationChannelFilter!] = null
}

"""Added in 24.09.0. Order by specification for notification channels"""
input NotificationChannelOrderBy {
  field: NotificationChannelOrderField!
  direction: OrderDirection! = ASC
}

"""Added in 26.3.0. Fields available for ordering notification channels"""
enum NotificationChannelOrderField {
  NAME
  CREATED_AT
  UPDATED_AT
}

"""Added in 26.3.0. Interface for notification channel specifications."""
interface NotificationChannelSpec {
  """Channel type discriminator"""
  channelType: NotificationChannelType!
}

"""
Added in 24.09.0. Input for notification channel configuration. Exactly one of webhook or email must be set.
"""
input NotificationChannelSpecInput @oneOf {
  webhook: WebhookSpecInput
  email: EmailSpecInput
}

"""Added in 26.3.0. Notification channel types"""
enum NotificationChannelType {
  WEBHOOK
  EMAIL
}

"""
Added in 26.3.0. Filter for notification channel type with equality and membership operators.
"""
input NotificationChannelTypeFilter {
  """Matches channels with this exact type."""
  equals: NotificationChannelType = null

  """Matches channels whose type is in this list."""
  in: [NotificationChannelType!] = null

  """Excludes channels with this exact type."""
  notEquals: NotificationChannelType = null

  """Excludes channels whose type is in this list."""
  notIn: [NotificationChannelType!] = null
}

"""Added in 26.3.0. Notification rule."""
type NotificationRule implements Node {
  """The Globally Unique ID of this object"""
  id: ID!
  name: String!
  description: String
  ruleType: NotificationRuleType!
  channel: NotificationChannel!
  messageTemplate: String!
  enabled: Boolean!
  createdAt: DateTime!
}

"""Added in 26.3.0. Notification rule connection."""
type NotificationRuleConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [NotificationRuleEdge!]!
  count: Int!
}

"""An edge in a connection."""
type NotificationRuleEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: NotificationRule!
}

"""Added in 24.09.0. Filter for notification rules"""
input NotificationRuleFilter {
  name: StringFilter = null
  ruleType: NotificationRuleTypeFilter = null
  enabled: Boolean = null
  AND: [NotificationRuleFilter!] = null
  OR: [NotificationRuleFilter!] = null
  NOT: [NotificationRuleFilter!] = null
}

"""Added in 24.09.0. Order by specification for notification rules"""
input NotificationRuleOrderBy {
  field: NotificationRuleOrderField!
  direction: OrderDirection! = ASC
}

"""Added in 26.3.0. Fields available for ordering notification rules"""
enum NotificationRuleOrderField {
  NAME
  CREATED_AT
  UPDATED_AT
}

"""Added in 26.3.0. Notification rule types"""
enum NotificationRuleType {
  SESSION_STARTED
  SESSION_TERMINATED
  ARTIFACT_DOWNLOAD_COMPLETED
  ENDPOINT_LIFECYCLE_CHANGED
}

"""
Added in 26.3.0. Filter for notification rule type with equality and membership operators.
"""
input NotificationRuleTypeFilter {
  """Matches rules with this exact type."""
  equals: NotificationRuleType = null

  """Matches rules whose type is in this list."""
  in: [NotificationRuleType!] = null

  """Excludes rules with this exact type."""
  notEquals: NotificationRuleType = null

  """Excludes rules whose type is in this list."""
  notIn: [NotificationRuleType!] = null
}

"""
Added in 26.4.3. Filter for nullable datetime fields with IS NULL / IS NOT NULL support.
"""
input NullableDateTimeFilter {
  before: DateTime = null
  after: DateTime = null
  equals: DateTime = null
  notEquals: DateTime = null
  isNull: Boolean = null
}

"""
Added in 26.3.0. Display number format configuration for a resource slot type.
"""
type NumberFormat {
  binary: Boolean!
  roundLength: Int!
}

"""Added in 26.4.2. Number input UI config."""
type NumberOption {
  """Minimum value."""
  min: Float

  """Maximum value."""
  max: Float
}

"""Added in 25.14.0. Object storage node."""
type ObjectStorage implements Node {
  """The Globally Unique ID of this object"""
  id: ID!
  name: String!
  host: String!
  accessKey: String!
  secretKey: String!
  endpoint: String!
  region: String!

  """The namespaces of this entity."""
  namespaces(before: String, after: String, first: Int, last: Int, limit: Int, offset: Int): StorageNamespaceConnection
}

"""
Added in 25.14.0. Relay-style connection for paginated object storage queries.
"""
type ObjectStorageConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [ObjectStorageEdge!]!

  """The count of this entity."""
  count: Int!
}

"""An edge in a connection."""
type ObjectStorageEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: ObjectStorage!
}

"""Added in 26.4.2. Information about a single RBAC operation."""
type OperationInfo {
  """Operation name"""
  operation: String!

  """Human-readable description"""
  description: String!

  """Required RBAC permission"""
  requiredPermission: OperationType!
}

"""Added in 26.3.0. RBAC operation type"""
enum OperationType {
  CREATE
  READ
  UPDATE
  SOFT_DELETE
  HARD_DELETE
  GRANT_ALL
  GRANT_READ
  GRANT_UPDATE
  GRANT_SOFT_DELETE
  GRANT_HARD_DELETE
}

"""
Added in UNRELEASED. Filter for permission operation columns. Supports equals / in / not_equals / not_in.
"""
input OperationTypeFilter {
  """Matches rows with this exact operation."""
  equals: OperationType = null

  """Matches rows whose operation is in this list."""
  in: [OperationType!] = null

  """Excludes rows with this exact operation."""
  notEquals: OperationType = null

  """Excludes rows whose operation is in this list."""
  notIn: [OperationType!] = null
}

"""Added in 24.09.0. Sort direction for ordering"""
enum OrderDirection {
  ASC
  DESC
}

"""Information to aid in pagination."""
type PageInfo @shareable {
  """When paginating forwards, are there more items?"""
  hasNextPage: Boolean!

  """When paginating backwards, are there more items?"""
  hasPreviousPage: Boolean!

  """When paginating backwards, the cursor to continue."""
  startCursor: String

  """When paginating forwards, the cursor to continue."""
  endCursor: String
}

"""Added in 26.3.0. RBAC scoped permission."""
type Permission implements Node {
  """The Globally Unique ID of this object"""
  id: ID!
  roleId: UUID!
  scopeType: RBACElementType!
  scopeId: String!
  entityType: RBACElementType!
  operation: OperationType!
  createdAt: DateTime!

  """The role this permission belongs to."""
  role: Role

  """The scope this permission applies to."""
  scope: EntityNode
}

"""Added in 26.3.0. Permission connection."""
type PermissionConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [PermissionEdge!]!
  count: Int!
}

"""An edge in a connection."""
type PermissionEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: Permission!
}

"""Added in 26.3.0. Filter for scoped permissions"""
input PermissionFilter {
  roleId: UUIDFilter = null
  scopeType: RBACElementTypeFilter = null
  scopeId: StringFilter = null
  entityType: RBACElementTypeFilter = null
  createdAt: DateTimeFilter = null
  AND: [PermissionFilter!] = null
  OR: [PermissionFilter!] = null
  NOT: [PermissionFilter!] = null
}

"""
Added in 26.4.0. Nested filter for permissions within a role assignment. Filters assignments where the assigned role has permissions matching all specified conditions.
"""
input PermissionNestedFilter {
  scopeId: StringFilter = null
  scopeType: RBACElementTypeFilter = null
  entityType: RBACElementTypeFilter = null
  operation: OperationTypeFilter = null
  AND: [PermissionNestedFilter!] = null
  OR: [PermissionNestedFilter!] = null
  NOT: [PermissionNestedFilter!] = null
}

"""Added in 26.3.0. Order by specification for permissions"""
input PermissionOrderBy {
  field: PermissionOrderField!
  direction: OrderDirection! = DESC
}

"""Added in 26.3.0. Permission ordering field"""
enum PermissionOrderField {
  ID
  ENTITY_TYPE
  CREATED_AT
}

"""
Added in 26.4.2. A pre-start action to execute before starting the model service.
"""
type PreStartAction {
  """The name of the pre-start action to execute."""
  action: String!

  """Arguments for the pre-start action."""
  args: JSON!
}

"""
Added in 26.4.0. Input for a pre-start action to execute before starting the model service.
"""
input PreStartActionInput {
  """The name of the pre-start action to execute."""
  action: String!

  """Arguments for the pre-start action."""
  args: JSON!
}

"""Added in 26.3.0. Preemption configuration for a resource group."""
type PreemptionConfig {
  """Sessions with priority <= this value are eligible for preemption."""
  preemptiblePriority: Int!

  """Tie-breaking order for same-priority sessions during preemption."""
  order: PreemptionOrder!

  """How to preempt a session when preemption is triggered."""
  mode: PreemptionMode!
}

"""Added in 26.3.0. Input for preemption configuration."""
input PreemptionConfigInput {
  """Sessions with priority <= this value are preemptible. Default is 5."""
  preemptiblePriority: Int! = 5

  """
  Tie-breaking order for same-priority sessions (OLDEST, NEWEST). Default is OLDEST.
  """
  order: PreemptionOrder! = OLDEST

  """How to preempt sessions (TERMINATE, RESCHEDULE). Default is TERMINATE."""
  mode: PreemptionMode! = TERMINATE
}

"""
Added in 26.3.0. How to preempt a session when preemption is triggered.
"""
enum PreemptionMode {
  TERMINATE
  RESCHEDULE
}

"""
Added in 26.3.0. Tie-breaking order for same-priority sessions during preemption.
"""
enum PreemptionOrder {
  OLDEST
  NEWEST
}

"""Added in 26.4.2. A resource preset with its availability status."""
type PresetAvailabilityV2 {
  """Resource preset UUID."""
  id: String!

  """Resource preset name."""
  name: String!

  """Resource slot allocations."""
  resourceSlots: [ResourceSlotEntry!]!

  """Shared memory size."""
  sharedMemory: BinarySizeInfo

  """Resource group name. Null means global preset."""
  resourceGroupName: String

  """Whether this preset can be used for session creation."""
  available: Boolean!
}

"""
Added in 26.4.2. Cluster topology settings for the deployment, defining whether the inference workload runs on a single node or is distributed across multiple nodes.
"""
type PresetClusterSpec {
  """Cluster mode."""
  clusterMode: String!

  """Cluster size."""
  clusterSize: Int!
}

"""
Added in 26.4.2. Deployment-level defaults stored on the preset. Any null field means the preset does not specify a default and callers should fall back to user input or the system default.
"""
type PresetDeploymentDefaults {
  """Default open_to_public for deployments from this preset."""
  openToPublic: Boolean

  """Default replica count for deployments from this preset."""
  replicaCount: Int

  """Default revision history limit for deployments from this preset."""
  revisionHistoryLimit: Int

  """Default deployment strategy type (ROLLING or BLUE_GREEN)."""
  deploymentStrategy: DeploymentStrategyType

  """Strategy-specific configuration (rolling or blue-green)."""
  deploymentStrategySpec: JSON
}

"""
Added in 26.4.2. Deployment strategy input for a revision preset, used to establish a default deployment strategy applied to any deployment created from this preset.
"""
input PresetDeploymentStrategyInput {
  """Strategy type (ROLLING or BLUE_GREEN)."""
  type: DeploymentStrategyType!

  """Rolling update configuration (required when type is ROLLING)."""
  rollingUpdate: RollingUpdateConfigInput = null

  """Blue/green configuration (required when type is BLUE_GREEN)."""
  blueGreen: BlueGreenConfigInput = null
}

"""
Added in 26.4.2. Container execution configuration for the deployment, including the inference server image, startup commands, and environment variables.
"""
type PresetExecutionSpec {
  """Container image UUID."""
  imageId: UUID

  """Startup command."""
  startupCommand: String

  """Bootstrap script."""
  bootstrapScript: String

  """Environment variables."""
  environ: [DeploymentRevisionPresetEnvironEntry!]!
}

"""
Added in 26.4.2. Compute resource allocation for the deployment, specifying CPU, memory, and accelerator requirements along with additional resource options.
"""
type PresetResourceAllocation {
  """Additional resource options."""
  resourceOpts: [ResourceOptsEntry!]!
}

"""
Added in 26.4.2. Target for applying a preset value: environment variable or command-line argument.
"""
enum PresetTarget {
  ENV
  ARGS
}

"""
Added in 26.4.2. Specifies how a runtime variant preset value is applied to the inference container, either as an environment variable or a command-line argument.
"""
type PresetTargetSpec {
  """Target: env or args."""
  presetTarget: PresetTarget!

  """Value type: str, int, float, bool, flag."""
  valueType: PresetValueType!

  """Default value."""
  defaultValue: String

  """Env key or args flag."""
  key: String!
}

"""Added in 26.4.2. Data type for preset value validation."""
enum PresetValueType {
  STR
  INT
  FLOAT
  BOOL
  FLAG
}

"""
Added in UNRELEASED. Input for previewing a prometheus query template (admin only).
"""
input PreviewQueryDefinitionInput {
  """PromQL template to validate."""
  queryTemplate: String!
}

"""
Added in 26.2.0. Basic project information. Contains identity and descriptive fields for the project.
"""
type ProjectBasicInfo {
  """Project name."""
  name: String!

  """Optional description of the project."""
  description: String

  """Project type determining its purpose. See ProjectType enum."""
  type: ProjectTypeV2!

  """External system integration identifier."""
  integrationName: String
}

"""Added in 25.19.0. Scope for project-level deployment operations."""
input ProjectDeploymentScope {
  """Project UUID to scope the deployment operation."""
  projectId: UUID!
}

"""
Added in 26.2.0. Nested filter for the domain a project belongs to. Filters projects whose domain matches all specified conditions.
"""
input ProjectDomainNestedFilter {
  name: StringFilter = null
  isActive: Boolean = null
}

"""
Added in 26.1.0. Project-level fair share data representing scheduling priority for a specific project. The fair share factor determines resource allocation relative to other projects in the same domain.
"""
type ProjectFairShare implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """Name of the scaling group this fair share belongs to."""
  resourceGroupName: String!

  """UUID of the project this fair share is calculated for."""
  projectId: UUID!

  """Name of the domain the project belongs to."""
  domainName: String!

  """Fair share specification parameters used for calculation."""
  spec: FairShareSpec!

  """Snapshot of the most recent fair share calculation results."""
  calculationSnapshot: FairShareCalculationSnapshot!

  """Timestamp when this record was created."""
  createdAt: DateTime!

  """Timestamp when this record was last updated."""
  updatedAt: DateTime!

  """
  Added in 26.2.0. The project entity associated with this fair share record.
  """
  project: ProjectV2

  """
  Added in 26.2.0. The domain entity associated with this fair share record.
  """
  domain: DomainV2

  """
  Added in 26.2.0. The resource group associated with this fair share record.
  """
  resourceGroup: ResourceGroup
}

"""
Added in 26.1.0. Paginated connection for project fair share records. Provides relay-style cursor-based pagination for efficient traversal of project fair share data. Use 'edges' to access individual records with cursor information, or 'nodes' for direct data access.
"""
type ProjectFairShareConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [ProjectFairShareEdge!]!

  """
  Total number of project fair share records matching the query criteria.
  """
  count: Int!
}

"""An edge in a connection."""
type ProjectFairShareEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: ProjectFairShare!
}

"""
Added in 26.1.0. Filter input for querying project fair shares. Supports filtering by scaling group, project ID, and domain name. Multiple filters can be combined using AND, OR, and NOT logical operators.
"""
input ProjectFairShareFilter {
  """
  Filter by scaling group name. Scaling groups define resource pool boundaries where projects compete for resources within their domain. Supports equals, contains, startsWith, and endsWith operations.
  """
  resourceGroup: StringFilter = null

  """
  Filter by project UUID. Projects are containers for sessions and user activities. Supports equals operation for exact match or 'in' operation for multiple UUIDs.
  """
  projectId: UUIDFilter = null

  """
  Filter by domain name. This filters projects belonging to a specific domain. Supports equals, contains, startsWith, and endsWith operations.
  """
  domainName: StringFilter = null

  """
  Added in 26.2.0. Nested filter for project entity properties. Allows filtering by project name, active status, and type.
  """
  project: ProjectFairShareProjectNestedFilter = null

  """Combine multiple filters with AND logic. All conditions must match."""
  AND: [ProjectFairShareFilter!] = null

  """
  Combine multiple filters with OR logic. At least one condition must match.
  """
  OR: [ProjectFairShareFilter!] = null

  """
  Negate the specified filters. Records matching these conditions will be excluded.
  """
  NOT: [ProjectFairShareFilter!] = null
}

"""
Added in 26.1.0. Specifies ordering for project fair share query results. Combine field selection with direction to sort results. Default direction is DESC (descending).
"""
input ProjectFairShareOrderBy {
  """
  The field to order by. See ProjectFairShareOrderField for available options.
  """
  field: ProjectFairShareOrderField!

  """
  Sort direction. ASC for ascending (lowest first), DESC for descending (highest first). For fair_share_factor, ASC shows highest priority projects first.
  """
  direction: OrderDirection! = DESC
}

"""
Added in 26.1.0. Fields available for ordering project fair share query results. FAIR_SHARE_FACTOR: Order by the calculated fair share factor (0-1 range, lower = higher priority). CREATED_AT: Order by record creation timestamp. PROJECT_NAME: Order alphabetically by project name. PROJECT_IS_ACTIVE: Order by project active status.
"""
enum ProjectFairShareOrderField {
  FAIR_SHARE_FACTOR
  CREATED_AT
  PROJECT_NAME
  PROJECT_IS_ACTIVE
}

"""
Added in 26.2.0. Nested filter for project entity fields in project fair share queries. Allows filtering by project properties such as name, active status, and type.
"""
input ProjectFairShareProjectNestedFilter {
  """
  Filter by project name. Supports equals, contains, startsWith, and endsWith.
  """
  name: StringFilter = null

  """Filter by project active status."""
  isActive: Boolean = null

  """Filter by project type (GENERAL, MODEL_STORE)."""
  type: ProjectFairShareTypeEnumFilter = null
}

"""Added in 24.09.0. Scope parameters for filtering project fair shares."""
input ProjectFairShareScope {
  """Resource group to filter fair shares by."""
  resourceGroupName: String!
}

"""Added in 26.2.0. Project type enum for fair share filtering."""
enum ProjectFairShareTypeEnum {
  GENERAL
  MODEL_STORE
}

"""
Added in 26.2.0. Filter for project type enum in fair share queries. Supports equals, in, not_equals, and not_in operations.
"""
input ProjectFairShareTypeEnumFilter {
  """Exact match for project type."""
  equals: ProjectFairShareTypeEnum = null

  """Match any of the provided types."""
  in: [ProjectFairShareTypeEnum!] = null

  """Exclude exact type match."""
  notEquals: ProjectFairShareTypeEnum = null

  """Exclude any of the provided types."""
  notIn: [ProjectFairShareTypeEnum!] = null
}

"""
Added in 26.2.0. Project lifecycle information. Contains activation status and timestamp tracking.
"""
type ProjectLifecycleInfo {
  """
  Whether the project is active. Inactive projects cannot create new sessions or perform operations.
  """
  isActive: Boolean

  """Timestamp when the project was created."""
  createdAt: DateTime

  """Timestamp when the project was last modified."""
  modifiedAt: DateTime
}

"""
Added in 26.4.2. Scope for model card queries within a MODEL_STORE project.
"""
input ProjectModelCardV2Scope {
  """MODEL_STORE project UUID."""
  projectId: UUID!
}

"""
Added in 26.2.0. Project's organizational context. Contains domain membership and resource policy information.
"""
type ProjectOrganizationInfo {
  """Name of the domain this project belongs to."""
  domainName: String!

  """Name of the project resource policy applied to this project."""
  resourcePolicy: String!
}

"""Added in 26.4.2. Payload for project mutation responses."""
type ProjectPayloadGQL {
  """The project entity."""
  project: ProjectV2!
}

"""Added in 26.4.2. Payload for project resource allocation query."""
type ProjectResourceAllocationV2 {
  """Project resource usage."""
  project: ScopeResourceUsageV2!
}

"""
Added in 26.4.2. Project resource policy defining vfolder, quota, and network limits per project.
"""
type ProjectResourcePolicyV2 implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """Policy name."""
  name: String!

  """Timestamp when the policy was created."""
  createdAt: DateTime

  """Maximum vfolders a project can have."""
  maxVfolderCount: Int!

  """Maximum quota scope size."""
  maxQuotaScopeSize: BinarySizeInfo!

  """Maximum networks a project can create. -1 means unlimited."""
  maxNetworkCount: Int!
}

"""Added in 26.4.2. Paginated connection for project resource policies."""
type ProjectResourcePolicyV2Connection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [ProjectResourcePolicyV2Edge!]!

  """Total number of matching policies."""
  count: Int!
}

"""An edge in a connection."""
type ProjectResourcePolicyV2Edge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: ProjectResourcePolicyV2!
}

"""Added in 26.4.2. Filter for project resource policies."""
input ProjectResourcePolicyV2Filter {
  name: StringFilter = null
  createdAt: DateTimeFilter = null
  maxVfolderCount: IntFilter = null
  maxQuotaScopeSize: IntFilter = null
  maxNetworkCount: IntFilter = null
}

"""Added in 26.4.2. Ordering specification for project resource policies."""
input ProjectResourcePolicyV2OrderBy {
  """Field to order by."""
  field: ProjectResourcePolicyV2OrderField! = CREATED_AT

  """Sort direction."""
  direction: OrderDirection! = DESC
}

"""
Added in 26.4.2. Fields available for ordering project resource policies.
"""
enum ProjectResourcePolicyV2OrderField {
  NAME
  CREATED_AT
  MAX_VFOLDER_COUNT
  MAX_QUOTA_SCOPE_SIZE
  MAX_NETWORK_COUNT
}

"""
Added in 26.4.2. Scope for session operations within a specific project.
"""
input ProjectSessionV2Scope {
  """Project UUID to scope the session operation."""
  projectId: UUID!
}

"""
Added in 26.2.0. Project storage configuration. Contains allowed virtual folder hosts and their permissions.
"""
type ProjectStorageInfo {
  """
  Storage hosts accessible to this project with their permissions. Each entry specifies a host and the operations allowed on it. Empty list means no storage access.
  """
  allowedVfolderHosts: [VFolderHostPermissionEntry!]!
}

"""
Added in 26.2.0. Project type determining its purpose and behavior. GENERAL: Standard project for general computation. MODEL_STORE: Project for model storage and management.
"""
enum ProjectTypeV2 {
  GENERAL
  MODEL_STORE
}

"""
Added in 26.2.0. Filter for ProjectTypeEnum fields. Supports equals, in, not_equals, and not_in operations.
"""
input ProjectTypeV2EnumFilter {
  equals: ProjectTypeV2 = null
  in_: [ProjectTypeV2!] = null
  notEquals: ProjectTypeV2 = null
  notIn: [ProjectTypeV2!] = null
}

"""
Added in 26.1.0. Project-level usage bucket representing aggregated resource consumption for a specific time period. Usage buckets store historical data used to calculate fair share factors.
"""
type ProjectUsageBucket implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """UUID of the project this usage bucket belongs to."""
  projectId: UUID!

  """Name of the domain the project belongs to."""
  domainName: String!

  """Name of the scaling group this usage was recorded in."""
  resourceGroupName: String!

  """Metadata about the usage measurement period and timestamps."""
  metadata: UsageBucketMetadata!

  """
  Aggregated resource usage during this period. Contains the total compute resources consumed by all workloads in this project during the measurement period (cpu cores, memory bytes, accelerator usage).
  """
  resourceUsage: ResourceSlot!

  """
  Snapshot of total available capacity in the scaling group at the end of this period. Used as a reference to calculate relative usage and fair share factors.
  """
  capacitySnapshot: ResourceSlot!

  """
  Added in 26.2.0. Average daily resource usage during this period. Calculated as resource_usage divided by bucket duration in days. For each resource type, this represents the average amount consumed per day. Units match the resource type (e.g., CPU cores, memory bytes).
  """
  averageDailyUsage: ResourceSlot

  """
  Added in 26.2.0. Usage ratio against total available capacity for each resource. Calculated as resource_usage divided by capacity_snapshot. Represents the fraction of total capacity consumed (resource-seconds / resource). The result is in seconds, where 86400 means full utilization for one day. Values can exceed this if usage exceeds capacity.
  """
  usageCapacityRatio: ResourceSlot

  """
  Added in 26.1.0. User usage buckets belonging to this project. Returns paginated user-level usage history for all users in this project within the same scaling group.
  """
  userUsageBuckets(filter: UserUsageBucketFilter = null, orderBy: [UserUsageBucketOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): UserUsageBucketConnection
}

"""
Added in 26.1.0. Paginated connection for project usage bucket records. Provides relay-style cursor-based pagination for browsing historical usage data by time period. Use 'edges' to access individual records with cursor information, or 'nodes' for direct data access.
"""
type ProjectUsageBucketConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [ProjectUsageBucketEdge!]!

  """
  Total number of project usage bucket records matching the query criteria.
  """
  count: Int!
}

"""An edge in a connection."""
type ProjectUsageBucketEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: ProjectUsageBucket!
}

"""
Added in 26.1.0. Filter input for querying project usage bucket records. Usage buckets contain historical resource consumption data aggregated by time period for projects. Multiple filters can be combined using AND, OR, and NOT logical operators.
"""
input ProjectUsageBucketFilter {
  """
  Filter by scaling group name. Scaling groups define where usage was recorded. Supports equals, contains, startsWith, and endsWith operations.
  """
  resourceGroup: StringFilter = null

  """
  Filter by project UUID. This filters usage buckets for a specific project. Supports equals operation for exact match.
  """
  projectId: UUIDFilter = null

  """
  Filter by domain name. This filters usage buckets for projects within a specific domain. Supports equals, contains, startsWith, and endsWith operations.
  """
  domainName: StringFilter = null

  """Filter by usage measurement period start date."""
  periodStart: DateFilter = null

  """Filter by usage measurement period end date."""
  periodEnd: DateFilter = null

  """Combine multiple filters with AND logic. All conditions must match."""
  AND: [ProjectUsageBucketFilter!] = null

  """
  Combine multiple filters with OR logic. At least one condition must match.
  """
  OR: [ProjectUsageBucketFilter!] = null

  """
  Negate the specified filters. Records matching these conditions will be excluded.
  """
  NOT: [ProjectUsageBucketFilter!] = null
}

"""
Added in 26.1.0. Specifies ordering for project usage bucket query results. Combine field selection with direction to sort results. Default direction is DESC (most recent first).
"""
input ProjectUsageBucketOrderBy {
  """
  The field to order by. See UsageBucketOrderField for available options.
  """
  field: UsageBucketOrderField!

  """
  Sort direction. ASC for chronological order (oldest first), DESC for reverse chronological order (most recent first).
  """
  direction: OrderDirection! = DESC
}

"""
Added in 24.09.0. Scope parameters for filtering project usage buckets.
"""
input ProjectUsageScope {
  """Resource group to filter usage buckets by."""
  resourceGroupName: String!
}

"""
Added in 26.2.0. Nested filter for users belonging to a project. Filters projects that have at least one user matching all specified conditions.
"""
input ProjectUserNestedFilter {
  id: UUIDFilter = null
  username: StringFilter = null
  email: StringFilter = null
  isActive: Boolean = null
}

"""
Added in 26.2.0. Scope for querying users within a specific project. Used to restrict user queries to members of a particular project.
"""
input ProjectUserV2Scope {
  """
  Project UUID to scope the user query. Only users who are members of this project will be returned.
  """
  projectId: UUID!
}

"""
Added in 26.2.0. Project entity with structured field groups. Formerly GroupNode. Provides comprehensive project information organized into logical categories: basic_info (identity), organization (domain/policy), storage (vfolders), and lifecycle (status/timestamps). All fields use typed structures instead of JSON scalars. Resource allocation and container registry are provided through separate dedicated APIs.
"""
type ProjectV2 implements Node @key(fields: "id") {
  """The Globally Unique ID of this object"""
  id: ID!

  """Basic project information including name, type, and description."""
  basicInfo: ProjectBasicInfo!

  """
  Organizational context including domain membership and resource policy.
  """
  organization: ProjectOrganizationInfo!

  """Storage configuration and vfolder host permissions."""
  storage: ProjectStorageInfo!

  """Lifecycle information including activation status and timestamps."""
  lifecycle: ProjectLifecycleInfo!

  """
  Fair share record for this project in the specified resource group. Returns the scheduling priority configuration for this project. Always returns an object, even if no explicit configuration exists (in which case default values are used).
  """
  fairShare(scope: ProjectFairShareScope!): ProjectFairShare

  """
  Added in 26.4.0. Active resource usage overview for this project. Returns the currently occupied resource slots and the number of active sessions.
  """
  activeResourceOverview: ActiveResourceOverview

  """
  Usage buckets for this project, filtered by resource group. Returns aggregated resource usage statistics over time.
  """
  usageBuckets(scope: ProjectUsageScope!, filter: ProjectUsageBucketFilter = null, orderBy: [ProjectUsageBucketOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): ProjectUsageBucketConnection

  """The domain this project belongs to."""
  domain: DomainV2

  """Users who are members of this project."""
  users(filter: UserV2Filter = null, orderBy: [UserV2OrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): UserV2Connection
}

"""
Added in 26.2.0. Paginated connection for project records. Provides relay-style cursor-based pagination for efficient traversal of project data. Use 'edges' to access individual records with cursor information, or 'nodes' for direct data access.
"""
type ProjectV2Connection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [ProjectV2Edge!]!

  """Total number of project records matching the query criteria."""
  count: Int!
}

"""An edge in a connection."""
type ProjectV2Edge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: ProjectV2!
}

"""
Added in 26.2.0. Filter input for querying projects. Supports filtering by ID, name, domain, type, active status, and timestamps. Multiple filters can be combined using AND, OR, and NOT logical operators.
"""
input ProjectV2Filter {
  id: UUIDFilter = null
  name: StringFilter = null
  domainName: StringFilter = null
  type: ProjectTypeV2EnumFilter = null
  isActive: Boolean = null
  createdAt: DateTimeFilter = null
  modifiedAt: DateTimeFilter = null
  domain: ProjectDomainNestedFilter = null
  user: ProjectUserNestedFilter = null
  AND: [ProjectV2Filter!] = null
  OR: [ProjectV2Filter!] = null
  NOT: [ProjectV2Filter!] = null
}

"""
Added in 26.2.0. Specifies ordering for project query results. Combine field selection with direction to sort results. Default direction is DESC (descending).
"""
input ProjectV2OrderBy {
  field: ProjectV2OrderField! = CREATED_AT
  direction: OrderDirection! = DESC
}

"""
Added in 26.2.0. Fields available for ordering project query results. CREATED_AT: Order by creation timestamp. MODIFIED_AT: Order by last modification timestamp. NAME: Order by project name alphabetically. IS_ACTIVE: Order by active status. TYPE: Order by project type. DOMAIN_NAME: Order by domain name (scalar subquery). USER_USERNAME: Order by username (MIN aggregation). USER_EMAIL: Order by user email (MIN aggregation).
"""
enum ProjectV2OrderField {
  CREATED_AT
  MODIFIED_AT
  NAME
  IS_ACTIVE
  TYPE
  DOMAIN_NAME
  USER_USERNAME
  USER_EMAIL
}

"""
Added in 26.1.0. Input item for a single project weight in bulk upsert. Represents one project's weight configuration.
"""
input ProjectWeightInputItem {
  """ID of the project to update weight for."""
  projectId: UUID!

  """Name of the domain this project belongs to."""
  domainName: String!

  """
  Priority weight multiplier. Higher weight = higher priority allocation ratio. Set to null to use resource group's default_weight.
  """
  weight: Decimal = null
}

"""Added in 26.4.2. Payload for domain permanent deletion mutation."""
type PurgeDomainPayloadGQL {
  """Whether the purge was successful."""
  purged: Boolean!
}

"""Added in 26.4.2. Payload for project permanent deletion mutation."""
type PurgeProjectPayloadGQL {
  """Whether the purge was successful."""
  purged: Boolean!
}

"""Added in 26.3.0. Input for purging a role"""
input PurgeRoleInput {
  id: UUID!
}

"""Added in 26.3.0. Payload for purge role mutation."""
type PurgeRolePayload {
  """ID of the purged role"""
  id: UUID!
}

"""
Added in 26.2.0. Input for permanently deleting a user and all associated data. This action is irreversible.
"""
input PurgeUserV2Input {
  """UUID of the user to purge."""
  userId: UUID!

  """Added in 26.4.2. Options for the purge operation."""
  options: PurgeUserV2Options = null
}

"""Added in 26.4.2. Options for single user purge operation."""
input PurgeUserV2Options {
  """
  If true, migrate shared virtual folders to the admin user before purging.
  """
  purgeSharedVfolders: Boolean! = false

  """If true, delegate endpoint ownership to the admin user before purging."""
  delegateEndpointOwnership: Boolean! = false
}

"""Added in 26.2.0. Payload for single user permanent deletion mutation."""
type PurgeUserV2Payload {
  """Whether the purge was successful."""
  success: Boolean!
}

"""
Added in UNRELEASED. Optional behavior flags for vfolder purge operations.
"""
input PurgeVFolderOptionsInput {
  """
  If true, also delete model card record(s) referencing the vfolder. If false, the request is rejected when any model card still references it.
  """
  cascadeModelCard: Boolean! = false
}

"""
Added in 26.4.2. Payload returned after permanently purging a virtual folder.
"""
type PurgeVFolderV2Payload {
  """ID of the purged virtual folder."""
  id: UUID!
}

type Query {
  _entities(representations: [_Any!]!): [_Entity]!
  _service: _Service!

  """Added in 25.15.0. Get aggregate agent resource statistics"""
  agentStats: AgentStats

  """Added in 26.1.0. List agents with filtering and pagination"""
  agentsV2(filter: AgentFilter = null, orderBy: [AgentOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): AgentV2Connection

  """
  Added in 25.14.0. Retrieve a specific artifact by its ID. Returns detailed information about the artifact including its metadata, registry information, and availability status.
  """
  artifact(id: ID!): Artifact

  """
  Added in 25.14.0. Query artifacts with optional filtering, ordering, and pagination. Returns artifacts that are available in the system, discovered through scanning external registries like HuggingFace or Reservoir. By default, only shows ALIVE (non-deleted) artifacts. Use filters to narrow down results by type, name, registry, or availability. Supports cursor-based pagination for efficient browsing of large datasets.
  """
  artifacts(filter: ArtifactFilter = null, orderBy: [ArtifactOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): ArtifactConnection

  """
  Added in 25.14.0. Retrieve a specific artifact revision by its ID. Returns detailed information about the revision including its status, version, file size, and README content.
  """
  artifactRevision(id: ID!): ArtifactRevision

  """
  Added in 25.14.0. Query artifact revisions with optional filtering, ordering, and pagination. Returns specific versions/revisions of artifacts. Each revision represents a specific version of an artifact with its own status, file data, and metadata. Use filters to find revisions by status, version, or artifact ID. Supports cursor-based pagination for efficient browsing.
  """
  artifactRevisions(filter: ArtifactRevisionFilter = null, orderBy: [ArtifactRevisionOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): ArtifactRevisionConnection

  """
  Added in 25.16.0. Retrieve user-level app configuration. Returns only the configuration set specifically for the user, without merging with domain config. This query is useful for checking what values are configured at the user level when you want to modify domain or user configurations separately. For actual configuration values to be applied, use mergedAppConfig instead. If user_id is not provided, returns the current user's configuration. Users can only access their own configuration, but admins can access any user's configuration.
  """
  userAppConfig(userId: ID = null): AppConfig

  """
  Added in 25.16.0. Retrieve merged app configuration for the current user. The result combines domain-level and user-level configurations, where user settings override domain settings for the same keys. This query should be used when working with user app configurations to get the actual configuration values that will be applied.
  """
  mergedAppConfig: AppConfig

  """Added in 25.16.0. Get a specific deployment by ID."""
  deployment(id: ID!): ModelDeployment

  """
  Added in 25.16.0. List revisions with optional filtering and pagination (admin, all deployments).
  """
  revisions(filter: ModelRevisionFilter = null, orderBy: [ModelRevisionOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): ModelRevisionConnection

  """Added in 25.16.0. Get a specific revision by ID."""
  revision(id: ID!): ModelRevision

  """
  Added in 25.16.0. List replicas with optional filtering and pagination (admin, all deployments).
  """
  replicas(filter: ReplicaFilter = null, orderBy: [ReplicaOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): ModelReplicaConnection

  """Added in 25.16.0. Get a specific replica by ID."""
  replica(id: ID!): ModelReplica

  """Added in 26.4.2. List available notification rule types"""
  notificationRuleTypes: [NotificationRuleType!]

  """
  Added in 26.4.2. Get JSON schema for a notification rule type's message format
  """
  notificationRuleTypeSchema(ruleType: NotificationRuleType!): JSON

  """Added in 25.14.0. Get an object storage by ID"""
  objectStorage(id: ID!): ObjectStorage

  """Added in 25.14.0. List all object storages"""
  objectStorages(before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): ObjectStorageConnection

  """Added in 25.16.0. Get a VFS storage by ID"""
  vfsStorage(id: ID!): VFSStorage

  """Added in 25.16.0. List all VFS storages"""
  vfsStorages(before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): VFSStorageConnection

  """Added in 25.14.0. Get a HuggingFace registry by ID"""
  huggingfaceRegistry(id: ID!): HuggingFaceRegistry

  """Added in 25.14.0. List all HuggingFace registries"""
  huggingfaceRegistries(before: String = null, after: String = null, first: Int = null, last: Int = null, offset: Int = null, limit: Int = null): HuggingFaceRegistryConnection

  """Added in 25.14.0. Get a reservoir registry by ID"""
  reservoirRegistry(id: ID!): ReservoirRegistry

  """Added in 25.14.0. List all reservoir registries"""
  reservoirRegistries(before: String = null, after: String = null, first: Int = null, last: Int = null, offset: Int = null, limit: Int = null): ReservoirRegistryConnection

  """
  Added in 26.2.0. Retrieve a specific image by its ID. Returns detailed information about the image including its identity, metadata, resource requirements, and permission settings.
  """
  imageV2(id: ID!): ImageV2

  """Added in 26.2.0. Query a single kernel by ID."""
  kernelV2(id: UUID!): KernelV2

  """
  Added in 26.2.0. Retrieve a specific image alias by its ID. Returns the alias information including the alias string.
  """
  imageAlias(id: ID!): ImageV2Alias

  """Added in 26.2.0. List resource groups (admin only)"""
  adminResourceGroups(filter: ResourceGroupFilter = null, orderBy: [ResourceGroupOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): ResourceGroupConnection

  """Added in 26.4.2. Get a single resource group by name (admin only)."""
  adminResourceGroupV2(name: String!): ResourceGroup

  """
  Added in UNRELEASED. List all registered deployment scheduling handlers (superadmin only). The returned ``name`` values are valid keys for ``DeploymentOptions.handler_options.by_handler``.
  """
  schedulingHandlers: [SchedulingHandlerNode!]

  """
  Added in 26.4.2. Get allowed resource groups for a domain (admin only).
  """
  adminAllowedResourceGroupsForDomainV2(domainName: String!): AllowedResourceGroupsPayload

  """
  Added in 26.4.2. Get allowed resource groups for a project (admin only).
  """
  adminAllowedResourceGroupsForProjectV2(projectId: UUID!): AllowedResourceGroupsPayload

  """
  Added in 26.4.2. Get allowed domains for a resource group (admin only).
  """
  adminAllowedDomainsForResourceGroupV2(resourceGroupName: String!): AllowedDomainsPayload

  """
  Added in 26.4.2. Get allowed projects for a resource group (admin only).
  """
  adminAllowedProjectsForResourceGroupV2(resourceGroupName: String!): AllowedProjectsPayload

  """Added in 26.3.0. Query service catalog entries. Admin only."""
  adminServiceCatalogs(filter: ServiceCatalogFilter = null, orderBy: [ServiceCatalogOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): [ServiceCatalog!]

  """Added in 26.4.2. List session scheduling history (admin only)"""
  adminSessionSchedulingHistories(filter: SessionSchedulingHistoryFilter = null, orderBy: [SessionSchedulingHistoryOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): SessionSchedulingHistoryConnection

  """Added in 25.16.0. List all deployments (superadmin only)."""
  adminDeployments(filter: DeploymentFilter = null, orderBy: [DeploymentOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): ModelDeploymentConnection

  """Added in 26.4.2. List deployment history (admin only)"""
  adminDeploymentHistories(filter: DeploymentHistoryFilter = null, orderBy: [DeploymentHistoryOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): DeploymentHistoryConnection

  """Added in 26.4.2. List route history (admin only)"""
  adminRouteHistories(filter: RouteHistoryFilter = null, orderBy: [RouteHistoryOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): RouteHistoryConnection

  """Added in 26.4.2. Get a notification channel by ID (admin only)"""
  adminNotificationChannel(id: ID!): NotificationChannel

  """Added in 26.4.2. List notification channels (admin only)"""
  adminNotificationChannels(filter: NotificationChannelFilter = null, orderBy: [NotificationChannelOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): NotificationChannelConnection

  """Added in 26.4.2. Get a notification rule by ID (admin only)"""
  adminNotificationRule(id: ID!): NotificationRule

  """Added in 26.4.2. List notification rules (admin only)"""
  adminNotificationRules(filter: NotificationRuleFilter = null, orderBy: [NotificationRuleOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): NotificationRuleConnection

  """
  Added in 26.2.0. Retrieve domain-level app configuration (admin only). Returns only the configuration set specifically for the domain, without merging. This query is useful for checking what values are configured at the domain level when you want to modify domain or user configurations separately. For actual configuration values to be applied, use mergedAppConfig instead.
  """
  adminDomainAppConfig(domainName: String!): AppConfig

  """Added in 26.2.0. Get domain fair share data (admin only)."""
  adminDomainFairShare(resourceGroupName: String!, domainName: String!): DomainFairShare

  """Added in 26.2.0. List domain fair shares (admin only)."""
  adminDomainFairShares(filter: DomainFairShareFilter = null, orderBy: [DomainFairShareOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): DomainFairShareConnection

  """Added in 26.2.0. Get project fair share data (admin only)."""
  adminProjectFairShare(resourceGroupName: String!, projectId: UUID!): ProjectFairShare

  """Added in 26.2.0. List project fair shares (admin only)."""
  adminProjectFairShares(filter: ProjectFairShareFilter = null, orderBy: [ProjectFairShareOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): ProjectFairShareConnection

  """Added in 26.2.0. Get user fair share data (admin only)."""
  adminUserFairShare(resourceGroupName: String!, projectId: UUID!, userUuid: UUID!): UserFairShare

  """Added in 26.2.0. List user fair shares (admin only)."""
  adminUserFairShares(filter: UserFairShareFilter = null, orderBy: [UserFairShareOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): UserFairShareConnection

  """Added in 26.2.0. List domain usage buckets (admin only)."""
  adminDomainUsageBuckets(filter: DomainUsageBucketFilter = null, orderBy: [DomainUsageBucketOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): DomainUsageBucketConnection

  """Added in 26.2.0. List project usage buckets (admin only)."""
  adminProjectUsageBuckets(filter: ProjectUsageBucketFilter = null, orderBy: [ProjectUsageBucketOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): ProjectUsageBucketConnection

  """Added in 26.2.0. List user usage buckets (admin only)."""
  adminUserUsageBuckets(filter: UserUsageBucketFilter = null, orderBy: [UserUsageBucketOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): UserUsageBucketConnection

  """
  Added in 26.2.0. Query images with optional filtering, ordering, and pagination (admin only). Returns container images available in the system. Images are container specifications that define runtime environments for compute sessions. Use filters to narrow down results by status, name, or architecture. Supports both cursor-based and offset-based pagination.
  """
  adminImagesV2(filter: ImageV2Filter = null, orderBy: [ImageV2OrderByGQL!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): ImageV2Connection

  """
  Added in 26.2.0. Query kernels with pagination and filtering. (admin only)
  """
  adminKernelsV2(filter: KernelV2Filter = null, orderBy: [KernelV2OrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): KernelV2Connection

  """
  Added in 26.3.0. Query audit logs with pagination and filtering. (admin only)
  """
  adminAuditLogsV2(filter: AuditLogFilter = null, orderBy: [AuditLogOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): AuditLogV2Connection

  """
  Added in UNRELEASED. Query audit logs within a scope (non-admin accessible, subject to RBAC). All scope items are OR'd; raises an error if every field is empty.
  """
  scopedAuditLogsV2(scope: AuditLogScope!, filter: AuditLogFilter = null, orderBy: [AuditLogOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): AuditLogV2Connection

  """
  Added in 26.4.2. List container registries with filtering, ordering, and pagination (admin only).
  """
  adminContainerRegistriesV2(filter: ContainerRegistryV2Filter = null, orderBy: [ContainerRegistryV2OrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): ContainerRegistryV2Connection

  """
  Added in 26.4.2. Query login sessions with pagination and filtering. (admin only)
  """
  adminLoginSessionsV2(filter: LoginSessionFilter = null, orderBy: [LoginSessionOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): LoginSessionV2Connection

  """
  Added in 26.4.2. Query login history with pagination and filtering. (admin only)
  """
  adminLoginHistoryV2(filter: LoginHistoryFilter = null, orderBy: [LoginHistoryOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): LoginHistoryV2Connection

  """
  Added in 26.3.0. Query sessions with pagination and filtering. (admin only)
  """
  adminSessionsV2(filter: SessionV2Filter = null, orderBy: [SessionV2OrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): SessionV2Connection

  """
  Added in 26.4.2. List sessions within a specific project. Requires project membership or higher privileges.
  """
  projectSessionsV2(scope: ProjectSessionV2Scope!, filter: SessionV2Filter = null, orderBy: [SessionV2OrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): SessionV2Connection

  """
  Added in 26.4.3. Query a single session by ID. Returns an error if not found.
  """
  sessionV2(id: UUID!): SessionV2

  """Added in 25.19.0. List deployments within a specific project."""
  projectDeployments(scope: ProjectDeploymentScope!, filter: DeploymentFilter = null, orderBy: [DeploymentOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): ModelDeploymentConnection

  """Added in 25.19.0. List deployments owned by the current user."""
  myDeployments(filter: DeploymentFilter = null, orderBy: [DeploymentOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): ModelDeploymentConnection

  """
  Added in 26.3.0. Returns a single resource slot type by slot_name, or null.
  """
  resourceSlotType(slotName: String!): ResourceSlotType

  """
  Added in 26.3.0. Returns resource slot types with pagination and filtering.
  """
  resourceSlotTypes(filter: ResourceSlotTypeFilter = null, orderBy: [ResourceSlotTypeOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): ResourceSlotTypeConnection

  """
  Added in 26.2.0. Query image aliases with optional filtering, ordering, and pagination. Returns image aliases that provide alternative names for container images. Use filters to search by alias string. Supports both cursor-based and offset-based pagination.
  """
  adminImageAliases(filter: ImageV2AliasFilter = null, orderBy: [ImageV2AliasOrderByGQL!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): ImageV2AliasConnection

  """
  Added in 26.4.2. Get a single prometheus query preset by ID. Available to any authenticated user since presets are a shared catalog of metric query templates.
  """
  prometheusQueryPreset(id: ID!): QueryDefinition

  """
  Added in 26.4.2. List prometheus query presets with filtering and pagination. Available to any authenticated user since presets are a shared catalog of metric query templates.
  """
  prometheusQueryPresets(filter: QueryDefinitionFilter = null, orderBy: [QueryDefinitionOrderBy!] = null, limit: Int = null, offset: Int = null): QueryDefinitionConnection

  """
  Added in 26.4.2. Execute a prometheus query preset by ID and return the result. Available to any authenticated user; the underlying preset query is the same regardless of who runs it.
  """
  prometheusQueryPresetResult(id: ID!, timeRange: QueryTimeRangeInput = null, options: ExecuteQueryDefinitionOptionsInput = null, timeWindow: String = null): QueryDefinitionExecuteResult

  """
  Added in UNRELEASED. Preview a prometheus query template before saving it as a preset (admin only).
  """
  adminPreviewPrometheusQueryPreset(input: PreviewQueryDefinitionInput!): QueryDefinitionExecuteResult

  """
  Added in 26.4.2. Get a single query preset category by ID. Available to any authenticated user.
  """
  prometheusQueryPresetCategory(id: ID!): QueryPresetCategory

  """
  Added in 26.4.2. List query preset categories with filtering and pagination. Available to any authenticated user.
  """
  prometheusQueryPresetCategories(filter: CategoryFilter = null, orderBy: [CategoryOrderBy!] = null, first: Int = null, after: String = null, last: Int = null, before: String = null, limit: Int = null, offset: Int = null): [QueryPresetCategory!]

  """Added in 26.3.0. Get a single role by ID (admin only)."""
  adminRole(id: UUID!): Role

  """
  Added in 26.3.0. List roles with filtering and pagination (admin only).
  """
  adminRoles(filter: RoleFilter = null, orderBy: [RoleOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): RoleConnection

  """
  Added in 26.3.0. List scoped permissions with filtering and pagination (admin only).
  """
  adminPermissions(filter: PermissionFilter = null, orderBy: [PermissionOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): PermissionConnection

  """
  Added in 26.3.0. List role assignments with filtering and pagination (admin only).
  """
  adminRoleAssignments(filter: RoleAssignmentFilter = null, orderBy: [RoleAssignmentOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): RoleAssignmentConnection

  """
  Added in 26.3.0. Search entity associations (admin only). Optionally filter by entity_type and entity_id.
  """
  adminEntities(filter: EntityFilter = null, orderBy: [EntityOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): EntityConnection

  """
  Added in 26.4.2. List keypairs owned by the current authenticated user. Supports filtering, ordering, and both cursor-based and offset-based pagination.
  """
  myKeypairs(filter: KeypairFilter = null, orderBy: [KeypairOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): KeyPairConnection

  """
  Added in 26.4.2. Get a single keypair by access key (admin only). Requires superadmin privileges.
  """
  adminKeypairV2(accessKey: String!): KeyPairGQL

  """
  Added in 26.4.2. List all keypairs with filtering and pagination (admin only). Requires superadmin privileges.
  """
  adminKeypairsV2(filter: KeypairFilter = null, orderBy: [KeypairOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): KeyPairConnection

  """
  Added in 26.4.2. Get a user's SSH public key (admin only). The private key is never returned.
  """
  adminSshKeypairV2(accessKey: String!): AdminGetSSHKeypairPayload

  """
  Added in 26.4.2. Query login sessions of the current user with pagination and filtering.
  """
  myLoginSessionsV2(filter: LoginSessionFilter = null, orderBy: [LoginSessionOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): LoginSessionV2Connection

  """
  Added in 26.4.2. Query login history of the current user with pagination and filtering.
  """
  myLoginHistoryV2(filter: LoginHistoryFilter = null, orderBy: [LoginHistoryOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): LoginHistoryV2Connection

  """
  Added in 26.3.0. List roles assigned to the current authenticated user.
  """
  myRoles(filter: RoleAssignmentFilter = null, orderBy: [RoleAssignmentOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): RoleAssignmentConnection

  """Added in UNRELEASED. List the current user's role invitations."""
  myRoleInvitations(filter: RoleInvitationFilter = null, orderBy: [RoleInvitationOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): RoleInvitationConnection

  """Added in UNRELEASED. List role invitations sent by the current user."""
  mySentRoleInvitations(filter: RoleInvitationFilter = null, orderBy: [RoleInvitationOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): RoleInvitationConnection

  """
  Added in UNRELEASED. List all role invitations across the system (superadmin only).
  """
  adminRoleInvitations(filter: RoleInvitationFilter = null, orderBy: [RoleInvitationOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): RoleInvitationConnection

  """Added in 26.4.2. List roles registered in a project scope."""
  projectRoles(projectId: UUID!, filter: RoleFilter = null, orderBy: [RoleOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): RoleConnection

  """Added in UNRELEASED. List invitations for a specific role."""
  roleScopedRoleInvitations(roleId: UUID!, filter: RoleInvitationFilter = null, orderBy: [RoleInvitationOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): RoleInvitationConnection

  """Added in 26.3.0. List valid RBAC scope-entity type combinations."""
  rbacScopeEntityCombinations: [ScopeEntityCombination!]

  """Added in 26.4.2. List valid RBAC entity-operation combinations."""
  rbacEntityOperationCombinations: [EntityOperationCombination!]

  """
  Added in 26.4.2. List complete RBAC scope-entity-operation combinations (permission matrix).
  """
  rbacPermissionMatrix: [ScopeEntityOperationCombination!]

  """Added in 26.2.0. Query kernels within a specific session."""
  sessionKernelsV2(scope: SessionScope!, filter: KernelV2Filter = null, orderBy: [KernelV2OrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): KernelV2Connection

  """
  Added in 26.2.0. Get domain fair share data within resource group scope.
  """
  rgDomainFairShare(scope: ResourceGroupDomainScope!, domainName: String!): DomainFairShare

  """Added in 26.2.0. List domain fair shares within resource group scope."""
  rgDomainFairShares(scope: ResourceGroupDomainScope!, filter: RGDomainFairShareFilter = null, orderBy: [DomainFairShareOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): DomainFairShareConnection

  """
  Added in 26.2.0. Get project fair share data within resource group scope.
  """
  rgProjectFairShare(scope: ResourceGroupProjectScope!, projectId: UUID!): ProjectFairShare

  """Added in 26.2.0. List project fair shares within resource group scope."""
  rgProjectFairShares(scope: ResourceGroupProjectScope!, filter: RGProjectFairShareFilter = null, orderBy: [ProjectFairShareOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): ProjectFairShareConnection

  """Added in 26.2.0. Get user fair share data within resource group scope."""
  rgUserFairShare(scope: ResourceGroupUserScope!, userUuid: UUID!): UserFairShare

  """Added in 26.2.0. List user fair shares within resource group scope."""
  rgUserFairShares(scope: ResourceGroupUserScope!, filter: RGUserFairShareFilter = null, orderBy: [UserFairShareOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): UserFairShareConnection

  """
  Added in 26.2.0. Query images within a specific container registry with optional filtering, ordering, and pagination. Returns container images that belong to the specified registry. Use filters to narrow down results by status, name, or architecture. Supports both cursor-based and offset-based pagination.
  """
  containerRegistryImagesV2(scope: ContainerRegistryScope!, filter: ImageV2Filter = null, orderBy: [ImageV2OrderByGQL!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): ImageV2Connection

  """
  Added in 26.2.0. Query image aliases within a specific image with optional filtering, ordering, and pagination. Returns image aliases that belong to the specified image. Supports both cursor-based and offset-based pagination.
  """
  imageScopedAliases(scope: ImageV2Scope!, filter: ImageV2AliasFilter = null, orderBy: [ImageV2AliasOrderByGQL!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): ImageV2AliasConnection

  """Added in 26.2.0. Get scheduling history for a specific session."""
  sessionScopedSchedulingHistories(scope: SessionScope!, filter: SessionSchedulingHistoryFilter = null, orderBy: [SessionSchedulingHistoryOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): SessionSchedulingHistoryConnection

  """Added in 26.2.0. Get scheduling history for a specific deployment."""
  deploymentScopedSchedulingHistories(scope: DeploymentScope!, filter: DeploymentHistoryFilter = null, orderBy: [DeploymentHistoryOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): DeploymentHistoryConnection

  """Added in 26.2.0. Get scheduling history for a specific route."""
  routeScopedSchedulingHistories(scope: RouteScope!, filter: RouteHistoryFilter = null, orderBy: [RouteHistoryOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): RouteHistoryConnection

  """Added in 26.2.0. List resource groups"""
  resourceGroups(filter: ResourceGroupFilter = null, orderBy: [ResourceGroupOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): ResourceGroupConnection @deprecated(reason: "Use admin_resource_groups instead. This API will be removed after v26.3.0. See BEP-1041 for migration guide.")

  """
  Added in 25.16.0. Retrieve domain-level app configuration. Returns only the configuration set specifically for the domain, without merging. This query is useful for checking what values are configured at the domain level when you want to modify domain or user configurations separately. For actual configuration values to be applied, use mergedAppConfig instead. Requires admin privileges.
  """
  domainAppConfig(domainName: String!): AppConfig @deprecated(reason: "Use admin_domain_app_config instead. This API will be removed after v26.3.0. See BEP-1041 for migration guide.")

  """Added in 26.1.0. Get domain fair share data (superadmin only)."""
  domainFairShare(resourceGroupName: String!, domainName: String!): DomainFairShare @deprecated(reason: "Use admin_domain_fair_share instead. This API will be removed after v26.3.0. See BEP-1041 for migration guide.")

  """Added in 26.1.0. List domain fair shares (superadmin only)."""
  domainFairShares(filter: DomainFairShareFilter = null, orderBy: [DomainFairShareOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): DomainFairShareConnection @deprecated(reason: "Use admin_domain_fair_shares instead. This API will be removed after v26.3.0. See BEP-1041 for migration guide.")

  """Added in 26.1.0. Get project fair share data (superadmin only)."""
  projectFairShare(resourceGroupName: String!, projectId: UUID!): ProjectFairShare @deprecated(reason: "Use admin_project_fair_share instead. This API will be removed after v26.3.0. See BEP-1041 for migration guide.")

  """Added in 26.1.0. List project fair shares (superadmin only)."""
  projectFairShares(filter: ProjectFairShareFilter = null, orderBy: [ProjectFairShareOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): ProjectFairShareConnection @deprecated(reason: "Use admin_project_fair_shares instead. This API will be removed after v26.3.0. See BEP-1041 for migration guide.")

  """Added in 26.1.0. Get user fair share data (superadmin only)."""
  userFairShare(resourceGroupName: String!, projectId: UUID!, userUuid: UUID!): UserFairShare @deprecated(reason: "Use admin_user_fair_share instead. This API will be removed after v26.3.0. See BEP-1041 for migration guide.")

  """Added in 26.1.0. List user fair shares (superadmin only)."""
  userFairShares(filter: UserFairShareFilter = null, orderBy: [UserFairShareOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): UserFairShareConnection @deprecated(reason: "Use admin_user_fair_shares instead. This API will be removed after v26.3.0. See BEP-1041 for migration guide.")

  """Added in 26.1.0. List domain usage buckets (superadmin only)."""
  domainUsageBuckets(filter: DomainUsageBucketFilter = null, orderBy: [DomainUsageBucketOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): DomainUsageBucketConnection @deprecated(reason: "Use admin_domain_usage_buckets instead. This API will be removed after v26.3.0. See BEP-1041 for migration guide.")

  """Added in 26.1.0. List project usage buckets (superadmin only)."""
  projectUsageBuckets(filter: ProjectUsageBucketFilter = null, orderBy: [ProjectUsageBucketOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): ProjectUsageBucketConnection @deprecated(reason: "Use admin_project_usage_buckets instead. This API will be removed after v26.3.0. See BEP-1041 for migration guide.")

  """Added in 26.1.0. List user usage buckets (superadmin only)."""
  userUsageBuckets(filter: UserUsageBucketFilter = null, orderBy: [UserUsageBucketOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): UserUsageBucketConnection @deprecated(reason: "Use admin_user_usage_buckets instead. This API will be removed after v26.3.0. See BEP-1041 for migration guide.")

  """Added in 26.4.2. Get a notification channel by ID"""
  notificationChannel(id: ID!): NotificationChannel @deprecated(reason: "Use admin_notification_channel instead. This API will be removed after v26.3.0. See BEP-1041 for migration guide.")

  """Added in 26.4.2. List notification channels"""
  notificationChannels(filter: NotificationChannelFilter = null, orderBy: [NotificationChannelOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): NotificationChannelConnection @deprecated(reason: "Use admin_notification_channels instead. This API will be removed after v26.3.0. See BEP-1041 for migration guide.")

  """Added in 26.4.2. Get a notification rule by ID"""
  notificationRule(id: ID!): NotificationRule @deprecated(reason: "Use admin_notification_rule instead. This API will be removed after v26.3.0. See BEP-1041 for migration guide.")

  """Added in 26.4.2. List notification rules"""
  notificationRules(filter: NotificationRuleFilter = null, orderBy: [NotificationRuleOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): NotificationRuleConnection @deprecated(reason: "Use admin_notification_rules instead. This API will be removed after v26.3.0. See BEP-1041 for migration guide.")

  """
  Added in 25.14.0. Get the default artifact registry for a given artifact type
  """
  defaultArtifactRegistry(artifactType: ArtifactType!): ArtifactRegistry

  """
  Added in 25.16.0. Get configuration JSON Schemas for all inference runtimes.
  """
  inferenceRuntimeConfigs: JSON @deprecated(reason: "Deprecated since UNRELEASED. Use the runtime_variant resources instead.")

  """Added in 25.16.0. Get JSON Schema for inference runtime configuration"""
  inferenceRuntimeConfig(name: String!): JSON @deprecated(reason: "Deprecated since UNRELEASED. Use the runtime_variant resources instead.")

  """Added in 25.19.0. Get a specific route by ID."""
  route(id: ID!): Route

  """Added in 25.19.0. List routes for a deployment with optional filters."""
  routes(deploymentId: ID!, filter: RouteFilter = null, orderBy: [RouteOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): RouteConnection

  """Added in 26.4.2. List session scheduling history (superadmin only)"""
  sessionSchedulingHistories(filter: SessionSchedulingHistoryFilter = null, orderBy: [SessionSchedulingHistoryOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): SessionSchedulingHistoryConnection @deprecated(reason: "Use admin_session_scheduling_histories instead. This API will be removed after v26.3.0. See BEP-1041 for migration guide.")

  """Added in 26.4.2. List deployment history (superadmin only)"""
  deploymentHistories(filter: DeploymentHistoryFilter = null, orderBy: [DeploymentHistoryOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): DeploymentHistoryConnection @deprecated(reason: "Use admin_deployment_histories instead. This API will be removed after v26.3.0. See BEP-1041 for migration guide.")

  """Added in 26.4.2. List route history (superadmin only)"""
  routeHistories(filter: RouteHistoryFilter = null, orderBy: [RouteHistoryOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): RouteHistoryConnection @deprecated(reason: "Use admin_route_histories instead. This API will be removed after v26.3.0. See BEP-1041 for migration guide.")

  """
  Added in 26.2.0. Get a single user by UUID (admin only). Requires superadmin privileges. Returns an error if user is not found.
  """
  adminUserV2(userId: UUID!): UserV2

  """
  Added in 26.2.0. List all users with filtering and pagination (admin only). Requires superadmin privileges.
  """
  adminUsersV2(filter: UserV2Filter = null, orderBy: [UserV2OrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): UserV2Connection

  """
  Added in 26.2.0. List users within a specific domain. Requires domain admin privileges or higher.
  """
  domainUsersV2(scope: DomainUserV2Scope!, filter: UserV2Filter = null, orderBy: [UserV2OrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): UserV2Connection

  """
  Added in 26.4.2. Get the current client's IP address as seen by the server. Useful for configuring IP allowlists.
  """
  myClientIp: MyClientIp

  """
  Added in 26.2.0. Get the current authenticated user's information. Returns the user associated with the current session. Returns an error if not authenticated.
  """
  myUserV2: UserV2

  """
  Added in 26.2.0. List users within a specific project. Requires project membership or higher privileges.
  """
  projectUsersV2(scope: ProjectUserV2Scope!, filter: UserV2Filter = null, orderBy: [UserV2OrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): UserV2Connection

  """
  Added in 26.2.0. Get a single domain by name. Returns an error if domain is not found.
  """
  domainV2(domainName: String!): DomainV2

  """
  Added in 26.2.0. List all domains with filtering and pagination (admin only). Requires superadmin privileges.
  """
  adminDomainsV2(filter: DomainV2Filter = null, orderBy: [DomainV2OrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): DomainV2Connection

  """Added in 26.2.0. List domains within resource group scope."""
  rgDomainsV2(scope: ResourceGroupDomainScope!, filter: DomainV2Filter = null, orderBy: [DomainV2OrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): DomainV2Connection

  """
  Added in 26.2.0. Get a single project by ID. Returns an error if project is not found.
  """
  projectV2(projectId: UUID!): ProjectV2

  """
  Added in 26.2.0. List all projects with filtering and pagination (admin only). Requires superadmin privileges.
  """
  adminProjectsV2(filter: ProjectV2Filter = null, orderBy: [ProjectV2OrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): ProjectV2Connection

  """
  Added in 26.2.0. List projects within a specific domain. Requires domain admin privileges or higher.
  """
  domainProjectsV2(scope: DomainProjectV2Scope!, filter: ProjectV2Filter = null, orderBy: [ProjectV2OrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): ProjectV2Connection

  """
  Added in 26.2.0. Get the domain that a project belongs to. Returns an error if project or domain is not found.
  """
  projectDomainV2(projectId: UUID!): DomainV2

  """
  Added in 26.4.2. Get a single keypair resource policy by name (admin only).
  """
  adminKeypairResourcePolicyV2(name: String!): KeypairResourcePolicyV2

  """
  Added in 26.4.2. List all keypair resource policies with pagination (admin only).
  """
  adminKeypairResourcePoliciesV2(filter: KeypairResourcePolicyV2Filter = null, orderBy: [KeypairResourcePolicyV2OrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): KeypairResourcePolicyV2Connection

  """
  Added in 26.4.2. Get a single user resource policy by name (admin only).
  """
  adminUserResourcePolicyV2(name: String!): UserResourcePolicyV2

  """
  Added in 26.4.2. List all user resource policies with pagination (admin only).
  """
  adminUserResourcePoliciesV2(filter: UserResourcePolicyV2Filter = null, orderBy: [UserResourcePolicyV2OrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): UserResourcePolicyV2Connection

  """
  Added in 26.4.2. Get a single project resource policy by name (admin only).
  """
  adminProjectResourcePolicyV2(name: String!): ProjectResourcePolicyV2

  """
  Added in 26.4.2. List all project resource policies with pagination (admin only).
  """
  adminProjectResourcePoliciesV2(filter: ProjectResourcePolicyV2Filter = null, orderBy: [ProjectResourcePolicyV2OrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): ProjectResourcePolicyV2Connection

  """Added in 26.4.2. Get the current user's keypair resource policy."""
  myKeypairResourcePolicyV2: KeypairResourcePolicyV2

  """Added in 26.4.2. Get the current user's user resource policy."""
  myUserResourcePolicyV2: UserResourcePolicyV2

  """
  Added in 26.4.2. List storage hosts the current user is allowed to mount, with the union of permissions inherited from domain, project, and keypair resource policies.
  """
  myStorageHostPermissions: MyStorageHostPermissionsPayload

  """Added in 26.4.2. List resource presets (admin only)."""
  adminResourcePresetsV2(filter: ResourcePresetFilter = null, orderBy: [ResourcePresetOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): ResourcePresetConnection

  """Added in 26.4.2. Get a single resource preset by ID (admin only)."""
  adminResourcePresetV2(id: UUID!): ResourcePresetV2

  """Added in 26.4.2. Get a single login client type by id."""
  loginClientType(id: UUID!): LoginClientType

  """
  Added in 26.4.2. Search login client types with filtering, ordering, and pagination.
  """
  loginClientTypes(filter: LoginClientTypeFilter = null, orderBy: [LoginClientTypeOrderBy!] = null, limit: Int = null, offset: Int = null): LoginClientTypeConnection

  """Added in 26.4.2. Search runtime variants."""
  runtimeVariants(filter: RuntimeVariantFilter = null, orderBy: [RuntimeVariantOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): RuntimeVariantConnection

  """Added in 26.4.2. Get a single runtime variant by ID."""
  runtimeVariant(id: UUID!): RuntimeVariant

  """Added in 26.4.2. Search runtime variant presets."""
  runtimeVariantPresets(filter: RuntimeVariantPresetFilter = null, orderBy: [RuntimeVariantPresetOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): RuntimeVariantPresetConnection

  """Added in 26.4.2. Get a single runtime variant preset by ID."""
  runtimeVariantPreset(id: UUID!): RuntimeVariantPreset

  """Added in 26.4.2. Search deployment revision presets."""
  deploymentRevisionPresets(filter: DeploymentRevisionPresetFilter = null, orderBy: [DeploymentRevisionPresetOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): DeploymentRevisionPresetConnection

  """Added in 26.4.2. Get a single deployment revision preset by ID."""
  deploymentRevisionPreset(id: UUID!): DeploymentRevisionPreset

  """Added in 26.4.2. Search all model cards (superadmin only)."""
  adminModelCardsV2(filter: ModelCardV2Filter = null, orderBy: [ModelCardV2OrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): ModelCardV2Connection

  """Added in 26.4.2. Search model cards within a MODEL_STORE project."""
  projectModelCardsV2(scope: ProjectModelCardV2Scope!, filter: ModelCardV2Filter = null, orderBy: [ModelCardV2OrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): ModelCardV2Connection

  """Added in 26.4.2. Get a single model card by ID."""
  modelCardV2(id: UUID!): ModelCardV2

  """
  Added in 26.4.2. Search deployment revision presets that satisfy a model card's minimum resource requirements.
  """
  modelCardAvailablePresets(scope: ModelCardAvailablePresetsScope!, filter: DeploymentRevisionPresetFilter = null, orderBy: [DeploymentRevisionPresetOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): DeploymentRevisionPresetConnection

  """Added in 26.4.2. Get my keypair resource allocation (current user)."""
  myKeypairResourceAllocationV2: KeypairResourceAllocationV2

  """Added in 26.4.2. Get project resource allocation (project usage)."""
  projectResourceAllocationV2(projectId: UUID!): ProjectResourceAllocationV2

  """Added in 26.4.2. Get domain resource allocation (admin only)."""
  adminDomainResourceAllocationV2(domainName: String!): DomainResourceAllocationV2

  """Added in 26.4.2. Get resource group resource allocation."""
  resourceGroupResourceAllocationV2(resourceGroupName: String!): ResourceGroupResourceAllocationV2

  """
  Added in 26.4.2. Get effective resource allocation for the current user.
  """
  effectiveResourceAllocationV2(input: EffectiveResourceAllocationV2Input!): EffectiveResourceAllocationV2

  """
  Added in 26.4.2. Get effective resource allocation for a specific user (admin only).
  """
  adminEffectiveResourceAllocationV2(input: AdminEffectiveResourceAllocationV2Input!): EffectiveResourceAllocationV2

  """
  Added in 26.4.2. Check which resource presets are available for session creation.
  """
  checkPresetAvailabilityV2(input: CheckPresetAvailabilityV2Input!): CheckPresetAvailabilityPayloadV2

  """Added in 26.4.2. Search all virtual folders (superadmin only)."""
  adminVfoldersV2(filter: VFolderFilter = null, orderBy: [VFolderOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): VFolderConnection

  """Added in 26.4.2. Get a single virtual folder by ID."""
  vfolderV2(vfolderId: UUID!): VFolder

  """Added in 26.4.2. List virtual folders within a specific project."""
  projectVfolders(projectId: UUID!, filter: VFolderFilter = null, orderBy: [VFolderOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): VFolderConnection

  """
  Added in 26.4.2. Search virtual folders accessible to the current user with pagination and filtering.
  """
  myVfolders(filter: VFolderFilter = null, orderBy: [VFolderOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): VFolderConnection
}

"""
Added in 26.3.0. Prometheus query definition entity implementing Relay Node pattern.
"""
type QueryDefinition implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """Human-readable query definition identifier."""
  name: String!

  """Human-readable description."""
  description: String

  """Sort rank (lower = higher priority)."""
  rank: Int!

  """Category UUID."""
  categoryId: UUID

  """Prometheus metric name."""
  metricName: String!

  """PromQL template with placeholders."""
  queryTemplate: String!

  """Default time window. Falls back to server config if null."""
  timeWindow: String

  """Query definition options including filter and group labels."""
  options: QueryDefinitionOptions!

  """Creation timestamp."""
  createdAt: DateTime!

  """Last update timestamp."""
  updatedAt: DateTime!

  """Added in 26.4.3. Resolved category entity."""
  category: QueryPresetCategory
}

"""Added in 26.3.0. Paginated connection for query definition records."""
type QueryDefinitionConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [QueryDefinitionEdge!]!

  """Total number of query definition records matching the query criteria."""
  count: Int!
}

"""An edge in a connection."""
type QueryDefinitionEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: QueryDefinition!
}

"""Added in 26.3.0. Result from executing a query definition."""
type QueryDefinitionExecuteResult {
  """Prometheus response status."""
  status: String!

  """Result type (e.g., matrix)."""
  resultType: String!

  """Metric result entries."""
  result: [QueryDefinitionMetricResult!]!
}

"""Added in 26.3.0. Filter input for querying query definitions."""
input QueryDefinitionFilter {
  """Filter by name."""
  name: StringFilter = null

  """Added in UNRELEASED. Filter by category ID."""
  categoryId: UUIDFilter = null

  """
  Added in UNRELEASED. Combine multiple filters with AND logic. All conditions must match.
  """
  AND: [QueryDefinitionFilter!] = null

  """
  Added in UNRELEASED. Combine multiple filters with OR logic. At least one condition must match.
  """
  OR: [QueryDefinitionFilter!] = null

  """
  Added in UNRELEASED. Negate the specified filters. Records matching these conditions will be excluded.
  """
  NOT: [QueryDefinitionFilter!] = null
}

"""Added in 26.3.0. Single metric result from Prometheus query."""
type QueryDefinitionMetricResult {
  """Label key-value pairs for this series"""
  metric: [MetricLabelEntry!]!

  """Data points (timestamp, value) for this series"""
  values: [QueryDefinitionMetricResultValue!]!
}

"""Added in 26.3.0. Single timestamp-value pair from Prometheus."""
type QueryDefinitionMetricResultValue {
  """Unix timestamp of the data point"""
  timestamp: Float!

  """Metric value as a string to preserve precision"""
  value: String!
}

"""Added in 26.3.0. Options for query definition label governance."""
type QueryDefinitionOptions {
  """Allowed filter label keys"""
  filterLabels: [String!]!

  """Allowed group-by label keys"""
  groupLabels: [String!]!
}

"""Added in 26.3.0. Options for query definition labels."""
input QueryDefinitionOptionsInput {
  """Allowed filter label keys."""
  filterLabels: [String!]!

  """Allowed group-by label keys."""
  groupLabels: [String!]!
}

"""Added in 26.3.0. Specifies ordering for query definition results."""
input QueryDefinitionOrderBy {
  """The field to order by."""
  field: QueryDefinitionOrderField!

  """Sort direction."""
  direction: OrderDirection! = DESC
}

"""
Added in 26.3.0. Fields available for ordering query definition results.
"""
enum QueryDefinitionOrderField {
  CREATED_AT
  UPDATED_AT
  NAME
}

"""Added in 26.3.0. Prometheus query preset category."""
type QueryPresetCategory {
  """Category ID"""
  id: UUID!

  """Human-readable category name"""
  name: String!

  """Optional category description"""
  description: String

  """Creation timestamp"""
  createdAt: DateTime!

  """Last update timestamp"""
  updatedAt: DateTime!
}

"""Added in 26.3.0. Time range for Prometheus query."""
input QueryTimeRangeInput {
  """Start of the time range."""
  start: DateTime!

  """End of the time range."""
  end: DateTime!

  """Query resolution step (e.g., '60s')."""
  step: String!
}

"""
Added in 26.3.0. Unified RBAC element type for scope-entity relationships
"""
enum RBACElementType {
  DOMAIN
  PROJECT
  USER
  SESSION
  VFOLDER
  MODEL_DEPLOYMENT
  KEYPAIR
  NOTIFICATION_CHANNEL
  NETWORK
  RESOURCE_GROUP
  CONTAINER_REGISTRY
  STORAGE_HOST
  AGENT
  KERNEL
  ROUTING
  IMAGE
  ARTIFACT
  ARTIFACT_REGISTRY
  SESSION_TEMPLATE
  APP_CONFIG
  MODEL_CARD
  RESOURCE_PRESET
  USER_RESOURCE_POLICY
  KEYPAIR_RESOURCE_POLICY
  PROJECT_RESOURCE_POLICY
  ROLE
  AUDIT_LOG
  EVENT_LOG
  PROJECT_ADMIN_PAGE
  DOMAIN_ADMIN_PAGE
  NOTIFICATION_RULE
  DEPLOYMENT_TOKEN
  DEPLOYMENT_POLICY
  DEPLOYMENT_REVISION
  IMAGE_ALIAS
  ROLE_ASSIGNMENT
  VFOLDER_DATA
  SESSION_APP_SERVICE
  USER_EMAIL
  ARTIFACT_REVISION
}

"""
Added in UNRELEASED. Filter for RBAC element type fields (scope_type / entity_type). Supports equals / in / not_equals / not_in.
"""
input RBACElementTypeFilter {
  """Matches rows with this exact element type."""
  equals: RBACElementType = null

  """Matches rows whose element type is in this list."""
  in: [RBACElementType!] = null

  """Excludes rows with this exact element type."""
  notEquals: RBACElementType = null

  """Excludes rows whose element type is in this list."""
  notIn: [RBACElementType!] = null
}

"""
Added in 26.2.0. Filter for domain fair shares within a resource group scope. References resource group membership columns to avoid excluding domains without fair share records.
"""
input RGDomainFairShareFilter {
  """Filter by scaling group name."""
  resourceGroup: StringFilter = null

  """Filter by domain name."""
  domainName: StringFilter = null

  """Filter by domain properties."""
  domain: DomainFairShareDomainNestedFilter = null

  """Combine with AND logic."""
  AND: [RGDomainFairShareFilter!] = null

  """Combine with OR logic."""
  OR: [RGDomainFairShareFilter!] = null

  """Negate filters."""
  NOT: [RGDomainFairShareFilter!] = null
}

"""
Added in 26.2.0. Filter for project fair shares within a resource group scope. References resource group membership columns to avoid excluding projects without fair share records.
"""
input RGProjectFairShareFilter {
  """Filter by scaling group name."""
  resourceGroup: StringFilter = null

  """Filter by project UUID."""
  projectId: UUIDFilter = null

  """Filter by domain name."""
  domainName: StringFilter = null

  """Filter by project properties."""
  project: ProjectFairShareProjectNestedFilter = null

  """Combine with AND logic."""
  AND: [RGProjectFairShareFilter!] = null

  """Combine with OR logic."""
  OR: [RGProjectFairShareFilter!] = null

  """Negate filters."""
  NOT: [RGProjectFairShareFilter!] = null
}

"""
Added in 26.2.0. Filter for user fair shares within a resource group scope. References resource group membership columns to avoid excluding users without fair share records.
"""
input RGUserFairShareFilter {
  """Filter by scaling group name."""
  resourceGroup: StringFilter = null

  """Filter by user UUID."""
  userUuid: UUIDFilter = null

  """Filter by project UUID."""
  projectId: UUIDFilter = null

  """Filter by domain name."""
  domainName: StringFilter = null

  """Filter by user properties."""
  user: UserFairShareUserNestedFilter = null

  """Combine with AND logic."""
  AND: [RGUserFairShareFilter!] = null

  """Combine with OR logic."""
  OR: [RGUserFairShareFilter!] = null

  """Negate filters."""
  NOT: [RGUserFairShareFilter!] = null
}

"""
Added in 25.19.0. This enum represents the readiness status of a replica, indicating whether the deployment has been checked and its health state.
"""
enum ReadinessStatus {
  NOT_CHECKED
  HEALTHY
  UNHEALTHY
}

"""Added in 25.15.0. Input type for registering a storage namespace."""
input RegisterStorageNamespaceInput {
  storageId: UUID!
  namespace: String!
}

"""
Added in 25.15.0. Payload returned after storage namespace registration.
"""
type RegisterStorageNamespacePayload {
  """ID of the registered storage namespace"""
  id: UUID!
}

"""
Added in 24.09.0. Input for rejecting an artifact revision.

Admin-only operation to reject artifact revisions, preventing their use.
"""
input RejectArtifactInput {
  artifactRevisionId: ID!
}

"""
Added in 25.14.0. Response payload for artifact revision rejection operations. Contains the rejected artifact revision. Admin-only operation.
"""
type RejectArtifactPayload {
  """Rejected artifact revision."""
  artifactRevision: ArtifactRevision!
}

"""Added in UNRELEASED. Input for rejecting a role invitation."""
input RejectRoleInvitationInput {
  invitationId: UUID!
}

"""
Added in UNRELEASED. Input for the replaceResourceGroupDefaultDeploymentOptions mutation. Full-replace semantics — the supplied payload is the complete new value.
"""
input ReplaceResourceGroupDefaultDeploymentOptionsInput {
  """Target resource group name."""
  resourceGroupName: String!

  """New default deployment options payload."""
  options: DeploymentOptionsInput!
}

"""
Added in UNRELEASED. Payload returned after replacing a resource group's default_deployment_options surface.
"""
type ReplaceResourceGroupDefaultDeploymentOptionsPayload {
  """Name of the resource group whose default options were replaced."""
  resourceGroupName: String!

  """The newly persisted ``default_deployment_options`` surface."""
  defaultDeploymentOptions: DeploymentOptionsInfoGQL!
}

"""
Added in UNRELEASED. Input for the replaceResourceGroupDefaultSessionOptions mutation. Full-replace semantics — the supplied payload is the complete new value.
"""
input ReplaceResourceGroupDefaultSessionOptionsInput {
  """Target resource group name."""
  resourceGroupName: String!

  """New default session options payload."""
  options: DefaultSessionOptionsInput!
}

"""
Added in UNRELEASED. Payload returned after replacing a resource group's default_session_options surface.
"""
type ReplaceResourceGroupDefaultSessionOptionsPayload {
  """Name of the resource group whose default options were replaced."""
  resourceGroupName: String!

  """The newly persisted ``default_session_options`` surface."""
  defaultSessionOptions: DefaultSessionOptionsInfo!
}

"""
Added in UNRELEASED. Failure detail for a single permission entry in replace
"""
type ReplaceRolePermissionFailureInfo {
  """Role ID of the failed entry"""
  roleId: UUID!

  """Scope element type of the failed entry"""
  scopeType: String!

  """Scope element ID of the failed entry"""
  scopeId: String!

  """Entity element type of the failed entry"""
  entityType: String!

  """Operation type of the failed entry"""
  operation: String!

  """Error message describing the failure"""
  message: String!
}

"""
Added in UNRELEASED. Input for replacing one role's entire scoped-permission set
"""
input ReplaceRolePermissionsInput {
  roleId: UUID!
  permissions: [CreatePermissionInput!]!
}

"""
Added in UNRELEASED. Payload for replacing a role's entire scoped-permission set
"""
type ReplaceRolePermissionsPayload {
  """Permission rows that make up the new set"""
  items: [Permission!]!

  """Permission entries that failed to insert"""
  failed: [ReplaceRolePermissionFailureInfo!]!
}

"""Added in 25.19.0. """
input ReplicaFilter {
  status: ReplicaStatusFilter = null
  trafficStatus: TrafficStatusFilter = null
  AND: [ReplicaFilter!] = null
  OR: [ReplicaFilter!] = null
  NOT: [ReplicaFilter!] = null
}

"""
Added in UNRELEASED. This enum represents the health check status of a replica.
"""
enum ReplicaHealthStatus {
  NOT_CHECKED
  HEALTHY
  UNHEALTHY
  DEGRADED
}

"""Added in 25.19.0. """
input ReplicaOrderBy {
  field: ReplicaOrderField!
  direction: OrderDirection! = DESC
}

enum ReplicaOrderField {
  CREATED_AT
  ID
}

"""
Added in 25.19.0. Represents the current replica state of a deployment, including the desired replica count and access to the list of active replicas.
"""
type ReplicaState {
  desiredReplicaCount: Int!
}

"""
Added in 25.19.0. This enum represents the provisioning status of a replica.
"""
enum ReplicaStatus {
  PROVISIONING
  RUNNING
  TERMINATING
  TERMINATED
  FAILED_TO_START
}

"""Added in 25.19.0. Payload for replica status changed event."""
type ReplicaStatusChangedPayload {
  """The replica whose status changed"""
  replica: ModelReplica!
}

"""Added in 25.19.0. """
input ReplicaStatusFilter {
  """The in  field."""
  in: [ReplicaStatus!] = null
  equals: ReplicaStatus = null

  """Excludes statuses in the list."""
  notIn: [ReplicaStatus!] = null

  """Excludes exact status match."""
  notEquals: ReplicaStatus = null
}

"""Added in 25.14.0. Reservoir registry node."""
type ReservoirRegistry implements Node {
  """The Globally Unique ID of this object"""
  id: ID!
  name: String!
  endpoint: String!
  accessKey: String!
  secretKey: String!
  apiVersion: String!

  """The remote artifact registries of this entity."""
  remoteArtifactRegistries: ArtifactRegistryMetaConnection
}

"""
Added in 25.14.0. Relay-style connection for paginated reservoir registry queries.
"""
type ReservoirRegistryConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [ReservoirRegistryEdge!]!

  """The count of this entity."""
  count: Int!
}

"""An edge in a connection."""
type ReservoirRegistryEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: ReservoirRegistry!
}

"""Added in 26.2.0. Resource allocation with requested and used slots."""
type ResourceAllocation {
  """
  The resource slots originally requested. Typed as Any because this field holds a nested GQL type (ResourceSlotGQL).
  """
  requested: ResourceSlot!

  """
  The resource slots currently used. Typed as Any because this field holds a nested GQL type (ResourceSlotGQL).
  """
  used: ResourceSlot
}

"""
Added in 26.3.0. Relay-style connection for per-slot kernel resource allocations.
"""
type ResourceAllocationConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [KernelResourceAllocationEdge!]!
  count: Int!
}

"""
Added in 25.19.0. Compute resource configuration for the deployment. Specifies CPU, memory, GPU allocations and additional resource options.
"""
type ResourceConfig {
  """The resource group of this entity."""
  resourceGroup: ScalingGroupNode
  resourceGroupName: String!
  resourceOpts: ResourceOpts
}

"""Added in 25.19.0. """
input ResourceConfigInput {
  """Added in 26.1.0. Resources allocated for the deployment."""
  resourceSlots: ResourceSlotInput!

  """
  Added in 26.1.0. Additional options for the resources such as shared memory.
  """
  resourceOpts: ResourceOptsInput = null
}

"""Added in 26.1.0. Resource group with structured configuration"""
type ResourceGroup implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """
  Unique name identifying the resource group. Used as primary key and referenced by agents, sessions, and resource presets.
  """
  name: String!

  """Added in 26.2.0. Status information including active and public flags."""
  status: ResourceGroupStatus!

  """
  Added in 26.2.0. Metadata including description and creation timestamp.
  """
  metadata: ResourceGroupMetadata!

  """Added in 26.2.0. Network configuration for the resource group."""
  network: ResourceGroupNetworkConfig!

  """
  Added in 26.2.0. Scheduler configuration for the resource group. Use scheduler.type to check if fair-share scheduling is enabled.
  """
  scheduler: ResourceGroupSchedulerConfig!

  """
  Added in UNRELEASED. Default deployment options (timeouts, etc.) snapshot-copied onto each new deployment created in this resource group.
  """
  defaultDeploymentOptions: DeploymentOptionsInfoGQL!

  """
  Added in UNRELEASED. Default session options used as the fallback layer for the scheduling controller's options resolver at session enqueue time.
  """
  defaultSessionOptions: DefaultSessionOptionsInfo!

  """
  Added in 26.1.0. Fair share calculation configuration for this resource group. Defines decay parameters and resource weights for fair share factor computation. Resource weights are merged with capacity and include default indicators.
  """
  fairShareSpec: FairShareScalingGroupSpec

  """
  Added in 26.1.0. Resource usage information for this resource group. Provides aggregated metrics for capacity, used, and free resources. This is a lazy-loaded field that queries agent and kernel data on demand.
  """
  resourceInfo: ResourceInfo
}

"""Added in 26.2.0. Resource group connection"""
type ResourceGroupConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [ResourceGroupEdge!]!
  count: Int!
}

"""Added in 24.09.0. Resource group scope for domain-level operations"""
input ResourceGroupDomainScope {
  """Resource group name to scope the operation"""
  resourceGroupName: String!
}

"""An edge in a connection."""
type ResourceGroupEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: ResourceGroup!
}

"""Added in 26.1.0. Filter for resource groups"""
input ResourceGroupFilter {
  name: StringFilter = null
  description: StringFilter = null
  isActive: Boolean = null
  isPublic: Boolean = null
  AND: [ResourceGroupFilter!] = null
  OR: [ResourceGroupFilter!] = null
  NOT: [ResourceGroupFilter!] = null
}

"""Added in 26.2.0. Metadata for a resource group."""
type ResourceGroupMetadata {
  """Human-readable description of the resource group."""
  description: String

  """Timestamp when the resource group was created."""
  createdAt: DateTime!
}

"""Added in 26.2.0. Network configuration for a resource group."""
type ResourceGroupNetworkConfig {
  """WebSocket proxy address for this resource group."""
  wsproxyAddr: String

  """
  Whether to use host network mode for containers in this resource group.
  """
  useHostNetwork: Boolean!
}

"""Added in 26.1.0. Order by specification for resource groups"""
input ResourceGroupOrderBy {
  field: ResourceGroupOrderField!
  direction: OrderDirection! = ASC
}

"""Added in 26.1.0. Fields available for ordering resource groups"""
enum ResourceGroupOrderField {
  NAME
  CREATED_AT
  IS_ACTIVE
}

"""
Added in 24.09.0. Resource group + domain scope for project-level operations
"""
input ResourceGroupProjectScope {
  """Resource group name to scope the operation"""
  resourceGroupName: String!

  """Domain name to scope the operation"""
  domainName: String!
}

"""Added in 26.4.2. Payload for resource group resource allocation query."""
type ResourceGroupResourceAllocationV2 {
  """Resource group resource usage."""
  resourceGroup: ResourceGroupUsageV2!
}

"""Added in 26.2.0. Scheduler configuration for a resource group."""
type ResourceGroupSchedulerConfig {
  """
  Type of scheduler used for session scheduling (fifo, lifo, drf, fair-share).
  """
  type: SchedulerType!

  """Preemption configuration for this resource group."""
  preemption: PreemptionConfig!
}

"""Added in 26.2.0. Status information for a resource group."""
type ResourceGroupStatus {
  """Whether the resource group is active and can accept new sessions."""
  isActive: Boolean!

  """Whether the resource group is publicly accessible to all users."""
  isPublic: Boolean!
}

"""
Added in 26.4.2. Resource usage for a resource group (agent-level physical resources).
"""
type ResourceGroupUsageV2 {
  """Total agent capacity."""
  capacity: [ResourceSlotEntry!]!

  """Currently occupied by sessions."""
  used: [ResourceSlotEntry!]!

  """Free resources (capacity - used)."""
  free: [ResourceSlotEntry!]!

  """Largest single-agent free resources."""
  maxPerNode: [ResourceSlotEntry!]!
}

"""
Added in 24.09.0. Resource group + domain + project scope for user-level operations
"""
input ResourceGroupUserScope {
  """Resource group name to scope the operation"""
  resourceGroupName: String!

  """Domain name to scope the operation"""
  domainName: String!

  """Project ID to scope the operation"""
  projectId: String!
}

"""
Added in 26.1.0. Resource information for a resource group. Provides aggregated resource metrics including capacity, used, and free resources.
"""
type ResourceInfo {
  """Total available resources"""
  capacity: ResourceSlot!

  """Currently occupied resources"""
  used: ResourceSlot!

  """Available resources (capacity - used)"""
  free: ResourceSlot!
}

"""Added in 26.4.2. A resource limit entry that may be unlimited."""
type ResourceLimitEntry {
  """Resource type identifier (e.g., cpu, mem, cuda.shares)"""
  resourceType: String!

  """Limit quantity. Null when unlimited."""
  quantity: Decimal

  """Whether this resource type has no limit."""
  unlimited: Boolean!
}

"""
Added in 26.1.0. A collection of additional resource options for a deployment. Contains key-value pairs for resource configuration like shared memory.
"""
type ResourceOpts {
  """List of resource option entries."""
  entries: [ResourceOptsEntry!]!
}

"""
Added in 26.1.0. A single key-value entry representing a resource option. Contains additional resource configuration such as shared memory settings.
"""
type ResourceOptsEntry {
  """The name of this resource option (e.g., 'shmem')."""
  name: String!

  """The value for this resource option (e.g., '64m')."""
  value: String!
}

"""
Added in 26.1.0. A single key-value entry representing a resource option.
"""
input ResourceOptsEntryInput {
  """The name of this resource option (e.g., 'shmem')."""
  name: String!

  """The value for this resource option (e.g., '64m')."""
  value: String!
}

"""
Added in 26.1.0. A collection of additional resource options for input.
"""
input ResourceOptsInput {
  """List of resource option entries."""
  entries: [ResourceOptsEntryInput!]!
}

"""Added in 26.4.2. Resource preset connection."""
type ResourcePresetConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [ResourcePresetV2Edge!]!
  count: Int!
}

"""Added in 26.4.2. Filter for resource presets."""
input ResourcePresetFilter {
  name: StringFilter = null
  resourceGroupName: StringFilter = null
  AND: [ResourcePresetFilter!] = null
  OR: [ResourcePresetFilter!] = null
  NOT: [ResourcePresetFilter!] = null
}

"""Added in 26.4.2. Order by specification for resource presets."""
input ResourcePresetOrderBy {
  field: ResourcePresetOrderField!
  direction: OrderDirection! = ASC
}

"""Added in 26.4.2. Fields available for ordering resource presets."""
enum ResourcePresetOrderField {
  NAME
}

"""Added in 26.4.2. Resource preset with resource slot allocations."""
type ResourcePresetV2 implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """Resource preset name."""
  name: String!

  """Resource slot allocations for this preset."""
  resourceSlots: [ResourceSlotEntry!]!

  """Shared memory size with both bytes and human-readable format."""
  sharedMemory: BinarySizeInfo

  """Resource group name. Null means global preset."""
  resourceGroupName: String

  """Added in 26.4.3. The resource group this preset belongs to."""
  resourceGroup: ResourceGroup
}

"""An edge in a connection."""
type ResourcePresetV2Edge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: ResourcePresetV2!
}

"""
Added in 26.1.0. A collection of compute resource allocations. Represents the resources consumed, allocated, or available for a workload. Each entry specifies a resource type and its quantity.
"""
type ResourceSlot {
  """List of resource allocations"""
  entries: [ResourceSlotEntry!]!
}

"""
Added in 26.1.0. A single entry representing one resource type and its allocated quantity. Resource types include compute resources (cpu, mem), accelerators (cuda.shares, cuda.device, rocm.device), and custom resources defined by plugins.
"""
type ResourceSlotEntry {
  """Resource type identifier (e.g., cpu, mem, cuda.shares)"""
  resourceType: String!

  """Quantity of the resource"""
  quantity: Decimal!
}

"""
Added in 26.1.0. A single entry representing one resource type and its allocated quantity.
"""
input ResourceSlotEntryInput {
  """Resource type identifier (e.g., 'cpu', 'mem', 'cuda.device')."""
  resourceType: String!

  """Quantity of the resource as a decimal string."""
  quantity: String!
}

"""
Added in 26.1.0. A collection of compute resource allocations for input.
"""
input ResourceSlotInput {
  """List of resource allocations."""
  entries: [ResourceSlotEntryInput!]!
}

"""
Added in 26.3.0. A registered resource slot type describing display metadata
and formatting rules for a specific resource (e.g., cpu, mem, cuda.device).
"""
type ResourceSlotType implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """
  Unique identifier for the resource slot (e.g., 'cpu', 'mem', 'cuda.device').
  """
  slotName: String!

  """Category of the slot type (e.g., 'count', 'bytes', 'unique-count')."""
  slotType: String!

  """Human-readable name for display in UIs."""
  displayName: String!

  """Longer description of what this resource slot represents."""
  description: String!

  """
  Unit label used when displaying resource amounts (e.g., 'GiB', 'cores').
  """
  displayUnit: String!

  """Icon identifier for UI rendering (e.g., 'cpu', 'memory', 'gpu')."""
  displayIcon: String!

  """Number formatting rules (binary vs decimal prefix, rounding)."""
  numberFormat: NumberFormat!

  """Display ordering rank. Lower values appear first."""
  rank: Int!
}

"""
Added in 26.3.0. Relay-style connection for paginated resource slot types.
"""
type ResourceSlotTypeConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [ResourceSlotTypeEdge!]!
  count: Int!
}

"""An edge in a connection."""
type ResourceSlotTypeEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: ResourceSlotType!
}

"""Added in 26.3.0. Filter criteria for querying resource slot types."""
input ResourceSlotTypeFilter {
  slotName: StringFilter = null
  slotType: StringFilter = null
  displayName: StringFilter = null
  AND: [ResourceSlotTypeFilter!] = null
  OR: [ResourceSlotTypeFilter!] = null
  NOT: [ResourceSlotTypeFilter!] = null
}

"""Added in 26.3.0. Ordering specification for resource slot types."""
input ResourceSlotTypeOrderBy {
  field: ResourceSlotTypeOrderField!
  direction: OrderDirection! = ASC
}

"""Added in 26.3.0. Fields available for ordering resource slot types."""
enum ResourceSlotTypeOrderField {
  SLOT_NAME
  RANK
  DISPLAY_NAME
}

"""
Added in 26.2.0. Resource weight with default indicator. Shows whether this resource type's weight was explicitly set or uses default.
"""
type ResourceWeightEntry {
  """Resource type identifier"""
  resourceType: String!

  """Weight multiplier for this resource type"""
  weight: Decimal!

  """Whether this resource uses the resource group's default weight"""
  usesDefault: Boolean!
}

"""
Added in 26.1.0. Input for a single resource weight entry. Specifies how much a resource type contributes to fair share calculations.
"""
input ResourceWeightEntryInput {
  """
  Resource type identifier (e.g., 'cpu', 'mem', 'cuda.shares'). Must match the resource types used in the cluster.
  """
  resourceType: String!

  """
  Weight multiplier for this resource type in fair share calculations. Higher weight means this resource contributes more to the normalized usage. Set to null to remove this resource type (revert to default weight 1.0). Example: 0.001 for memory (bytes) to normalize against CPU cores.
  """
  weight: Decimal = null
}

"""
Added in 24.09.0. Input for restoring previously deleted artifacts.

Reverses the soft-delete operation, making the artifacts available again.
"""
input RestoreArtifactsInput {
  artifactIds: [ID!]!
}

"""
Added in 25.15.0. Response payload for artifact restoration operations. Contains the artifacts that were restored from soft-deleted state.
"""
type RestoreArtifactsPayload {
  """List of restored artifacts."""
  artifacts: [Artifact!]!
}

"""
Added in UNRELEASED. Payload returned after restoring a virtual folder from trash.
"""
type RestoreVFolderPayload {
  """ID of the restored virtual folder"""
  id: UUID!
}

"""
Added in 26.4.3. Per-deployment result of an admin bulk revision refresh.
"""
type RevisionRefreshResult {
  """Deployment ID"""
  deploymentId: UUID!

  """
  Newly created revision ID; null when the refresh failed for this deployment
  """
  newRevisionId: UUID

  """Whether the refresh succeeded for this deployment"""
  success: Boolean!

  """Error class and message when the refresh failed; null on success"""
  failureReason: String
}

"""Added in 26.4.2. Payload returned after revoking a login session."""
type RevokeLoginSessionPayload {
  """Whether the revocation was successful"""
  success: Boolean!
}

"""
Added in 24.09.0. Input for revoking a keypair owned by the current user.
"""
input RevokeMyKeypairInput {
  """Access key of the keypair to revoke. Must not be the main access key."""
  accessKey: String!
}

"""Added in 26.2.0. Payload returned after revoking a keypair."""
type RevokeMyKeypairPayload {
  """Whether the revocation was successful."""
  success: Boolean!
}

"""Added in 26.3.0. Input for revoking a role from a user"""
input RevokeRoleInput {
  userId: UUID!
  roleId: UUID!
}

"""Added in 26.3.0. RBAC role."""
type Role implements Node {
  """The Globally Unique ID of this object"""
  id: ID!
  name: String!
  description: String
  source: RoleSource!
  status: RoleStatus!
  createdAt: DateTime!
  updatedAt: DateTime!
  deletedAt: DateTime

  """Added in 26.3.0. Permissions associated with this role."""
  permissions(filter: PermissionFilter = null, orderBy: [PermissionOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): PermissionConnection

  """Added in 26.3.0. Users assigned to this role."""
  users(filter: RoleAssignmentFilter = null, orderBy: [RoleAssignmentOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): RoleAssignmentConnection

  """Added in 26.4.2. Scopes this role is registered in."""
  scopes(filter: EntityFilter = null, orderBy: [EntityOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): EntityConnection
}

"""Added in 26.3.0. RBAC role assignment (user-role association)."""
type RoleAssignment implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """The assigned user ID."""
  userId: UUID!

  """The assigned role ID."""
  roleId: UUID!

  """The user who granted this assignment."""
  grantedBy: UUID
  grantedAt: DateTime!

  """The assigned role."""
  role: Role

  """The assigned user."""
  user: UserV2

  """Added in 26.4.3. The user who granted this role assignment."""
  grantedByUser: UserV2
}

"""Added in 26.3.0. Role assignment connection."""
type RoleAssignmentConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [RoleAssignmentEdge!]!
  count: Int!
}

"""An edge in a connection."""
type RoleAssignmentEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: RoleAssignment!
}

"""Added in 26.3.0. Filter for role assignments"""
input RoleAssignmentFilter {
  roleId: UUIDFilter = null
  role: RoleAssignmentRoleNestedFilter = null
  permission: PermissionNestedFilter = null
  username: StringFilter = null
  email: StringFilter = null
  AND: [RoleAssignmentFilter!] = null
  OR: [RoleAssignmentFilter!] = null
  NOT: [RoleAssignmentFilter!] = null
}

"""Added in 26.3.0. Order by specification for role assignments"""
input RoleAssignmentOrderBy {
  field: RoleAssignmentOrderField!
  direction: OrderDirection! = DESC
}

"""Added in 26.3.0. Role assignment ordering field"""
enum RoleAssignmentOrderField {
  USERNAME
  EMAIL
  GRANTED_AT
}

"""
Added in 26.3.0. Nested filter for roles within a role assignment. Filters assignments that have a role matching all specified conditions.
"""
input RoleAssignmentRoleNestedFilter {
  name: StringFilter = null
  source: RoleSourceFilter = null
  status: RoleStatusFilter = null
  AND: [RoleAssignmentRoleNestedFilter!] = null
  OR: [RoleAssignmentRoleNestedFilter!] = null
  NOT: [RoleAssignmentRoleNestedFilter!] = null
}

"""Added in 26.3.0. Role connection."""
type RoleConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [RoleEdge!]!
  count: Int!
}

"""An edge in a connection."""
type RoleEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: Role!
}

"""Added in 26.3.0. Filter for roles"""
input RoleFilter {
  name: StringFilter = null
  source: RoleSourceFilter = null
  status: RoleStatusFilter = null
  assignedUser: RoleUserNestedFilter = null
  AND: [RoleFilter!] = null
  OR: [RoleFilter!] = null
  NOT: [RoleFilter!] = null
}

"""Added in UNRELEASED. A role invitation."""
type RoleInvitation implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """Inviter user ID."""
  inviterUserId: UUID

  """Invitee user ID."""
  inviteeUserId: UUID!

  """Role ID."""
  roleId: UUID!

  """Invitation state."""
  state: RoleInvitationState!

  """Creation timestamp."""
  createdAt: DateTime!

  """Last update timestamp."""
  updatedAt: DateTime

  """The user who sent this invitation. Null for system-issued invitations."""
  inviter: UserV2

  """
  The user who received this invitation. Null if the user no longer exists.
  """
  invitee: UserV2

  """
  The role this invitation grants on acceptance. Null if the role no longer exists.
  """
  role: Role
}

"""Added in UNRELEASED. Role invitation connection."""
type RoleInvitationConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [RoleInvitationEdge!]!
  count: Int!
}

"""An edge in a connection."""
type RoleInvitationEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: RoleInvitation!
}

"""Added in UNRELEASED. Filter for role invitations."""
input RoleInvitationFilter {
  state: RoleInvitationStateFilter = null
  roleId: UUIDFilter = null
  role: RoleInvitationRoleNestedFilter = null
  inviter: RoleInvitationUserNestedFilter = null
  invitee: RoleInvitationUserNestedFilter = null
  AND: [RoleInvitationFilter!] = null
  OR: [RoleInvitationFilter!] = null
  NOT: [RoleInvitationFilter!] = null
}

"""Added in UNRELEASED. Order by specification for role invitations."""
input RoleInvitationOrderBy {
  field: RoleInvitationOrderField!
  direction: OrderDirection! = DESC
}

"""Added in UNRELEASED. Role invitation ordering field."""
enum RoleInvitationOrderField {
  CREATED_AT
  UPDATED_AT
  STATE
}

"""
Added in UNRELEASED. Nested filter for the role associated with an invitation.
"""
input RoleInvitationRoleNestedFilter {
  name: StringFilter = null
}

"""Added in UNRELEASED. Role invitation state."""
enum RoleInvitationState {
  PENDING
  ACCEPTED
  REJECTED
  CANCELED
}

"""Added in UNRELEASED. Filter for role invitation state."""
input RoleInvitationStateFilter {
  equals: RoleInvitationState = null

  """Match any of the provided states."""
  in: [RoleInvitationState!] = null

  """Exclude exact state match."""
  notEquals: RoleInvitationState = null

  """Exclude any of the provided states."""
  notIn: [RoleInvitationState!] = null
}

"""
Added in UNRELEASED. Nested filter for a user (inviter or invitee) of an invitation.
"""
input RoleInvitationUserNestedFilter {
  email: StringFilter = null
}

"""Added in 26.3.0. Order by specification for roles"""
input RoleOrderBy {
  field: RoleOrderField!
  direction: OrderDirection! = DESC
}

"""Added in 26.3.0. Role ordering field"""
enum RoleOrderField {
  NAME
  CREATED_AT
  UPDATED_AT
}

"""Added in 26.3.0. Role definition source"""
enum RoleSource {
  SYSTEM
  CUSTOM
}

"""
Added in 26.3.0. Filter for role source with equality and membership operators.
"""
input RoleSourceFilter {
  """Matches roles with this exact source."""
  equals: RoleSource = null

  """Matches roles whose source is in this list."""
  in: [RoleSource!] = null

  """Excludes roles with this exact source."""
  notEquals: RoleSource = null

  """Excludes roles whose source is in this list."""
  notIn: [RoleSource!] = null
}

"""Added in 26.3.0. Role status"""
enum RoleStatus {
  ACTIVE
  INACTIVE
  DELETED
}

"""
Added in 26.3.0. Filter for role status with equality and membership operators.
"""
input RoleStatusFilter {
  """Matches roles with this exact status."""
  equals: RoleStatus = null

  """Matches roles whose status is in this list."""
  in: [RoleStatus!] = null

  """Excludes roles with this exact status."""
  notEquals: RoleStatus = null

  """Excludes roles whose status is in this list."""
  notIn: [RoleStatus!] = null
}

"""Added in UNRELEASED. Filter roles by their user assignments."""
input RoleUserNestedFilter {
  userId: UUIDFilter = null
  AND: [RoleUserNestedFilter!] = null
  OR: [RoleUserNestedFilter!] = null
  NOT: [RoleUserNestedFilter!] = null
}

"""
Added in 25.19.0. Configuration for rolling update strategy. Defaults: max_surge=50%, max_unavailable=0%.
"""
input RollingUpdateConfigInput {
  maxSurge: IntOrPercentInput
  maxUnavailable: IntOrPercentInput
}

"""Added in 25.19.0. Represents a route for a model deployment."""
type Route implements Node {
  """The Globally Unique ID of this object"""
  id: ID!
  deploymentId: ID!
  sessionId: ID
  revisionId: ID

  """The lifecycle status of the route."""
  status: RouteStatus!

  """The health check status of the route."""
  healthStatus: RouteHealthStatus!

  """
  The traffic routing status (ACTIVE/INACTIVE). Controls whether traffic should be sent to this route.
  """
  trafficStatus: RouteTrafficStatus!

  """The traffic ratio for load balancing."""
  trafficRatio: Float!

  """The timestamp when the route was created."""
  createdAt: DateTime

  """Error data if the route is in a failed state."""
  errorData: JSON

  """The deployment this route belongs to."""
  deployment: ModelDeployment

  """
  The session associated with the route. Can be null if the route is still provisioning.
  """
  session: ID @deprecated(reason: "Use session_v2 instead.")

  """
  Added in 26.4.3. The compute session associated with this route, resolved via DataLoader.
  """
  sessionV2: SessionV2

  """The revision associated with the route."""
  revision: ModelRevision
}

"""Added in 25.19.0. Connection type for paginated route results."""
type RouteConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [RouteEdge!]!

  """Total number of routes matching the filter criteria."""
  count: Int!
}

"""An edge in a connection."""
type RouteEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: Route!
}

"""Added in 25.19.0. Filter for routes."""
input RouteFilter {
  status: [RouteStatus!] = null
  healthStatus: [RouteHealthStatus!] = null
  trafficStatus: [RouteTrafficStatus!] = null
  AND: [RouteFilter!] = null
  OR: [RouteFilter!] = null
  NOT: [RouteFilter!] = null
}

"""Added in 25.19.0. Health check status of a route."""
enum RouteHealthStatus {
  NOT_CHECKED
  HEALTHY
  UNHEALTHY
  DEGRADED
}

"""Added in 26.3.0. Route history record."""
type RouteHistory implements Node {
  """The Globally Unique ID of this object"""
  id: ID!
  routeId: ID!
  deploymentId: ID!
  category: String!
  phase: String!
  fromStatus: String
  toStatus: String
  result: SchedulingResult!
  errorCode: String
  message: String
  subSteps: [SubStepResultGQL!]!
  attempts: Int!
  createdAt: DateTime!
  updatedAt: DateTime!

  """Added in 26.4.3. The route this history record belongs to."""
  route: Route

  """Added in 26.4.3. The deployment this history record belongs to."""
  deployment: ModelDeployment
}

"""Added in 26.3.0. Route history connection."""
type RouteHistoryConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [RouteHistoryEdge!]!
  count: Int!
}

"""An edge in a connection."""
type RouteHistoryEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: RouteHistory!
}

"""Added in 24.09.0. Filter for route history"""
input RouteHistoryFilter {
  id: UUIDFilter = null
  routeId: UUIDFilter = null
  deploymentId: UUIDFilter = null
  phase: StringFilter = null
  fromStatus: [String!] = null
  toStatus: [String!] = null
  result: SchedulingResultFilter = null
  errorCode: StringFilter = null
  message: StringFilter = null
  createdAt: DateTimeFilter = null
  updatedAt: DateTimeFilter = null
  AND: [RouteHistoryFilter!] = null
  OR: [RouteHistoryFilter!] = null
  NOT: [RouteHistoryFilter!] = null
}

"""Added in 24.09.0. Order by specification for route history"""
input RouteHistoryOrderBy {
  field: RouteHistoryOrderField!
  direction: OrderDirection! = DESC
}

"""Added in 26.3.0. Fields available for ordering route history"""
enum RouteHistoryOrderField {
  CREATED_AT
  UPDATED_AT
}

"""Added in 25.19.0. Order by specification for routes."""
input RouteOrderBy {
  field: RouteOrderField!
  direction: OrderDirection! = ASC
}

"""Added in 25.19.0. Fields available for ordering routes"""
enum RouteOrderField {
  CREATED_AT
  STATUS
  TRAFFIC_RATIO
}

"""Added in 24.09.0. Scope for route scheduling history query"""
input RouteScope {
  """Route ID to get history for"""
  routeId: UUID!
}

"""Added in 25.19.0. Lifecycle status of a route."""
enum RouteStatus {
  PROVISIONING
  RUNNING
  TERMINATING
  TERMINATED
  FAILED_TO_START
}

"""
Added in 25.19.0. Traffic routing status for a route. Controls whether traffic should be sent to this route.
"""
enum RouteTrafficStatus {
  ACTIVE
  INACTIVE
}

"""
Added in 26.4.2. Represents an inference runtime engine definition (e.g., vLLM, SGLang, NIM, TGI). Previously hardcoded as an enum, runtime variants are now managed as dynamic database entities to allow administrators to register and configure new inference runtimes without code changes.
"""
type RuntimeVariant implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """
  Unique short identifier for the runtime engine (e.g., 'vllm', 'sglang', 'nim', 'tgi').
  """
  name: String!

  """
  Human-readable description explaining the runtime engine and its typical use cases.
  """
  description: String

  """Timestamp when this runtime variant was registered."""
  createdAt: DateTime!

  """Timestamp of the last modification to this runtime variant."""
  updatedAt: DateTime
}

"""Added in 26.4.2. Paginated list of runtime variants."""
type RuntimeVariantConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [RuntimeVariantEdge!]!
  count: Int!
}

"""An edge in a connection."""
type RuntimeVariantEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: RuntimeVariant!
}

"""Added in 26.4.2. Filter for runtime variants."""
input RuntimeVariantFilter {
  """Name filter."""
  name: StringFilter = null
}

"""Added in 26.4.2. Order specification."""
input RuntimeVariantOrderBy {
  """Field to order by."""
  field: RuntimeVariantOrderField!

  """ASC or DESC."""
  direction: String! = "ASC"
}

"""Added in 26.4.2. Order fields for runtime variants."""
enum RuntimeVariantOrderField {
  NAME
  CREATED_AT
}

"""
Added in 26.4.2. Defines a configurable parameter for a runtime variant. Each preset maps a user-facing setting (e.g., tensor parallelism, quantization) to either an environment variable or a command-line argument that is applied to the inference container.
"""
type RuntimeVariantPreset implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """The runtime variant this preset belongs to."""
  runtimeVariantId: UUID!

  """
  Human-readable name of the configurable parameter (e.g., 'Tensor Parallel Size', 'Quantization').
  """
  name: String!

  """
  Detailed explanation of what this parameter controls and how it affects inference behavior.
  """
  description: String

  """
  Display ordering among presets of the same runtime variant, with lower values shown first.
  """
  rank: Int!

  """
  Specification defining how the user-provided value is applied to the inference container.
  """
  targetSpec: PresetTargetSpec!

  """UI category group for organizing parameters."""
  category: String

  """Human-readable display label for the UI."""
  displayName: String

  """UI rendering options."""
  uiOption: UIOption

  """Timestamp when this preset was created."""
  createdAt: DateTime!

  """Timestamp of the last modification to this preset."""
  updatedAt: DateTime
}

"""Added in 26.4.2. Paginated list of runtime variant presets."""
type RuntimeVariantPresetConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [RuntimeVariantPresetEdge!]!
  count: Int!
}

"""An edge in a connection."""
type RuntimeVariantPresetEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: RuntimeVariantPreset!
}

"""Added in 26.4.2. Filter for presets."""
input RuntimeVariantPresetFilter {
  """Name filter."""
  name: StringFilter = null

  """Variant ID filter."""
  runtimeVariantId: UUIDFilter = null
}

"""Added in 26.4.2. Order specification."""
input RuntimeVariantPresetOrderBy {
  """Field to order by."""
  field: RuntimeVariantPresetOrderField!

  """ASC or DESC."""
  direction: String! = "ASC"
}

"""Added in 26.4.2. Order fields for runtime variant presets."""
enum RuntimeVariantPresetOrderField {
  NAME
  RANK
  CREATED_AT
}

"""Added in 24.09.0. Input for SMTP authentication credentials"""
input SMTPAuthInput {
  username: String = null
  password: String = null
}

"""Added in 24.09.0. Input for SMTP server connection settings"""
input SMTPConnectionInput {
  host: String!
  port: Int!
  useTls: Boolean! = true
  timeout: Int! = 30
}

"""
Added in 26.4.2. SSH keypair read model. Never includes the private key.
"""
type SSHKeypairNode {
  """Access key owning this SSH keypair."""
  accessKey: String!

  """PEM-encoded SSH public key, or null if none is registered."""
  sshPublicKey: String
}

extend type ScalingGroupNode @key(fields: "id") {
  id: ID! @external
}

"""
Added in UNRELEASED. Replica scaling axis for a deployment, orthogonal to the lifecycle status. ``SCALING`` while the replica reconciler is adjusting replica count against desired_replica_count; ``STABLE`` once holding at the desired count.
"""
enum ScalingState {
  STABLE
  SCALING
}

"""
Added in 24.09.0. Input for batch scanning of specific models from external registries.

Scans multiple specified models and retrieves detailed information including
README content and file sizes. This operation performs immediate detailed scanning
unlike the general scan_artifacts which only retrieves basic metadata.
"""
input ScanArtifactModelsInput {
  models: [ModelTarget!]!
  registryId: UUID = null
}

"""
Added in 25.14.0. Response payload for batch model scanning operations. Contains the artifact revisions discovered during detailed scanning of specific models, including README content and file size information.
"""
type ScanArtifactModelsPayload {
  """Artifact revisions discovered during model scanning."""
  artifactRevision: ArtifactRevisionConnection!
}

"""
Added in 24.09.0. Input for scanning artifacts from external registries (HuggingFace, Reservoir).

Discovers available artifacts and registers their metadata in the system.
Artifacts remain in SCANNED status until explicitly imported via import_artifacts.
"""
input ScanArtifactsInput {
  registryId: ID = null

  """The limit field."""
  limit: Int!
  artifactType: ArtifactType = null
  search: String = null
}

"""
Added in 25.14.0. Response payload for artifact scanning operations. Contains the list of artifacts discovered during scanning of external registries. These artifacts are registered with SCANNED status and can be imported for actual use.
"""
type ScanArtifactsPayload {
  """List of scanned artifacts."""
  artifacts: [Artifact!]!
}

"""
Added in 26.4.2. Result of scanning a MODEL_STORE project for model cards.
"""
type ScanProjectModelCardsV2Payload {
  """Number of newly created model cards."""
  createdCount: Int!

  """Number of updated existing model cards."""
  updatedCount: Int!

  """Per-vfolder error messages."""
  errors: [String!]!
}

"""
Added in 26.2.0. Type of scheduler used for session scheduling in a resource group.
"""
enum SchedulerType {
  FIFO
  LIFO
  DRF
  FAIR_SHARE
}

"""Added in 25.15.0. Scheduling event broadcast payload."""
type SchedulingBroadcastEventPayload {
  """
  The session ID associated with the replica. This can be null right after replica creation.
  """
  session: ComputeSessionNode

  """UUID of the session being scheduled."""
  sessionId: ID!

  """Status transition that occurred during session scheduling."""
  statusTransition: SchedulingStatus!

  """Human-readable reason for this status transition."""
  reason: String!
}

enum SchedulingHandlerCategory {
  LIFECYCLE
  SCALING
  HEALTH
}

"""
Added in UNRELEASED. Metadata for a single registered deployment scheduling handler. Surfaces the stable ``name`` used in ``DeploymentOptions.handler_options.by_handler``.
"""
type SchedulingHandlerNode {
  """Stable handler key used in deployment timeout maps."""
  name: String!

  """Handler category classifying its scheduling axis."""
  category: SchedulingHandlerCategory!

  """
  First line of the handler's docstring, if any. Null when the backing class has no docstring.
  """
  description: String
}

"""Added in 26.3.0. Scheduling result status"""
enum SchedulingResult {
  SUCCESS
  FAILURE
  STALE
  NEED_RETRY
  EXPIRED
  GIVE_UP
  SKIPPED
}

"""
Added in 26.3.0. Filter for scheduling result with equality and membership operators.
"""
input SchedulingResultFilter {
  equals: SchedulingResult = null

  """The in  field."""
  in: [SchedulingResult!] = null
  notEquals: SchedulingResult = null
  notIn: [SchedulingResult!] = null
}

"""Added in 24.3.0. Status of session scheduling transitions"""
enum SchedulingStatus {
  PENDING
  SCHEDULED
  PREPARING
  PULLING
  PREPARED
  CREATING
  RUNNING
  TERMINATING
  TERMINATED
  CANCELLED
  ERROR
}

"""
Added in 26.3.0. Valid scope-entity type combination for RBAC permissions.
"""
type ScopeEntityCombination {
  """Scope element type"""
  scopeType: RBACElementType!

  """Valid entity types for this scope type"""
  validEntityTypes: [RBACElementType!]!
}

"""
Added in 26.4.2. Scope-entity-operation combination for RBAC permission matrix.
"""
type ScopeEntityOperationCombination {
  """Scope element type"""
  scopeType: RBACElementType!

  """Entities and their valid operations within this scope"""
  entities: [EntityActionInfo!]!
}

"""
Added in 26.4.2. Scope reference for associating an entity with a scope.
"""
input ScopeInput {
  scopeType: RBACElementType!
  scopeId: String!
}

"""
Added in 26.4.2. Resource usage for a single scope (keypair, project, domain).
"""
type ScopeResourceUsageV2 {
  """Policy-defined resource limits."""
  limits: [ResourceLimitEntry!]!

  """Currently occupied resources."""
  used: [ResourceSlotEntry!]!

  """Assignable resources within policy limits (limits - used)."""
  assignable: [ResourceLimitEntry!]!
}

"""Added in 26.3.0. A registered service instance in the catalog."""
type ServiceCatalog implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """Logical group name (e.g., 'manager', 'agent', 'storage-proxy')."""
  serviceGroup: String!

  """Unique instance identifier within the group."""
  instanceId: String!

  """Human-readable display name."""
  displayName: String!

  """Version of the service instance."""
  version: String!

  """Labels for categorization and filtering."""
  labels: JSON!

  """Health status of the service."""
  status: ServiceCatalogStatus!

  """When the service instance started."""
  startupTime: DateTime!

  """When the service was first registered."""
  registeredAt: DateTime!

  """Last heartbeat timestamp."""
  lastHeartbeat: DateTime!

  """Hash of the service configuration."""
  configHash: String!

  """Endpoints exposed by this service instance."""
  endpoints: [ServiceCatalogEndpoint!]!
}

"""Added in 26.3.0. An endpoint exposed by a service instance."""
type ServiceCatalogEndpoint {
  role: String!
  scope: String!
  address: String!
  port: Int!
  protocol: String!
  metadata: JSON
}

"""Added in 26.3.0. Filter for service catalog queries."""
input ServiceCatalogFilter {
  """
  Filter by service group name. Supports equals, contains, startsWith, and endsWith.
  """
  serviceGroup: StringFilter = null

  """
  Filter by health status. Supports equals, in, not_equals, and not_in operations.
  """
  status: ServiceCatalogStatusFilter = null
  AND: [ServiceCatalogFilter!] = null
  OR: [ServiceCatalogFilter!] = null
  NOT: [ServiceCatalogFilter!] = null
}

"""
Added in 26.3.0. Specifies the field and direction for ordering service catalog queries.
"""
input ServiceCatalogOrderBy {
  field: ServiceCatalogOrderField!
  direction: OrderDirection! = ASC
}

"""
Added in 26.3.0. Fields available for ordering service catalog queries.
"""
enum ServiceCatalogOrderField {
  SERVICE_GROUP
  REGISTERED_AT
}

"""Added in 26.3.0. Health status of a service in the catalog."""
enum ServiceCatalogStatus {
  HEALTHY
  UNHEALTHY
  DEREGISTERED
}

"""
Added in 26.3.0. Filter for ServiceCatalogStatus enum fields. Supports equals, in, not_equals, and not_in operations.
"""
input ServiceCatalogStatusFilter {
  """Exact match for service catalog status."""
  equals: ServiceCatalogStatus = null

  """Match any of the provided statuses."""
  in: [ServiceCatalogStatus!] = null

  """Exclude exact status match."""
  notEquals: ServiceCatalogStatus = null

  """Exclude any of the provided statuses."""
  notIn: [ServiceCatalogStatus!] = null
}

"""
Added in 26.2.0. A single service port entry representing an exposed service. Contains port mapping and protocol information for accessing services.
"""
type ServicePortEntry {
  """Name of the service"""
  name: String!

  """Protocol type (http, tcp, preopen, internal)"""
  protocol: ServicePortProtocol!

  """Port numbers inside the container"""
  containerPorts: [Int!]!

  """Mapped port numbers on the host"""
  hostPorts: [Int]!

  """Whether this port is used for inference endpoints"""
  isInference: Boolean!
}

"""Added in 26.2.0. Protocol type for service ports."""
enum ServicePortProtocol {
  HTTP
  TCP
  PREOPEN
  INTERNAL
  VNC
  RDP
}

"""
Added in 26.2.0. A collection of exposed service ports. Each entry defines a service accessible through the compute session.
"""
type ServicePorts {
  """List of service port entries"""
  entries: [ServicePortEntry!]!
}

"""
Added in UNRELEASED. Scheduling constraint applied to designated agents for a session.
"""
enum SessionAgentSelectionPolicy {
  STRICT
  PREFERRED
}

"""Added in 26.4.2. Batch session specific configuration."""
input SessionBatchConfigInput {
  """Shell command to execute."""
  startupCommand: String!

  """Scheduled start time (ISO 8601)."""
  startsAt: String = null

  """Execution timeout in seconds."""
  batchTimeout: Int = null
}

"""Added in 26.4.2. Cluster networking modes for session creation."""
enum SessionClusterMode {
  SINGLE_NODE
  MULTI_NODE
}

"""
Added in UNRELEASED. Policy for how a kernel group's startup failures affect the owning session.
"""
enum SessionFailurePolicy {
  STRICT
  BOOT_ALL
  TOLERANT
}

"""Added in 26.4.2. A virtual folder mount specification."""
input SessionMountItemInput {
  """Virtual folder UUID."""
  vfolderId: ID!

  """Custom mount path."""
  mountPath: String = null

  """Mount permission ('rw' or 'ro')."""
  permission: String = null

  """
  Added in UNRELEASED. Subpath within the vfolder to mount. Null mounts the vfolder root.
  """
  subpath: String = null
}

"""Added in 26.4.2. Additional resource options for session creation."""
input SessionResourceOptsInput {
  """Shared memory size (e.g., '1g')."""
  shmem: BinarySizeInput = null
}

"""Added in 26.4.2. A single resource slot allocation entry."""
input SessionResourceSlotEntryInput {
  """Resource type identifier."""
  resourceType: String!

  """Quantity as a decimal string."""
  quantity: String!
}

"""Added in 26.3.0. Session scheduling history record."""
type SessionSchedulingHistory implements Node {
  """The Globally Unique ID of this object"""
  id: ID!
  sessionId: ID!
  phase: String!
  fromStatus: String
  toStatus: String
  result: SchedulingResult!
  errorCode: String
  message: String
  subSteps: [SubStepResultGQL!]!
  attempts: Int!
  createdAt: DateTime!
  updatedAt: DateTime!

  """Added in 26.4.3. The session this history record belongs to."""
  session: SessionV2
}

"""Added in 26.3.0. Session scheduling history connection."""
type SessionSchedulingHistoryConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [SessionSchedulingHistoryEdge!]!
  count: Int!
}

"""An edge in a connection."""
type SessionSchedulingHistoryEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: SessionSchedulingHistory!
}

"""Added in 24.09.0. Filter for session scheduling history"""
input SessionSchedulingHistoryFilter {
  id: UUIDFilter = null
  sessionId: UUIDFilter = null
  phase: StringFilter = null
  fromStatus: [String!] = null
  toStatus: [String!] = null
  result: SchedulingResultFilter = null
  errorCode: StringFilter = null
  message: StringFilter = null
  createdAt: DateTimeFilter = null
  updatedAt: DateTimeFilter = null
  AND: [SessionSchedulingHistoryFilter!] = null
  OR: [SessionSchedulingHistoryFilter!] = null
  NOT: [SessionSchedulingHistoryFilter!] = null
}

"""
Added in 24.09.0. Order by specification for session scheduling history
"""
input SessionSchedulingHistoryOrderBy {
  field: SessionSchedulingHistoryOrderField!
  direction: OrderDirection! = DESC
}

"""
Added in 26.3.0. Fields available for ordering session scheduling history
"""
enum SessionSchedulingHistoryOrderField {
  CREATED_AT
  UPDATED_AT
}

"""Added in 24.09.0. Scope for session scheduling history query"""
input SessionScope {
  """Session ID to get history for"""
  sessionId: UUID!
}

enum SessionTypes {
  INTERACTIVE
  BATCH
  INFERENCE
  SYSTEM
}

"""Added in 26.3.0. Represents a compute session in Backend.AI."""
type SessionV2 implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """
  UUIDs of the images used by this session. Multiple images are possible in multi-kernel (cluster) sessions.
  """
  imageIds: [ID!]
  domainName: String!
  userId: ID!
  projectId: ID!

  """Metadata including domain, project, and user information."""
  metadata: SessionV2MetadataInfo!

  """Resource allocation and cluster information."""
  resource: SessionV2ResourceInfo!

  """Lifecycle status and timestamps."""
  lifecycle: SessionV2LifecycleInfo!

  """Runtime execution configuration."""
  runtime: SessionV2RuntimeInfo!

  """Network configuration."""
  network: SessionV2NetworkInfo!

  """Added in 26.3.0. The domain this session belongs to."""
  domain: DomainV2

  """Added in 26.3.0. The user who owns this session."""
  user: UserV2

  """Added in 26.3.0. The project this session belongs to."""
  project: ProjectV2

  """Added in 26.3.0. The resource group this session is assigned to."""
  resourceGroup: ResourceGroup

  """
  Added in 26.4.3. The images used by this session. Multiple images are possible in multi-kernel (cluster) sessions.
  """
  images: ImageV2Connection

  """Added in 26.3.0. The kernels belonging to this session."""
  kernels: KernelV2Connection
}

"""Added in 26.3.0. Connection type for paginated session results."""
type SessionV2Connection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [SessionV2Edge!]!
  count: Int!
}

"""An edge in a connection."""
type SessionV2Edge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: SessionV2!
}

"""Added in 26.3.0. Filter criteria for querying sessions."""
input SessionV2Filter {
  id: UUIDFilter = null
  status: SessionV2StatusFilter = null
  name: StringFilter = null
  domainName: StringFilter = null
  projectId: UUIDFilter = null
  userUuid: UUIDFilter = null
  AND: [SessionV2Filter!] = null
  OR: [SessionV2Filter!] = null
  NOT: [SessionV2Filter!] = null
}

"""Added in 26.3.0. Lifecycle status and timestamps for a session."""
type SessionV2LifecycleInfo {
  """Current status of the session."""
  status: SessionV2Status!

  """Result of the session execution (success, failure, etc.)."""
  result: SessionV2Result!

  """Timestamp when the session was created."""
  createdAt: DateTime

  """Timestamp when the session was terminated. Null if still active."""
  terminatedAt: DateTime

  """Scheduled start time for the session, if applicable."""
  startsAt: DateTime

  """Batch execution timeout in seconds. Applicable to batch sessions."""
  batchTimeout: Int
}

"""Added in 26.3.0. Metadata information for a session."""
type SessionV2MetadataInfo {
  """Server-generated unique token for tracking session creation."""
  creationId: String!

  """Human-readable name of the session."""
  name: String!

  """Type of the session (interactive, batch, inference)."""
  sessionType: SessionV2Type!

  """Access key used to create this session."""
  accessKey: String!

  """Cluster mode for distributed sessions (single-node, multi-node)."""
  clusterMode: ClusterMode!

  """Number of nodes in the cluster."""
  clusterSize: Int!

  """Scheduling priority of the session."""
  priority: Int!

  """
  Whether this session is eligible for preemption by higher-priority sessions.
  """
  isPreemptible: Boolean!

  """Optional user-provided tag for the session."""
  tag: String
}

"""Added in 26.3.0. Network configuration for a session."""
type SessionV2NetworkInfo {
  """Whether the session uses the host network directly."""
  useHostNetwork: Boolean!

  """Type of network used by the session."""
  networkType: String

  """ID of the network if applicable."""
  networkId: String
}

"""Added in 26.3.0. Ordering specification for sessions."""
input SessionV2OrderBy {
  field: SessionV2OrderField!
  direction: OrderDirection! = DESC
}

"""Added in 26.3.0. Fields available for ordering sessions."""
enum SessionV2OrderField {
  CREATED_AT
  TERMINATED_AT
  STATUS
  ID
  NAME
}

"""Added in 26.3.0. Resource allocation information for a session."""
type SessionV2ResourceInfo {
  """
  Resource allocation with requested and occupied slots. Typed as Any because this field holds a nested GQL type (ResourceAllocationGQL).
  """
  allocation: ResourceAllocation!

  """The resource group (scaling group) this session is assigned to."""
  resourceGroupName: String
}

"""
Added in 26.3.0. Result status of a session or kernel execution. Indicates the final outcome after the session/kernel has terminated. UNDEFINED: The session has not yet finished or its result is unknown. SUCCESS: The session completed normally without errors. FAILURE: The session terminated abnormally due to an error or user cancellation.
"""
enum SessionV2Result {
  UNDEFINED
  SUCCESS
  FAILURE
}

"""Added in 26.3.0. Runtime execution configuration for a session."""
type SessionV2RuntimeInfo {
  """
  Environment variables for the session. Typed as Any because this field holds a nested GQL type (EnvironmentVariablesGQL).
  """
  environ: EnvironmentVariables

  """Bootstrap script to run before the main process."""
  bootstrapScript: String

  """Startup command to execute when the session starts."""
  startupCommand: String

  """
  URL to call back when the session completes (e.g., for batch sessions).
  """
  callbackUrl: String
}

"""Added in 26.3.0. Status of a session in its lifecycle."""
enum SessionV2Status {
  PENDING
  SCHEDULED
  PREPARING
  PREPARED
  CREATING
  RUNNING
  DEPRIORITIZING
  TERMINATING
  TERMINATED
  CANCELLED
}

"""Added in 26.3.0. Filter for session status."""
input SessionV2StatusFilter {
  equals: SessionV2Status = null

  """The in  field."""
  in: [SessionV2Status!] = null

  """Excludes exact status match."""
  notEquals: SessionV2Status = null
  notIn: [SessionV2Status!] = null
}

"""Added in 26.3.0. Type of compute session."""
enum SessionV2Type {
  INTERACTIVE
  BATCH
  INFERENCE
  SYSTEM
}

"""Added in 26.4.2. Slider UI config."""
type SliderOption {
  """Minimum value."""
  min: Float!

  """Maximum value."""
  max: Float!

  """Increment step."""
  step: Float!
}

"""
Added in 25.14.0. Information about the source or registry of an artifact. Contains the name and URL of the registry where the artifact is stored or originates from.
"""
type SourceInfo {
  """Name of the registry or source."""
  name: String

  """URL of the registry or source."""
  url: String
}

"""
Added in 26.4.2. A single storage host together with the permissions granted to a user.
"""
type StorageHostPermission {
  """Storage host name."""
  host: String!

  """Permissions granted to the current user on this storage host."""
  permissions: [VFolderHostPermissionV2!]!
}

"""
Added in 25.15.0. Storage namespace provides logical separation of data within a single storage system
to organize and isolate domain-specific concerns.

Implementation varies by storage type:
- Object Storage (S3, MinIO): Uses bucket-based namespace separation
- File System (VFS): Uses directory path prefix for namespace distinction
"""
type StorageNamespace implements Node {
  """The Globally Unique ID of this object"""
  id: ID!
  storageId: ID!
  namespace: String!
}

"""Added in 25.15.0. Storage namespace connection for pagination."""
type StorageNamespaceConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [StorageNamespaceEdge!]!

  """The count of this entity."""
  count: Int!
}

"""An edge in a connection."""
type StorageNamespaceEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: StorageNamespace!
}

"""
Added in 24.09.0. Filter for string fields supporting equality, containment, prefix/suffix, and case-insensitive variants.
"""
input StringFilter {
  contains: String = null
  startsWith: String = null
  endsWith: String = null
  equals: String = null
  notContains: String = null
  notStartsWith: String = null
  notEndsWith: String = null
  notEquals: String = null

  """The i contains field."""
  iContains: String = null

  """The i starts with field."""
  iStartsWith: String = null

  """The i ends with field."""
  iEndsWith: String = null

  """The i equals field."""
  iEquals: String = null

  """The i not contains field."""
  iNotContains: String = null

  """The i not starts with field."""
  iNotStartsWith: String = null

  """The i not ends with field."""
  iNotEndsWith: String = null

  """The i not equals field."""
  iNotEquals: String = null

  """Value is in the provided list (case-sensitive)."""
  in: [String!] = null

  """Value is not in the provided list (case-sensitive)."""
  notIn: [String!] = null

  """Value is in the provided list (case-insensitive)."""
  iIn: [String!] = null

  """Value is not in the provided list (case-insensitive)."""
  iNotIn: [String!] = null
}

"""Added in 26.3.0. Sub-step result in scheduling history."""
type SubStepResultGQL {
  step: String!
  result: SchedulingResult!
  errorCode: String
  message: String
  startedAt: DateTime
  endedAt: DateTime
}

type Subscription {
  """
  Added in 25.14.0. Subscribe to real-time artifact status change notifications. Receives updates when artifact revision statuses change during import, cleanup, or other operations.
  """
  artifactStatusChanged(input: ArtifactStatusChangedInput!): ArtifactStatusChangedPayload!

  """
  Added in 25.14.0. Subscribe to real-time artifact import progress updates. Receives progress notifications during artifact import operations, including percentage completed and current status.
  """
  artifactImportProgressUpdated(artifactRevisionId: ID!): ArtifactImportProgressUpdatedPayload!

  """Added in 25.16.0. Subscribe to deployment status changes."""
  deploymentStatusChanged: DeploymentStatusChangedPayload!

  """Added in 25.16.0. Subscribe to replica status changes."""
  replicaStatusChanged(revisionId: ID!): ReplicaStatusChangedPayload!

  """
  Added in 25.15.0. Subscribe to real-time scheduling events for a specific session. Streams status transition events during the session lifecycle (PENDING → SCHEDULED → PREPARING → RUNNING → TERMINATED).
  """
  schedulingEventsBySession(sessionId: ID!): SchedulingBroadcastEventPayload!

  """
  Added in 26.4.2. Subscribe to real-time events for a specific background task. Streams progress updates and completion events (done/cancelled/failed) for the task lifecycle.
  """
  backgroundTaskEvents(taskId: ID!): BackgroundTaskEventPayload!
}

"""
Added in 24.09.0. Input for switching the main access key of the current user.
"""
input SwitchMyMainAccessKeyInput {
  """
  Access key to set as the new main access key. Must be active and owned by the user.
  """
  accessKey: String!
}

"""Added in 26.2.0. Payload returned after switching the main access key."""
type SwitchMyMainAccessKeyPayload {
  """Whether the switch was successful."""
  success: Boolean!
}

"""Added in 25.19.0. """
input SyncReplicaInput {
  modelDeploymentId: ID!
}

"""Added in 25.19.0. Payload for replica sync mutation result."""
type SyncReplicaPayload {
  """Whether the sync succeeded"""
  success: Boolean!
}

"""Added in 26.4.2. Payload returned after terminating sessions."""
type TerminateSessionsPayload {
  """Sessions cancelled from PENDING."""
  cancelled: [ID!]!

  """Sessions marked TERMINATING."""
  terminating: [ID!]!

  """Sessions force-terminated."""
  forceTerminated: [ID!]!

  """Sessions already terminated or not found."""
  skipped: [ID!]!
}

"""Added in 26.4.2. Text input UI config."""
type TextOption {
  """Placeholder text."""
  placeholder: String
}

"""
Added in 25.19.0. This enum represents the traffic status of a replica.
"""
enum TrafficStatus {
  ACTIVE
  INACTIVE
}

"""Added in 25.19.0. """
input TrafficStatusFilter {
  """The in  field."""
  in: [TrafficStatus!] = null
  equals: TrafficStatus = null

  """Excludes traffic statuses in the list."""
  notIn: [TrafficStatus!] = null

  """Excludes exact traffic status match."""
  notEquals: TrafficStatus = null
}

"""Added in 26.4.2. UI rendering options."""
type UIOption {
  """UI render type."""
  uiType: String!

  """Slider config."""
  slider: SliderOption

  """Number input config."""
  number: NumberOption

  """Select/radio config."""
  choices: ChoiceOption

  """Text input config."""
  text: TextOption
}

scalar UUID

"""Added in 26.1.0. Filter for UUID fields."""
input UUIDFilter {
  equals: UUID = null

  """The in  field."""
  in: [UUID!] = null
  notEquals: UUID = null
  notIn: [UUID!] = null
}

"""Added in UNRELEASED. Single-UUID scope item wrapper."""
input UUIDScope {
  """UUID value."""
  value: UUID!
}

"""
Added in 26.4.2. Error information for a user that failed to be unassigned.
"""
type UnassignUserError {
  """UUID of the user that failed to be unassigned."""
  userId: UUID!

  """Error message describing the failure reason."""
  message: String!
}

"""Added in 26.4.2. Input for unassigning users from a project."""
input UnassignUsersFromProjectInput {
  """List of user UUIDs to unassign from the project."""
  userIds: [UUID!]!
}

"""Added in 26.4.2. Payload for user unassignment from project."""
type UnassignUsersFromProjectPayload {
  """List of users that were unassigned from the project."""
  unassignedUsers: [UserV2!]!

  """List of errors for users that could not be unassigned."""
  failed: [UnassignUserError!]!
}

"""
Added in 26.4.2. Payload returned after clearing a user's failed-login block.
"""
type UnblockUserPayload {
  """Whether the unblock was successful"""
  success: Boolean!
}

"""Added in 25.15.0. Input type for unregistering a storage namespace."""
input UnregisterStorageNamespaceInput {
  storageId: UUID!
  namespace: String!
}

"""
Added in 25.15.0. Payload returned after storage namespace unregistration.
"""
type UnregisterStorageNamespacePayload {
  """ID of the unregistered storage namespace"""
  id: UUID!
}

"""
Added in 26.4.2. Input for updating allowed domains for a resource group.
"""
input UpdateAllowedDomainsForResourceGroupInput {
  """Resource group name."""
  resourceGroupName: String!

  """Domain names to allow."""
  add: [String!] = null

  """Domain names to disallow."""
  remove: [String!] = null
}

"""
Added in 26.4.2. Input for updating allowed projects for a resource group.
"""
input UpdateAllowedProjectsForResourceGroupInput {
  """Resource group name."""
  resourceGroupName: String!

  """Project IDs to allow."""
  add: [UUID!] = null

  """Project IDs to disallow."""
  remove: [UUID!] = null
}

"""
Added in 26.4.2. Input for updating allowed resource groups for a domain.
"""
input UpdateAllowedResourceGroupsForDomainInput {
  """Domain name."""
  domainName: String!

  """Resource group names to allow."""
  add: [String!] = null

  """Resource group names to disallow."""
  remove: [String!] = null
}

"""
Added in 26.4.2. Input for updating allowed resource groups for a project.
"""
input UpdateAllowedResourceGroupsForProjectInput {
  """Project ID."""
  projectId: UUID!

  """Resource group names to allow."""
  add: [String!] = null

  """Resource group names to disallow."""
  remove: [String!] = null
}

"""
Added in 24.09.0. Input for updating artifact metadata properties.

Modifies artifact metadata such as readonly status and description.
This operation does not affect the actual artifact files or revisions.
"""
input UpdateArtifactInput {
  artifactId: ID!
  readonly: Boolean
  description: String
}

"""
Added in 25.14.0. Response payload for artifact update operations. Returns the updated artifact with modified metadata properties.
"""
type UpdateArtifactPayload {
  """Updated artifact."""
  artifact: Artifact!
}

"""Added in 25.19.0. Input for updating an auto-scaling rule."""
input UpdateAutoScalingRuleInput {
  id: ID!
  metricSource: AutoScalingMetricSource
  metricName: String
  minThreshold: Decimal
  maxThreshold: Decimal
  stepSize: Int
  timeWindow: Int
  minReplicas: Int
  maxReplicas: Int
  prometheusQueryPresetId: ID
}

"""Added in 25.19.0. Payload for updating an auto-scaling rule."""
type UpdateAutoScalingRulePayload {
  """Updated auto-scaling rule"""
  rule: AutoScalingRule!
}

"""
Added in 26.4.2. Input for updating a container registry. All fields optional except id.
"""
input UpdateContainerRegistryInputGQL {
  """ID of the registry to update."""
  id: String!

  """Updated URL."""
  url: String = null

  """Updated registry name."""
  registryName: String = null

  """Updated type."""
  type: ContainerRegistryType = null

  """Updated project."""
  project: String = null

  """Updated username."""
  username: String = null

  """Updated password."""
  password: String = null

  """Updated SSL verification."""
  sslVerify: Boolean = null

  """Updated global accessibility."""
  isGlobal: Boolean = null

  """Updated extra metadata."""
  extra: JSON = null
}

"""Added in 26.4.2. Payload for container registry update mutation."""
type UpdateContainerRegistryPayloadGQL {
  """Updated container registry."""
  registry: ContainerRegistryV2!
}

"""Added in 25.19.0. """
input UpdateDeploymentInput {
  id: ID!
  openToPublic: Boolean
  tags: [String!]
  defaultDeploymentStrategy: DeploymentStrategyInput
  replicaCount: Int
  name: String
  preferredDomainName: String
}

"""Added in 25.19.0. Payload for updating a model deployment."""
type UpdateDeploymentPayload {
  """Updated deployment"""
  deployment: ModelDeployment!
}

"""
Added in 26.4.2. Input for creating or updating a deployment policy (upsert semantics).
Specify the target deployment_id and the desired strategy type.
Exactly one of rolling_update or blue_green must be provided,
matching the chosen strategy type.
If a policy already exists for the deployment, it is replaced entirely.
"""
input UpdateDeploymentPolicyInput {
  deploymentId: ID!
  strategy: DeploymentStrategyType!
  rollingUpdate: RollingUpdateConfigInput = null
  blueGreen: BlueGreenConfigInput = null
}

"""
Added in 26.4.2. Result payload returned after creating or updating a deployment policy. Contains the full deployment_policy object reflecting the applied configuration.
"""
type UpdateDeploymentPolicyPayload {
  """The updated deployment policy"""
  deploymentPolicy: DeploymentPolicy!
}

"""Added in 26.4.2. Update deployment revision preset input."""
input UpdateDeploymentRevisionPresetInput {
  """Preset ID."""
  id: UUID!

  """New name."""
  name: String = null

  """New description."""
  description: String = null

  """New rank."""
  rank: Int = null

  """
  Default open_to_public for deployments created from this preset. Set to null to clear.
  """
  openToPublic: Boolean

  """
  Default replica count for deployments created from this preset. Set to null to clear.
  """
  replicaCount: Int

  """
  Default revision history limit for deployments created from this preset. Set to null to clear.
  """
  revisionHistoryLimit: Int

  """
  Default deployment strategy for deployments created from this preset. Set to null to clear.
  """
  deploymentStrategy: PresetDeploymentStrategyInput

  """
  Added in UNRELEASED. Container image for the inference server. Set to null to clear.
  """
  imageId: UUID

  """Added in UNRELEASED. Parsed model definition. Set to null to clear."""
  modelDefinition: ModelDefinitionInput

  """Added in UNRELEASED. Container startup command. Set to null to clear."""
  startupCommand: String

  """
  Added in UNRELEASED. Bootstrap script run before the main process. Set to null to clear.
  """
  bootstrapScript: String

  """
  Added in UNRELEASED. Replace resource slot allocations. Omit to leave unchanged.
  """
  resourceSlots: [ResourceSlotEntryInput!] = null

  """
  Added in UNRELEASED. Replace additional resource options. Omit to leave unchanged.
  """
  resourceOpts: [ResourceOptsEntryInput!] = null

  """
  Added in UNRELEASED. New cluster topology mode. Omit to leave unchanged.
  """
  clusterMode: ClusterMode = null

  """Added in UNRELEASED. New cluster size. Omit to leave unchanged."""
  clusterSize: Int = null

  """
  Added in UNRELEASED. Replace environment variables. Omit to leave unchanged.
  """
  environ: [EnvironEntryInput!] = null

  """
  Added in UNRELEASED. Replace runtime variant preset values. Omit to leave unchanged.
  """
  presetValues: [DeploymentRevisionPresetValueEntryInput!] = null
}

"""Added in 26.4.2. Update deployment revision preset payload."""
type UpdateDeploymentRevisionPresetPayloadGQL {
  """The updated preset."""
  preset: DeploymentRevisionPreset!
}

"""
Added in 26.4.2. Input for updating domain information. All fields optional.
"""
input UpdateDomainInputGQL {
  """New domain name."""
  name: String = null

  """New description."""
  description: String = null

  """Updated active status."""
  isActive: Boolean = null

  """New allowed Docker registry URLs."""
  allowedDockerRegistries: [String!] = null

  """New external integration identifier."""
  integrationName: String = null
}

"""Added in 25.14.0. """
input UpdateHuggingFaceRegistryInput {
  id: ID!
  url: String
  name: String
  token: String
}

"""Added in 25.14.0. Payload for updating a HuggingFace registry."""
type UpdateHuggingFaceRegistryPayload {
  """Updated HuggingFace registry"""
  huggingfaceRegistry: HuggingFaceRegistry!
}

"""
Added in 26.4.2. Input for updating a keypair resource policy. All fields optional.
"""
input UpdateKeypairResourcePolicyInputGQL {
  """Updated default for unspecified."""
  defaultForUnspecified: String = null

  """Updated resource slot limits."""
  totalResourceSlots: [ResourceSlotEntryInput!] = null

  """Updated max session lifetime."""
  maxSessionLifetime: Int = null

  """Updated max concurrent sessions."""
  maxConcurrentSessions: Int = null

  """Updated max pending sessions."""
  maxPendingSessionCount: Int = null

  """Updated max pending session resource slots."""
  maxPendingSessionResourceSlots: [ResourceSlotEntryInput!] = null

  """Updated max concurrent SFTP sessions."""
  maxConcurrentSftpSessions: Int = null

  """Updated max containers per session."""
  maxContainersPerSession: Int = null

  """Updated idle timeout."""
  idleTimeout: Int = null

  """Updated vfolder host permissions."""
  allowedVfolderHosts: [VFolderHostPermissionEntryInput!] = null
}

"""Added in 26.4.2. Payload for keypair resource policy update mutation."""
type UpdateKeypairResourcePolicyPayloadGQL {
  """Updated keypair resource policy."""
  keypairResourcePolicy: KeypairResourcePolicyV2!
}

"""
Added in 26.4.2. Input for updating a login client type. Both fields are optional for partial update.
"""
input UpdateLoginClientTypeInput {
  """Updated name."""
  name: String = null

  """Updated description. Pass null to clear, omit to leave unchanged."""
  description: String = null
}

"""Added in 26.4.2. Payload for login client type update."""
type UpdateLoginClientTypePayload {
  """Updated login client type."""
  loginClientType: LoginClientType!
}

"""Added in 26.4.2. Update model card payload."""
type UpdateModelCardPayloadGQL {
  """The updated model card."""
  modelCard: ModelCardV2!
}

"""Added in 26.4.2. Update model card input."""
input UpdateModelCardV2Input {
  """Model card ID."""
  id: UUID!

  """New name."""
  name: String = null

  """Author."""
  author: String = null

  """Title."""
  title: String = null

  """Version."""
  modelVersion: String = null

  """Description."""
  description: String = null

  """ML task."""
  task: String = null

  """Category."""
  category: String = null

  """Architecture."""
  architecture: String = null

  """Frameworks."""
  framework: [String!] = null

  """Labels."""
  label: [String!] = null

  """License."""
  license: String = null

  """README content."""
  readme: String = null

  """Access level (public or internal)."""
  accessLevel: ModelCardV2AccessLevel = null
}

"""
Added in 26.4.0. Input for updating the current user's allowed client IP list. Set allowed_client_ip to null to remove all restrictions. Use force=true to bypass the lockout safety check.
"""
input UpdateMyAllowedClientIPInput {
  """
  New allowed client IP addresses or CIDR ranges. Set to null to remove all IP restrictions.
  """
  allowedClientIp: [String!]

  """
  If false (default), the operation will fail if the current request IP is not included in the new allowlist. Set to true to override this safety check.
  """
  force: Boolean! = false
}

"""
Added in 26.4.0. Payload for updating the current user's allowed client IP list.
"""
type UpdateMyAllowedClientIPPayload {
  """Whether the update was successful."""
  success: Boolean!
}

"""
Added in 24.09.0. Input for updating a keypair owned by the current user.
"""
input UpdateMyKeypairInput {
  """
  Access key of the keypair to update. Must be owned by the current user.
  """
  accessKey: String!

  """Target active state for the keypair."""
  isActive: Boolean!
}

"""Added in 26.2.0. Payload returned after updating a keypair."""
type UpdateMyKeypairPayload {
  """The updated keypair."""
  keypair: KeyPairGQL!
}

"""Added in 24.09.0. Input for updating a notification channel"""
input UpdateNotificationChannelInput {
  id: ID!
  name: String
  description: String
  spec: NotificationChannelSpecInput
  enabled: Boolean
}

"""Added in 26.3.0. Payload for update notification channel mutation."""
type UpdateNotificationChannelPayload {
  """Updated notification channel"""
  channel: NotificationChannel!
}

"""Added in 24.09.0. Input for updating a notification rule"""
input UpdateNotificationRuleInput {
  id: ID!
  name: String
  description: String
  messageTemplate: String
  enabled: Boolean
}

"""Added in 26.3.0. Payload for update notification rule mutation."""
type UpdateNotificationRulePayload {
  """Updated notification rule"""
  rule: NotificationRule!
}

"""Added in 25.14.0. """
input UpdateObjectStorageInput {
  id: ID!
  name: String
  host: String
  accessKey: String
  secretKey: String
  endpoint: String
  region: String
}

"""Added in 25.14.0. Payload for updating an object storage."""
type UpdateObjectStoragePayload {
  """Updated object storage"""
  objectStorage: ObjectStorage!
}

"""Added in 26.3.0. Input for updating a scoped permission"""
input UpdatePermissionInput {
  id: UUID!
  scopeType: RBACElementType = null
  scopeId: String = null
  entityType: RBACElementType = null
  operation: OperationType = null
}

"""
Added in 26.4.2. Input for updating project information. All fields optional.
"""
input UpdateProjectInputGQL {
  """New project name."""
  name: String = null

  """New description."""
  description: String = null

  """Updated active status."""
  isActive: Boolean = null

  """New external integration identifier."""
  integrationName: String = null

  """New resource policy name."""
  resourcePolicy: String = null
}

"""
Added in 26.4.2. Input for updating a project resource policy. All fields optional.
"""
input UpdateProjectResourcePolicyInputGQL {
  """Updated max vfolder count."""
  maxVfolderCount: Int = null

  """Updated max quota scope size."""
  maxQuotaScopeSize: BinarySizeInput = null

  """Updated max network count."""
  maxNetworkCount: Int = null
}

"""Added in 26.4.2. Payload for project resource policy update mutation."""
type UpdateProjectResourcePolicyPayloadGQL {
  """Updated project resource policy."""
  projectResourcePolicy: ProjectResourcePolicyV2!
}

"""Added in 25.14.0. """
input UpdateReservoirRegistryInput {
  id: ID!
  name: String
  endpoint: String
  accessKey: String
  secretKey: String
  apiVersion: String
}

"""Added in 25.14.0. Payload for updating a reservoir registry."""
type UpdateReservoirRegistryPayload {
  """Updated Reservoir registry"""
  reservoir: ReservoirRegistry!
}

"""
Added in 26.1.0. Input for updating resource group fair share configuration. All fields are optional - only provided fields will be updated, others retain existing values.
"""
input UpdateResourceGroupFairShareSpecInput {
  """Name of the resource group to update."""
  resourceGroupName: String!

  """
  Half-life for exponential decay in days. Leave null to keep existing value.
  """
  halfLifeDays: Int = null

  """Total lookback period in days. Leave null to keep existing value."""
  lookbackDays: Int = null

  """
  Granularity of decay buckets in days. Leave null to keep existing value.
  """
  decayUnitDays: Int = null

  """Default weight for entities. Leave null to keep existing value."""
  defaultWeight: Decimal = null

  """
  Resource weights for fair share calculation. Each entry specifies a resource type and its weight multiplier. Only provided resource types are updated (partial update). Set weight to null to remove that resource type (revert to default). Leave the entire list null to keep all existing values.
  """
  resourceWeights: [ResourceWeightEntryInput!] = null
}

"""
Added in 26.1.0. Payload for resource group fair share spec update mutation.
"""
type UpdateResourceGroupFairShareSpecPayload {
  """The updated resource group with new fair share configuration."""
  resourceGroup: ResourceGroup!
}

"""
Added in 26.2.0. Resource group configuration update input. All fields are optional - only provided fields will be updated. Supports all ScalingGroupUpdaterSpec fields (except fair_share, use separate mutation).
"""
input UpdateResourceGroupInput {
  """Name of the resource group to update."""
  resourceGroupName: String!

  """
  Whether the resource group is active. Leave null to keep existing value.
  """
  isActive: Boolean = null

  """
  Whether the resource group is public. Leave null to keep existing value.
  """
  isPublic: Boolean = null

  """Human-readable description. Leave null to keep existing value."""
  description: String = null

  """App proxy address. Leave null to keep existing value."""
  appProxyAddr: String = null

  """App proxy API token. Leave null to keep existing value."""
  appproxyApiToken: String = null

  """Whether to use host network mode. Leave null to keep existing value."""
  useHostNetwork: Boolean = null

  """
  Scheduler type (FIFO, LIFO, DRF, FAIR_SHARE). Leave null to keep existing value.
  """
  schedulerType: SchedulerType = null

  """
  Added in 26.3.0. Preemption configuration. When provided, replaces the entire preemption config. Leave null to keep existing value.
  """
  preemption: PreemptionConfigInput = null
}

"""Added in 26.2.0. Payload for resource group update mutation."""
type UpdateResourceGroupPayload {
  """The updated resource group with new configuration."""
  resourceGroup: ResourceGroup!
}

"""Added in 26.4.2. Payload for resource preset update."""
type UpdateResourcePresetPayloadGQL {
  """Updated resource preset."""
  resourcePreset: ResourcePresetV2!
}

"""
Added in 26.4.2. Input for updating a resource preset. All fields optional for partial update.
"""
input UpdateResourcePresetV2Input {
  """UUID of the resource preset to update."""
  id: UUID!

  """Updated name."""
  name: String = null

  """Updated resource slot allocations."""
  resourceSlots: [ResourceSlotEntryInput!] = null

  """Updated shared memory. Use null to clear."""
  sharedMemory: BinarySizeInput = null

  """Updated resource group name. Use null to make global."""
  resourceGroupName: String = null
}

"""Added in 26.3.0. Input for updating a role"""
input UpdateRoleInput {
  id: UUID!
  name: String
  description: String
  status: RoleStatus
}

"""Added in 25.19.0. Input for updating route traffic status."""
input UpdateRouteTrafficStatusInput {
  """The ID of the route to update."""
  routeId: ID!

  """The new traffic status (ACTIVE/INACTIVE)."""
  trafficStatus: RouteTrafficStatus!
}

"""Added in 25.19.0. Result of updating route traffic status."""
type UpdateRouteTrafficStatusPayload {
  """The updated route"""
  route: Route!
}

"""Added in 26.4.2. Input for updating a runtime variant."""
input UpdateRuntimeVariantInput {
  """Runtime variant ID."""
  id: UUID!

  """New name."""
  name: String = null

  """New description. Set to null to clear."""
  description: String
}

"""Added in 26.4.2. Payload for runtime variant update."""
type UpdateRuntimeVariantPayloadGQL {
  """The updated runtime variant."""
  runtimeVariant: RuntimeVariant!
}

"""Added in 26.4.2. Update preset input."""
input UpdateRuntimeVariantPresetInput {
  """Preset ID."""
  id: UUID!

  """New name."""
  name: String = null

  """New description."""
  description: String = null

  """New rank."""
  rank: Int = null

  """New target."""
  presetTarget: PresetTarget = null

  """New value type."""
  valueType: PresetValueType = null

  """New default value."""
  defaultValue: String = null

  """New key."""
  key: String = null
}

"""Added in 26.4.2. Update preset payload."""
type UpdateRuntimeVariantPresetPayloadGQL {
  """The updated preset."""
  preset: RuntimeVariantPreset!
}

"""
Added in 26.4.2. Input for updating a user resource policy. All fields optional.
"""
input UpdateUserResourcePolicyInputGQL {
  """Updated max vfolder count."""
  maxVfolderCount: Int = null

  """
  Added in 26.4.2. Updated maximum number of concurrent authenticated login sessions per user. Set to null to clear (unlimited). Distinct from keypair_resource_policies.max_concurrent_sessions which caps compute sessions.
  """
  maxConcurrentLogins: Int = null

  """Updated max quota scope size."""
  maxQuotaScopeSize: BinarySizeInput = null

  """Updated max sessions per model session."""
  maxSessionCountPerModelSession: Int = null

  """Updated max customized image count."""
  maxCustomizedImageCount: Int = null
}

"""Added in 26.4.2. Payload for user resource policy update mutation."""
type UpdateUserResourcePolicyPayloadGQL {
  """Updated user resource policy."""
  userResourcePolicy: UserResourcePolicyV2!
}

"""
Added in 26.3.0. Input for updating user information. All fields are optional - only provided fields will be updated.
"""
input UpdateUserV2Input {
  """New username."""
  username: String

  """New password."""
  password: String

  """New full display name."""
  fullName: String

  """New description."""
  description: String

  """New account status."""
  status: UserStatusV2

  """New user role."""
  role: UserRoleV2

  """New domain assignment."""
  domainName: String

  """New project (group) assignments. Replaces existing assignments."""
  groupIds: [UUID!]

  """New allowed client IP addresses or CIDR ranges."""
  allowedClientIp: [String!]

  """Set password change requirement."""
  needPasswordChange: Boolean

  """New user resource policy name."""
  resourcePolicy: String

  """Enable or disable sudo session capability."""
  sudoSessionEnabled: Boolean

  """Set the primary API access key."""
  mainAccessKey: String

  """New container user ID."""
  containerUid: Int

  """New container primary group ID."""
  containerMainGid: Int

  """New container supplementary group IDs."""
  containerGids: [Int!]
}

"""Added in 26.3.0. Payload for user update mutation."""
type UpdateUserV2Payload {
  """The updated user."""
  user: UserV2!
}

"""Added in 25.16.0. Input for updating VFS storage"""
input UpdateVFSStorageInput {
  id: ID!
  name: String
  host: String
  basePath: String
}

"""Added in 25.16.0. Payload for updating VFS storage."""
type UpdateVFSStoragePayload {
  """Updated VFS storage"""
  vfsStorage: VFSStorage!
}

"""
Added in 24.09.0. Input for creating or updating domain-level app configuration.
The provided extra_config object will completely replace the existing configuration;
existing keys not present in the new extra_config will be removed.
All users in this domain will be affected by these settings when their configurations are merged.
"""
input UpsertDomainConfigInput {
  domainName: String!
  extraConfig: JSON!
}

"""
Added in 25.16.0. Payload returned after upserting domain-level app configuration. Contains the resulting configuration that was stored.
"""
type UpsertDomainConfigPayload {
  """The resulting app configuration"""
  appConfig: AppConfig!
}

"""
Added in 26.1.0. Input for upserting domain fair share weight. The weight parameter affects scheduling priority - higher weight = higher priority. Set weight to null to use resource group's default_weight.
"""
input UpsertDomainFairShareWeightInput {
  """Name of the scaling group (resource group) for this fair share."""
  resourceGroupName: String!

  """Name of the domain to update weight for."""
  domainName: String!

  """
  Priority weight multiplier. Higher weight = higher priority allocation ratio. Set to null to use resource group's default_weight.
  """
  weight: Decimal = null
}

"""Added in 26.1.0. Payload for domain fair share weight upsert mutation."""
type UpsertDomainFairShareWeightPayload {
  """Updated domain fair share data"""
  domainFairShare: DomainFairShare!
}

"""
Added in 26.1.0. Input for upserting project fair share weight. The weight parameter affects scheduling priority - higher weight = higher priority. Set weight to null to use resource group's default_weight.
"""
input UpsertProjectFairShareWeightInput {
  """Name of the scaling group (resource group) for this fair share."""
  resourceGroupName: String!

  """UUID of the project to update weight for."""
  projectId: UUID!

  """Name of the domain the project belongs to."""
  domainName: String!

  """
  Priority weight multiplier. Higher weight = higher priority allocation ratio. Set to null to use resource group's default_weight.
  """
  weight: Decimal = null
}

"""
Added in 26.1.0. Payload for project fair share weight upsert mutation.
"""
type UpsertProjectFairShareWeightPayload {
  """Updated project fair share data"""
  projectFairShare: ProjectFairShare!
}

"""
Added in 24.09.0. Input for creating or updating user-level app configuration.
The provided extra_config object will completely replace the existing configuration;
existing keys not present in the new extra_config will be removed.
These settings will override domain-level settings when configurations are merged for this user.
If user_id is not provided, the current user's configuration will be updated.
"""
input UpsertUserConfigInput {
  extraConfig: JSON!
  userId: ID = null
}

"""
Added in 25.16.0. Payload returned after upserting user-level app configuration. Contains the resulting configuration that was stored.
"""
type UpsertUserConfigPayload {
  """The resulting app configuration"""
  appConfig: AppConfig!
}

"""
Added in 26.1.0. Input for upserting user fair share weight. The weight parameter affects scheduling priority - higher weight = higher priority. Set weight to null to use resource group's default_weight.
"""
input UpsertUserFairShareWeightInput {
  """Name of the scaling group (resource group) for this fair share."""
  resourceGroupName: String!

  """UUID of the project the user belongs to."""
  projectId: UUID!

  """UUID of the user to update weight for."""
  userUuid: UUID!

  """Name of the domain the user belongs to."""
  domainName: String!

  """
  Priority weight multiplier. Higher weight = higher priority allocation ratio. Set to null to use resource group's default_weight.
  """
  weight: Decimal = null
}

"""Added in 26.1.0. Payload for user fair share weight upsert mutation."""
type UpsertUserFairShareWeightPayload {
  """Updated user fair share data"""
  userFairShare: UserFairShare!
}

"""
Added in 26.1.0. Common metadata for usage bucket records including the measurement period and timestamps.
"""
type UsageBucketMetadata {
  """Start date of the usage measurement period (inclusive)."""
  periodStart: Date!

  """End date of the usage measurement period (exclusive)."""
  periodEnd: Date!

  """Number of days in each decay unit for this bucket."""
  decayUnitDays: Int!

  """Timestamp when this record was created."""
  createdAt: DateTime!

  """Timestamp when this record was last updated."""
  updatedAt: DateTime!
}

"""
Added in 26.1.0. Fields available for ordering usage bucket query results. PERIOD_START: Order by the start date of the usage measurement period. Use DESC to get most recent buckets first, ASC for chronological order.
"""
enum UsageBucketOrderField {
  PERIOD_START
}

"""
Added in 26.2.0. Nested filter for the domain a user belongs to. Filters users whose domain matches all specified conditions.
"""
input UserDomainNestedFilter {
  name: StringFilter = null
  isActive: Boolean = null
}

"""
Added in 26.1.0. User-level fair share data representing scheduling priority for an individual user. This is the most granular level of fair share calculation.
"""
type UserFairShare implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """Name of the scaling group this fair share belongs to."""
  resourceGroupName: String!

  """UUID of the user this fair share is calculated for."""
  userUuid: UUID!

  """UUID of the project the user belongs to."""
  projectId: UUID!

  """Name of the domain the user belongs to."""
  domainName: String!

  """Fair share specification parameters used for calculation."""
  spec: FairShareSpec!

  """Snapshot of the most recent fair share calculation results."""
  calculationSnapshot: FairShareCalculationSnapshot!

  """Timestamp when this record was created."""
  createdAt: DateTime!

  """Timestamp when this record was last updated."""
  updatedAt: DateTime!

  """
  Added in 26.2.0. The user entity associated with this fair share record.
  """
  user: UserV2

  """
  Added in 26.2.0. The domain entity associated with this fair share record.
  """
  domain: DomainV2

  """
  Added in 26.2.0. The project entity associated with this fair share record.
  """
  project: ProjectV2

  """
  Added in 26.2.0. The resource group associated with this fair share record.
  """
  resourceGroup: ResourceGroup
}

"""
Added in 26.1.0. Paginated connection for user fair share records. Provides relay-style cursor-based pagination for efficient traversal of user fair share data. Use 'edges' to access individual records with cursor information, or 'nodes' for direct data access.
"""
type UserFairShareConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [UserFairShareEdge!]!

  """Total number of user fair share records matching the query criteria."""
  count: Int!
}

"""An edge in a connection."""
type UserFairShareEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: UserFairShare!
}

"""
Added in 26.1.0. Filter input for querying user fair shares. Supports filtering by scaling group, user UUID, project ID, and domain name. This is the most granular level of fair share filtering. Multiple filters can be combined using AND, OR, and NOT logical operators.
"""
input UserFairShareFilter {
  """
  Filter by scaling group name. Scaling groups define resource pool boundaries where users compete for resources within their project. Supports equals, contains, startsWith, and endsWith operations.
  """
  resourceGroup: StringFilter = null

  """
  Filter by user UUID. Users are individual accounts that create and run sessions. Supports equals operation for exact match or 'in' operation for multiple UUIDs.
  """
  userUuid: UUIDFilter = null

  """
  Filter by project UUID. This filters users by their project membership. Supports equals operation for exact match or 'in' operation for multiple UUIDs.
  """
  projectId: UUIDFilter = null

  """
  Filter by domain name. This filters users belonging to a specific domain. Supports equals, contains, startsWith, and endsWith operations.
  """
  domainName: StringFilter = null

  """
  Added in 26.2.0. Nested filter for user entity properties. Allows filtering by username, email, and active status.
  """
  user: UserFairShareUserNestedFilter = null

  """Combine multiple filters with AND logic. All conditions must match."""
  AND: [UserFairShareFilter!] = null

  """
  Combine multiple filters with OR logic. At least one condition must match.
  """
  OR: [UserFairShareFilter!] = null

  """
  Negate the specified filters. Records matching these conditions will be excluded.
  """
  NOT: [UserFairShareFilter!] = null
}

"""
Added in 26.1.0. Specifies ordering for user fair share query results. Combine field selection with direction to sort results. Default direction is DESC (descending).
"""
input UserFairShareOrderBy {
  """
  The field to order by. See UserFairShareOrderField for available options.
  """
  field: UserFairShareOrderField!

  """
  Sort direction. ASC for ascending (lowest first), DESC for descending (highest first). For fair_share_factor, ASC shows highest priority users first.
  """
  direction: OrderDirection! = DESC
}

"""
Added in 26.1.0. Fields available for ordering user fair share query results. FAIR_SHARE_FACTOR: Order by the calculated fair share factor (0-1 range, lower = higher priority). CREATED_AT: Order by record creation timestamp. USER_USERNAME: Order alphabetically by username. USER_EMAIL: Order alphabetically by email.
"""
enum UserFairShareOrderField {
  FAIR_SHARE_FACTOR
  CREATED_AT
  USER_USERNAME
  USER_EMAIL
}

"""Added in 24.09.0. Scope parameters for filtering user fair shares."""
input UserFairShareScope {
  """Resource group to filter fair shares by."""
  resourceGroupName: String!

  """
  Project ID that the user belongs to (required for user-level fair shares).
  """
  projectId: UUID!
}

"""
Added in 26.2.0. Nested filter for user entity fields in user fair share queries. Allows filtering by user properties such as username, email, and active status.
"""
input UserFairShareUserNestedFilter {
  """
  Filter by username. Supports equals, contains, startsWith, and endsWith.
  """
  username: StringFilter = null

  """Filter by email. Supports equals, contains, startsWith, and endsWith."""
  email: StringFilter = null

  """Filter by user active status (based on user status field)."""
  isActive: Boolean = null
}

"""
Added in 26.2.0. Nested filter for projects a user belongs to. Filters users that belong to at least one project matching all specified conditions.
"""
input UserProjectNestedFilter {
  name: StringFilter = null
  isActive: Boolean = null
}

"""
Added in 26.4.2. User resource policy defining vfolder and quota limits per user.
"""
type UserResourcePolicyV2 implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """Policy name."""
  name: String!

  """Timestamp when the policy was created."""
  createdAt: DateTime

  """Maximum vfolders a user can create."""
  maxVfolderCount: Int!

  """
  Added in 26.4.2. Maximum number of concurrent authenticated login sessions per user. Null means unlimited. Distinct from keypair_resource_policies.max_concurrent_sessions which caps compute sessions.
  """
  maxConcurrentLogins: Int

  """Maximum quota scope size."""
  maxQuotaScopeSize: BinarySizeInfo!

  """Maximum sessions per model session."""
  maxSessionCountPerModelSession: Int!

  """Maximum customized images a user can create."""
  maxCustomizedImageCount: Int!
}

"""Added in 26.4.2. Paginated connection for user resource policies."""
type UserResourcePolicyV2Connection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [UserResourcePolicyV2Edge!]!

  """Total number of matching policies."""
  count: Int!
}

"""An edge in a connection."""
type UserResourcePolicyV2Edge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: UserResourcePolicyV2!
}

"""Added in 26.4.2. Filter for user resource policies."""
input UserResourcePolicyV2Filter {
  name: StringFilter = null
  createdAt: DateTimeFilter = null
  maxVfolderCount: IntFilter = null
  maxConcurrentLogins: IntFilter = null
  maxQuotaScopeSize: IntFilter = null
  maxSessionCountPerModelSession: IntFilter = null
  maxCustomizedImageCount: IntFilter = null
}

"""Added in 26.4.2. Ordering specification for user resource policies."""
input UserResourcePolicyV2OrderBy {
  """Field to order by."""
  field: UserResourcePolicyV2OrderField! = CREATED_AT

  """Sort direction."""
  direction: OrderDirection! = DESC
}

"""Added in 26.4.2. Fields available for ordering user resource policies."""
enum UserResourcePolicyV2OrderField {
  NAME
  CREATED_AT
  MAX_VFOLDER_COUNT
  MAX_CONCURRENT_LOGINS
  MAX_QUOTA_SCOPE_SIZE
  MAX_SESSION_COUNT_PER_MODEL_SESSION
  MAX_CUSTOMIZED_IMAGE_COUNT
}

"""
Added in 26.2.0. User role determining access permissions. USER: Standard user with basic permissions. ADMIN: Domain administrator with elevated permissions. SUPERADMIN: System-wide administrator with full access. MONITOR: Read-only access for monitoring purposes.
"""
enum UserRoleV2 {
  USER
  ADMIN
  SUPERADMIN
  MONITOR
}

"""
Added in 26.2.0. Filter for UserRoleV2 enum fields. Supports equals, in, not_equals, and not_in operations.
"""
input UserRoleV2EnumFilter {
  equals: UserRoleV2 = null

  """The in  field."""
  in: [UserRoleV2!] = null
  notEquals: UserRoleV2 = null
  notIn: [UserRoleV2!] = null
}

"""
Added in 26.2.0. User account status. ACTIVE: User can log in and use the system. INACTIVE: User account is disabled but preserved. DELETED: User has been soft-deleted. BEFORE_VERIFICATION: User account is pending email verification.
"""
enum UserStatusV2 {
  ACTIVE
  INACTIVE
  DELETED
  BEFORE_VERIFICATION
}

"""
Added in 26.2.0. Filter for UserStatusV2 enum fields. Supports equals, in, not_equals, and not_in operations.
"""
input UserStatusV2EnumFilter {
  equals: UserStatusV2 = null

  """The in  field."""
  in: [UserStatusV2!] = null
  notEquals: UserStatusV2 = null
  notIn: [UserStatusV2!] = null
}

"""
Added in 26.1.0. User-level usage bucket representing aggregated resource consumption for a specific time period. This is the most granular level of usage tracking.
"""
type UserUsageBucket implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """UUID of the user this usage bucket belongs to."""
  userUuid: UUID!

  """UUID of the project the user belongs to."""
  projectId: UUID!

  """Name of the domain the user belongs to."""
  domainName: String!

  """Name of the scaling group this usage was recorded in."""
  resourceGroupName: String!

  """Metadata about the usage measurement period and timestamps."""
  metadata: UsageBucketMetadata!

  """
  Aggregated resource usage during this period. Contains the total compute resources consumed by this user's workloads during the measurement period (cpu cores, memory bytes, accelerator usage).
  """
  resourceUsage: ResourceSlot!

  """
  Snapshot of total available capacity in the scaling group at the end of this period. Used as a reference to calculate relative usage and fair share factors.
  """
  capacitySnapshot: ResourceSlot!

  """
  Added in 26.2.0. Average daily resource usage during this period. Calculated as resource_usage divided by bucket duration in days. For each resource type, this represents the average amount consumed per day. Units match the resource type (e.g., CPU cores, memory bytes).
  """
  averageDailyUsage: ResourceSlot

  """
  Added in 26.2.0. Usage ratio against total available capacity for each resource. Calculated as resource_usage divided by capacity_snapshot. Represents the fraction of total capacity consumed (resource-seconds / resource). The result is in seconds, where 86400 means full utilization for one day. Values can exceed this if usage exceeds capacity.
  """
  usageCapacityRatio: ResourceSlot
}

"""
Added in 26.1.0. Paginated connection for user usage bucket records. Provides relay-style cursor-based pagination for browsing historical usage data by time period. Use 'edges' to access individual records with cursor information, or 'nodes' for direct data access.
"""
type UserUsageBucketConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [UserUsageBucketEdge!]!

  """Total number of user usage bucket records matching the query criteria."""
  count: Int!
}

"""An edge in a connection."""
type UserUsageBucketEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: UserUsageBucket!
}

"""
Added in 26.1.0. Filter input for querying user usage bucket records. Usage buckets contain historical resource consumption data aggregated by time period for users. This is the most granular level of usage bucket filtering. Multiple filters can be combined using AND, OR, and NOT logical operators.
"""
input UserUsageBucketFilter {
  """
  Filter by scaling group name. Scaling groups define where usage was recorded. Supports equals, contains, startsWith, and endsWith operations.
  """
  resourceGroup: StringFilter = null

  """
  Filter by user UUID. This filters usage buckets for a specific user. Supports equals operation for exact match.
  """
  userUuid: UUIDFilter = null

  """
  Filter by project UUID. This filters usage buckets for users within a specific project. Supports equals operation for exact match.
  """
  projectId: UUIDFilter = null

  """
  Filter by domain name. This filters usage buckets for users within a specific domain. Supports equals, contains, startsWith, and endsWith operations.
  """
  domainName: StringFilter = null

  """Filter by usage measurement period start date."""
  periodStart: DateFilter = null

  """Filter by usage measurement period end date."""
  periodEnd: DateFilter = null

  """Combine multiple filters with AND logic. All conditions must match."""
  AND: [UserUsageBucketFilter!] = null

  """
  Combine multiple filters with OR logic. At least one condition must match.
  """
  OR: [UserUsageBucketFilter!] = null

  """
  Negate the specified filters. Records matching these conditions will be excluded.
  """
  NOT: [UserUsageBucketFilter!] = null
}

"""
Added in 26.1.0. Specifies ordering for user usage bucket query results. Combine field selection with direction to sort results. Default direction is DESC (most recent first).
"""
input UserUsageBucketOrderBy {
  """
  The field to order by. See UsageBucketOrderField for available options.
  """
  field: UsageBucketOrderField!

  """
  Sort direction. ASC for chronological order (oldest first), DESC for reverse chronological order (most recent first).
  """
  direction: OrderDirection! = DESC
}

"""Added in 24.09.0. Scope parameters for filtering user usage buckets."""
input UserUsageScope {
  """Resource group to filter usage buckets by."""
  resourceGroupName: String!

  """Project ID that the user belongs to (required for user-level usage)."""
  projectId: UUID!
}

"""
Added in 26.2.0. User entity with structured field groups. Provides comprehensive user information organized into logical categories: basic_info (profile), status (account state), organization (permissions), security (auth settings), container (execution settings), and timestamps.
"""
type UserV2 implements Node @key(fields: "id") {
  """The Globally Unique ID of this object"""
  id: ID!

  """Basic profile information including username, email, and display name."""
  basicInfo: UserV2BasicInfo!

  """Account status and password-related flags."""
  status: UserV2StatusInfo!

  """Organizational context including domain, role, and resource policy."""
  organization: UserV2OrganizationInfo!

  """Security settings including IP restrictions and TOTP configuration."""
  security: UserV2SecurityInfo!

  """Container execution settings including UID/GID mappings."""
  container: UserV2ContainerSettings!

  """Creation and modification timestamps."""
  timestamps: EntityTimestamps!

  """
  Fair share record for this user in the specified resource group and project. Returns the scheduling priority configuration for this user. Always returns an object, even if no explicit configuration exists (in which case default values are used).
  """
  fairShare(scope: UserFairShareScope!): UserFairShare

  """
  Usage buckets for this user, filtered by resource group and project. Returns aggregated resource usage statistics over time.
  """
  usageBuckets(scope: UserUsageScope!, filter: UserUsageBucketFilter = null, orderBy: [UserUsageBucketOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): UserUsageBucketConnection

  """The domain this user belongs to."""
  domain: DomainV2

  """Projects this user is a member of."""
  projects(filter: ProjectV2Filter = null, orderBy: [ProjectV2OrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): ProjectV2Connection
}

"""
Added in 26.2.0. Basic user profile information. Contains identity and descriptive fields for the user account.
"""
type UserV2BasicInfo {
  """
  Unique username for login. May be null if only email-based login is used.
  """
  username: String

  """User's email address. Used for login and notifications."""
  email: String!

  """User's full display name."""
  fullName: String

  """Optional description or notes about the user."""
  description: String

  """External system integration identifier."""
  integrationName: String
}

"""
Added in 26.2.0. Paginated connection for user records. Provides relay-style cursor-based pagination for efficient traversal of user data. Use 'edges' to access individual records with cursor information, or 'nodes' for direct data access.
"""
type UserV2Connection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [UserV2Edge!]!

  """Total number of user records matching the query criteria."""
  count: Int!
}

"""
Added in 26.2.0. Container execution settings for the user. Defines UID/GID mappings for containers created by this user.
"""
type UserV2ContainerSettings {
  """
  User ID (UID) to use inside containers. If null, system default is used.
  """
  containerUid: Int

  """
  Primary group ID (GID) to use inside containers. If null, system default is used.
  """
  containerMainGid: Int

  """Additional supplementary group IDs for container processes."""
  containerGids: [Int!]
}

"""An edge in a connection."""
type UserV2Edge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: UserV2!
}

"""
Added in 26.2.0. Filter input for querying users. Supports filtering by UUID, username, email, status, domain, integration_name, role, creation time, and nested domain/project filters. Multiple filters can be combined using AND, OR, and NOT logical operators.
"""
input UserV2Filter {
  uuid: UUIDFilter = null
  username: StringFilter = null
  email: StringFilter = null
  status: UserStatusV2EnumFilter = null
  domainName: StringFilter = null

  """Added in 26.4.2. Filter by external integration identifier."""
  integrationName: StringFilter = null
  role: UserRoleV2EnumFilter = null
  createdAt: DateTimeFilter = null
  domain: UserDomainNestedFilter = null
  project: UserProjectNestedFilter = null
  AND: [UserV2Filter!] = null
  OR: [UserV2Filter!] = null
  NOT: [UserV2Filter!] = null
}

"""
Added in 26.2.0. Specifies ordering for user query results. Combine field selection with direction to sort results. Default direction is DESC (descending).
"""
input UserV2OrderBy {
  field: UserV2OrderField! = CREATED_AT
  direction: OrderDirection! = DESC
}

"""
Added in 26.2.0. Fields available for ordering user query results. CREATED_AT: Order by creation timestamp. MODIFIED_AT: Order by last modification timestamp. USERNAME: Order by username alphabetically. EMAIL: Order by email address alphabetically. STATUS: Order by account status. DOMAIN_NAME: Order by domain name (scalar subquery). PROJECT_NAME: Order by project name (MIN aggregation).
"""
enum UserV2OrderField {
  CREATED_AT
  MODIFIED_AT
  USERNAME
  EMAIL
  STATUS
  DOMAIN_NAME
  PROJECT_NAME
}

"""
Added in 26.2.0. User's organizational context and permissions. Contains domain membership, role, and resource policy information.
"""
type UserV2OrganizationInfo {
  """Name of the domain this user belongs to."""
  domainName: String

  """User's role determining access permissions. See UserRole enum."""
  role: UserRoleV2

  """Name of the user resource policy applied to this user."""
  resourcePolicy: String!

  """Primary API access key for this user."""
  mainAccessKey: String
}

"""
Added in 26.2.0. User security settings and authentication configuration. Contains IP restrictions, TOTP settings, and privilege flags.
"""
type UserV2SecurityInfo {
  """
  List of allowed client IP addresses or CIDR ranges. If set, login is restricted to these IP addresses. Supports both IPv4 and IPv6 formats (e.g., '192.168.1.0/24', '::1').
  """
  allowedClientIp: [String!]

  """
  Whether TOTP (Time-based One-Time Password) two-factor authentication is enabled.
  """
  totpActivated: Boolean

  """Timestamp when TOTP was activated."""
  totpActivatedAt: DateTime

  """Whether this user can create sudo (privileged) sessions."""
  sudoSessionEnabled: Boolean!
}

"""
Added in 26.2.0. User account status information. Contains current status and password-related flags.
"""
type UserV2StatusInfo {
  """
  Current account status. See UserStatus enum for possible values. Replaces the deprecated is_active field.
  """
  status: UserStatusV2!

  """
  Additional information about the current status, such as reason for deactivation.
  """
  statusInfo: String

  """If true, user must change password on next login."""
  needPasswordChange: Boolean
}

"""
Added in 26.1.0. Input item for a single user weight in bulk upsert. Represents one user's weight configuration within a project.
"""
input UserWeightInputItem {
  """UUID of the user to update weight for."""
  userUuid: UUID!

  """ID of the project this user's fair share belongs to."""
  projectId: UUID!

  """Name of the domain this project belongs to."""
  domainName: String!

  """
  Priority weight multiplier. Higher weight = higher priority allocation ratio. Set to null to use resource group's default_weight.
  """
  weight: Decimal = null
}

"""Added in 25.16.0. VFS Storage configuration."""
type VFSStorage implements Node {
  """The Globally Unique ID of this object"""
  id: ID!
  name: String!
  host: String!
  basePath: String!
}

"""Added in 25.16.0. VFS Storage connection."""
type VFSStorageConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [VFSStorageEdge!]!

  """The count of this entity."""
  count: Int!
}

"""An edge in a connection."""
type VFSStorageEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: VFSStorage!
}

"""
Added in 26.4.2. Virtual folder entity with structured field groups. Provides comprehensive vfolder information organized into logical categories: metadata (descriptive), permission (access control), and usage (storage statistics). Owner and creator are resolved as Node references.
"""
type VFolder implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """
  Current operation status. READY, CLONING, DELETE_PENDING, DELETE_ONGOING, DELETE_COMPLETE, or DELETE_ERROR.
  """
  status: VFolderOperationStatus!

  """Storage host where the virtual folder is physically located."""
  host: String!

  """
  Descriptive metadata including name, usage mode, quota scope, timestamps, and clone eligibility.
  """
  metadata: VFolderMetadataInfo!

  """Access control including permission level and ownership type."""
  accessControl: VFolderAccessControlInfo!

  """
  Ownership context including scalar IDs (userId, projectId, creatorEmail) and full node resolvers (user, project, creator).
  """
  ownership: VFolderOwnershipInfo!

  """Path for unmanaged virtual folders."""
  unmanagedPath: String

  """Added in UNRELEASED. Model cards backed by this vfolder."""
  modelCards(filter: ModelCardV2Filter = null, orderBy: [ModelCardV2OrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): ModelCardV2Connection
}

"""
Added in 26.4.2. Access control information for a virtual folder. Includes the mount permission level (read-only, read-write, read-write-delete) and ownership type (user or project).
"""
type VFolderAccessControlInfo {
  permission: VFolderMountPermission!
  ownershipType: VFolderOwnershipType!
}

"""
Added in 26.4.2. Paginated connection for virtual folder records. Provides relay-style cursor-based pagination for efficient traversal of vfolder data. Use 'edges' to access individual records with cursor information, or 'nodes' for direct data access.
"""
type VFolderConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [VFolderEdge!]!

  """Total number of virtual folder records matching the query criteria."""
  count: Int!
}

"""An edge in a connection."""
type VFolderEdge {
  """A cursor for use in pagination"""
  cursor: String!

  """The item at the end of the edge"""
  node: VFolder!
}

"""Added in 26.4.2. A file or directory entry inside a virtual folder."""
type VFolderFileEntryV2 {
  """File or directory name"""
  name: String!

  """Entry type"""
  type: String!

  """File size in bytes"""
  size: Int!

  """POSIX file permission mode (e.g., 33188 for 0o100644)"""
  mode: Int!

  """Creation timestamp"""
  createdAt: String!

  """Last modification timestamp"""
  updatedAt: String!
}

"""
Added in 26.4.2. Filter input for querying virtual folders. Supports filtering by name, host, status, usage mode, and creation time. Multiple filters can be combined using AND, OR, and NOT logical operators.
"""
input VFolderFilter {
  name: StringFilter = null
  host: StringFilter = null
  status: VFolderOperationStatusFilter = null
  usageMode: VFolderUsageModeFilter = null
  cloneable: Boolean = null
  createdAt: DateTimeFilter = null
  AND: [VFolderFilter!] = null
  OR: [VFolderFilter!] = null
  NOT: [VFolderFilter!] = null
}

"""
Added in 26.2.0. Storage host permission configuration. Defines what operations are allowed for a specific storage host.
"""
type VFolderHostPermissionEntry {
  """Virtual folder host name (e.g., 'default', 'nfs-vol1')."""
  host: String!

  """List of permission values (e.g., 'mount-in-session', 'upload-file')."""
  permissions: [VFolderHostPermissionV2!]!
}

"""Added in 26.4.2. Input for a vfolder host with its permissions."""
input VFolderHostPermissionEntryInput {
  """Virtual folder host name."""
  host: String!

  """List of permission values."""
  permissions: [String!]!
}

"""
Added in 26.2.0. Atomic permissions for virtual folders on a storage host.
"""
enum VFolderHostPermissionV2 {
  CREATE_VFOLDER
  MODIFY_VFOLDER
  DELETE_VFOLDER
  MOUNT_IN_SESSION
  UPLOAD_FILE
  DOWNLOAD_FILE
  INVITE_OTHERS
  SET_USER_PERM
}

"""
Added in 26.4.2. Descriptive metadata for a virtual folder. Includes the folder name, usage mode, quota scope, timestamps, and clone eligibility.
"""
type VFolderMetadataInfo {
  name: String!
  usageMode: VFolderUsageMode!
  quotaScopeId: String
  createdAt: DateTime!
  lastUsed: DateTime
  cloneable: Boolean!
}

"""Added in 26.4.2. Mount permission level for a virtual folder."""
enum VFolderMountPermission {
  READ_ONLY
  READ_WRITE
  RW_DELETE
}

"""Added in 26.4.2. Operation status of a virtual folder."""
enum VFolderOperationStatus {
  READY
  CLONING
  DELETE_PENDING
  DELETE_ONGOING
  DELETE_COMPLETE
  DELETE_ERROR
}

"""
Added in 26.4.2. Filter for VFolder operation status enum fields. Supports in and not_in operations.
"""
input VFolderOperationStatusFilter {
  equals: VFolderOperationStatus = null

  """The in field."""
  in: [VFolderOperationStatus!] = null

  """Excludes exact status match."""
  notEquals: VFolderOperationStatus = null

  """Exclude statuses not in this list."""
  notIn: [VFolderOperationStatus!] = null
}

"""
Added in 26.4.2. Specifies ordering for virtual folder query results. Combine field selection with direction to sort results. Default direction is DESC (descending).
"""
input VFolderOrderBy {
  field: VFolderOrderField! = CREATED_AT
  direction: OrderDirection! = DESC
}

"""
Added in 26.4.2. Fields available for ordering virtual folder query results. NAME: Order by folder name alphabetically. CREATED_AT: Order by creation timestamp. STATUS: Order by operation status. USAGE_MODE: Order by usage mode. HOST: Order by storage host.
"""
enum VFolderOrderField {
  NAME
  CREATED_AT
  STATUS
  USAGE_MODE
  HOST
}

"""
Added in 26.4.2. Ownership context for a virtual folder. Provides both scalar IDs (userId, projectId, creatorEmail) for lightweight access and full node resolvers (user, project, creator) for detailed entity information.
"""
type VFolderOwnershipInfo {
  """The user who owns this virtual folder. Null for project-owned folders."""
  user: UserV2

  """
  The project that owns this virtual folder. Null for user-owned folders.
  """
  project: ProjectV2

  """The user who originally created this virtual folder."""
  creator: UserV2
  userId: UUID
  projectId: UUID
  creatorId: UUID
  creatorEmail: String
}

"""Added in 26.4.2. Ownership type of a virtual folder (USER or GROUP)."""
enum VFolderOwnershipType {
  USER
  GROUP
}

"""
Added in 26.4.2. Usage mode of a virtual folder (GENERAL, MODEL, DATA).
"""
enum VFolderUsageMode {
  GENERAL
  MODEL
  DATA
}

"""
Added in 26.4.2. Filter for VFolder usage mode enum fields. Supports in and not_in operations.
"""
input VFolderUsageModeFilter {
  equals: VFolderUsageMode = null

  """The in field."""
  in: [VFolderUsageMode!] = null

  """Excludes exact usage mode match."""
  notEquals: VFolderUsageMode = null

  """Exclude usage modes not in this list."""
  notIn: [VFolderUsageMode!] = null
}

"""Added in 24.09.0. Input for validate notification channel mutation"""
input ValidateNotificationChannelInput {
  id: ID!
  testMessage: String!
}

"""Added in 26.3.0. Payload for validate notification channel mutation."""
type ValidateNotificationChannelPayload {
  """ID of the validated notification channel"""
  id: UUID!
}

"""Added in 24.09.0. Input for validate notification rule mutation"""
input ValidateNotificationRuleInput {
  id: ID!
  notificationData: JSON
}

"""Added in 26.3.0. Payload for validate notification rule mutation."""
type ValidateNotificationRulePayload {
  """The rendered message from the template"""
  message: String!
}

extend type VirtualFolderNode @key(fields: "id") {
  id: ID! @external
}

"""Added in 24.09.0. Input for webhook configuration"""
input WebhookSpecInput {
  url: String!
}

scalar _Any

union _Entity = ComputeSessionNode | DomainNode | DomainV2 | GroupNode | ImageNode | ProjectV2 | ScalingGroupNode | UserV2 | VirtualFolderNode

type _Service {
  sdl: String!
}