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
}

type AccessToken implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """Added in 25.16.0: The access token."""
  token: String!

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

  """Added in 25.16.0: The expiration timestamp of the access token."""
  validUntil: DateTime!
}

"""Added in 25.16.0"""
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
  validUntil: 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 {
  deployment: ModelDeployment!
  previousRevisionId: ID
  activatedRevisionId: ID!
}

"""
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 by active sessions. Each entry represents a resource type and the total quantity in use.
  """
  slots: ResourceSlot!

  """
  Number of active sessions contributing to the current resource occupancy.
  """
  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 {
  name: String = null
  deploymentId: ID!
  clusterConfig: ClusterConfigInput!
  resourceConfig: ResourceConfigInput!
  image: ImageInput!
  modelRuntimeConfig: ModelRuntimeConfigInput!
  modelMountConfig: ModelMountConfigInput!
  extraMounts: [ExtraVFolderMountInput!]
}

"""Added in 25.19.0"""
type AddRevisionPayload {
  revision: ModelRevision!
}

"""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").
  This is the bind or advertised address used by the manager to communicate
  with the agent for session lifecycle management and health monitoring.
  """
  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"""
type AgentResource {
  """
  Total hardware resource capacity available on the agent.
  Expressed as a JSON object containing resource slots (e.g., cpu, mem, accelerators).
  Each slot represents the maximum amount of that resource type the agent can provide.
  """
  capacity: JSON!

  """
  Total amount of resources currently consumed by running and scheduled compute sessions.
  Includes both the requested resources for sessions being prepared and already allocated
  resources for active sessions. The sum of occupied resources across all session states
  that occupy agent resources (PREPARING, PULLING, RUNNING, RESTARTING, etc.).
  Expressed as a JSON object with the same structure as capacity.
  """
  used: JSON!

  """
  Available resources for scheduling new compute sessions (capacity - used).
  This represents the maximum resources that can be allocated to new sessions
  without exceeding the agent's capacity. Expressed as a JSON object with
  the same structure as capacity.
  """
  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
  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"""
type AgentStats {
  """Added in 25.15.0"""
  totalResource: AgentResource!
}

enum AgentStatus {
  ALIVE
  LOST
  RESTARTING
  TERMINATED
}

"""
Added in 26.1.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 {
  in: [AgentStatus!] = null
  equals: AgentStatus = null
}

"""Added in 26.1.0. Status and lifecycle information for an agent"""
type AgentStatusInfo {
  """
  Current operational status of the agent.
  Indicates whether the agent is ALIVE (active and reachable), LOST (unreachable),
  TERMINATED (intentionally stopped), or RESTARTING (in recovery process).
  """
  status: AgentStatus!

  """
  Timestamp when the agent last changed its status.
  Updated whenever the agent transitions between different status states
  (e.g., from ALIVE to LOST, or RESTARTING to ALIVE).
  Will be null if the agent status has never changed since initial registration.
  """
  statusChanged: DateTime

  """
  Timestamp when the agent first registered with the manager.
  This value remains constant throughout the agent's lifecycle and can be used
  to track the agent's age or identify when it was initially deployed.
  """
  firstContact: DateTime

  """
  Timestamp when the agent was marked as lost or unreachable.
  Set when the manager detects the agent has stopped sending heartbeats.
  Will be 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.
  An agent can be non-schedulable due to maintenance mode, resource constraints or other operational reasons by admin.
  When false, no new sessions will be assigned to this agent.
  """
  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 and ensure
  proper binary execution on the agent.
  """
  architecture: String!

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

  """
  Legacy configuration flag, no longer actively used in the system.
  Retained for backward compatibility and schema consistency.
  Originally intended to control automatic termination of misbehaving sessions.
  """
  autoTerminateAbusingKernel: Boolean! @deprecated(reason: "Legacy feature no longer in use.")

  """
  List of compute plugin metadata supported by this agent.
  Each plugin represents a specific accelerator or resource type (e.g., CUDA).
  Entries contain plugin names and their associated metadata with
  plugin-specific configuration and capabilities.
  """
  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 25.16.0. App configuration data"""
type AppConfig {
  extraConfig: JSON!
}

"""
Added in 25.14.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 {
  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 (available), DELETED (soft-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!
  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 {
  artifactId: ID!
  progress: Float!
  status: ArtifactStatus!
}

"""
Added in 25.14.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"""
type ArtifactRegistry {
  """
  Added in 25.17.0. Internal identifier for the artifact registry metadata record in the 'artifact_registries' table. This ID is unique across all registry types and represents the metadata record itself. Example: When you need to reference a registry entry in the metadata table, use this ID.
  """
  id: ID!

  """
  Added in 25.17.0. Identifier of the actual registry implementation (e.g., HuggingFace registry, Reservoir registry). This ID corresponds to the primary key in the registry-type-specific table. Example: For a HuggingFace registry, this value matches the 'id' field in the 'huggingface_registries' table. Use this ID when you need to access type-specific registry details.
  """
  registryId: ID!

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

  """Type of the default 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"""
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"""
  remoteStatus: ArtifactRemoteStatus
  version: String!
  readme: String
  size: ByteSize
  createdAt: DateTime
  updatedAt: DateTime

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

  """
  Verification result containing malware scan results from all verifiers. None if not yet verified. Added in 25.17.0
  """
  verificationResult: ArtifactVerificationResult
  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"""
  remoteStatus: ArtifactRevisionRemoteStatusFilter = null
  version: StringFilter = null
  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 {
  taskId: ID
  artifactRevision: ArtifactRevision!
}

"""
Added in 25.14.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 {
  in: [ArtifactRemoteStatus!] = null
  equals: ArtifactRemoteStatus = null
}

"""
Added in 25.14.0.

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

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

"""
Added in 25.14.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 {
  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. Each entry contains a key-value pair."""
  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!

  """Added in 26.1.0. 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 (e.g., 'clamav', 'custom')"""
  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!
}

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

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

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

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

"""Filter for audit log status field."""
input AuditLogStatusFilter {
  in: [AuditLogStatus!] = null
  notIn: [AuditLogStatus!] = null
}

"""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
}

"""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"""
enum AutoScalingMetricSource {
  KERNEL
  INFERENCE_FRAMEWORK
}

type AutoScalingRule implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """Added in 25.19.0 (e.g. KERNEL, INFERENCE_FRAMEWORK)"""
  metricSource: AutoScalingMetricSource!
  metricName: String!

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

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

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

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

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

  """Added in 25.19.0: The maximum number of replicas (e.g. 10)."""
  maxReplicas: Int
  createdAt: DateTime!
  lastTriggeredAt: DateTime!
}

"""Added in 25.19.0"""
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: DateTimeFilter = 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
}

"""Background task event payload"""
type BackgroundTaskEventPayload {
  taskId: ID!
  eventType: BgtaskEventType!
  message: String!
  currentProgress: Float
  totalProgress: Float
}

"""Type of background task event"""
enum BgtaskEventType {
  UPDATED
  DONE
  CANCELLED
  FAILED
}

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

"""
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!]!
}

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

  """List of errors for 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 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 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 {
  """List of successfully revoked role assignments."""
  revoked: [RoleAssignment!]!

  """List of errors for 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 domain fair share records created or updated."""
  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 project fair share records created or updated."""
  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 user fair share records created or updated."""
  upsertedCount: Int!
}

scalar ByteSize

"""
Added in 25.14.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 {
  artifactRevision: ArtifactRevision!
}

"""
Added in 25.14.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 {
  artifactRevisions: ArtifactRevisionConnection!
}

type ClusterConfig {
  """The clustering mode (e.g., SINGLE_NODE)."""
  mode: ClusterMode!

  """Number of replicas in the cluster."""
  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 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. The list includes all accelerator and resource type plugins installed on the agent.
  """
  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.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
}

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

  """Added in 25.16.0: The expiration timestamp of the access token."""
  validUntil: DateTime!
}

type CreateAccessTokenPayload {
  accessToken: AccessToken!
}

input CreateAutoScalingRuleInput {
  modelDeploymentId: ID!
  metricSource: AutoScalingMetricSource!
  metricName: String!
  minThreshold: Decimal
  maxThreshold: Decimal
  stepSize: Int!
  timeWindow: Int!
  minReplicas: Int
  maxReplicas: Int
}

type CreateAutoScalingRulePayload {
  autoScalingRule: AutoScalingRule!
}

"""Added in 25.19.0"""
input CreateDeploymentInput {
  metadata: ModelDeploymentMetadataInput!
  networkAccess: ModelDeploymentNetworkAccessInput!
  defaultDeploymentStrategy: DeploymentStrategyInput!
  desiredReplicaCount: Int!
  initialRevision: CreateRevisionInput!
}

"""Added in 25.19.0"""
type CreateDeploymentPayload {
  deployment: ModelDeployment!
}

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

"""Added in 25.14.0"""
type CreateHuggingFaceRegistryPayload {
  huggingfaceRegistry: HuggingFaceRegistry!
}

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

"""Payload for create notification channel mutation"""
type CreateNotificationChannelPayload {
  channel: NotificationChannel!
}

"""Input for creating a notification rule"""
input CreateNotificationRuleInput {
  name: String!
  description: String = null
  ruleType: NotificationRuleType!
  channelId: ID!
  messageTemplate: String!
  enabled: Boolean! = true
}

"""Payload for create notification rule mutation"""
type CreateNotificationRulePayload {
  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"""
type CreateObjectStoragePayload {
  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.3.0. Input for creating a new query definition."""
input CreateQueryDefinitionInput {
  """Human-readable identifier (must be unique)."""
  name: String!

  """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 {
  preset: QueryDefinition!
}

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

"""Added in 25.14.0"""
type CreateReservoirRegistryPayload {
  reservoir: ReservoirRegistry!
}

"""
Added in 25.19.0. Input for specifying revision configuration within a deployment.
"""
input CreateRevisionInput {
  name: String = null
  clusterConfig: ClusterConfigInput!
  resourceConfig: ResourceConfigInput!
  image: ImageInput!
  modelRuntimeConfig: ModelRuntimeConfigInput!
  modelMountConfig: ModelMountConfigInput!
  extraMounts: [ExtraVFolderMountInput!]
}

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

"""
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 {
  vfsStorage: VFSStorage!
}

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

input DateFilter {
  before: Date = null
  after: Date = null
  equals: Date = null
  notEquals: Date = null
}

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

input DateTimeFilter {
  before: DateTime = null
  after: DateTime = null
  equals: DateTime = null
  notEquals: DateTime = null
}

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

"""
Added in 25.15.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
  artifactType: ArtifactType = null
  delegateeTarget: DelegateeTarget = null

  """
  Options controlling import behavior such as forcing re-download. Added in 26.1.0.
  """
  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 {
  """
  Connection of artifact revisions that were imported from the reservoir registry's remote registry
  """
  artifactRevisions: ArtifactRevisionConnection!

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

"""
Added in 25.15.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

  """Maximum number of artifacts to scan (max: 500)"""
  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 from the reservoir registry's remote registry
  """
  artifacts: [Artifact!]!
}

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

"""
Added in 25.15.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 {
  artifacts: [Artifact!]!
}

input DeleteAutoScalingRuleInput {
  id: ID!
}

type DeleteAutoScalingRulePayload {
  id: ID!
}

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

"""Added in 25.19.0"""
type DeleteDeploymentPayload {
  id: ID!
}

"""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 {
  deleted: Boolean!
}

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

"""Added in 25.14.0"""
type DeleteHuggingFaceRegistryPayload {
  id: ID!
}

"""Input for deleting a notification channel"""
input DeleteNotificationChannelInput {
  id: ID!
}

"""Payload for delete notification channel mutation"""
type DeleteNotificationChannelPayload {
  id: ID!
}

"""Input for deleting a notification rule"""
input DeleteNotificationRuleInput {
  id: ID!
}

"""Payload for delete notification rule mutation"""
type DeleteNotificationRulePayload {
  id: ID!
}

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

"""Added in 25.14.0"""
type DeleteObjectStoragePayload {
  id: ID!
}

"""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: ID!
}

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

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

"""Added in 25.14.0"""
type DeleteReservoirRegistryPayload {
  id: ID!
}

"""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: ID!
}

"""
Added in 25.16.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 {
  deleted: Boolean!
}

"""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: ID!
}

"""Added in 25.19.0"""
input DeploymentFilter {
  name: StringFilter = null
  status: DeploymentStatusFilter = null
  openToPublic: Boolean = null
  tags: StringFilter = null
  endpointUrl: StringFilter = null
  AND: [DeploymentFilter!] = null
  OR: [DeploymentFilter!] = null
  NOT: [DeploymentFilter!] = null
}

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

  """The deployment ID this history record belongs to."""
  deploymentId: ID!
}

"""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!
}

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

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

enum DeploymentHistoryOrderField {
  CREATED_AT
  UPDATED_AT
}

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

enum DeploymentOrderField {
  CREATED_AT
  UPDATED_AT
  NAME
}

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

"""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
  DESTROYING
  DESTROYED
  STOPPING
  STOPPED
}

"""Added in 25.19.0"""
type DeploymentStatusChangedPayload {
  deployment: ModelDeployment!
}

"""Added in 25.19.0"""
input DeploymentStatusFilter {
  in: [DeploymentStatus!] = null
  equals: DeploymentStatus = null
}

type DeploymentStrategyGQL {
  type: DeploymentStrategyType!
}

"""
Added in 25.19.0. Deployment strategy configuration with discriminator pattern.
"""
input DeploymentStrategyInput {
  type: DeploymentStrategyType!
  rollbackOnFailure: Boolean! = false
  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."""
  integrationId: 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 (added in 26.2.0).
"""
enum DomainFairShareOrderField {
  FAIR_SHARE_FACTOR
  DOMAIN_NAME
  CREATED_AT
  DOMAIN_IS_ACTIVE
}

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.2.0. Nested filter for projects belonging to a domain. Filters domains that have at least one project matching all specified conditions.
"""
input DomainProjectNestedFilter {
  """
  Filter by project name. Supports equals, contains, startsWith, and endsWith.
  """
  name: StringFilter = null

  """Filter by project active status."""
  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.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
}

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 {
  """
  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. True for active users (status=ACTIVE), False for inactive.
  """
  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 {
  """
  Filter by domain name. Supports equals, contains, startsWith, and endsWith.
  """
  name: StringFilter = null

  """
  Filter by domain description. Supports equals, contains, startsWith, and endsWith.
  """
  description: StringFilter = null

  """
  Filter by active status. True for active domains, False for inactive domains.
  """
  isActive: Boolean = null

  """
  Filter by creation timestamp. Supports before, after, and between operations.
  """
  createdAt: DateTimeFilter = null

  """
  Filter by last modification timestamp. Supports before, after, and between operations.
  """
  modifiedAt: DateTimeFilter = null

  """
  Filter by nested project conditions. Returns domains that have at least one project matching all specified conditions.
  """
  project: DomainProjectNestedFilter = null

  """
  Filter by nested user conditions. Returns domains that have at least one user matching all specified conditions.
  """
  user: DomainUserNestedFilter = null

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

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

  """
  Negate the specified filters. Records matching these conditions will be excluded.
  """
  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 {
  """The field to order by. See DomainV2OrderField for available options."""
  field: DomainV2OrderField!

  """Sort direction. ASC for ascending, DESC for descending."""
  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
}

"""Input for email message settings"""
input EmailMessageInput {
  fromEmail: String!
  toEmails: [String!]!
  subjectTemplate: String = null
}

"""Input for email notification channel configuration"""
input EmailSpecInput {
  smtp: SMTPConnectionInput!
  message: EmailMessageInput!
  auth: SMTPAuthInput = null
}

"""Added in 26.3.0. Entity connection"""
type EntityConnection {
  edges: [EntityEdge!]!
  pageInfo: PageInfo!
  count: Int!
}

"""Added in 26.3.0. Entity edge"""
type EntityEdge {
  node: EntityRef!
  cursor: String!
}

"""Added in 26.3.0. Filter for entity associations"""
input EntityFilter {
  entityType: RBACElementType = null
  entityId: StringFilter = null
  AND: [EntityFilter!] = null
  OR: [EntityFilter!] = null
  NOT: [EntityFilter!] = null
}

union EntityNode = UserV2 | ProjectV2 | DomainV2 | VirtualFolderNode | ImageV2 | ComputeSessionNode | Artifact | ArtifactRegistry | AppConfig | NotificationChannel | NotificationRule | ModelDeployment | ResourceGroup | ContainerRegistryV2 | ArtifactRevision | Role

"""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.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 26.1.0. A single environment variable entry with name and value.
"""
type EnvironmentVariableEntry {
  """Environment variable name (e.g., CUDA_VISIBLE_DEVICES)."""
  name: String!

  """Environment variable value."""
  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 {
  """List of environment variable entries."""
  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
}

type ExtraVFolderMount implements Node {
  """The Globally Unique ID of this object"""
  id: ID!
  mountDestination: String!
  vfolder: VirtualFolderNode!
}

"""Added in 25.16.0"""
type ExtraVFolderMountConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

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

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

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

"""Added in 25.19.0"""
input ExtraVFolderMountInput {
  vfolderId: ID!
  mountDestination: String
}

"""
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 {
  """
  Computed fair share factor ranging from 0 to 1. Higher values indicate more entitlement to resources (less historical usage relative to others). Used by the scheduler to prioritize workloads - entities with higher factors get scheduled first.
  """
  fairShareFactor: Decimal!

  """
  Sum of exponentially decayed historical usage across the lookback period. Recent usage contributes more than older usage based on the half-life decay function. This is the raw usage data before normalization.
  """
  totalDecayedUsage: ResourceSlot!

  """
  Single scalar value representing weighted resource consumption. Computed by applying resource weights to the decayed usage and summing. Used to compare usage across entities with different resource consumption patterns.
  """
  normalizedUsage: Decimal!

  """
  Start date of the lookback window used in this calculation (inclusive). Usage before this date is not considered in the fair share factor computation.
  """
  lookbackStart: Date!

  """
  End date of the lookback window used in this calculation (inclusive). Typically the current date or the date of the last calculation.
  """
  lookbackEnd: Date!

  """
  Timestamp when this fair share calculation was performed. Fair share factors are recalculated periodically by the scheduler.
  """
  lastCalculatedAt: DateTime!

  """
  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!
}

"""
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. Determines how quickly historical usage loses significance. Default is 7 days.
  """
  halfLifeDays: Int!

  """
  Total lookback period in days for usage aggregation. Only usage within this window is considered. Default is 28 days.
  """
  lookbackDays: Int!

  """
  Granularity of decay buckets in days. Usage is aggregated into buckets of this size. Default is 1 day.
  """
  decayUnitDays: Int!

  """
  Default weight for entities without explicit weight in this resource group. Default is 1.0.
  """
  defaultWeight: Decimal!

  """
  Added in 26.2.0. Weights for each resource type with default indicators. All resource types from capacity are included. Shows which resources use explicit vs default weights.
  """
  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 {
  """
  Base weight multiplier for this entity. Higher weight values result in higher scheduling priority. This is the effective weight - either the explicitly set value or the resource group's default_weight.
  """
  weight: Decimal!

  """
  Added in 26.1.0. Whether this entity uses the resource group's default_weight. True means no explicit weight was set and the default is being used. False means an explicit weight value was configured for this entity.
  """
  usesDefault: Boolean!

  """
  Half-life for exponential decay in days. Determines how quickly historical usage loses significance. For example, with half_life_days=7, usage from 7 days ago contributes half as much as today's usage.
  """
  halfLifeDays: Int!

  """
  Total lookback period in days for usage aggregation. Only usage within this window is considered. Typical values range from 7 to 30 days depending on scheduling policy.
  """
  lookbackDays: Int!

  """
  Granularity of decay buckets in days. Usage is aggregated into buckets of this size. Smaller values provide more precision but require more storage. Typically 1 day.
  """
  decayUnitDays: Int!

  """
  Added in 26.2.0. Weights for each resource type with default indicators. Shows which resources use explicit vs default weights. Allows different resources to contribute differently to the fair share calculation. For example, GPU usage might be weighted higher than CPU usage.
  """
  resourceWeights: [ResourceWeightEntry!]!
}

"""Added in 25.14.0"""
input GetPresignedDownloadURLInput {
  artifactRevisionId: ID!
  key: String!
  expiration: Int = null
}

"""Added in 25.14.0"""
type GetPresignedDownloadURLPayload {
  presignedUrl: String!
}

"""Added in 25.14.0"""
input GetPresignedUploadURLInput {
  artifactRevisionId: ID!
  key: String!
}

"""Added in 25.14.0"""
type GetPresignedUploadURLPayload {
  presignedUrl: String!
  fields: String!
}

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

"""Added in 25.14.0"""
type HuggingFaceRegistry implements Node {
  """The Globally Unique ID of this object"""
  id: ID!
  url: String!
  name: String!
  token: String
}

"""Added in 25.14.0"""
type HuggingFaceRegistryConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [HuggingFaceRegistryEdge!]!
  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: ImageV2AliasFilterGQL = 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.
"""
input ImageV2AliasFilterGQL {
  alias: StringFilter = null
  AND: [ImageV2AliasFilterGQL!] = null
  OR: [ImageV2AliasFilterGQL!] = null
  NOT: [ImageV2AliasFilterGQL!] = 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 ImageV2FilterGQL {
  status: [ImageV2Status!] = null
  name: StringFilter = null
  architecture: StringFilter = 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: [ImageV2FilterGQL!] = null
  OR: [ImageV2FilterGQL!] = null
  NOT: [ImageV2FilterGQL!] = null
}

"""
Added in 26.2.0.

Identity information for an image.
Contains the canonical name, namespace, and architecture.
"""
type ImageV2IdentityInfo {
  """Full canonical name (e.g., 'cr.backend.ai/stable/python:3.9')."""
  canonicalName: String!

  """Image namespace/path within the registry (e.g., 'stable/python')."""
  namespace: String!

  """CPU architecture (e.g., 'x86_64', 'aarch64')."""
  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 {
  """The label key (e.g., 'maintainer')."""
  key: String!

  """The label value."""
  value: String!
}

"""
Added in 26.2.0.

Metadata information for an image.
Contains tags, labels, digest, size, status, and creation timestamp.
"""
type ImageV2MetadataInfo {
  """
  Parsed tag components from the image reference (e.g., python=3.11, cuda=12.1).
  """
  tags: [ImageV2TagEntry!]!

  """Docker labels."""
  labels: [ImageV2LabelEntry!]!

  """Config digest (image hash) for verification."""
  digest: String

  """Image size in bytes."""
  sizeBytes: Int!

  """Image status (ALIVE or DELETED)."""
  status: ImageV2Status!

  """Timestamp when the image was created/registered."""
  createdAt: DateTime
}

"""
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 {
  """Resource slot limits (cpu, memory, accelerators, etc.)."""
  resourceLimits: [ImageV2ResourceLimit!]!

  """List of supported accelerator types (e.g., 'cuda', 'rocm')."""
  supportedAccelerators: [String!]!
}

"""
Added in 26.2.0.

Resource limit specification for an image.
Defines minimum and maximum values for a resource slot.
"""
type ImageV2ResourceLimit {
  """Resource slot name (e.g., 'cpu', 'mem', 'cuda.shares')."""
  key: String!

  """Minimum required amount."""
  min: String!

  """Maximum allowed amount."""
  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.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 {
  """The tag key (e.g., 'python', 'cuda')."""
  key: String!

  """The tag value (e.g., '3.11', '12.1')."""
  value: String!
}

"""
Added in 25.14.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!]!

  """Target vfolder ID to store the imported artifacts. Added in 26.1.0."""
  vfolderId: ID = null

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

"""
Added in 26.1.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 {
  artifactRevisions: ArtifactRevisionConnection!
  tasks: [ArtifactRevisionImportTask!]!
}

input IntFilter {
  equals: Int = null
  notEquals: Int = null
  greaterThan: Int = null
  greaterThanOrEqual: Int = null
  lessThan: Int = null
  lessThanOrEqual: Int = null
}

"""
Payload returned after issuing a new keypair. The secret_key is only shown once.
"""
type IssueMyKeypairPayload {
  """The newly generated access key."""
  accessKey: String!

  """
  The newly generated secret key. This value is only returned at creation time.
  """
  secretKey: String!

  """The generated SSH public key."""
  sshPublicKey: 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!

  """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.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 (e.g., PENDING, RUNNING, TERMINATED).
  Indicates the kernel's position in its lifecycle.
  """
  status: KernelV2Status!

  """The result of the kernel execution (UNDEFINED, SUCCESS, FAILURE)."""
  result: SessionV2Result!

  """Timestamp when the kernel was created."""
  createdAt: DateTime

  """Timestamp when the kernel was terminated. Null if still active."""
  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."""
  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. Null if container not yet created or hidden.
  """
  containerId: String

  """Resource allocation with requested and used slots."""
  allocation: ResourceAllocation!

  """The fractional resource shares occupied by this kernel."""
  shares: ResourceSlot!

  """Additional resource options and configurations for this kernel."""
  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 {
  in: [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 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.3.0. Key-value label entry for queries."""
input MetricLabelEntryInput {
  """Label key."""
  key: String!

  """Label value."""
  value: String!
}

type ModelDeployment implements Node {
  """The Globally Unique ID of this object"""
  id: ID!
  metadata: ModelDeploymentMetadata!
  networkAccess: ModelDeploymentNetworkAccess!
  revision: ModelRevision
  defaultDeploymentStrategy: DeploymentStrategyGQL!
  replicaState: ReplicaState!
  createdUser: UserNode!
  scalingRule: ScalingRule!

  """Added in 25.19.0. Deployment policy configuration."""
  deploymentPolicy: DeploymentPolicy
  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!
}

"""Added in 25.19.0"""
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!
}

type ModelDeploymentMetadata {
  name: String!
  status: DeploymentStatus!
  tags: [String!]!
  createdAt: DateTime!
  updatedAt: DateTime!
  project: GroupNode!
  domain: DomainNode!
}

"""Added in 25.19.0"""
input ModelDeploymentMetadataInput {
  projectId: ID!
  domainName: String!
  name: String = null
  tags: [String!] = null
}

type ModelDeploymentNetworkAccess {
  endpointUrl: String
  preferredDomainName: String
  openToPublic: Boolean!
  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"""
input ModelDeploymentNetworkAccessInput {
  preferredDomainName: String = null
  openToPublic: Boolean! = false
}

type ModelMountConfig {
  """Path inside the container where the model is mounted."""
  mountDestination: String!

  """Path to the model definition file within the mounted folder."""
  definitionPath: String!
  vfolder: VirtualFolderNode!
}

"""Added in 25.19.0"""
input ModelMountConfigInput {
  vfolderId: ID!
  mountDestination: String!
  definitionPath: String!
}

type ModelReplica implements Node {
  """The Globally Unique ID of this object"""
  id: 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 currently active and able to serve requests."""
  activenessStatus: ActivenessStatus!

  """Traffic weight for load balancing between replicas."""
  weight: Int!

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

  """
  The session ID associated with the replica. This can be null right after replica creation.
  """
  session: ComputeSessionNode!
  revision: ModelRevision!
}

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!
}

type ModelRevision implements Node {
  """The Globally Unique ID of this object"""
  id: ID!

  """The name identifier for this revision."""
  name: String!

  """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

  """Additional volume folder mounts."""
  extraMounts: ExtraVFolderMountConnection!

  """Timestamp when the revision was created."""
  createdAt: DateTime!
  image: ImageNode!
}

"""Added in 25.19.0"""
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 {
  name: StringFilter = null
  deploymentId: ID = null
  AND: [ModelRevisionFilter!] = null
  OR: [ModelRevisionFilter!] = null
  NOT: [ModelRevisionFilter!] = null
}

"""Added in 25.19.0"""
input ModelRevisionOrderBy {
  field: ModelRevisionOrderField!
  direction: OrderDirection! = DESC
}

enum ModelRevisionOrderField {
  CREATED_AT
  NAME
}

type ModelRuntimeConfig {
  """The inference runtime variant (e.g., vllm, triton)."""
  runtimeVariant: String!

  """Framework-specific configuration in JSON format."""
  inferenceRuntimeConfig: JSON

  """Environment variables for the service, e.g. CUDA_VISIBLE_DEVICES=0."""
  environ: EnvironmentVariables
}

"""Added in 25.19.0"""
input ModelRuntimeConfigInput {
  runtimeVariant: String!
  inferenceRuntimeConfig: JSON = null

  """Environment variables for the service."""
  environ: EnvironmentVariablesInput = null
}

"""
Added in 25.14.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 metric name."""
  metricName: String

  """New PromQL template."""
  queryTemplate: String

  """New default time window."""
  timeWindow: String

  """New query definition options."""
  options: QueryDefinitionOptionsInput
}

"""Added in 26.3.0. Payload returned after modifying a query definition."""
type ModifyQueryDefinitionPayload {
  preset: QueryDefinition!
}

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 25.16.0"""
  createModelDeployment(input: CreateDeploymentInput!): CreateDeploymentPayload!

  """Added in 25.16.0"""
  updateModelDeployment(input: UpdateDeploymentInput!): UpdateDeploymentPayload!

  """Added in 25.16.0"""
  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"""
  addModelRevision(input: AddRevisionInput!): AddRevisionPayload!

  """
  Added in 26.4.0.
  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!

  """Create a new notification channel (admin only)"""
  adminCreateNotificationChannel(input: CreateNotificationChannelInput!): CreateNotificationChannelPayload!

  """Update a notification channel (admin only)"""
  adminUpdateNotificationChannel(input: UpdateNotificationChannelInput!): UpdateNotificationChannelPayload!

  """Delete a notification channel (admin only)"""
  adminDeleteNotificationChannel(input: DeleteNotificationChannelInput!): DeleteNotificationChannelPayload!

  """Validate a notification channel (admin only)"""
  adminValidateNotificationChannel(input: ValidateNotificationChannelInput!): ValidateNotificationChannelPayload!

  """Create a new notification rule (admin only)"""
  adminCreateNotificationRule(input: CreateNotificationRuleInput!): CreateNotificationRulePayload!

  """Update a notification rule (admin only)"""
  adminUpdateNotificationRule(input: UpdateNotificationRuleInput!): UpdateNotificationRulePayload!

  """Delete a notification rule (admin only)"""
  adminDeleteNotificationRule(input: DeleteNotificationRuleInput!): DeleteNotificationRulePayload!

  """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!

  """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.")

  """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.")

  """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.")

  """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.")

  """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.")

  """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.")

  """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.")

  """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"""
  createObjectStorage(input: CreateObjectStorageInput!): CreateObjectStoragePayload!

  """Added in 25.14.0"""
  updateObjectStorage(input: UpdateObjectStorageInput!): UpdateObjectStoragePayload!

  """Added in 25.16.0"""
  createAutoScalingRule(input: CreateAutoScalingRuleInput!): CreateAutoScalingRulePayload!

  """Added in 25.16.0"""
  updateAutoScalingRule(input: UpdateAutoScalingRuleInput!): UpdateAutoScalingRulePayload!

  """Added in 25.16.0"""
  deleteAutoScalingRule(input: DeleteAutoScalingRuleInput!): DeleteAutoScalingRulePayload!

  """Added in 25.14.0"""
  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"""
  createHuggingfaceRegistry(input: CreateHuggingFaceRegistryInput!): CreateHuggingFaceRegistryPayload!

  """Added in 25.14.0"""
  updateHuggingfaceRegistry(input: UpdateHuggingFaceRegistryInput!): UpdateHuggingFaceRegistryPayload!

  """Added in 25.14.0"""
  deleteHuggingfaceRegistry(input: DeleteHuggingFaceRegistryInput!): DeleteHuggingFaceRegistryPayload!

  """Added in 25.14.0"""
  createReservoirRegistry(input: CreateReservoirRegistryInput!): CreateReservoirRegistryPayload!

  """Added in 25.14.0"""
  updateReservoirRegistry(input: UpdateReservoirRegistryInput!): UpdateReservoirRegistryPayload!

  """Added in 25.14.0"""
  deleteReservoirRegistry(input: DeleteReservoirRegistryInput!): DeleteReservoirRegistryPayload!

  """Added in 25.14.0"""
  getPresignedDownloadUrl(input: GetPresignedDownloadURLInput!): GetPresignedDownloadURLPayload!

  """Added in 25.14.0"""
  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"""
  createAccessToken(input: CreateAccessTokenInput!): CreateAccessTokenPayload!

  """
  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.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.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!

  """
  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!

  """
  Revoke a keypair owned by the current user. The main access key cannot be revoked — switch it first.
  """
  revokeMyKeypair(input: RevokeMyKeypairInput!): RevokeMyKeypairPayload!

  """
  Switch the main access key for the current user. The target keypair must be active and owned by the user.
  """
  switchMyMainAccessKey(input: SwitchMyMainAccessKeyInput!): SwitchMyMainAccessKeyPayload!

  """
  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.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 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!
}

"""An object with a Globally Unique ID"""
interface Node {
  """The Globally Unique ID of this object"""
  id: ID!
}

"""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!
}

"""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!
}

"""Filter for notification channels"""
input NotificationChannelFilter {
  name: StringFilter = null
  channelType: [NotificationChannelType!] = null
  enabled: Boolean = null
  AND: [NotificationChannelFilter!] = null
  OR: [NotificationChannelFilter!] = null
  NOT: [NotificationChannelFilter!] = null
}

"""Order by specification for notification channels"""
input NotificationChannelOrderBy {
  field: NotificationChannelOrderField!
  direction: OrderDirection! = ASC
}

enum NotificationChannelOrderField {
  NAME
  CREATED_AT
  UPDATED_AT
}

"""Interface for notification channel specifications"""
interface NotificationChannelSpec {
  channelType: NotificationChannelType!
}

"""
Input for notification channel configuration. Exactly one of webhook or email must be set.
"""
input NotificationChannelSpecInput @oneOf {
  webhook: WebhookSpecInput
  email: EmailSpecInput
}

"""Notification channel types"""
enum NotificationChannelType {
  WEBHOOK
  EMAIL
}

"""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!
}

"""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!
}

"""Filter for notification rules"""
input NotificationRuleFilter {
  name: StringFilter = null
  ruleType: [NotificationRuleType!] = null
  enabled: Boolean = null
  AND: [NotificationRuleFilter!] = null
  OR: [NotificationRuleFilter!] = null
  NOT: [NotificationRuleFilter!] = null
}

"""Order by specification for notification rules"""
input NotificationRuleOrderBy {
  field: NotificationRuleOrderField!
  direction: OrderDirection! = ASC
}

enum NotificationRuleOrderField {
  NAME
  CREATED_AT
  UPDATED_AT
}

"""Notification rule types"""
enum NotificationRuleType {
  SESSION_STARTED
  SESSION_TERMINATED
  ARTIFACT_DOWNLOAD_COMPLETED
  ENDPOINT_LIFECYCLE_CHANGED
}

"""
Added in 26.3.0. Display number format configuration for a resource slot type.
"""
type NumberFormat {
  """
  Whether to use binary (1024-based) prefix instead of decimal (1000-based).
  """
  binary: Boolean!

  """Number of decimal places to display."""
  roundLength: Int!
}

"""Added in 25.14.0"""
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!
  namespaces(before: String, after: String, first: Int, last: Int, limit: Int, offset: Int): StorageNamespaceConnection!
}

"""Added in 25.14.0"""
type ObjectStorageConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [ObjectStorageEdge!]!
  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.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
}

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!

  """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: UUID = null
  scopeType: RBACElementType = null
  entityType: RBACElementType = null
  AND: [PermissionFilter!] = null
  OR: [PermissionFilter!] = null
  NOT: [PermissionFilter!] = 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
}

"""Added in 26.3.0. Preemption configuration for a resource group."""
type PreemptionConfig {
  """
  Sessions with priority <= this value are eligible for preemption. Default is 5.
  """
  preemptiblePriority: Int!

  """
  Tie-breaking order for sessions with the same priority during preemption. 'oldest' preempts the oldest session first, 'newest' preempts the newest. Default is 'oldest'.
  """
  order: PreemptionOrder!

  """
  How to preempt a session when preemption is triggered. 'terminate' destroys the session, 'reschedule' queues it for rescheduling. Default is 'terminate'.
  """
  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.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 ProjectTypeV2 enum."""
  type: ProjectTypeV2!

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

"""
Added in 26.2.0. Nested filter for the domain a project belongs to. Filters projects whose domain matches all specified conditions.
"""
input ProjectDomainNestedFilter {
  """
  Filter by domain name. Supports equals, contains, startsWith, and endsWith.
  """
  name: StringFilter = null

  """Filter by domain active status."""
  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 (added in 26.2.0). PROJECT_IS_ACTIVE: Order by project active status (added in 26.2.0).
"""
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
}

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.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.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 {
  """Exact match for project type."""
  equals: ProjectTypeV2 = null

  """Match any of the provided types."""
  in: [ProjectTypeV2!] = null

  """Exclude exact type match."""
  notEquals: ProjectTypeV2 = null

  """Exclude any of the provided types."""
  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
}

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 {
  """
  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. True for active users (status=ACTIVE), False for inactive.
  """
  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 {
  """Filter by project ID (UUID). Supports equals and 'in' operations."""
  id: UUIDFilter = null

  """
  Filter by project name. Supports equals, contains, startsWith, and endsWith.
  """
  name: StringFilter = null

  """
  Filter by domain name. Supports equals, contains, startsWith, and endsWith.
  """
  domainName: StringFilter = null

  """
  Filter by project type. Supports equals, in, not_equals, and not_in operations.
  """
  type: ProjectTypeV2EnumFilter = null

  """
  Filter by active status. True for active projects, False for inactive projects.
  """
  isActive: Boolean = null

  """
  Filter by creation timestamp. Supports before, after, and between operations.
  """
  createdAt: DateTimeFilter = null

  """
  Filter by last modification timestamp. Supports before, after, and between operations.
  """
  modifiedAt: DateTimeFilter = null

  """
  Filter by nested domain conditions. Returns projects whose domain matches all specified conditions.
  """
  domain: ProjectDomainNestedFilter = null

  """
  Filter by nested user conditions. Returns projects that have at least one user matching all specified conditions.
  """
  user: ProjectUserNestedFilter = null

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

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

  """
  Negate the specified filters. Records matching these conditions will be excluded.
  """
  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 {
  """The field to order by. See ProjectV2OrderField for available options."""
  field: ProjectV2OrderField!

  """Sort direction. ASC for ascending, DESC for descending."""
  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.3.0. Input for purging a role"""
input PurgeRoleInput {
  id: UUID!
}

"""Added in 26.3.0. Payload for purge role mutation"""
type PurgeRolePayload {
  id: ID!
}

"""
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.2.0. Payload for single user permanent deletion mutation."""
type PurgeUserV2Payload {
  """Whether the purge was successful."""
  success: Boolean!
}

type Query {
  _entities(representations: [_Any!]!): [_Entity]!
  _service: _Service!

  """Added in 25.15.0"""
  agentStats: AgentStats

  """Added in 26.1.0"""
  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"""
  deployments(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.16.0"""
  deployment(id: ID!): ModelDeployment

  """Added in 25.16.0"""
  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"""
  revision(id: ID!): ModelRevision

  """Added in 25.16.0"""
  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"""
  replica(id: ID!): ModelReplica

  """List available notification rule types"""
  notificationRuleTypes: [NotificationRuleType!]

  """Added in 25.14.0"""
  objectStorage(id: ID!): ObjectStorage

  """Added in 25.14.0"""
  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"""
  huggingfaceRegistry(id: ID!): HuggingFaceRegistry

  """Added in 25.14.0"""
  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"""
  reservoirRegistry(id: ID!): ReservoirRegistry

  """Added in 25.14.0"""
  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.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!]!

  """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

  """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

  """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

  """Get a notification channel by ID (admin only)"""
  adminNotificationChannel(id: ID!): NotificationChannel

  """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

  """Get a notification rule by ID (admin only)"""
  adminNotificationRule(id: ID!): NotificationRule

  """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: ImageV2FilterGQL = 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

  """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 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.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: ImageV2AliasFilterGQL = 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.3.0. Get a single query definition by ID (admin only)."""
  adminPrometheusQueryPreset(id: ID!): QueryDefinition

  """
  Added in 26.3.0. List query definitions with filtering and pagination (admin only).
  """
  adminPrometheusQueryPresets(filter: QueryDefinitionFilter = null, orderBy: [QueryDefinitionOrderBy!] = null, before: String = null, after: String = null, first: Int = null, last: Int = null, limit: Int = null, offset: Int = null): QueryDefinitionConnection

  """
  Added in 26.3.0. Execute a query definition by ID and return the result (admin only).
  """
  adminPrometheusQueryPresetResult(id: ID!, timeRange: QueryTimeRangeInput = null, options: ExecuteQueryDefinitionOptionsInput = null, timeWindow: String = null): QueryDefinitionExecuteResult!

  """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.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 26.3.0. List valid RBAC scope-entity type combinations."""
  rbacScopeEntityCombinations: [ScopeEntityCombination!]!

  """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. List domain usage buckets within resource group scope. This API is not yet implemented.
  """
  rgDomainUsageBuckets(scope: ResourceGroupDomainScope!, 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 within resource group scope. This API is not yet implemented.
  """
  rgProjectUsageBuckets(scope: ResourceGroupProjectScope!, 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 within resource group scope. This API is not yet implemented.
  """
  rgUserUsageBuckets(scope: ResourceGroupUserScope!, 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 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: ImageV2FilterGQL = 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: ImageV2AliasFilterGQL = 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.")

  """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.")

  """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.")

  """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.")

  """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"""
  defaultArtifactRegistry(artifactType: ArtifactType!): ArtifactRegistry

  """
  Added in 25.16.0 Get configuration JSON Schemas for all inference runtimes
  """
  inferenceRuntimeConfigs: JSON!

  """Added in 25.16.0. Get JSON Schema for inference runtime configuration"""
  inferenceRuntimeConfig(name: String!): JSON!

  """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

  """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.")

  """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.")

  """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.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.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!

  """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.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

  """Combine multiple filters with AND logic."""
  AND: [QueryDefinitionFilter!] = null

  """Combine multiple filters with OR logic."""
  OR: [QueryDefinitionFilter!] = null

  """Negate the specified filters."""
  NOT: [QueryDefinitionFilter!] = null
}

"""Added in 26.3.0. Key-value label entry from Prometheus result."""
type QueryDefinitionMetricLabelEntry {
  key: String!
  value: String!
}

"""Added in 26.3.0. Single metric result from Prometheus query."""
type QueryDefinitionMetricResult {
  """Metric labels as key-value entries."""
  metric: [QueryDefinitionMetricLabelEntry!]!

  """Time-series values."""
  values: [QueryDefinitionMetricResultValue!]!
}

"""Added in 26.3.0. Single timestamp-value pair from Prometheus."""
type QueryDefinitionMetricResultValue {
  timestamp: Float!
  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. 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
  RESOURCE_PRESET
  USER_RESOURCE_POLICY
  KEYPAIR_RESOURCE_POLICY
  PROJECT_RESOURCE_POLICY
  ROLE
  AUDIT_LOG
  EVENT_LOG
  NOTIFICATION_RULE
  DEPLOYMENT_TOKEN
  DEPLOYMENT_POLICY
  DEPLOYMENT_REVISION
  ARTIFACT_REVISION
}

"""
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: UUID!
}

"""
Added in 25.14.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 {
  artifactRevision: ArtifactRevision!
}

"""Added in 25.19.0"""
input ReplicaFilter {
  status: ReplicaStatusFilter = null
  trafficStatus: TrafficStatusFilter = null
  AND: [ReplicaFilter!] = null
  OR: [ReplicaFilter!] = null
  NOT: [ReplicaFilter!] = null
}

"""Added in 25.19.0"""
input ReplicaOrderBy {
  field: ReplicaOrderField!
  direction: OrderDirection! = DESC
}

enum ReplicaOrderField {
  CREATED_AT
  ID
}

type ReplicaState {
  desiredReplicaCount: Int!
  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.19.0. This enum represents the provisioning status of a replica.
"""
enum ReplicaStatus {
  PROVISIONING
  HEALTHY
  UNHEALTHY
  DEGRADED
  TERMINATING
  TERMINATED
  FAILED_TO_START
}

"""Added in 25.19.0"""
type ReplicaStatusChangedPayload {
  replica: ModelReplica!
}

"""Added in 25.19.0"""
input ReplicaStatusFilter {
  in: [ReplicaStatus!] = null
  equals: ReplicaStatus = null
}

"""Added in 25.14.0"""
type ReservoirRegistry implements Node {
  """The Globally Unique ID of this object"""
  id: ID!
  name: String!
  endpoint: String!
  accessKey: String!
  secretKey: String!
  apiVersion: String!
  remoteArtifactRegistries: ArtifactRegistryMetaConnection!
}

"""Added in 25.14.0"""
type ReservoirRegistryConnection {
  """Pagination data for this connection"""
  pageInfo: PageInfo!

  """Contains the nodes in this connection"""
  edges: [ReservoirRegistryEdge!]!
  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 for this kernel."""
  requested: ResourceSlot!

  """
  The resource slots currently used by this kernel. May be null if not yet allocated.
  """
  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!
}

type ResourceConfig {
  """
  Added in 26.1.0. Allocated compute resources including CPU, memory, and accelerators.
  """
  resourceSlots: ResourceSlot!

  """Added in 26.1.0. Additional resource options such as shared memory."""
  resourceOpts: ResourceOpts
  resourceGroup: ScalingGroupNode!
}

"""Added in 25.19.0"""
input ResourceConfigInput {
  resourceGroup: ResourceGroupInput!

  """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 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!
}

"""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 25.19.0"""
input ResourceGroupInput {
  name: String!
}

"""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
}

"""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.2.0. Scheduler configuration for a resource group."""
type ResourceGroupSchedulerConfig {
  """
  Type of scheduler used for session scheduling (fifo, lifo, drf, fair-share).
  """
  type: SchedulerType!

  """Added in 26.3.0. 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!
}

"""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 from ALIVE, schedulable agents in this resource group.
  """
  capacity: ResourceSlot!

  """
  Currently occupied resources from active kernels (RUNNING/TERMINATING status).
  """
  used: ResourceSlot!

  """Available resources (capacity - used)."""
  free: ResourceSlot!
}

"""
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. Each entry contains a key-value pair."""
  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. Example: 'shmem'."""
  name: String!

  """The value for this resource option. Example: '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.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. Each entry contains a resource type and quantity pair. The list may include cpu, mem, and various accelerator types depending on the cluster configuration.
  """
  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. Common types include: 'cpu' (CPU cores), 'mem' (memory in bytes), 'cuda.shares' (fractional GPU), 'cuda.device' (whole GPU devices), 'rocm.device' (AMD GPU devices). Custom accelerator plugins may define additional types.
  """
  resourceType: String!

  """
  Quantity of the resource. For 'cpu': number of cores (e.g., 2.0, 0.5). For 'mem': bytes (e.g., 4294967296 for 4GB). For accelerators: device count or share fraction.
  """
  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 (e.g., 'cpu', 'mem', 'cuda.device'). Matches the resource types available in the scaling group.
  """
  resourceType: String!

  """
  Weight multiplier for this resource type in fair share calculations. Higher weight means more contribution to normalized usage.
  """
  weight: Decimal!

  """
  Whether this resource uses the resource group's default weight. True means no explicit weight was configured for this type.
  """
  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 25.15.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 {
  artifacts: [Artifact!]!
}

"""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!
}

"""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.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.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: UUID = null
  role: RoleAssignmentRoleNestedFilter = 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: [RoleSource!] = null
  status: [RoleStatus!] = 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: [RoleSource!] = null
  status: [RoleStatus!] = null
  AND: [RoleFilter!] = null
  OR: [RoleFilter!] = null
  NOT: [RoleFilter!] = 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. Role status"""
enum RoleStatus {
  ACTIVE
  INACTIVE
  DELETED
}

"""Added in 25.19.0. Configuration for rolling update strategy."""
input RollingUpdateConfigInput {
  maxSurge: Int! = 1
  maxUnavailable: Int! = 0
}

"""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!

  """The current status of the route indicating its health state."""
  status: RouteStatus!

  """
  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

  """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
  trafficStatus: [RouteTrafficStatus!] = null
  AND: [RouteFilter!] = null
  OR: [RouteFilter!] = null
  NOT: [RouteFilter!] = null
}

"""Route history record"""
type RouteHistory implements Node {
  """The Globally Unique ID of this object"""
  id: ID!
  phase: String!
  fromStatus: String
  toStatus: String
  result: SchedulingResult!
  errorCode: String
  message: String
  subSteps: [SubStepResultGQL!]!
  attempts: Int!
  createdAt: DateTime!
  updatedAt: DateTime!

  """The route ID this history record belongs to."""
  routeId: ID!

  """The deployment ID this route belongs to."""
  deploymentId: ID!
}

"""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!
}

"""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: [SchedulingResult!] = null
  errorCode: StringFilter = null
  message: StringFilter = null
  createdAt: DateTimeFilter = null
  updatedAt: DateTimeFilter = null
  AND: [RouteHistoryFilter!] = null
  OR: [RouteHistoryFilter!] = null
  NOT: [RouteHistoryFilter!] = null
}

"""Order by specification for route history"""
input RouteHistoryOrderBy {
  field: RouteHistoryOrderField!
  direction: OrderDirection! = DESC
}

enum RouteHistoryOrderField {
  CREATED_AT
  UPDATED_AT
}

"""Added in 25.19.0. Order by specification for routes."""
input RouteOrderBy {
  field: RouteOrderField!
  direction: OrderDirection! = ASC
}

enum RouteOrderField {
  CREATED_AT
  STATUS
  TRAFFIC_RATIO
}

"""Scope for route scheduling history query"""
input RouteScope {
  """Route ID to get history for"""
  routeId: UUID!
}

"""
Added in 25.19.0. Route status indicating the health and lifecycle state of a route.
"""
enum RouteStatus {
  PROVISIONING
  HEALTHY
  UNHEALTHY
  DEGRADED
  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
}

"""Input for SMTP authentication credentials"""
input SMTPAuthInput {
  username: String = null
  password: String = null
}

"""Input for SMTP server connection settings"""
input SMTPConnectionInput {
  host: String!
  port: Int!
  useTls: Boolean! = true
  timeout: Int! = 30
}

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

type ScalingRule {
  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!
}

"""
Added in 25.14.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 {
  artifactRevision: ArtifactRevisionConnection!
}

"""
Added in 25.14.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

  """Maximum number of artifacts to scan (max: 500)"""
  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 {
  artifacts: [Artifact!]!
}

"""
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 {
  statusTransition: SchedulingStatus!
  reason: String!

  """
  The session ID associated with the replica. This can be null right after replica creation.
  """
  session: ComputeSessionNode!
}

"""Scheduling result status"""
enum SchedulingResult {
  SUCCESS
  FAILURE
  STALE
  NEED_RETRY
  EXPIRED
  GIVE_UP
  SKIPPED
}

"""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 {
  scopeType: RBACElementType!
  validEntityTypes: [RBACElementType!]!
}

"""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 of this endpoint (e.g., 'main', 'health')."""
  role: String!

  """Network scope (e.g., 'public', 'private', 'internal')."""
  scope: String!

  """Hostname or IP address."""
  address: String!

  """Port number."""
  port: Int!

  """Protocol (e.g., 'grpc', 'http', 'https')."""
  protocol: String!

  """Additional metadata."""
  metadata: JSON
}

"""Added in 26.3.0. Filter for service catalog queries."""
input ServiceCatalogFilter {
  """Filter by service group name (exact match)."""
  serviceGroup: String = null

  """Filter by health status."""
  status: ServiceCatalogStatus = 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.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 (e.g., 'jupyter', 'tensorboard', 'ssh')."""
  name: String!

  """Protocol type for this service port (http, tcp, preopen, internal)."""
  protocol: ServicePortProtocol!

  """Port numbers inside the container."""
  containerPorts: [Int!]!

  """Mapped port numbers on the host. May be null if not yet assigned."""
  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!]!
}

"""Session scheduling history record"""
type SessionSchedulingHistory implements Node {
  """The Globally Unique ID of this object"""
  id: ID!
  phase: String!
  fromStatus: String
  toStatus: String
  result: SchedulingResult!
  errorCode: String
  message: String
  subSteps: [SubStepResultGQL!]!
  attempts: Int!
  createdAt: DateTime!
  updatedAt: DateTime!

  """The session ID this history record belongs to."""
  sessionId: ID!
}

"""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!
}

"""Filter for session scheduling history"""
input SessionSchedulingHistoryFilter {
  id: UUIDFilter = null
  sessionId: UUIDFilter = null
  phase: StringFilter = null
  fromStatus: [String!] = null
  toStatus: [String!] = null
  result: [SchedulingResult!] = null
  errorCode: StringFilter = null
  message: StringFilter = null
  createdAt: DateTimeFilter = null
  updatedAt: DateTimeFilter = null
  AND: [SessionSchedulingHistoryFilter!] = null
  OR: [SessionSchedulingHistoryFilter!] = null
  NOT: [SessionSchedulingHistoryFilter!] = null
}

"""Order by specification for session scheduling history"""
input SessionSchedulingHistoryOrderBy {
  field: SessionSchedulingHistoryOrderField!
  direction: OrderDirection! = DESC
}

enum SessionSchedulingHistoryOrderField {
  CREATED_AT
  UPDATED_AT
}

"""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!

  """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.3.0. The candidate resource groups considered during scheduling.
  """
  targetResourceGroups: ResourceGroupConnection

  """
  Added in 26.3.0. 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."""
  allocation: ResourceAllocation!

  """The resource group (scaling group) this session is assigned to."""
  resourceGroupName: String

  """Candidate resource group names considered during scheduling."""
  targetResourceGroupNames: [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."""
  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 {
  in: [SessionV2Status!] = null
  notIn: [SessionV2Status!] = null
}

"""Added in 26.3.0. Type of compute session."""
enum SessionV2Type {
  INTERACTIVE
  BATCH
  INFERENCE
  SYSTEM
}

"""
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: String
  url: String
}

"""
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!]!
  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!
}

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
  iContains: String = null
  iStartsWith: String = null
  iEndsWith: String = null
  iEquals: String = null
  iNotContains: String = null
  iNotStartsWith: String = null
  iNotEndsWith: String = null
  iNotEquals: String = null
}

"""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. Useful for building reactive UIs that
  show live progress of artifact 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. Useful for displaying
  progress bars and real-time import status to users.
  """
  artifactImportProgressUpdated(artifactRevisionId: ID!): ArtifactImportProgressUpdatedPayload!

  """Added in 25.16.0. Subscribe to deployment status changes"""
  deploymentStatusChanged: DeploymentStatusChangedPayload!

  """Added in 25.16.0"""
  replicaStatusChanged(revisionId: ID!): ReplicaStatusChangedPayload!

  """
  Subscribe to real-time scheduling events for a specific session. Streams status transition events during the session lifecycle (PENDING → SCHEDULED → PREPARING → RUNNING → TERMINATED). Added in 25.15.0.
  """
  schedulingEventsBySession(sessionId: ID!): SchedulingBroadcastEventPayload!

  """
  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!
}

"""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!
}

"""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"""
type SyncReplicaPayload {
  success: Boolean!
}

"""
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 {
  in: [TrafficStatus!] = null
  equals: TrafficStatus = null
}

scalar UUID

"""Added in 26.1.0. Filter for UUID fields."""
input UUIDFilter {
  equals: UUID = null
  in: [UUID!] = null
  notEquals: UUID = null
  notIn: [UUID!] = null
}

"""
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: UUID!
}

"""
Added in 25.14.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 {
  artifact: Artifact!
}

input UpdateAutoScalingRuleInput {
  id: ID!
  metricSource: AutoScalingMetricSource
  metricName: String
  minThreshold: Decimal
  maxThreshold: Decimal
  stepSize: Int
  timeWindow: Int
  minReplicas: Int
  maxReplicas: Int
}

type UpdateAutoScalingRulePayload {
  autoScalingRule: AutoScalingRule!
}

"""Added in 25.19.0"""
input UpdateDeploymentInput {
  id: ID!
  openToPublic: Boolean = null
  tags: [String!] = null
  defaultDeploymentStrategy: DeploymentStrategyInput = null
  activeRevisionId: ID = null
  desiredReplicaCount: Int = null
  name: String = null
  preferredDomainName: String = null
}

"""Added in 25.19.0"""
type UpdateDeploymentPayload {
  deployment: ModelDeployment!
}

"""
Added in 26.4.0.
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!
  rollbackOnFailure: Boolean! = false
  rollingUpdate: RollingUpdateConfigInput = null
  blueGreen: BlueGreenConfigInput = null
}

"""
Added in 26.4.0.
Result payload returned after creating or updating a deployment policy.
Contains the full deployment_policy object reflecting the applied configuration.
"""
type UpdateDeploymentPolicyPayload {
  deploymentPolicy: DeploymentPolicy!
}

"""Added in 25.14.0"""
input UpdateHuggingFaceRegistryInput {
  id: ID!
  url: String
  name: String
  token: String
}

"""Added in 25.14.0"""
type UpdateHuggingFaceRegistryPayload {
  huggingfaceRegistry: HuggingFaceRegistry!
}

"""
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!
}

"""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!
}

"""Payload returned after updating a keypair."""
type UpdateMyKeypairPayload {
  """Whether the update was successful."""
  success: Boolean!
}

"""Input for updating a notification channel"""
input UpdateNotificationChannelInput {
  id: ID!
  name: String
  description: String
  spec: NotificationChannelSpecInput
  enabled: Boolean
}

"""Payload for update notification channel mutation"""
type UpdateNotificationChannelPayload {
  channel: NotificationChannel!
}

"""Input for updating a notification rule"""
input UpdateNotificationRuleInput {
  id: ID!
  name: String
  description: String
  messageTemplate: String
  enabled: Boolean
}

"""Payload for update notification rule mutation"""
type UpdateNotificationRulePayload {
  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"""
type UpdateObjectStoragePayload {
  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 25.14.0"""
input UpdateReservoirRegistryInput {
  id: ID!
  name: String
  endpoint: String
  accessKey: String
  secretKey: String
  apiVersion: String
}

"""Added in 25.14.0"""
type UpdateReservoirRegistryPayload {
  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.3.0. Input for updating a role"""
input UpdateRoleInput {
  id: UUID!
  name: String = null
  description: String = null
  status: RoleStatus = null
}

"""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.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 {
  vfsStorage: VFSStorage!
}

"""
Added in 25.16.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 {
  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 {
  """The updated or created domain fair share record."""
  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 {
  """The updated or created project fair share record."""
  projectFairShare: ProjectFairShare!
}

"""
Added in 25.16.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 {
  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 {
  """The updated or created user fair share record."""
  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 {
  """
  Filter by domain name. Supports equals, contains, startsWith, and endsWith.
  """
  name: StringFilter = null

  """Filter by domain active status."""
  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 (added in 26.2.0). USER_EMAIL: Order alphabetically by email (added in 26.2.0).
"""
enum UserFairShareOrderField {
  FAIR_SHARE_FACTOR
  CREATED_AT
  USER_USERNAME
  USER_EMAIL
}

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
}

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

"""
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 {
  """
  Filter by project name. Supports equals, contains, startsWith, and endsWith.
  """
  name: StringFilter = null

  """Filter by project active status."""
  isActive: Boolean = null
}

"""
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 {
  """Exact match for user role."""
  equals: UserRoleV2 = null

  """Match any of the provided roles."""
  in: [UserRoleV2!] = null

  """Exclude exact role match."""
  notEquals: UserRoleV2 = null

  """Exclude any of the provided roles."""
  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 {
  """Exact match for user status."""
  equals: UserStatusV2 = null

  """Match any of the provided statuses."""
  in: [UserStatusV2!] = null

  """Exclude exact status match."""
  notEquals: UserStatusV2 = null

  """Exclude any of the provided statuses."""
  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
}

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
}

"""
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, role, creation time, and nested domain/project filters. Multiple filters can be combined using AND, OR, and NOT logical operators.
"""
input UserV2Filter {
  """Filter by user UUID. Supports equals and 'in' operations."""
  uuid: UUIDFilter = null

  """
  Filter by username. Supports equals, contains, startsWith, and endsWith.
  """
  username: StringFilter = null

  """
  Filter by email address. Supports equals, contains, startsWith, and endsWith.
  """
  email: StringFilter = null

  """
  Filter by account status. Supports equals, in, not_equals, and not_in operations.
  """
  status: UserStatusV2EnumFilter = null

  """
  Filter by domain name. Supports equals, contains, startsWith, and endsWith.
  """
  domainName: StringFilter = null

  """
  Filter by user role. Supports equals, in, not_equals, and not_in operations.
  """
  role: UserRoleV2EnumFilter = null

  """
  Filter by creation timestamp. Supports before, after, and between operations.
  """
  createdAt: DateTimeFilter = null

  """
  Filter by nested domain conditions. Returns users whose domain matches all specified conditions.
  """
  domain: UserDomainNestedFilter = null

  """
  Filter by nested project conditions. Returns users that belong to at least one project matching all specified conditions.
  """
  project: UserProjectNestedFilter = null

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

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

  """
  Negate the specified filters. Records matching these conditions will be excluded.
  """
  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 {
  """The field to order by. See UserOrderField for available options."""
  field: UserV2OrderField!

  """Sort direction. ASC for ascending, DESC for descending."""
  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 UserRoleV2 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 UserStatusV2 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!]!
  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.2.0. Storage host permission configuration. Defines what operations are allowed for a specific storage host.
"""
type VFolderHostPermissionEntry {
  """Storage host identifier (e.g., 'default', 'storage-01')."""
  host: String!

  """
  List of permissions granted for this host. See VFolderHostPermissionV2 enum for available permissions.
  """
  permissions: [VFolderHostPermissionV2!]!
}

"""
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
}

"""Input for validate notification channel mutation"""
input ValidateNotificationChannelInput {
  id: ID!
  testMessage: String!
}

"""Payload for validate notification channel mutation"""
type ValidateNotificationChannelPayload {
  id: ID!
}

"""Input for validate notification rule mutation"""
input ValidateNotificationRuleInput {
  id: ID!
  notificationData: JSON
}

"""Payload for validate notification rule mutation"""
type ValidateNotificationRulePayload {
  message: String!
}

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

"""Input for webhook configuration"""
input WebhookSpecInput {
  url: String!
}

scalar _Any

union _Entity = ComputeSessionNode | DomainNode | DomainV2 | GroupNode | ImageNode | ProjectV2 | ScalingGroupNode | UserNode | UserV2 | VirtualFolderNode

type _Service {
  sdl: String!
}