ActivateUserResponse

Union, One Of:

AddonComponent

name
AddonComponentName
required
app_name
typing_extensions.Annotated[(typing.Optional[str], Any)]
namespace
typing.Optional[str]
application_id
typing_extensions.Annotated[(typing.Optional[str], Any)]
description
typing.Optional[str]
path
typing.Optional[str]
addon_folder
typing_extensions.Annotated[(typing.Optional[str], Any)]
installed
typing.Optional[bool]
status
typing.Optional[AddonComponentStatus]
version
typing.Optional[str]
manifest
typing.Optional[typing.Dict[(str, typing.Optional[typing.Any])]]
installation_source
typing_extensions.Annotated[(typing.Optional[str], Any)]
unsupported_cluster_types
typing_extensions.Annotated[(typing.Optional[typing.List[ClusterType]], Any)]
required
typing.Optional[bool]
known_cr_ds
typing_extensions.Annotated[(typing.Optional[typing.List[str]], Any)]
source
typing.Optional[AddOnComponentSource]
upgrades
typing.Optional[UpgradeData]
labels
typing.Optional[typing.List[str]]
recommendations
typing.Optional[typing.List[Recommendation]]
workspace_id
typing_extensions.Annotated[(typing.Optional[str], Any)]

AddOnComponentSource

repo_url
str
required
Repository URL of the source
chart
str
required
Chart of the source

AddonComponentStatus

health_status
typing_extensions.Annotated[(typing.Optional[str], Any)]
Health status of the addon
sync_status
typing_extensions.Annotated[(typing.Optional[str], Any)]
Sync status of the addon
installed
bool
required
Indicates whether the addon is installed

Ai21KeyAuth

type
typing.Literal[Any]
default:"api-key"
required
api_key
str
required
API key must not be empty

Ai21Model

type
typing.Literal[Any]
default:"integration/model/ai21"
required
name
str
required
2 to 62 characters long alphanumeric word, may contain - in between, cannot start with a number
model_id
str
required
Model ID must not be empty
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeSpecify the type of the AI21 model
cost
typing.Optional[ModelCostMetric]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

Ai21ProviderAccount

type
typing.Literal[Any]
default:"provider-account/ai21"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
auth_data
Ai21KeyAuth
required
integrations
typing.Optional[typing.List[Ai21Integrations]]
List of integrations that are associated with the AI21 provider account
collaborators
typing.Optional[typing.List[Collaborator]]
πŸ”— CollaboratorList of users who have access to this provider account

AiFeaturesSettings

type
typing.Literal[Any]
default:"settings/ai-features"
required
enabled
bool
required
Enable/Disable AI features. Other fields only apply when this is true
ai_provider
typing.Literal[Any]
default:"truefoundry"
required
AI provider to use for AI features When TrueFoundry is selected, TrueFoundry will manage and provide the AI models for the features.

Alert

id
typing.Optional[str]
name
str
required
timestamps
typing.List[dt.datetime]
required
start_time
typing_extensions.Annotated[(dt.datetime, Any)]
required
resolved_time
typing_extensions.Annotated[(typing.Optional[dt.datetime], Any)]
application_id
typing_extensions.Annotated[(typing.Optional[str], Any)]
cluster_id
typing_extensions.Annotated[(str, Any)]
required
tenant_name
typing_extensions.Annotated[(typing.Optional[str], Any)]
fingerprint
str
required
updated_at
typing_extensions.Annotated[(typing.Optional[str], Any)]
created_at
typing_extensions.Annotated[(typing.Optional[str], Any)]
application_debug_info_id
typing_extensions.Annotated[(typing.Optional[str], Any)]

AlertConfig

type
typing.Literal[Any]
default:"alert-config"
required
name
str
required
3 to 35 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
resource
AlertConfigResource
required
notification_targets
typing.List[NotificationTargetForAlertRule]
required
πŸ”— NotificationTargetForAlertRuleConfigure one or more notification targets where alerts will be sent. Each target specifies a notification channel (email or slack).
rules
typing.List[PrometheusAlertRule]
required
πŸ”— PrometheusAlertRuleDefine one or more alert rules that specify the conditions to monitor, when to trigger alerts, and how they should be handled.

AlertConfigResource

type
AlertConfigResourceType
required
πŸ”— AlertConfigResourceTypeThe type of resource this alert config belongs to. Can be either an application or a cluster.
fqn
str
required
FQN of the resource this alert config belongs to.

AmqpInputConfig

type
typing.Literal[Any]
default:"amqp"
required
url
str
required
AMQP Queue URL of Subscriber
queue_name
str
required
AMQP Queue Name
wait_time_seconds
int
default:"5"
required
Wait timeout for long polling.

AmqpMetricConfig

type
typing.Literal[Any]
default:"amqp"
required
queue_length
int
required
Upper limit of the number of backlog messages the auto-scaler will try to maintain per replica. If you set this number to 10 and have 30 messages in the stream and one replica, the auto-scaler will scale the number of replicas to 3.

AmqpOutputConfig

type
typing.Literal[Any]
default:"amqp"
required
url
str
required
AMQP Queue URL of Publisher
routing_key
str
required
AMQP Routing Key to publish to.
exchange_name
typing.Optional[str]
AMQP Exchange Name

AnthropicKeyAuth

type
typing.Literal[Any]
default:"api-key"
required
api_key
str
required
API key must not be empty

AnthropicModel

name
str
required
2 to 62 characters long alphanumeric word, may contain - in between, cannot start with a number
model_id
str
required
Model ID must not be empty
type
typing.Literal[Any]
default:"integration/model/anthropic"
required
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeSpecify the type of the Anthropic model
cost
typing.Optional[ModelCostMetric]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

AnthropicProviderAccount

type
typing.Literal[Any]
default:"provider-account/anthropic"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
auth_data
AnthropicKeyAuth
required
integrations
typing.Optional[typing.List[AnthropicIntegrations]]
List of integrations that are associated with the Anthropic provider account
collaborators
typing.Optional[typing.List[Collaborator]]
πŸ”— CollaboratorList of users who have access to this provider account

Application

id
typing.Optional[str]
fqn
typing.Optional[str]
name
typing.Optional[str]
type
typing.Optional[ApplicationType]
created_by_subject
typing_extensions.Annotated[(Subject, Any)]
required
tenant_name
typing_extensions.Annotated[(typing.Optional[str], Any)]
metadata
typing.Optional[ApplicationMetadata]
lifecycle_stage
typing_extensions.Annotated[(ApplicationLifecycleStage, Any)]
required
workspace_id
typing_extensions.Annotated[(typing.Optional[str], Any)]
last_version
typing_extensions.Annotated[(typing.Optional[int], Any)]
active_version
typing_extensions.Annotated[(typing.Optional[int], Any)]
created_at
typing_extensions.Annotated[(typing.Optional[dt.datetime], Any)]
updated_at
typing_extensions.Annotated[(typing.Optional[dt.datetime], Any)]
recommendations
typing.Optional[typing.List[Recommendation]]
πŸ”— RecommendationRecommendations for this application
alerts
typing.Optional[typing.List[Alert]]
πŸ”— AlertAlerts for this application
alerts_summary
typing_extensions.Annotated[(typing.Optional[typing.Dict[(str, typing.Optional[typing.Any])]], Any)]
Summary of alerts for this application
application_debug_infos
typing_extensions.Annotated[(typing.Optional[typing.List[Any]], Any)]
Debug infos for this application
potential_problems
typing_extensions.Annotated[(typing.Optional[typing.List[ApplicationProblem]], Any)]
πŸ”— ApplicationProblemPotential problems with the application
autopilot
typing.Dict[(str, typing.Optional[typing.Any])]
workspace_fqn
typing_extensions.Annotated[(typing.Optional[str], Any)]
created_by
typing_extensions.Annotated[(typing.Optional[str], Any)]
deployment
typing.Optional[Any]
active_deployment_id
typing_extensions.Annotated[(typing.Optional[str], Any)]
last_deployment_id
typing_extensions.Annotated[(typing.Optional[str], Any)]

ApplicationDebugInfo

id
typing.Optional[str]
application_id
typing_extensions.Annotated[(str, Any)]
required
application
typing.Optional[Any]
debug_info
typing_extensions.Annotated[(typing.Dict[(str, typing.Optional[typing.Any])], Any)]
created_at
typing_extensions.Annotated[(typing.Optional[dt.datetime], Any)]
updated_at
typing_extensions.Annotated[(typing.Optional[dt.datetime], Any)]

ApplicationMetadata

paused
typing.Optional[bool]

ApplicationProblem

name
str
required
description
str
required

ApplicationsCancelDeploymentResponse

message
typing.Optional[str]
Deployment cancelled

ApplicationSet

type
typing.Literal[Any]
default:"application-set"
required
name
str
required
Name of the application set.
components
typing.Optional[typing.List[ApplicationSetComponentsItem]]
πŸ”— ApplicationSetComponentsItemArray of components with their specifications.
template
typing.Optional[str]
Template to be used for the application set.
values
typing.Optional[typing.Dict[(str, typing.Optional[typing.Any])]]
Values to be used to render components for the application set.
workspace_fqn
typing.Optional[str]
convert_template_manifest
typing.Optional[bool]

ApplicationSetComponentsItem

Union, One Of:

ApplyMlEntityResponse

data
ApplyMlEntityResponseData
required

ApplyMlEntityResponseData

Union, One Of:

Artifact

id
str
required
ml_repo_id
str
required
type
ArtifactType
required
name
str
required
fqn
str
required
created_by_subject
Subject
required
created_at
typing.Optional[dt.datetime]
updated_at
typing.Optional[dt.datetime]
latest_version
typing.Optional[BaseArtifactVersion]
run_steps
typing.Optional[typing.List[int]]

ArtifactManifest

name
str
required
Name of the entity
description
typing.Optional[str]
metadata
typing.Dict[(str, typing.Optional[typing.Any])]
Key value metadata. Should be valid JSON. For e.g. \{"business-unit": "sales", "quality": "good", "rating": 4.5\}
version_alias
typing.Optional[str]
Version alias is alternate, ideally human readable, version string to reference an artifact version. It should start with v followed by alphanumeric and it can include . and - in between (e.g. v1.0.0, v1-prod, v3-dev, etc)
ml_repo
str
required
Name of the ML Repo
version
typing.Optional[int]
Version of the entity
type
typing.Literal[Any]
default:"artifact-version"
required
source
ArtifactManifestSource
required
step
typing.Optional[int]
Step/Epoch number in an iterative training loop the artifact version was created. Generally useful when logging a model version from a MLRepo Run
run_id
typing.Optional[str]
ID of the MLRepo Run that generated the artifact version

ArtifactManifestSource

Union, One Of:

ArtifactPath

src
str
required
Local file or folder path
dest
typing.Optional[str]
Relative path where the file or folder will be uploaded to in the artifact

ArtifactsCacheVolume

storage_class
str
required
Storage class of the Volume where artifacts will be cached
cache_size
int
default:"200"
required
Size of the Volume (in GB) where artifacts will be cached. Should be greater than twice the size of artifacts getting cached

ArtifactsDownload

cache_volume
typing.Optional[ArtifactsCacheVolume]
artifacts
typing.List[ArtifactsDownloadArtifactsItem]
required
πŸ”— ArtifactsDownloadArtifactsItemList of artifacts to be cached

ArtifactsDownloadArtifactsItem

Union, One Of:

ArtifactVersion

id
str
required
fqn
str
required
created_by_subject
Subject
required
created_at
typing.Optional[dt.datetime]
updated_at
typing.Optional[dt.datetime]
manifest
ArtifactManifest
required
usage_code_snippet
typing.Optional[str]
ml_repo_id
str
required
artifact_id
str
required

AssistantMessage

role
typing.Literal[Any]
default:"assistant"
required
Role of the message
content
typing.Optional[AssistantMessageContent]
πŸ”— AssistantMessageContentText content for the assistant message
tool_calls
typing.Optional[typing.List[ToolCall]]
πŸ”— ToolCallList of tool calls made by the assistant
name
typing.Optional[str]
Name of the assistant this message is from

AssistantMessageContent

Union, One Of:

AssistantMessageContentItem

Union, One Of:

AsyncProcessorSidecar

destination_url
str
required
URL for the processor to invoke
request_timeout
typing.Optional[int]
default:"10"
Timeout for the invoke request in seconds
sidecar_image
typing.Optional[str]
Image for the processor sidecar (This field will be deprecated in the future)

AsyncService

type
typing.Optional[typing.Literal[Any]]
replicas
typing.Optional[AsyncServiceReplicas]
πŸ”— AsyncServiceReplicasDeploy multiple instances of your pods to distribute incoming traffic across them, ensuring effective load balancing.
rollout_strategy
typing.Optional[Rolling]
worker_config
typing.Optional[WorkerConfig]
sidecar
typing.Optional[AsyncProcessorSidecar]

AsyncServiceAutoscaling

metrics
typing.Optional[AsyncServiceAutoscalingMetrics]
πŸ”— AsyncServiceAutoscalingMetricsMetrics to use for the autoscaler

AsyncServiceAutoscalingMetrics

Union, One Of:

AsyncServiceReplicas

Union, One Of:

Autoshutdown

wait_time
int
default:"900"
required
The period to wait after the last received request before scaling the replicas to 0. This value should be high enough to allow for the replicas of the service to come up to avoid premature scaling down.

AwsAccessKeyAuth

aws_access_key_id
str
required
AWS Access Key ID
aws_secret_access_key
str
required
AWS Secret Access Key for the user to authenticate with
aws_session_token
typing.Optional[str]
AWS Session Token, only required when using temporary credentials

AwsAccessKeyBasedAuth

type
typing.Literal[Any]
default:"access-key-based"
required
access_key_id
str
required
AWS access key ID that you want to use for authentication.
secret_access_key
str
required
AWS access key secret that you want to use for authentication.

AwsAssumedRoleBasedAuth

type
typing.Literal[Any]
default:"assumed-role-based"
required
assumed_role_arn
str
required
ARN of the role you want to assume.

AwsBedrockGuardrailConfig

name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
type
typing.Literal[Any]
default:"integration/guardrail-config/aws-bedrock"
required
operation
AwsBedrockGuardrailConfigOperation
required
πŸ”— AwsBedrockGuardrailConfigOperationThe operation type to use for the Guardrail. Validate guardrails are used to validate requests and mutate can validate as well as mutate requests. Validate guardrails are run in parallel while mutate guardrails are run sequentially.
auth_data
typing.Optional[AwsBedrockGuardrailConfigAuthData]
πŸ”— AwsBedrockGuardrailConfigAuthDataAuthentication data for the AWS account
guardrail_id
str
required
The ID of the Guardrail to use.
guardrail_version
str
required
The version of the Guardrail to use.
region
AwsRegion
required

AwsBedrockGuardrailConfigAuthData

Union, One Of:

AwsBedrockProviderAccount

type
typing.Literal[Any]
default:"provider-account/aws-bedrock"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
region
AwsRegion
required
auth_data
typing.Optional[AwsBedrockProviderAccountAuthData]
πŸ”— AwsBedrockProviderAccountAuthDataAuthentication data for the AWS account
integrations
typing.List[BedrockModelV2]
required
πŸ”— BedrockModelV2List of integrations that are associated with the AWS Bedrock provider account
collaborators
typing.Optional[typing.List[Collaborator]]
πŸ”— CollaboratorList of users who have access to this provider account

AwsBedrockProviderAccountAuthData

Union, One Of:

AwsEcr

type
typing.Literal[Any]
default:"integration/docker-registry/aws/ecr"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
registry_url
str
required
The URL of the registry.
auth_data
typing.Optional[AwsEcrAuthData]
πŸ”— AwsEcrAuthDataCustom authentication data for the integration.
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

AwsEcrAuthData

Union, One Of:

AwsEksIntegration

type
typing.Literal[Any]
default:"integration/cluster/aws/eks"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
region
AwsRegion
required
cluster_name
str
required
Name of the cluster given in the cloud account.
auth_data
typing.Optional[AwsEksIntegrationAuthData]
πŸ”— AwsEksIntegrationAuthDataCustom authentication data for the integration.
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

AwsEksIntegrationAuthData

Union, One Of:

AwsInferentia

type
typing.Literal[Any]
default:"aws_inferentia"
required
name
typing.Optional[str]
Name of the AWS Inferentia Accccelerator. One of [INF1, INF2]. This field is required for Node Selector and can be ignored in Nodepool Selector.
count
int
required
Count of Inferentia accelerator chips to provide to the application

AwsIntegrations

Union, One Of:

AwsParameterStore

type
typing.Literal[Any]
default:"integration/secret-store/aws/parameter-store"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
region
AwsRegion
required
auth_data
typing.Optional[AwsParameterStoreAuthData]
πŸ”— AwsParameterStoreAuthDataCustom authentication data for the integration.
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

AwsParameterStoreAuthData

Union, One Of:

AwsProviderAccount

type
typing.Literal[Any]
default:"provider-account/aws"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
aws_account_id
str
required
The AWS account ID.
auth_data
typing.Optional[AwsProviderAccountAuthData]
πŸ”— AwsProviderAccountAuthDataAuthentication data for the AWS account.
integrations
typing.List[AwsIntegrations]
required
πŸ”— AwsIntegrationsList of integrations that are associated with the AWS provider account.

AwsProviderAccountAuthData

Union, One Of:

AwsS3

type
typing.Literal[Any]
default:"integration/blob-storage/aws/s3"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
storage_root
str
required
The root path of the storage.
region
AwsRegion
required
auth_data
typing.Optional[AwsS3AuthData]
πŸ”— AwsS3AuthDataCustom authentication data for the integration.
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

AwsS3AuthData

Union, One Of:

AwsSecretsManager

type
typing.Literal[Any]
default:"integration/secret-store/aws/secrets-manager"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
region
AwsRegion
required
auth_data
typing.Optional[AwsSecretsManagerAuthData]
πŸ”— AwsSecretsManagerAuthDataCustom authentication data for the integration.
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

AwsSecretsManagerAuthData

Union, One Of:

AzureAiInferenceModel

name
str
required
2 to 62 characters long alphanumeric word, may contain - in between, cannot start with a number
type
typing.Literal[Any]
default:"integration/model/azure/ai-inference"
required
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeTypes of models supported by this Azure AI deployment
auth_data
typing.Optional[AzureKeyAuth]
deployment_details
typing_extensions.Annotated[(AzureAiInferenceModelDeploymentDetails, Any)]
required
πŸ”— AzureAiInferenceModelDeploymentDetailsConfiguration details for the Azure AI deployment
cost
typing.Optional[ModelCostMetric]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

AzureAiInferenceModelDeploymentDetails

Union, One Of:

AzureAiManagedDeployment

type
typing.Literal[Any]
default:"managed"
required
deployment_name
typing_extensions.Annotated[(str, Any)]
required
Name of the Azure AI deployment
endpoint_name
typing_extensions.Annotated[(str, Any)]
required
Name of the Azure AI endpoint

AzureAiServerlessDeployment

type
typing.Literal[Any]
default:"serverless"
required
deployment_name
typing_extensions.Annotated[(str, Any)]
required
Name of the Azure AI deployment
region
str
required
Region where the Azure AI deployment is located

AzureAksIntegration

type
typing.Literal[Any]
default:"integration/cluster/azure/aks"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
resource_group
str
required
The resource group of the cluster in the cloud account.
cluster_name
str
required
Name of the cluster given in the cloud account.
auth_data
typing.Optional[AzureOAuth]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

AzureBasicAuth

type
typing.Literal[Any]
default:"basic-auth"
required
username
str
required
The username for the Azure managed identity.
password
str
required
The password for the Azure managed identity.

AzureBlobStorage

type
typing.Literal[Any]
default:"integration/blob-storage/azure/blob"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
storage_root
str
required
The root path of the storage.
auth_data
typing.Optional[AzureConnectionStringAuth]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

AzureConnectionStringAuth

type
typing.Literal[Any]
default:"connection-string"
required
connection_string
str
required
The connection string for the Azure managed identity.

AzureContainerRegistry

type
typing.Literal[Any]
default:"integration/docker-registry/azure/acr"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
registry_url
str
required
The URL of the registry.
auth_data
typing.Optional[AzureBasicAuth]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

AzureContentSafetyGuardrailConfig

name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
type
typing.Literal[Any]
required
resource_name
str
required
The resource name where API is deployed.
api_version
str
default:"2024-09-01"
required
API version for the Content Safety API
custom_host
typing.Optional[str]
Custom host for the PII detection API
blocklist_names
typing.Optional[typing.List[str]]
Array of blocklist names to check against
severity_threshold
float
default:"2.0"
required
Severity threshold for the Content Safety API
categories
typing.List[AzureContentSafetyCategory]
required
πŸ”— AzureContentSafetyCategoryCategories to check against
auth_data
AzureKeyAuth
required

AzureFoundryModel

type
typing.Literal[Any]
default:"integration/model/azure/ai-foundry"
required
name
str
required
2 to 62 characters long alphanumeric word, may contain - in between, cannot start with a number
model_id
str
required
This is the Model Name on Azure
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeTypes of models supported by this Azure AI Foundry deployment
azure_endpoint
str
required
Azure Foundry endpoint
auth_data
typing.Optional[AzureKeyAuth]
cost
typing.Optional[ModelCostMetric]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

AzureFoundryModelV2

type
typing.Literal[Any]
default:"integration/model/azure-foundry"
required
name
str
required
2 to 62 characters long alphanumeric word, may contain - in between, cannot start with a number
auth_data
AzureKeyAuth
required
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeTypes of models supported by this Azure AI Foundry deployment
model_id
str
required
The name of the Azure Foundry deployment
azure_endpoint
str
required
Endpoint URL must not be empty
api_version
str
required
The API version for the Azure Foundry model
cost
typing.Optional[ModelCostMetric]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

AzureFoundryProviderAccount

type
typing.Literal[Any]
default:"provider-account/azure-foundry"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
integrations
typing.List[AzureFoundryModelV2]
required
πŸ”— AzureFoundryModelV2List of integrations that are associated with the Azure Foundry provider account
collaborators
typing.Optional[typing.List[Collaborator]]
πŸ”— CollaboratorList of users who have access to this provider account

AzureIntegrations

Union, One Of:

AzureKeyAuth

type
typing.Literal[Any]
default:"api-key"
required
api_key
str
required
API key must not be empty

AzureOAuth

type
typing.Literal[Any]
default:"oauth"
required
tenant_id
str
required
The Azure Active Directory tenant (directory) ID.
client_id
str
required
The client (application) ID of an App Registration in the tenant.
client_secret
str
required
A client secret that was generated for the App Registration.
subscription_id
str
required
The ID of the target subscription. The value must be an UUID.

AzureOpenAiModel

name
str
required
2 to 62 characters long alphanumeric word, may contain - in between, cannot start with a number
model_id
str
required
This is the name of the deployment
type
typing.Literal[Any]
default:"integration/model/azure"
required
auth_data
AzureKeyAuth
required
azure_endpoint
str
required
Azure OpenAI Service endpoint
api_version
str
required
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeSpecify the type of the model
cost
typing.Optional[ModelCostMetric]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

AzureOpenAiModelV2

type
typing.Literal[Any]
default:"integration/model/azure-openai"
required
name
str
required
2 to 62 characters long alphanumeric word, may contain - in between, cannot start with a number
model_id
str
required
Model ID must not be empty
api_version
str
required
API version must not be empty
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeSpecify the type of the Azure OpenAI model
cost
typing.Optional[ModelCostMetric]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

AzureOpenAiProviderAccount

type
typing.Literal[Any]
default:"provider-account/azure-openai"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
azure_endpoint
str
required
Endpoint URL must not be empty
auth_data
AzureKeyAuth
required
integrations
typing.List[AzureOpenAiModelV2]
required
πŸ”— AzureOpenAiModelV2List of integrations that are associated with the Azure OpenAI provider account
collaborators
typing.Optional[typing.List[Collaborator]]
πŸ”— CollaboratorList of users who have access to this provider account

AzurePiiGuardrailConfig

name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
type
typing.Literal[Any]
default:"integration/guardrail-config/azure-pii"
required
resource_name
str
required
The resource name where API is deployed.
api_version
str
default:"2024-11-01"
required
API version for the Content Safety API
custom_host
typing.Optional[str]
Custom host for the PII detection API
domain
AzurePiiGuardrailConfigDomain
required
pii_categories
typing.List[AzurePiiCategory]
required
πŸ”— AzurePiiCategoryCategories of PII to detect.
model_version
str
default:"latest"
required
Version of the PII detection model to use
language
str
default:"en"
required
Language code for PII detection
auth_data
AzureKeyAuth
required

AzureProviderAccount

type
typing.Literal[Any]
default:"provider-account/azure"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
subscription_id
typing.Optional[str]
The ID of the target subscription. The value must be an UUID.
integrations
typing.List[AzureIntegrations]
required
πŸ”— AzureIntegrationsList of integrations that are associated with the Azure provider account.

AzureReposIntegration

type
typing.Literal[Any]
default:"integration/vcs/azure"
required
name
str
required
account_name
str
required
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

AzureVault

type
typing.Literal[Any]
default:"integration/secret-store/azure/vault"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
auth_data
typing.Optional[AzureOAuth]
key_vault_name
str
required
Name of key vault name.
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

BaseArtifactVersion

id
str
required
fqn
str
required
created_by_subject
Subject
required
created_at
typing.Optional[dt.datetime]
updated_at
typing.Optional[dt.datetime]
manifest
typing.Optional[BaseArtifactVersionManifest]
usage_code_snippet
typing.Optional[str]
ml_repo_id
str
required

BaseArtifactVersionManifest

Union, One Of:

BaseAutoscaling

min_replicas
int
default:"1"
required
Minimum number of replicas to keep available
max_replicas
int
required
Maximum number of replicas allowed for the component.
polling_interval
typing.Optional[int]
default:"30"
This is the interval to check each trigger on.

BaseOAuth2Login

client_id
str
required
client ID for OAuth2.
client_secret
typing.Optional[str]
Client secret or the TrueFoundry secret containing the client secret for OAuth2.
authorization_url
str
required
URL for the authorization request
token_url
str
required
The endpoint to exchange auth code for tokens.
scopes
typing.List[str]
required
List of scopes to request from the OAuth2 provider.
jwt_source
BaseOAuth2LoginJwtSource
required
πŸ”— BaseOAuth2LoginJwtSourceSource of the JWT token to be used for verification.

BaseOAuth2McpServerLogin

client_id
str
required
client ID for OAuth2 or the TrueFoundry secret FQN containing the client ID.
client_secret
typing.Optional[str]
Client secret or the TrueFoundry secret FQN containing the client secret for OAuth2.
authorization_url
str
required
URL for the authorization request
token_url
str
required
The endpoint to exchange auth code for tokens.
scopes
typing.List[str]
required
List of scopes to request from the OAuth2 provider.
jwt_source
BaseOAuth2McpServerLoginJwtSource
required
πŸ”— BaseOAuth2McpServerLoginJwtSourceSource of the JWT token to be used for verification.

BaseService

name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
image
BaseServiceImage
required
artifacts_download
typing.Optional[ArtifactsDownload]
resources
typing.Optional[Resources]
env
typing.Optional[typing.Dict[(str, typing.Optional[str])]]
Configure environment variables to be injected in the service either as plain text or secrets. Docs
ports
typing.List[Port]
required
πŸ”— PortExpose the deployment to make it accessible over the internet or keep it private. Implement authentication to restrict access. Docs
service_account
typing.Optional[str]
mounts
typing.Optional[typing.List[BaseServiceMountsItem]]
πŸ”— BaseServiceMountsItemConfigure data to be mounted to service pod(s) as a string, secret or volume. Docs
labels
typing.Optional[typing.Dict[(str, str)]]
kustomize
typing.Optional[Kustomize]
liveness_probe
typing.Optional[HealthProbe]
readiness_probe
typing.Optional[HealthProbe]
startup_probe
typing.Optional[HealthProbe]
workspace_fqn
typing.Optional[str]

BaseServiceImage

Union, One Of:

BaseServiceMountsItem

Union, One Of:

BaseWorkbenchInput

name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
home_directory_size
int
default:"20"
required
Size of the home directory for the workbench (Persistent Storage)
resources
typing.Optional[Resources]
env
typing.Optional[typing.Dict[(str, typing.Optional[str])]]
Configure environment variables to be injected in the service either as plain text or secrets. Docs
mounts
typing.Optional[typing.List[BaseWorkbenchInputMountsItem]]
πŸ”— BaseWorkbenchInputMountsItemConfigure data to be mounted to workbench pod(s) as a string, secret or volume. Docs
service_account
typing.Optional[str]
kustomize
typing.Optional[Kustomize]
workspace_fqn
typing.Optional[str]

BaseWorkbenchInputMountsItem

Union, One Of:

BasicAuthCreds

type
typing.Literal[Any]
default:"basic_auth"
required
username
str
required
Username for the user to authenticate with
password
str
required
Password for the user to authenticate with

BedrockKeyAuth

type
typing.Literal[Any]
default:"api-key"
required
access_key
str
required
access_key_secret
str
required

BedrockModel

name
str
required
2 to 62 characters long alphanumeric word, may contain - in between, cannot start with a number
model_id
str
required
type
typing.Literal[Any]
default:"integration/model/aws"
required
auth_data
typing.Optional[BedrockModelAuthData]
region
AwsRegion
required
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeSpecify the type of the model
cost
typing.Optional[ModelCostMetric]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

BedrockModelAuthData

Union, One Of:

BedrockModelV2

name
str
required
2 to 62 characters long alphanumeric word, may contain - in between, cannot start with a number
model_id
str
required
Model ID must not be empty
type
typing.Literal[Any]
default:"integration/model/bedrock"
required
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeSpecify the type of the Bedrock model
region
typing.Optional[AwsRegion]
cost
typing.Optional[ModelCostMetric]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

BitbucketIntegration

type
typing.Literal[Any]
default:"integration/vcs/bitbucket"
required
name
str
required
account_name
str
required
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

BitbucketProviderAccount

type
typing.Literal[Any]
default:"provider-account/bitbucket"
required
name
str
required
integrations
typing.List[BitbucketIntegration]
required

BlobStorageReference

type
typing.Literal[Any]
default:"blob-storage"
required
path
str
required
Path to the content in blob storage
mime_type
MimeType
required
πŸ”— MimeTypeMIME type of the content

BlueGreen

type
typing.Literal[Any]
default:"blue_green"
required
enable_auto_promotion
typing.Optional[bool]
auto_promotion_seconds
typing.Optional[int]
default:"30"

BudgetConfig

name
str
required
Name of the budget configuration
type
typing.Literal[Any]
default:"gateway-budget-config"
required
rules
typing.List[BudgetRule]
required
πŸ”— BudgetRuleList of budget rules

BudgetRule

id
str
required
Unique identifier for the rule
when
BudgetWhen
required
limit_to
float
required
Numeric limit value for the budget
unit
BudgetLimitUnit
required

BudgetWhen

subjects
typing.Optional[typing.List[str]]
List of subjects that this rule applies to
models
typing.Optional[typing.List[str]]
List of models that this rule applies to
metadata
typing.Optional[typing.Dict[(str, str)]]
Metadata key-value pairs that this rule applies to

Build

type
typing.Literal[Any]
default:"build"
required
docker_registry
typing.Optional[str]
FQN of the container registry. If you can’t find your registry here, add it through the Integrations page
build_source
BuildBuildSource
required
build_spec
BuildBuildSpec
required

BuildBuildSource

Union, One Of:

BuildBuildSpec

Union, One Of:

BuildInfo

name
str
required
status
float
required
Status of the build: STARTED = 20, SUCCEEDED = 30, FAILED = 40

Canary

type
typing.Literal[Any]
default:"canary"
required
steps
typing.List[CanaryStep]
required

CanaryStep

weight_percentage
int
required
The rest will continue to go to the existing deployment
pause_duration
typing.Optional[int]
default:"30"
If this is not set, the step will pause indefinitely on this step

ChangePasswordResponse

Union, One Of:

ChatPromptManifest

name
str
required
Name of the entity
description
typing.Optional[str]
metadata
typing.Dict[(str, typing.Optional[typing.Any])]
Key value metadata. Should be valid JSON. For e.g. \{"business-unit": "sales", "quality": "good", "rating": 4.5\}
version_alias
typing.Optional[str]
Version alias is alternate, ideally human readable, version string to reference an artifact version. It should start with v followed by alphanumeric and it can include . and - in between (e.g. v1.0.0, v1-prod, v3-dev, etc)
ml_repo
str
required
Name of the ML Repo
version
typing.Optional[int]
Version of the entity
type
typing.Literal[Any]
default:"chat_prompt"
required
messages
typing.List[ChatPromptManifestMessagesItem]
required
πŸ”— ChatPromptManifestMessagesItemList of messages in the chat conversation, must be non-empty
variables
typing.Optional[typing.Dict[(str, str)]]
Variables referenced in messages and that can be replaced when running generation
model_configuration
typing.Optional[ModelConfiguration]
tools
typing.Optional[typing.List[ToolSchema]]
πŸ”— ToolSchemaList of tools to be used in the chat prompt
mcp_servers
typing.Optional[typing.List[ChatPromptManifestMcpServersItem]]
πŸ”— ChatPromptManifestMcpServersItemA list of MCP servers FQNs or URLs and their tools
guardrails
typing.Optional[Guardrails]

ChatPromptManifestMcpServersItem

Union, One Of:

ChatPromptManifestMessagesItem

Union, One Of:

Cluster

id
str
required
fqn
str
required
name
str
required
manifest
ClusterManifest
required
tenant_name
typing_extensions.Annotated[(str, Any)]
required
created_by_subject
typing_extensions.Annotated[(typing.Optional[Subject], Any)]
created_at
typing_extensions.Annotated[(dt.datetime, Any)]
required
updated_at
typing_extensions.Annotated[(dt.datetime, Any)]
required
created_by
typing_extensions.Annotated[(typing.Optional[str], Any)]

ClusterGateway

uid
typing.Optional[str]
name
str
required
hosts
typing.List[str]
required
is_tie_breaker
typing_extensions.Annotated[(typing.Optional[bool], Any)]
Used when there are 2 gateways with same host
selector
typing.Dict[(str, str)]
required

ClusterManifest

type
typing.Literal[Any]
default:"cluster"
required
name
str
required
3 to 35 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
cluster_type
ClusterManifestClusterType
required
πŸ”— ClusterManifestClusterTypeThe cluster type of this cluster
environment_names
typing.List[str]
required
Tag the environment like dev, staging or production. You will need to create environments if you don’t have already.
base_domains
typing.Optional[typing.List[str]]
Domain URL should be valid domain or IP address
monitoring
typing.Optional[ClusterManifestMonitoring]
default_registry_fqn
typing.Optional[str]
workbench_config
typing.Optional[ClusterManifestWorkbenchConfig]
spark_config
typing.Optional[SparkConfig]
cluster_integration_fqn
typing.Optional[str]
workflow_storage_integration_fqn
typing.Optional[str]
supported_nodepools
typing.Optional[typing.List[Nodepool]]
πŸ”— NodepoolAdd nodepools that are already created in your cluster. When deploying, applications can choose to schedule from these nodepools.
node_label_keys
typing.Optional[ClusterManifestNodeLabelKeys]
πŸ”— ClusterManifestNodeLabelKeysThe node label keys that this cluster supports. Note: You will additionally need to add truefoundry.com/gpu_type label for GPU-supported node pools. For more information, check out this documentation.
collaborators
typing.List[Collaborator]
required
πŸ”— CollaboratorCollaborators who can access this cluster

ClusterManifestMonitoring

loki_url
typing.Optional[str]
victoria_logs_url
typing.Optional[str]
prometheus_url
typing.Optional[str]
kubecost_url
typing.Optional[str]

ClusterManifestNodeLabelKeys

nodepool_selector_label
str
required
The nodepool selector label that this cluster supports

ClusterManifestWorkbenchConfig

notebook_config
typing.Optional[NotebookConfig]
ssh_server_config
typing.Optional[SshServerConfig]
default_storage_class
typing.Optional[str]
Must not contain any spaces.

ClustersDeleteResponse

message
typing.Optional[str]
Success message

Codeserver

type
typing.Optional[typing.Literal[Any]]
image
typing.Optional[WorkbenchImage]

CohereKeyAuth

type
typing.Literal[Any]
default:"api-key"
required
api_key
str
required
API key must not be empty

CohereModel

type
typing.Literal[Any]
default:"integration/model/cohere"
required
name
str
required
2 to 62 characters long alphanumeric word, may contain - in between, cannot start with a number
model_id
str
required
Model ID must not be empty
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeSpecify the type of the Cohere model
cost
typing.Optional[ModelCostMetric]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

CohereProviderAccount

type
typing.Literal[Any]
default:"provider-account/cohere"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
auth_data
CohereKeyAuth
required
integrations
typing.Optional[typing.List[CohereIntegrations]]
List of integrations that are associated with the Cohere provider account
collaborators
typing.Optional[typing.List[Collaborator]]
πŸ”— CollaboratorList of users who have access to this provider account

Collaborator

subject
str
required
Fully Qualified Name of the subject. eg: user:email or team:teamname
role_id
str
required
Role ID for the resource

CommonToolsSettings

type
typing.Literal[Any]
default:"settings/common-tools"
required
Enable web search tool Allows model to search the web for information.
code_executor
bool
required
Enable code executor tool Allows model to execute code and return the results.
sequential_thinking
bool
required
Enable sequential thinking tool Allows model to reason step-by-step to solve complex problems.
vision_ocr
bool
required
Enable vision OCR tool Allows model to extract text from images or PDFs.
web_scrape
bool
required
Enable web scraping tool. Allows model to scrape content from web pages with intelligent format selection for structured or unstructured data.

ContainerTaskConfig

type
typing.Literal[Any]
default:"container-task-config"
required
image
ContainerTaskConfigImage
required
env
typing.Optional[typing.Dict[(str, typing.Optional[str])]]
Configure environment variables to be injected in the task either as plain text or secrets. Docs
resources
typing.Optional[Resources]
mounts
typing.Optional[typing.List[VolumeMount]]
πŸ”— VolumeMountConfigure data to be mounted to Workflow pod(s) as a volume.
service_account
typing.Optional[str]

ContainerTaskConfigImage

Union, One Of:

CoreNatsOutputConfig

type
typing.Literal[Any]
default:"core-nats"
required
nats_url
str
required
Output NATS URL
root_subject
str
required
Output NATS root subject should only contain alphanumeric letters, dashes(-), and periods(.)
auth
typing.Optional[NatsUserPasswordAuth]

CpuUtilizationMetric

type
typing.Literal[Any]
default:"cpu_utilization"
required
value
int
required
Percentage of cpu request averaged over all replicas which the autoscaler should try to maintain

CreateMultiPartUploadRequest

id
str
required
path
str
required
num_parts
int
required

CreatePersonalAccessTokenResponse

token
str
required
Personal Access Token

CronMetric

type
typing.Literal[Any]
default:"cron"
required
desired_replicas
typing.Optional[int]
Desired number of replicas during the given interval. Default value is max_replicas.
start
str
required
Cron expression indicating the start of the cron schedule.
* * * * *
| | | | |
| | | | |___ day of week (0-6) (Sunday is 0)
| | | |_____ month (1-12)
| | |_______ day of month (1-31)
| |_________ hour (0-23)
|___________ minute (0-59)
end
str
required
Cron expression indicating the end of the cron schedule.
* * * * *
| | | | |
| | | | |___ day of week (0-6) (Sunday is 0)
| | | |_____ month (1-12)
| | |_______ day of month (1-31)
| |_________ hour (0-23)
|___________ minute (0-59)
timezone
str
default:"UTC"
required
Timezone against which the cron schedule will be calculated, e.g. β€œAsia/Tokyo”. Default is machine’s local time. https://docs.truefoundry.com/docs/list-of-supported-timezones

CustomBasicAuth

type
typing.Literal[Any]
default:"basic-auth"
required
username
str
required
The username for the basic authentication.
password
str
required
The password for the basic authentication.

CustomBearerAuth

type
typing.Literal[Any]
default:"bearer-auth"
required
bearer_token
str
required
The bearer token for the custom bearer authentication.

CustomBlobStorage

type
typing.Literal[Any]
default:"integration/blob-storage/custom"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
endpoint
str
required
The endpoint of the storage provider.
storage_root
str
required
The root path of the storage.
auth_data
CustomBasicAuth
required
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

CustomGuardrailConfig

name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
type
typing.Literal[Any]
default:"integration/guardrail-config/custom"
required
operation
CustomGuardrailConfigOperation
required
πŸ”— CustomGuardrailConfigOperationThe operation type to use for the Guardrail. Validate guardrails are used to validate requests and mutate can validate as well as mutate requests. Validate guardrails are run in parallel while mutate guardrails are run sequentially.
target
CustomGuardrailConfigTarget
required
πŸ”— CustomGuardrailConfigTargetSpecify whether the guardrail should be applied to the request or response. Guardrails with target β€œRequest” can be only used in input guardrails and guardrails with target β€œResponse” can only be used in output guardrails.
url
str
required
The URL of the Guardrail to send a post request to.
auth_data
typing.Optional[CustomGuardrailConfigAuthData]
πŸ”— CustomGuardrailConfigAuthDataAuthentication data for the Guardrail Server.
headers
typing.Optional[typing.Dict[(str, str)]]
Headers for the Guardrail Server. Forwarded to the Guardrail Server as is. For example: \{"Authorization": "APIKey \<token\>"\}
config
typing.Dict[(str, typing.Optional[typing.Any])]
The config for the Guardrail Server. This is a JSON object that will be sent as a config to Guardrail Server along with the request.

CustomGuardrailConfigAuthData

Union, One Of:

CustomHelmRepo

type
typing.Literal[Any]
default:"integration/helm-repo/custom"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
repo_url
str
required
The URL of the Helm Repo.
auth_data
CustomBasicAuth
required
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

CustomIntegrations

Union, One Of:

CustomJwtAuthIntegration

type
typing.Literal[Any]
default:"integration/jwt-auth/custom"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
issuer
str
required
The base URL of the authentication provider.
jwks_uri
str
required
The JSON Web Key Set URI for JWT verification.
login_provider
typing.Optional[OAuth2LoginProvider]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

CustomModel

name
str
required
2 to 62 characters long alphanumeric word, may contain - in between, cannot start with a number
hosted_model_name
str
required
url
str
required
enter valid https/http URL that should not end with trailing slash
model_server
CustomModelModelServer
required
tfy_application_id
typing.Optional[str]
type
typing.Literal[Any]
default:"integration/model/custom"
required
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeSpecify the type of the model
auth_data
typing.Optional[CustomModelAuthData]
πŸ”— CustomModelAuthDataCustom authentication data for the integration.
headers
typing.Optional[typing.Dict[(str, str)]]
Custom headers for the integration. Forwarded to the provider as is. For example: \{"Authorization": "APIKey \<token\>"\}
cost
typing.Optional[ModelCostMetric]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

CustomModelAuthData

Union, One Of:

CustomProviderAccount

type
typing.Literal[Any]
default:"provider-account/custom"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
auth_data
typing.Optional[CustomBasicAuth]
integrations
typing.List[CustomIntegrations]
required
πŸ”— CustomIntegrationsList of integrations that are associated with the provider account.

CustomUsernamePasswordArtifactsRegistry

type
typing.Literal[Any]
default:"integration/docker-registry/custom"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
registry_url
str
required
The URL of the registry.
auth_data
typing.Optional[CustomBasicAuth]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

DatabricksApiKeyAuth

type
typing.Literal[Any]
default:"api-key"
required
api_key
str
required
API key for Databricks authentication.

DatabricksModel

type
typing.Literal[Any]
default:"integration/model/databricks"
required
name
str
required
2 to 62 characters long alphanumeric word, may contain - in between, cannot start with a number
model_id
str
required
Model ID must not be empty
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeSpecify the type of the Databricks model
cost
typing.Optional[ModelCostMetric]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

DatabricksProviderAccount

type
typing.Literal[Any]
default:"provider-account/databricks"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
auth_data
DatabricksProviderAccountAuthData
required
πŸ”— DatabricksProviderAccountAuthDataDatabricks authentication credentials
base_url
str
required
Base URL must not be empty
integrations
typing.List[DatabricksIntegrations]
required
List of integrations that are associated with the Databricks provider account
collaborators
typing.Optional[typing.List[Collaborator]]
πŸ”— CollaboratorList of users who have access to this provider account

DatabricksProviderAccountAuthData

Union, One Of:

DatabricksServicePrincipalAuth

type
typing.Literal[Any]
default:"service-principal"
required
oauth_secret
str
required
OAuth secret of the Databricks service principal.
client_id
str
required
Client ID or Application ID of the Databricks service principal.

DataDirectory

id
str
required
ml_repo_id
str
required
name
str
required
fqn
str
required
created_by_subject
Subject
required
created_at
dt.datetime
required
updated_at
dt.datetime
required
manifest
DataDirectoryManifest
required
usage_code_snippet
typing.Optional[str]

DataDirectoryManifest

type
typing.Literal[Any]
default:"data-dir"
required
name
str
required
Name of the data directory
ml_repo
str
required
Name of the ML Repo to create the data directory under
description
typing.Optional[str]
Description for the data directory
metadata
typing.Dict[(str, typing.Optional[typing.Any])]
Key Value metadata. Should be valid JSON. For e.g. \{"business-unit": "sales", "quality": "good", "rating": 4.5\}
source
DataDirectoryManifestSource
required

DataDirectoryManifestSource

Union, One Of:

DeactivateUserResponse

Union, One Of:

DeepinfraKeyAuth

type
typing.Literal[Any]
default:"api-key"
required
api_key
str
required
API key must not be empty

DeepinfraModel

type
typing.Literal[Any]
default:"integration/model/deepinfra"
required
name
str
required
2 to 62 characters long alphanumeric word, may contain - in between, cannot start with a number
model_id
str
required
Model ID must not be empty
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeSpecify the type of the DeepInfra model
cost
typing.Optional[ModelCostMetric]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

DeepinfraProviderAccount

type
typing.Literal[Any]
default:"provider-account/deepinfra"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
auth_data
DeepinfraKeyAuth
required
integrations
typing.Optional[typing.List[DeepinfraIntegrations]]
List of integrations that are associated with the DeepInfra provider account
collaborators
typing.Optional[typing.List[Collaborator]]
πŸ”— CollaboratorList of users who have access to this provider account

DeleteApplicationResponse

message
str
required
Application deletion message

DeleteJobRunResponse

message
str
required
Job run deleted

DeletePersonalAccessTokenResponse

Union, One Of:

DeleteSecretGroupResponse

Union, One Of:

DeleteTeamResponse

Union, One Of:

DeleteVirtualAccountResponse

Union, One Of:

Deployment

id
typing.Optional[str]
version
typing.Optional[float]
fqn
typing.Optional[str]
application_id
typing_extensions.Annotated[(typing.Optional[str], Any)]
manifest
DeploymentManifest
required
application
typing.Optional[Any]
created_by_subject
typing_extensions.Annotated[(Subject, Any)]
required
created_at
typing_extensions.Annotated[(typing.Optional[dt.datetime], Any)]
updated_at
typing_extensions.Annotated[(typing.Optional[dt.datetime], Any)]
deployment_builds
typing_extensions.Annotated[(typing.Optional[typing.List[BuildInfo]], Any)]
deployment_statuses
typing_extensions.Annotated[(typing.Optional[typing.List[DeploymentStatus]], Any)]
current_status_id
typing_extensions.Annotated[(typing.Optional[str], Any)]
current_status
typing_extensions.Annotated[(typing.Optional[DeploymentStatus], Any)]
applied_recommendations
typing_extensions.Annotated[(typing.Optional[typing.List[Recommendation]], Any)]
πŸ”— RecommendationApplied recommendations for this deployment
created_by
typing_extensions.Annotated[(typing.Optional[str], Any)]

DeploymentBuild

id
typing.Optional[str]
deployment_id
typing_extensions.Annotated[(typing.Optional[str], Any)]
component_name
typing_extensions.Annotated[(typing.Optional[str], Any)]
build
typing.Optional[BuildInfo]
build_id
typing_extensions.Annotated[(typing.Optional[str], Any)]
image_uri
typing_extensions.Annotated[(typing.Optional[str], Any)]
name
typing.Optional[str]
status
typing.Optional[BuildStatus]
get_logs_url
typing_extensions.Annotated[(typing.Optional[str], Any)]
tail_logs_url
typing_extensions.Annotated[(typing.Optional[str], Any)]
logs_start_ts
typing_extensions.Annotated[(typing.Optional[str], Any)]
created_at
typing_extensions.Annotated[(typing.Optional[dt.datetime], Any)]
updated_at
typing_extensions.Annotated[(typing.Optional[dt.datetime], Any)]

DeploymentManifest

Union, One Of:

DeploymentStatus

id
typing.Optional[str]
deployment_id
typing_extensions.Annotated[(typing.Optional[str], Any)]
status
typing.Optional[DeploymentStatusValue]
state
typing.Optional[typing.Dict[(str, typing.Optional[typing.Any])]]
transition
typing.Optional[DeploymentTransition]
message
typing.Optional[str]
retry_count
typing_extensions.Annotated[(typing.Optional[float], Any)]
created_at
typing_extensions.Annotated[(typing.Optional[dt.datetime], Any)]
updated_at
typing_extensions.Annotated[(typing.Optional[dt.datetime], Any)]

DeveloperMessage

role
typing.Literal[Any]
default:"developer"
required
The role of the messages author, in this case developer.
content
DeveloperMessageContent
required
πŸ”— DeveloperMessageContentThe contents of the developer message.
name
typing.Optional[str]
An optional name for the participant.

DeveloperMessageContent

Union, One Of:

DockerFileBuild

type
typing.Literal[Any]
default:"dockerfile"
required
dockerfile_path
str
default:"./Dockerfile"
required
The file path of the Dockerfile relative to project root path.
build_context_path
str
default:"./"
required
Build context path for the Dockerfile relative to project root path.
command
typing.Optional[DockerFileBuildCommand]
πŸ”— DockerFileBuildCommandOverride the command to run when the container starts When deploying a Job, the command can be templatized by defining params and referencing them in command E.g. python main.py --learning_rate \{\{learning_rate\}\}
build_args
typing.Optional[typing.Dict[(str, str)]]

DockerFileBuildCommand

Union, One Of:

DockerhubBasicAuth

type
typing.Literal[Any]
default:"basic-auth"
required
username
str
required
password
str
required

DockerhubProviderAccount

type
typing.Literal[Any]
default:"provider-account/dockerhub"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
account_name
typing.Optional[str]
auth_data
typing.Optional[DockerhubBasicAuth]
integrations
typing.List[DockerhubIntegrations]
required

DockerhubRegistry

type
typing.Literal[Any]
default:"integration/docker-registry/dockerhub"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
registry_url
str
required
auth_data
typing.Optional[DockerhubBasicAuth]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

DynamicVolumeConfig

type
typing.Literal[Any]
default:"dynamic"
required
Volume Type for the volume.
storage_class
str
required
Name of the storage class to be used for the volume.
size
int
required
Size of volume in Gi

Email

type
typing.Literal[Any]
default:"email"
required
notification_channel
str
required
Specify the notification channel to send alerts to
to_emails
typing.List[str]
required
List of recipients’ email addresses if the notification channel is Email.

EmailNotificationChannel

type
typing.Literal[Any]
default:"integration/notification-channel/email"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
auth_data
SmtpCredentials
required
from_email
str
required
The email address from which the email will be sent.
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

EmptyResponse

Union, One Of:

Endpoint

host
str
required
Upto 253 characters, each part of host should be at most 63 characters long, can contain alphabets, digits and hypen, must begin and end with an alphanumeric characters. Parts must be separated by periods (.)
path
typing.Optional[str]
Should begin and end with a forward slash (/). Each part can can contain alphabets, digits and hypen, must begin and end with an alphanumeric characters. Parts should be separated by forward slashes (/)

EnkryptAiGuardrailConfig

name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
type
typing.Literal[Any]
default:"integration/guardrail-config/enkrypt-ai"
required
operation
EnkryptAiGuardrailConfigOperation
required
πŸ”— EnkryptAiGuardrailConfigOperationThe operation type to use for the Guardrail. Validate guardrails are used to validate requests and mutate can validate as well as mutate requests. Validate guardrails are run in parallel while mutate guardrails are run sequentially.
guardrail_name
str
required
The name of the guardrail to use for the Enkrypt AI Guardrail.
auth_data
EnkryptAiKeyAuth
required

EnkryptAiKeyAuth

type
typing.Literal[Any]
default:"api-key"
required
api_key
str
required
API key must not be empty

Environment

id
typing.Optional[str]
name
str
required
priority
float
required
color
EnvironmentColor
required
tenant_name
typing_extensions.Annotated[(str, Any)]
required
created_by_subject
typing_extensions.Annotated[(Subject, Any)]
required
is_production
typing_extensions.Annotated[(bool, Any)]
required
optimize_for
typing_extensions.Annotated[(typing.Optional[EnvironmentOptimizeFor], Any)]
manifest
EnvironmentManifest
required
created_by
typing_extensions.Annotated[(typing.Optional[str], Any)]

EnvironmentColor

color_hex
typing_extensions.Annotated[(typing.Optional[str], Any)]
background_color_hex
typing_extensions.Annotated[(typing.Optional[str], Any)]
color
typing.Optional[str]
background_color
typing_extensions.Annotated[(typing.Optional[str], Any)]

EnvironmentManifest

type
typing.Literal[Any]
default:"environment"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
color
EnvironmentColor
required
is_production
typing_extensions.Annotated[(bool, Any)]
required
Indicates if the environment is for production use
optimize_for
typing_extensions.Annotated[(EnvironmentOptimizeFor, Any)]
required

Event

name
typing.Optional[str]
Name of the event
first_timestamp
typing_extensions.Annotated[(typing.Optional[str], Any)]
Timestamp when the event was first observed
last_timestamp
typing_extensions.Annotated[(str, Any)]
required
Timestamp when the event was last observed
involved_object
typing_extensions.Annotated[(EventInvolvedObject, Any)]
required
πŸ”— EventInvolvedObjectDetails of the involved object
type
str
required
Type of the event
count
int
required
Number of occurrences of the event
reason
str
required
Reason for the event
message
str
required
Message describing the event
namespace
typing.Optional[str]
Namespace of the event
chart
EventChart
required
πŸ”— EventChartChart of the event

EventChart

category
EventChartCategory
required

EventInvolvedObject

kind
str
required
name
str
required
api_version
typing_extensions.Annotated[(typing.Optional[str], Any)]
namespace
typing.Optional[str]
container_name
typing_extensions.Annotated[(typing.Optional[str], Any)]

ExternalBlobStorageSource

type
typing.Literal[Any]
default:"external"
required
Type of the source
uri
str
required
URI referencing a path in the blob storage bucket linked to the MLRepo

FailureToleranceConfig

allowed_failures_per_minute
int
required
Number of failures allowed per minute before cooldown
cooldown_period_minutes
int
required
Cooldown period in minutes after failure threshold is reached
failure_status_codes
typing.List[int]
required
HTTP status codes considered as failures

FallbackConfig

name
str
required
Name of the fallback configuration
type
typing.Literal[Any]
default:"gateway-fallback-config"
required
rules
typing.List[FallbackRule]
required
πŸ”— FallbackRuleList of fallback rules

FallbackModel

target
str
required
Target model or provider FQN to use as fallback
override_params
typing.Optional[typing.Dict[(str, typing.Optional[typing.Any])]]
Optional parameters to override in the fallback request

FallbackRule

id
str
required
Unique identifier for the rule
when
FallbackWhen
required
fallback_models
typing.List[FallbackModel]
required
πŸ”— FallbackModelList of fallback models to try in sequence

FallbackWhen

subjects
typing.Optional[typing.List[str]]
List of subjects that this rule applies to
models
typing.Optional[typing.List[str]]
List of models that this rule applies to
metadata
typing.Optional[typing.Dict[(str, str)]]
Metadata key-value pairs that this rule applies to
response_status_codes
typing.List[int]
required
HTTP status codes that trigger fallback behavior

FastAiFramework

type
typing.Literal[Any]
default:"fastai"
required
Type of the framework

FileInfo

path
str
required
is_dir
bool
required
file_size
typing.Optional[int]
signed_url
typing.Optional[str]
last_modified
typing.Optional[dt.datetime]

FlyteLaunchPlan

id
FlyteLaunchPlanId
required
spec
FlyteLaunchPlanSpec
required
closure
typing.Optional[typing.Any]

FlyteLaunchPlanId

resource_type
typing_extensions.Annotated[(typing.Literal[Any], Any)]
default:"LAUNCH_PLAN"
required
name
str
required

FlyteLaunchPlanSpec

workflow_id
typing_extensions.Annotated[(FlyteWorkflowId, Any)]
required

FlyteTask

template
FlyteTaskTemplate
required
description
typing.Optional[typing.Optional[typing.Any]]

FlyteTaskCustom

truefoundry
FlyteTaskCustomTruefoundry
required

FlyteTaskCustomTruefoundry

Union, One Of:

FlyteTaskId

resource_type
typing_extensions.Annotated[(typing.Literal[Any], Any)]
default:"TASK"
required
name
str
required

FlyteTaskTemplate

id
FlyteTaskId
required
custom
FlyteTaskCustom
required

FlyteWorkflow

template
FlyteWorkflowTemplate
required
description
typing.Optional[typing.Optional[typing.Any]]

FlyteWorkflowId

resource_type
typing_extensions.Annotated[(typing.Literal[Any], Any)]
default:"WORKFLOW"
required
name
str
required

FlyteWorkflowTemplate

id
FlyteWorkflowId
required

ForwardAction

type
typing.Literal[Any]
default:"forward"
required
service_uri
str
required
Eg - For a service called sample-service in workspace ws this would be `sample-service.ws.svc.cluster.local
port
int
required

Function

name
str
required
Name of the tool/function being called
arguments
str
required
Arguments passed to the tool/function

FunctionSchema

name
str
required
Name of the function
description
str
required
Description of the function
parameters
typing.Optional[typing.Dict[(str, typing.Optional[typing.Any])]]
Parameters schema for the function
strict
typing.Optional[bool]
Indicates if the function should be called strictly

GatewayConfig

Union, One Of:

GcpApiKeyAuth

type
typing.Literal[Any]
default:"api-key"
required
api_key
typing_extensions.Annotated[(str, Any)]
required

GcpGcr

type
typing.Literal[Any]
default:"integration/docker-registry/gcp/gcr"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
registry_url
str
required
The URL of the registry.
auth_data
typing.Optional[GcpKeyFileAuth]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

GcpGcs

type
typing.Literal[Any]
default:"integration/blob-storage/gcp/gcs"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
storage_root
str
required
The root path of the storage.
auth_data
typing.Optional[GcpKeyFileAuth]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

GcpGkeIntegration

type
typing.Literal[Any]
default:"integration/cluster/gcp/gke-standard"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
location
GcpRegion
required
cluster_name
str
required
Name of the cluster given in the cloud account.
auth_data
typing.Optional[GcpKeyFileAuth]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

GcpGsm

type
typing.Literal[Any]
default:"integration/secret-store/gcp/gsm"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
auth_data
typing.Optional[GcpKeyFileAuth]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

GcpIntegrations

Union, One Of:

GcpKeyFileAuth

type
typing.Literal[Any]
default:"key-file"
required
key_file_content
typing.Dict[(str, typing.Optional[typing.Any])]

GcpProviderAccount

type
typing.Literal[Any]
default:"provider-account/gcp"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
project_id
typing.Optional[str]
The project id of the GCP account.
auth_data
typing.Optional[GcpProviderAccountAuthData]
πŸ”— GcpProviderAccountAuthDataAuthentication data for the GCP account.
integrations
typing.List[GcpIntegrations]
required
πŸ”— GcpIntegrationsList of integrations that are associated with the GCP provider account.

GcpProviderAccountAuthData

Union, One Of:

GcpTpu

type
typing.Literal[Any]
default:"gcp_tpu"
required
name
str
required
Name of the TPU Type. One of
  • tpu-v4-podslice (TPU v4, ct4p)
  • tpu-v5-lite-device (TPU v5e, ct5l)
  • tpu-v5-lite-podslice (TPU v5e, ct5lp)
  • tpu-v5p-slice (TPU v5p, ct5p)
topology
str
required
Topology of the TPU slices. Currently only single-host topology is supported. Please refer to TPUs on GKE docs Allowed Values:
  • 2x2x1 for tpu-v4-podslice
  • One of 1x1, 2x2, 2x4 for tpu-v5-lite-device and tpu-v5-lite-podslice
  • 2x2x1 for tpu-v5p-slice

GeminiModelV2

type
typing.Literal[Any]
default:"integration/model/gemini"
required
name
str
required
2 to 62 characters long alphanumeric word, may contain - in between, cannot start with a number
model_id
str
required
Model ID must not be empty
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeSpecify the type of the Gemini model (e.g., chat, text, etc.)
cost
typing.Optional[ModelCostMetric]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

GetAlertsResponse

data
typing.Dict[(str, typing.List[Alert])]
required
πŸ”— AlertObject containing alert data grouped by alert name

GetApplicationDeploymentResponse

data
Any
required
Deployment

GetApplicationResponse

data
Any
required
Application

GetArtifactResponse

data
Artifact
required

GetArtifactVersionResponse

data
ArtifactVersion
required

GetAuthenticatedVcsurlResponse

authenticated_url
typing_extensions.Annotated[(str, Any)]
required
Authenticated URL to access the repository

GetAutoProvisioningStateResponse

state
typing.Optional[typing.Dict[(str, typing.Optional[typing.Any])]]
State of auto-provisioning for the cluster.

GetChartsResponse

step
str
required
Step size
graphs
typing.List[Graph]
required

GetClusterResponse

data
Cluster
required

GetDataDirectoryResponse

data
DataDirectory
required

GetEnvironmentResponse

data
Environment
required

GetEventsResponse

data
typing.List[Event]
required

GetJobRunResponse

data
JobRun
required

GetLogsResponse

data
typing.List[Log]
required
πŸ”— LogList of logs

GetMlRepoResponse

data
MlRepo
required

GetModelResponse

data
Model
required

GetModelVersionResponse

data
ModelVersion
required

GetOrCreatePersonalAccessTokenResponse

data
VirtualAccount
required
πŸ”— VirtualAccountPersonal Access Token data
token
str
required
Personal Access Token
created
bool
required
Whether the PAT was created (true) or already existed (false)

GetPromptResponse

data
Prompt
required

GetPromptVersionResponse

data
PromptVersion
required

GetSecretGroupResponse

data
SecretGroup
required

GetSecretResponse

data
Any
required
Secret

GetSignedUrLsRequest

id
str
required
paths
typing.List[str]
required
operation
Operation
required

GetSignedUrLsResponse

data
typing.List[SignedUrl]
required

GetSuggestedDeploymentEndpointResponse

host
str
required
Host name
path
typing.Optional[str]
Path
gateway
typing.Optional[ClusterGateway]
πŸ”— ClusterGatewayGateway configuration

GetTeamResponse

data
Team
required

GetUserResponse

data
User
required

GetVirtualAccountResponse

data
VirtualAccount
required
token
typing.Optional[str]
Virtual Account token (present only when creating a virtual account)

GetWorkspaceResponse

data
Workspace
required

GitHelmRepo

type
typing.Literal[Any]
default:"git-helm-repo"
required
repo_url
str
required
Needs to be a valid URL.
revision
str
required
Branch/Commit SHA/Tag of the git repo.
path
str
required
Path to the chart.
value_files
typing.Optional[typing.List[str]]
Helm values files for overriding values in the helm chart. The path is relative to the Path directory defined above

GithubIntegration

type
typing.Literal[Any]
default:"integration/vcs/github"
required
name
str
required
account_name
str
required
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

GithubProviderAccount

type
typing.Literal[Any]
default:"provider-account/github"
required
name
str
required
integrations
typing.List[GithubIntegration]
required

GitlabIntegration

type
typing.Literal[Any]
default:"integration/vcs/gitlab"
required
name
str
required
account_name
str
required
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

GitlabProviderAccount

type
typing.Literal[Any]
default:"provider-account/gitlab"
required
name
str
required
integrations
typing.List[GitlabIntegration]
required

GitRepositoryExistsResponse

exists
bool
required
The flag if repository exists or not
id
typing.Optional[str]
The integration id of the repository

GitSource

type
typing.Literal[Any]
default:"git"
required
repo_url
str
required
Needs to be a valid Github, Bitbucket, Azure Repos or Gitlab link
ref
str
required
The commit SHA.
branch_name
typing.Optional[str]
Selecting branch will select latest commit SHA of the branch.

GluonFramework

type
typing.Literal[Any]
default:"gluon"
required
Type of the framework

GoogleGeminiProviderAccount

type
typing.Literal[Any]
default:"provider-account/google-gemini"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
auth_data
GcpApiKeyAuth
required
integrations
typing.List[GeminiModelV2]
required
πŸ”— GeminiModelV2List of integrations that are associated with the Google Gemini provider account
collaborators
typing.Optional[typing.List[Collaborator]]
πŸ”— CollaboratorList of users who have access to this provider account

GoogleModel

name
str
required
2 to 62 characters long alphanumeric word, may contain - in between, cannot start with a number
model_id
str
required
type
typing.Literal[Any]
default:"integration/model/gcp/google"
required
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeSpecify the type of the model
auth_data
typing.Optional[GcpApiKeyAuth]
cost
typing.Optional[ModelCostMetric]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

GoogleVertexProviderAccount

type
typing.Literal[Any]
default:"provider-account/google-vertex"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
project_id
str
required
Project ID must not be empty
region
GcpRegion
required
auth_data
typing.Optional[GcpKeyFileAuth]
integrations
typing.List[VertexModelV2]
required
πŸ”— VertexModelV2List of integrations that are associated with the Google Vertex provider account
collaborators
typing.Optional[typing.List[Collaborator]]
πŸ”— CollaboratorList of users who have access to this provider account

Graph

name
str
required
Name
description
str
required
Description
chart
str
required
Chart name
chart_type
typing_extensions.Annotated[(GraphChartType, Any)]
required
params
str
required
Chart params

GroqKeyAuth

type
typing.Literal[Any]
default:"api-key"
required
api_key
str
required
API key must not be empty

GroqModel

type
typing.Literal[Any]
default:"integration/model/groq"
required
name
str
required
2 to 62 characters long alphanumeric word, may contain - in between, cannot start with a number
model_id
str
required
Model ID must not be empty
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeSpecify the type of the Groq model
cost
typing.Optional[ModelCostMetric]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

GroqProviderAccount

type
typing.Literal[Any]
default:"provider-account/groq"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
auth_data
GroqKeyAuth
required
integrations
typing.Optional[typing.List[GroqIntegrations]]
List of integrations that are associated with the Groq provider account
collaborators
typing.Optional[typing.List[Collaborator]]
πŸ”— CollaboratorList of users who have access to this provider account

GuardrailConfigGroup

type
typing.Literal[Any]
default:"provider-account/guardrail-config-group"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
collaborators
typing.Optional[typing.List[Collaborator]]
πŸ”— CollaboratorList of users who have access to this Guardrail Config Group.
integrations
typing.List[GuardrailConfigIntegrations]
required
πŸ”— GuardrailConfigIntegrationsList of Guardrail Configs, which are part of this Guardrail Config Group.

GuardrailConfigIntegrations

Union, One Of:

Guardrails

input_guardrails
typing.Optional[typing.List[str]]
List of guardrail names to apply to user input messages before processing.
output_guardrails
typing.Optional[typing.List[str]]
List of guardrail names to apply to AI response messages before returning to user.

GuardrailsConfig

name
str
required
Name of the guardrails configuration
type
typing.Literal[Any]
default:"gateway-guardrails-config"
required
rules
typing.List[GuardrailsRule]
required
πŸ”— GuardrailsRuleList of guardrail rules

GuardrailsRule

id
str
required
Unique identifier for the rule
when
GuardrailsWhen
required
input_guardrails
typing.List[str]
required
Guardrail selectors of the guardrails to apply to the input (format: groupName/guardrailName)
output_guardrails
typing.List[str]
required
Guardrail selectors of the guardrails to apply to the output (format: groupName/guardrailName)

GuardrailsWhen

subjects
typing.Optional[typing.List[str]]
List of subjects that this rule applies to
models
typing.Optional[typing.List[str]]
List of models that this rule applies to
metadata
typing.Optional[typing.Dict[(str, str)]]
Metadata key-value pairs that this rule applies to

H2OFramework

type
typing.Literal[Any]
default:"h2o"
required
Type of the framework

HeaderMatch

type
typing.Literal[Any]
default:"header"
required
name
str
required
exact_match
str
required

HealthProbe

config
HttpProbe
required
initial_delay_seconds
typing.Optional[int]
Time to wait after container has started before checking the endpoint
period_seconds
typing.Optional[int]
default:"10"
How often to check the endpoint
timeout_seconds
typing.Optional[int]
default:"1"
Time to wait for a response from the endpoint before considering it down
success_threshold
typing.Optional[int]
default:"1"
Number of successful responses from the endpoint before container is considered healthy
failure_threshold
typing.Optional[int]
default:"3"
Number of consecutive failures before the container is considered down

Helm

type
typing.Literal[Any]
default:"helm"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
labels
typing.Optional[typing.Dict[(str, str)]]
Add labels to base argo app
source
HelmSource
required
values
typing.Optional[typing.Dict[(str, typing.Optional[typing.Any])]]
Values file as block file
kustomize
typing.Optional[Kustomize]
ignore_differences
typing_extensions.Annotated[(typing.Optional[typing.List[typing.Dict[(str, typing.Optional[typing.Any])]]], Any)]
workspace_fqn
typing.Optional[str]

HelmRepo

type
typing.Literal[Any]
default:"helm-repo"
required
repo_url
str
required
Needs to be a valid URL.
integration_fqn
typing.Optional[str]
FQN of the helm repo integration. If you can’t find your integration here, add it through the Integrations page
chart
str
required
The helm chart name
version
str
required
Helm chart version

HelmSource

Union, One Of:

HttpError

status_code
typing_extensions.Annotated[(int, Any)]
required
HTTP Status Code
message
str
required
Error Message
code
typing.Optional[HttpErrorCode]
details
typing.Optional[typing.List[typing.Dict[(str, typing.Optional[typing.Any])]]]
Error details

HttpErrorCode

Union, One Of:

HttpProbe

type
typing.Literal[Any]
default:"http"
required
path
str
required
Path to the health check endpoint
port
int
required
Listening port for the health check endpoint
host
typing.Optional[str]
Host name to connect to, defaults to the pod IP
scheme
typing.Optional[str]
default:"HTTP"
Scheme to use for connecting to the host

HttpValidationError

detail
typing.Optional[typing.List[ValidationError]]

HuggingfaceArtifactSource

type
typing.Literal[Any]
default:"huggingface-hub"
required
model_id
str
required
Model ID of the artifact to be downloaded
revision
str
required
Revision of the artifact to be downloaded
ignore_patterns
typing.List[str]
required
List of patterns to ignore while downloading the artifact
download_path_env_variable
str
required
Environment variable which will contain the download path of the artifact

IChange

type
IChangeOperation
required
key
str
required
value
typing.Optional[typing.Dict[(str, typing.Optional[typing.Any])]]
old_value
typing_extensions.Annotated[(typing.Optional[typing.Dict[(str, typing.Optional[typing.Any])]], Any)]
changes
typing.Optional[typing.List[Any]]

Image

type
typing.Literal[Any]
default:"image"
required
image_uri
str
required
The image URI. Specify the name of the image and the tag. If the image is in Dockerhub, you can skip registry-url (for e.g. tensorflow/tensorflow). You can use an image from a private registry using Advanced fields
docker_registry
typing.Optional[str]
FQN of the container registry. If you can’t find your registry here, add it through the Integrations page
command
typing.Optional[ImageCommand]
πŸ”— ImageCommandOverride the command to run when container starts. When deploying a Job, the command can be templatized by defining params and referencing them in command E.g. python main.py --learning_rate \{\{learning_rate\}\}

ImageCommand

Union, One Of:

ImageContentPart

type
typing.Literal[Any]
default:"image_url"
required
Type of the content part
image_url
ImageUrl
required
πŸ”— ImageUrlImage URL linking to the image

ImageUrl

url
ImageUrlUrl
required
πŸ”— ImageUrlUrlImage URL linking to the image
detail
typing.Optional[str]

ImageUrlUrl

Union, One Of:

InfraProviderAccount

Union, One Of:

InputOutputBasedCostMetricValue

input
float
required
output
float
required

Intercept

type
typing.Literal[Any]
default:"intercept"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
rules
typing.List[InterceptRulesItem]
required

InterceptRulesItem

port
int
required
match
typing.Optional[HeaderMatch]
action
InterceptRulesItemAction
required

InterceptRulesItemAction

Union, One Of:

InternalArtifactVersion

id
str
required
fqn
str
required
created_by_subject
Subject
required
created_at
typing.Optional[dt.datetime]
updated_at
typing.Optional[dt.datetime]
manifest
ArtifactManifest
required
usage_code_snippet
typing.Optional[str]
ml_repo_id
str
required
artifact_id
str
required
artifact_fqn
str
required
artifact_size
typing.Optional[int]

InternalListArtifactVersionsResponse

data
typing.List[InternalListArtifactVersionsResponseDataItem]
required
pagination
Pagination
required

InternalListArtifactVersionsResponseDataItem

Union, One Of:

InternalModelVersion

id
str
required
fqn
str
required
created_by_subject
Subject
required
created_at
typing.Optional[dt.datetime]
updated_at
typing.Optional[dt.datetime]
manifest
ModelManifest
required
usage_code_snippet
typing.Optional[str]
ml_repo_id
str
required
model_id
str
required
metrics
typing.Optional[typing.List[Metric]]
deployable
typing.Optional[bool]
artifact_fqn
str
required
artifact_size
typing.Optional[int]

InviteUserResponse

Union, One Of:

IsClusterConnectedResponse

is_connected
typing_extensions.Annotated[(bool, Any)]
required
Whether the cluster is connected

JfrogArtifactsRegistry

type
typing.Literal[Any]
default:"integration/docker-registry/jfrog"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
registry_url
str
required
The URL of the registry.
auth_data
typing.Optional[JfrogBasicAuth]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

JfrogBasicAuth

type
typing.Literal[Any]
default:"basic-auth"
required
username
str
required
The username for the basic authentication.
password
str
required
The password for the basic authentication.

JfrogProviderAccount

type
typing.Literal[Any]
default:"provider-account/jfrog"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
account_name
typing.Optional[str]
The name of the JFrog account.
auth_data
typing.Optional[JfrogBasicAuth]
integrations
typing.List[JFrogIntegrations]
required
List of integrations that are associated with the provider account.

Job

type
typing.Literal[Any]
default:"job"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
image
JobImage
required
trigger
JobTrigger
required
trigger_on_deploy
typing.Optional[bool]
Trigger the job after deploy immediately
params
typing.Optional[typing.List[Param]]
πŸ”— ParamConfigure params and pass it to create different job runs
env
typing.Optional[typing.Dict[(str, typing.Optional[str])]]
Configure environment variables to be injected in the service either as plain text or secrets. Docs
resources
typing.Optional[Resources]
alerts
typing.Optional[typing.List[JobAlert]]
πŸ”— JobAlertConfigure alerts to be sent when the job starts/fails/completes
retries
typing.Optional[int]
Specify the maximum number of attempts to retry a job before it is marked as failed.
timeout
typing.Optional[int]
Job timeout in seconds.
concurrency_limit
typing.Optional[int]
Number of runs that can run concurrently
service_account
typing.Optional[str]
mounts
typing.Optional[typing.List[JobMountsItem]]
πŸ”— JobMountsItemConfigure data to be mounted to job pod(s) as a string, secret or volume. Docs
labels
typing.Optional[typing.Dict[(str, str)]]
kustomize
typing.Optional[Kustomize]
workspace_fqn
typing.Optional[str]

JobAlert

notification_channel
typing.Optional[str]
Specify the notification channel to send alerts to
to_emails
typing.Optional[typing.List[str]]
List of recipients’ email addresses if the notification channel is Email.
notification_target
typing.Optional[NotificationTarget]
on_start
typing.Optional[bool]
Send an alert when the job starts
on_completion
typing.Optional[bool]
on_failure
typing.Optional[bool]
Send an alert when the job fails

JobImage

Union, One Of:

JobMountsItem

Union, One Of:

JobRun

name
str
required
JobRun Name
application_name
typing_extensions.Annotated[(str, Any)]
required
Application Name
deployment_version
typing_extensions.Annotated[(str, Any)]
required
Deployment Version
created_at
typing_extensions.Annotated[(float, Any)]
required
Created At
end_time
typing_extensions.Annotated[(typing.Optional[float], Any)]
End Time of JobRun
duration
typing.Optional[int]
Duration of JobRun
command
str
required
Command
total_retries
typing_extensions.Annotated[(int, Any)]
required
Total Retries
error
typing.Optional[str]
Error
status
JobRunStatus
required
πŸ”— JobRunStatusStatus of JobRun
triggered_by
typing_extensions.Annotated[(typing.Optional[str], Any)]
Triggered By
triggered_by_subject
typing_extensions.Annotated[(typing.Optional[Subject], Any)]
πŸ”— SubjectTriggered By Subject
exit_code
typing_extensions.Annotated[(typing.Optional[int], Any)]
Exit Code
spark_ui
typing_extensions.Annotated[(typing.Optional[str], Any)]
Spark UI Url

JobTrigger

Union, One Of:

JobTriggerInput

command
typing.Optional[JobTriggerInputCommand]
params
typing.Optional[typing.Dict[(str, typing.Optional[typing.Any])]]
Parameters used to populate template command

JobTriggerInputCommand

Union, One Of:

JwtAuthConfig

type
typing.Literal[Any]
default:"jwt_auth"
required
integration_fqn
str
required
FQN of the JWT Auth integration. If you can’t find your integration here, add it through the Integrations page
enable_login
typing.Optional[bool]
Enable login for the service
claims
typing.Optional[typing.List[JwtAuthConfigClaimsItem]]
πŸ”— JwtAuthConfigClaimsItemList of key-value pairs of claims to verify in the JWT token
bypass_auth_paths
typing.Optional[typing.List[str]]
List of paths that will bypass auth. needs to start with a forward slash(/) and should not contain wildcards(*)

JwtAuthConfigClaimsItem

key
str
required
values
typing.List[str]
required

KafkaInputConfig

type
typing.Literal[Any]
default:"kafka"
required
bootstrap_servers
str
required
β€˜Kafka Bootstrap servers - Comma separated list of Kafka brokers β€œhostname:port” to connect to for bootstrap’
topic_name
str
required
Kafka topic to subscribe to
consumer_group
str
required
The name of the consumer group to join for dynamic partition assignment
tls
bool
required
TLS configuration for SASL authentication
wait_time_seconds
typing.Optional[int]
default:"10"
Wait timeout for long polling.
auth
typing.Optional[KafkaSaslAuth]

KafkaMetricConfig

type
typing.Literal[Any]
default:"kafka"
required
lag_threshold
int
required
Upper limit of the number of backlog messages the auto-scaler will try to maintain per replica. If you set this number to 10 and have 30 messages in the stream and one replica, the auto-scaler will scale the number of replicas to 3.

KafkaOutputConfig

type
typing.Literal[Any]
default:"kafka"
required
bootstrap_servers
str
required
β€˜Kafka Bootstrap servers - Comma separated list of Kafka brokers β€œhostname:port” to connect to for bootstrap’
topic_name
str
required
Kafka topic to publish to
tls
bool
required
TLS configuration for SASL authentication
auth
typing.Optional[KafkaSaslAuth]

KafkaSaslAuth

username
str
required
Username for SASL authentication
password
str
required
Password for SASL authentication

KerasFramework

type
typing.Literal[Any]
default:"keras"
required
Type of the framework

Kustomize

patch
typing.Optional[typing.Dict[(str, typing.Optional[typing.Any])]]
Content of kustomization.yaml to perform kustomize operation. Please do not include the resources section. It is filled in automatically
additions
typing.Optional[typing.List[typing.Dict[(str, typing.Optional[typing.Any])]]]
Additional kubernetes manifests to be included in the application

LatencyBasedLoadBalanceTarget

target
str
required
Target model or provider FQN
override_params
typing.Optional[typing.Dict[(str, typing.Optional[typing.Any])]]
Optional parameters to override in the request

LatencyBasedLoadBalancingRule

id
str
required
Unique identifier for the rule
when
LoadBalancingWhen
required
load_balance_targets
typing.List[LatencyBasedLoadBalanceTarget]
required
πŸ”— LatencyBasedLoadBalanceTargetList of targets for latency-based load balancing
type
typing.Literal[Any]
default:"latency-based-routing"
required

LightGbmFramework

type
typing.Literal[Any]
default:"lightgbm"
required
Type of the framework

ListApplicationDeploymentsResponse

data
typing.List[Any]
required
Array of Deployments
pagination
Pagination
required
πŸ”— PaginationPagination information

ListApplicationsResponse

data
typing.List[Any]
required
Array of Applications
pagination
Pagination
required
πŸ”— PaginationPagination information

ListArtifactsResponse

data
typing.List[Artifact]
required
pagination
Pagination
required

ListArtifactVersionsResponse

data
typing.List[ArtifactVersion]
required
pagination
Pagination
required

ListClusterAddonsResponse

data
typing.List[AddonComponent]
required
πŸ”— AddonComponentArray of Cluster Addons
pagination
Pagination
required
πŸ”— PaginationPagination information

ListClustersResponse

data
typing.List[Cluster]
required
πŸ”— ClusterArray of cluster
pagination
Pagination
required
πŸ”— PaginationPagination information

ListDataDirectoriesResponse

data
typing.List[DataDirectory]
required
pagination
Pagination
required

ListEnvironmentsResponse

data
typing.List[Environment]
required
πŸ”— EnvironmentArray of Environments
pagination
Pagination
required
πŸ”— PaginationPagination information

ListFilesRequest

id
str
required
path
typing.Optional[str]
limit
typing.Optional[int]
page_token
typing.Optional[str]

ListFilesResponse

data
typing.List[FileInfo]
required
pagination
TokenPagination
required

ListJobRunResponse

data
typing.List[JobRun]
required
πŸ”— JobRunJobRun History
pagination
Pagination
required
πŸ”— PaginationPagination Information

ListMlReposResponse

data
typing.List[MlRepo]
required
pagination
Pagination
required

ListModelsResponse

data
typing.List[Model]
required
pagination
Pagination
required

ListModelVersionsResponse

data
typing.List[ModelVersion]
required
pagination
Pagination
required

ListPersonalAccessTokenResponse

data
typing.List[VirtualAccount]
required
πŸ”— VirtualAccountArray of Personal Access Tokens
pagination
Pagination
required
πŸ”— PaginationPagination Information

ListPromptsResponse

data
typing.List[Prompt]
required
pagination
Pagination
required

ListPromptVersionsResponse

data
typing.List[PromptVersion]
required
pagination
Pagination
required

ListSecretGroupResponse

data
typing.List[SecretGroup]
required
πŸ”— SecretGroupArray of Secret Groups
pagination
Pagination
required
πŸ”— PaginationPagination information

ListSecretsResponse

data
typing.List[Any]
required
Array of Secrets
pagination
Pagination
required
πŸ”— PaginationPagination Information

ListTeamsResponse

data
typing.List[Team]
required
pagination
Pagination
required
πŸ”— PaginationPagination Information

ListUsersResponse

data
typing.List[User]
required
πŸ”— UserArray of Users
pagination
Pagination
required
πŸ”— PaginationPagination information

ListVirtualAccountResponse

data
typing.List[VirtualAccount]
required
πŸ”— VirtualAccountArray of Virtual Accounts
pagination
Pagination
required
πŸ”— PaginationPagination Information

ListWorkspacesResponse

data
typing.List[Workspace]
required
πŸ”— WorkspaceArray of Workspace
pagination
Pagination
required
πŸ”— PaginationPagination information

LoadBalanceTarget

target
str
required
Target model or provider FQN
weight
int
required
Relative weight for routing decisions (higher values mean more traffic)
override_params
typing.Optional[typing.Dict[(str, typing.Optional[typing.Any])]]
Optional parameters to override in the request

LoadBalancingConfig

name
str
required
Name of the load balancing configuration
type
typing.Literal[Any]
default:"gateway-load-balancing-config"
required
model_configs
typing.Optional[typing.List[ModelConfig]]
πŸ”— ModelConfigConfiguration for specific models
rules
typing.List[LoadBalancingRule]
required
πŸ”— LoadBalancingRuleList of load balancing rules

LoadBalancingRule

Union, One Of:

LoadBalancingWhen

subjects
typing.Optional[typing.List[str]]
List of subjects that this rule applies to
models
typing.List[str]
required
List of models that this rule applies to
metadata
typing.Optional[typing.Dict[(str, str)]]
Metadata key-value pairs that this rule applies to

LocalArtifactSource

type
typing.Literal[Any]
default:"local"
required
Type of the source
paths
typing.List[ArtifactPath]
required
πŸ”— ArtifactPathArray of ArtifactPath objects representing the source and destination paths

LocalModelSource

type
typing.Literal[Any]
default:"local"
required
Type of the source
file_or_folder
str
required
Path to the model file or folder

LocalSource

type
typing.Literal[Any]
default:"local"
required
project_root_path
str
default:"./"
required
Local project root path.
local_build
bool
required
run docker build locally

Log

job_name
typing.Optional[str]
Job Name
log
str
required
Log Content
stream
str
required
Log Stream
time
str
required
Log Time
container_name
typing_extensions.Annotated[(typing.Optional[str], Any)]
Container Name

Manual

type
typing.Literal[Any]
default:"manual"
required

McpServerAuth

Union, One Of:

McpServerHeaderAuth

type
typing.Literal[Any]
default:"header"
required
headers
typing.Dict[(str, str)]
required

McpServerIntegration

type
typing.Literal[Any]
default:"integration/mcp-server/hosted-mcp-server"
required
name
str
required
The name of the MCP Server.
description
str
required
1 to 1000 characters long, may contain any character except newlines
url
str
required
The endpoint URL for the MCP Server. The system will first try a connection using streamable-http transport on this URL. If that fails, it will attempt a connection using SSE transport on <url>/sse.
auth_data
typing.Optional[McpServerAuth]

McpServerOAuth2

type
typing.Optional[typing.Literal[Any]]

McpServerPassthrough

type
typing.Literal[Any]
default:"passthrough"
required

McpServerProviderAccount

type
typing.Literal[Any]
default:"provider-account/hosted-mcp-server"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
collaborators
typing.Optional[typing.List[Collaborator]]
πŸ”— CollaboratorList of users who have access to this MCP Server Group.
integrations
typing.List[McpServerIntegrations]
required
πŸ”— McpServerIntegrationList of MCP Servers, which are part of this MCP Server Group.

McpServerWithFqn

type
typing.Literal[Any]
default:"mcp-server-fqn"
required
The FQN of the MCP server
integration_fqn
str
required
The FQN of the MCP server
enable_all_tools
typing.Optional[bool]
Whether to enable all tools from the MCP server
tools
typing.Optional[typing.List[McpTool]]
πŸ”— McpToolThe tools to enable from the MCP server

McpServerWithUrl

type
typing.Literal[Any]
default:"mcp-server-url"
required
The URL of the MCP server
url
str
required
The URL of the MCP server
headers
typing.Optional[typing.Dict[(str, str)]]
The headers to send to the MCP server
enable_all_tools
typing.Optional[bool]
Whether to enable all tools from the MCP server
tools
typing.Optional[typing.List[McpTool]]
πŸ”— McpToolThe tools to enable from the MCP server

McpTool

name
str
required
The name of the tool as it appears in the MCP server

Metadata

job_run_name_alias
typing.Optional[str]
Job Run Name Alias

Metric

key
str
required
value
typing.Optional[float]
timestamp
typing.Optional[int]
step
typing.Optional[int]

MirrorAction

type
typing.Literal[Any]
default:"mirror"
required
service_uri
str
required
Eg - For a service called sample-service in workspace ws this would be `sample-service.ws.svc.cluster.local
port
int
required
percentage
int
required

MistralAiKeyAuth

type
typing.Literal[Any]
default:"api-key"
required
api_key
str
required
API key must not be empty

MistralAiModel

type
typing.Literal[Any]
default:"integration/model/mistral-ai"
required
name
str
required
2 to 62 characters long alphanumeric word, may contain - in between, cannot start with a number
model_id
str
required
Model ID must not be empty
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeSpecify the type of the Mistral AI model
cost
typing.Optional[ModelCostMetric]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

MistralAiProviderAccount

type
typing.Literal[Any]
default:"provider-account/mistral-ai"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
auth_data
MistralAiKeyAuth
required
integrations
typing.Optional[typing.List[MistralAiIntegrations]]
List of integrations that are associated with the Mistral AI provider account
collaborators
typing.Optional[typing.List[Collaborator]]
πŸ”— CollaboratorList of users who have access to this provider account

MlRepo

tenant_name
str
required
Tenant Name
manifest
MlRepoManifest
required
created_by_subject
Subject
required
created_at
dt.datetime
required
Created At
id
str
required
Experiment Id
num_runs
typing.Optional[int]
Number of runs
artifact_type_counts
typing.Optional[typing.Dict[(str, int)]]
datasets_count
typing.Optional[int]
Number of datasets

MlRepoManifest

type
typing.Literal[Any]
default:"ml-repo"
required
name
str
required
Alphanumeric word, may contain ’-’ with a maximum length of 100 characters
description
typing.Optional[str]
Description can be maximum 500 characters
storage_integration_fqn
str
required
Select the storage-integration where you want to save your artifacts and models View Docs
collaborators
typing.List[Collaborator]
required
πŸ”— CollaboratorUsers and Teams that have access to MLRepo

Model

id
str
required
ml_repo_id
str
required
type
typing.Optional[typing.Literal[Any]]
name
str
required
fqn
str
required
created_by_subject
Subject
required
created_at
typing.Optional[dt.datetime]
updated_at
typing.Optional[dt.datetime]
latest_version
typing.Optional[ModelVersion]
run_steps
typing.Optional[typing.List[int]]

ModelConfig

model
str
required
Model identifier
usage_limits
typing.Optional[UsageLimits]
failure_tolerance
typing.Optional[FailureToleranceConfig]

ModelConfiguration

provider
str
required
Name of the provider, must be one of the integration providers configured for the Gateway
model
str
required
Name of the model to be used for generations. This model should be available in the provider
parameters
typing.Optional[Parameters]
πŸ”— ParametersParameters to pass to the model when generating
extra_parameters
typing.Optional[typing.Dict[(str, typing.Optional[typing.Any])]]
Arbitrary extra parameters to pass to the model when generating

ModelCostMetric

Union, One Of:

ModelManifest

name
str
required
Name of the entity
description
typing.Optional[str]
metadata
typing.Dict[(str, typing.Optional[typing.Any])]
Key value metadata. Should be valid JSON. For e.g. \{"business-unit": "sales", "quality": "good", "rating": 4.5\}
version_alias
typing.Optional[str]
Version alias is alternate, ideally human readable, version string to reference an artifact version. It should start with v followed by alphanumeric and it can include . and - in between (e.g. v1.0.0, v1-prod, v3-dev, etc)
ml_repo
str
required
Name of the ML Repo
version
typing.Optional[int]
Version of the entity
type
typing.Literal[Any]
default:"model-version"
required
source
ModelManifestSource
required
framework
typing.Optional[ModelManifestFramework]
πŸ”— ModelManifestFrameworkFramework for the model version like Transformers, PyTorch, Sklearn, Xgboost etc with framework specific metadata. This will be used to infer model deployment configuration
environment
typing.Optional[ModelVersionEnvironment]
step
typing.Optional[int]
Step/Epoch number in an iterative training loop the model version was created. Generally useful when logging a model version from a MLRepo Run
run_id
typing.Optional[str]
ID of the MLRepo Run that generated the model version

ModelManifestFramework

Union, One Of:

ModelManifestSource

Union, One Of:

ModelProviderAccount

Union, One Of:

ModelVersion

id
str
required
fqn
str
required
created_by_subject
Subject
required
created_at
typing.Optional[dt.datetime]
updated_at
typing.Optional[dt.datetime]
manifest
ModelManifest
required
usage_code_snippet
typing.Optional[str]
ml_repo_id
str
required
model_id
str
required
metrics
typing.Optional[typing.List[Metric]]
deployable
typing.Optional[bool]

ModelVersionEnvironment

python_version
typing.Optional[str]
Python version to use when running the model
pip_packages
typing.Optional[typing.List[str]]
pip dependencies needed for running the model

MultiPartUpload

storage_provider
MultiPartUploadStorageProvider
required
part_signed_urls
typing.List[SignedUrl]
required
s3compatible_upload_id
typing_extensions.Annotated[(typing.Optional[str], Any)]
azure_blob_block_ids
typing.Optional[typing.List[str]]
finalize_signed_url
SignedUrl
required

MultiPartUploadResponse

data
MultiPartUpload
required

NatsInputConfig

type
typing.Literal[Any]
default:"nats"
required
nats_url
str
required
Input NATS URL
stream_name
str
required
Name of the NATS stream
root_subject
str
required
Input NATS root subject should only contain alphanumeric letters, dashes(-), and periods(.)
consumer_name
str
required
Consumer name should only contain alphanumeric letters, dashes(-), and underscores(_)
wait_time_seconds
int
default:"19"
required
Wait timeout for long polling.
nats_metrics_url
typing.Optional[str]
NATS Metrics URL should be a valid HTTP/HTTPS URL
auth
typing.Optional[NatsUserPasswordAuth]

NatsMetricConfig

type
typing.Literal[Any]
default:"nats"
required
lag_threshold
int
required
Upper limit of the number of backlog messages the auto-scaler will try to maintain per replica. If you set this number to 10 and have 30 messages in the stream and one replica, the auto-scaler will scale the number of replicas to 3.

NatsOutputConfig

type
typing.Literal[Any]
default:"nats"
required
nats_url
str
required
Output NATS URL
root_subject
str
required
Output NATS root subject should only contain alphanumeric letters, dashes(-), and periods(.)
auth
typing.Optional[NatsUserPasswordAuth]

NatsUserPasswordAuth

account_name
str
default:"$G"
required
Name of the NATS account
user
str
required
User for NATS authentication
password
str
required
Password for NATS authentication

Nodepool

name
str
required
description
typing.Optional[str]

NodepoolSelector

type
typing.Literal[Any]
default:"nodepool_selector"
required
nodepools
typing.Optional[typing.List[str]]
Nodepools where you want to run your workload. Multiple nodepools can be selected. The workload is guaranteed to be scheduled on one of the nodepool

NodeSelector

type
typing.Literal[Any]
default:"node_selector"
required
instance_families
typing.Optional[typing.List[str]]
Instance family of the underlying machine to use. Multiple instance families can be supplied. The workload is guaranteed to be scheduled on one of them.
capacity_type
typing.Optional[NodeSelectorCapacityType]
πŸ”— NodeSelectorCapacityTypeConfigure what type of nodes to run the app. By default no placement logic is applied. β€œspot_fallback_on_demand” will try to place the application on spot nodes but will fallback to on-demand when spot nodes are not available. β€œspot” will strictly place the application on spot nodes. β€œon_demand” will strictly place the application on on-demand nodes.

NomicKeyAuth

type
typing.Literal[Any]
default:"api-key"
required
api_key
str
required
API key must not be empty

NomicModel

type
typing.Literal[Any]
default:"integration/model/nomic"
required
name
str
required
2 to 62 characters long alphanumeric word, may contain - in between, cannot start with a number
model_id
str
required
Model ID must not be empty
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeSpecify the type of the Nomic model
cost
typing.Optional[ModelCostMetric]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

NomicProviderAccount

type
typing.Literal[Any]
default:"provider-account/nomic"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
auth_data
NomicKeyAuth
required
integrations
typing.Optional[typing.List[NomicIntegrations]]
List of integrations that are associated with the Nomic provider account
collaborators
typing.Optional[typing.List[Collaborator]]
πŸ”— CollaboratorList of users who have access to this provider account

Notebook

type
typing.Optional[typing.Literal[Any]]
image
typing.Optional[WorkbenchImage]
cull_timeout
typing.Optional[int]
default:"30"
Stop the notebook instance after this much time in minutes of inactivity. The notebook instance will be stopped even if the notebook is open in your browser, but nothing is running on the notebook.

NotebookConfig

base_domain
str
required
Must not contain any spaces.

NotificationTarget

Union, One Of:

NotificationTargetForAlertRule

Union, One Of:

NvidiaGpu

type
typing.Literal[Any]
default:"nvidia_gpu"
required
name
typing.Optional[str]
Name of the Nvidia GPU. One of [P4, P100, V100, T4, A10G, A100_40GB, A100_80GB] This field is required for Node Selector and can be ignored in Nodepool Selector. One instance of the card contains the following amount of memory - P4: 8 GB, P100: 16 GB, V100: 16 GB, T4: 16 GB, A10G: 24 GB, A100_40GB: 40GB, A100_80GB: 80 GB
count
int
required
Count of GPUs to provide to the application Note the exact count and max count available for a given GPU type depends on cloud provider and cluster type.

NvidiaMiggpu

type
typing.Literal[Any]
default:"nvidia_mig_gpu"
required
name
typing.Optional[str]
Name of the Nvidia GPU. One of [P4, P100, V100, T4, A10G, A100_40GB, A100_80GB] This field is required for Node Selector and can be ignored in Nodepool Selector. One instance of the card contains the following amount of memory - P4: 8 GB, P100: 16 GB, V100: 16 GB, T4: 16 GB, A10G: 24 GB, A100_40GB: 40GB, A100_80GB: 80 GB
profile
NvidiaMiggpuProfile
required
πŸ”— NvidiaMiggpuProfileName of the MIG profile to use. One of the following based on gpu type Please refer to https://docs.nvidia.com/datacenter/tesla/mig-user-guide/#supported-mig-profiles for more details A100 40 GB - [1g.5gb, 1g.10gb, 2g.10gb, 3g.20gb, 4g.20gb] A100 80 GB / H100 80 GB - [1g.10gb, 1g.20gb, 2g.20gb, 3g.40gb, 4g.40gb] H100 94 GB - [1g.12gb, 1g.24gb, 2g.24gb, 3g.47gb, 4g.47gb] H100 96 GB - [1g.12gb, 1g.24gb, 2g.24gb, 3g.48gb, 4g.48gb] H200 141 GB - [1g.18gb, 1g.35gb, 2g.35gb, 3g.71gb, 4g.71gb]

NvidiaTimeslicingGpu

type
typing.Literal[Any]
default:"nvidia_timeslicing_gpu"
required
name
typing.Optional[str]
Name of the Nvidia GPU. One of [P4, P100, V100, T4, A10G, A100_40GB, A100_80GB] This field is required for Node Selector and can be ignored in Nodepool Selector. One instance of the card contains the following amount of memory - P4: 8 GB, P100: 16 GB, V100: 16 GB, T4: 16 GB, A10G: 24 GB, A100_40GB: 40GB, A100_80GB: 80 GB
gpu_memory
int
required
Amount of GPU memory (in MB) to allocate. Please note, this limit is not being enforced today but will be in future. Applications are expected to operate in co-opertative mode

OAuth2LoginProvider

type
typing.Optional[typing.Literal[Any]]

OciRepo

type
typing.Literal[Any]
default:"oci-repo"
required
oci_chart_url
str
required
Need to be a valid URL.
integration_fqn
typing.Optional[str]
FQN of the container registry. If you can’t find your registry here, add it through the Integrations page
version
str
required
Helm chart version

OllamaKeyAuth

custom_host
str
required
Host URL must not be empty

OllamaModel

type
typing.Literal[Any]
default:"integration/model/ollama"
required
name
str
required
2 to 62 characters long alphanumeric word, may contain - in between, cannot start with a number
model_id
str
required
Model ID must not be empty
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeSpecify the type of the Ollama model
cost
typing.Optional[ModelCostMetric]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

OllamaProviderAccount

type
typing.Literal[Any]
default:"provider-account/ollama"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
auth_data
OllamaKeyAuth
required
integrations
typing.List[OllamaIntegrations]
required
List of integrations that are associated with the Ollama provider account
collaborators
typing.Optional[typing.List[Collaborator]]
πŸ”— CollaboratorList of users who have access to this provider account

OnnxFramework

type
typing.Literal[Any]
default:"onnx"
required
Type of the framework

OpenaiApiKeyAuth

type
typing.Literal[Any]
default:"api-key"
required
api_key
str
required
API key must not be empty

OpenAiModel

type
typing.Literal[Any]
default:"integration/model/openai"
required
name
str
required
2 to 62 characters long alphanumeric word, may contain - in between, cannot start with a number
model_id
str
required
Model ID must not be empty
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeSpecify the type of the OpenAI model
cost
typing.Optional[ModelCostMetric]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

OpenAiModerationsGuardrailConfig

name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
type
typing.Literal[Any]
default:"integration/guardrail-config/openai-moderations"
required
base_url
typing.Optional[str]
Optional custom base URL for OpenAI API. If not provided, the default base URL will be used.
auth_data
OpenaiApiKeyAuth
required
model
str
default:"omni-moderation-latest"
required
The model to use for the OpenAI Moderation API.
category_thresholds
typing.Optional[typing.Dict[(str, OpenAiModerationsGuardrailConfigCategoryThresholdsValue)]]
πŸ”— OpenAiModerationsGuardrailConfigCategoryThresholdsValueThe thresholds for the OpenAI Moderation API.

OpenAiModerationsGuardrailConfigCategoryThresholdsValue

Union, One Of:

OpenAiModerationsGuardrailConfigCategoryThresholdsValueHarassment

harassment
float
required
sexual
float
required
violence
float
required

OpenaiProviderAccount

type
typing.Literal[Any]
default:"provider-account/openai"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
auth_data
OpenaiApiKeyAuth
required
base_url
typing.Optional[str]
Base URL must not be empty
integrations
typing.List[OpenAiIntegrations]
required
List of integrations that are associated with the OpenAI provider account
collaborators
typing.Optional[typing.List[Collaborator]]
πŸ”— CollaboratorList of users who have access to this provider account

PaddleFramework

type
typing.Literal[Any]
default:"paddle"
required
Type of the framework

PagerDuty

type
typing.Literal[Any]
default:"pagerduty"
required
notification_channel
str
required
Specify the notification channel to send alerts to

PagerDutyIntegration

type
typing.Literal[Any]
default:"integration/notification-channel/pagerduty"
required
name
str
required
The name of the integration that will be displayed in the TrueFoundry UI.
auth_data
PagerDutyIntegrationKeyAuth
required
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

PagerDutyIntegrationKeyAuth

type
typing.Literal[Any]
default:"pagerduty-integration-auth"
required
integration_key
str
required
The integration key for the PagerDuty integration
integration_url
str
required
The integration URL for the PagerDuty integration

PagerDutyProviderAccount

type
typing.Literal[Any]
default:"provider-account/pagerduty"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
integrations
typing.List[PagerDutyIntegrations]
required
πŸ”— PagerDutyIntegrationList of integrations that are associated with the PagerDuty provider account

Pagination

total
int
required
Total number of items
offset
typing.Optional[int]
Number of items skipped
limit
typing.Optional[int]
Number of items per page

PalmKeyAuth

type
typing.Literal[Any]
default:"api-key"
required
api_key
str
required
API key must not be empty

PalmModel

type
typing.Literal[Any]
default:"integration/model/palm"
required
name
str
required
2 to 62 characters long alphanumeric word, may contain - in between, cannot start with a number
model_id
str
required
Model ID must not be empty
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeSpecify the type of the PaLM model
cost
typing.Optional[ModelCostMetric]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

PalmProviderAccount

type
typing.Literal[Any]
default:"provider-account/palm"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
auth_data
PalmKeyAuth
required
integrations
typing.Optional[typing.List[PalmIntegrations]]
List of integrations that are associated with the PaLM provider account
collaborators
typing.Optional[typing.List[Collaborator]]
πŸ”— CollaboratorList of users who have access to this provider account

Param

name
str
required
name can contain lower case alphabets, digits, underscore (_) and hypen (-). It can be 32 characters long, should start with an alphabet, and should end with either an alphabet or digit.
description
typing.Optional[str]
description cannot be longer than 127 characters
default
typing.Optional[str]
default value cannot be longer than 127 characters
param_type
typing.Optional[ParamParamType]

Parameters

max_tokens
typing.Optional[int]
temperature
typing.Optional[float]
top_k
typing.Optional[float]
top_p
typing.Optional[float]
stop
typing.Optional[ParametersStop]

ParametersStop

Union, One Of:

Permissions

resource_fqn
str
required
The fully qualified name of the resource
resource_type
str
required
The type of the resource (cluster, workspace, etc.)
role_id
str
required
The role id of the role to be assigned to the service account for that resource

PerplexityAiKeyAuth

type
typing.Literal[Any]
default:"api-key"
required
api_key
str
required
API key must not be empty

PerplexityAiModel

type
typing.Literal[Any]
default:"integration/model/perplexity-ai"
required
name
str
required
2 to 62 characters long alphanumeric word, may contain - in between, cannot start with a number
model_id
str
required
Model ID must not be empty
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeSpecify the type of the Perplexity AI model
cost
typing.Optional[ModelCostMetric]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

PerplexityAiProviderAccount

type
typing.Literal[Any]
default:"provider-account/perplexity-ai"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
auth_data
PerplexityAiKeyAuth
required
integrations
typing.Optional[typing.List[PerplexityIntegrations]]
List of integrations that are associated with the Perplexity AI provider account
collaborators
typing.Optional[typing.List[Collaborator]]
πŸ”— CollaboratorList of users who have access to this provider account

PersonalAccessTokenManifest

name
str
required
3 to 25 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
type
typing.Literal[Any]
default:"pat"
required
expiration_date
typing.Optional[str]
Expiration date of the personal access token
user_fqn
str
required
The fully qualified name of the user

PerThousandEmbeddingTokensCostMetric

metric
str
required
value
float
required

PerThousandTokensCostMetric

metric
str
required
value
InputOutputBasedCostMetricValue
required

PolicyFilters

cluster_names
typing.Optional[typing.List[str]]
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
workspace_names
typing.Optional[typing.List[str]]
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
env_names
typing.Optional[typing.List[str]]
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number

PolicyManifest

type
typing.Literal[Any]
default:"policy"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
description
str
required
Description must be between 1 byte and 1024 bytes
operation
PolicyManifestOperation
required
πŸ”— PolicyManifestOperationDefines if the policy validates or mutates resources. Validation policies check TrueFoundry manifests to ensure they meet conditions and can block deployments. Mutation policies modify Kubernetes manifests before they’re applied to the cluster. See this documentation for more details.
mode
PolicyManifestMode
required
πŸ”— PolicyManifestModeMode of the policy: Audit logs all policy evaluations without blocking deployments. Enforce blocks deployments if the policy fails. Disabled deactivates the policy.
entities
typing.List[PolicyEntityTypes]
required
πŸ”— PolicyEntityTypesTypes of applications this policy applies to
actions
typing.List[PolicyActions]
required
Actions this policy applies to
filters
typing.Optional[PolicyFilters]
code
str
required
Code size must be between 1 byte and 10 KB

PolicyManifestOperation

Union, One Of:

PolicyMutationOperation

type
typing.Literal[Any]
default:"mutate"
required
Mutates or Validates Resources
order
int
required
Order must be a positive integer less than or equal to 100

PolicyValidationOperation

type
typing.Literal[Any]
default:"validate"
required
Mutates or Validates Resources

Port

port
int
default:"80"
required
Port number to expose.
protocol
PortProtocol
required
πŸ”— PortProtocolProtocol for the port.
expose
bool
required
Expose the port
app_protocol
typing.Optional[PortAppProtocol]
πŸ”— PortAppProtocolApplication Protocol for the port. Select the application protocol used by your service. For most use cases, this should be http(HTTP/1.1). If you are running a gRPC server, select the grpc option. This is only applicable if expose=true.
host
typing.Optional[str]
Upto 253 characters, each part of host should be at most 63 characters long, can contain alphabets, digits and hypen, must begin and end with an alphanumeric characters. Parts must be separated by periods (.)
path
typing.Optional[str]
Should begin and end with a forward slash (/). Each part can can contain alphabets, digits and hypen, must begin and end with an alphanumeric characters. Parts should be separated by forward slashes (/)
rewrite_path_to
typing.Optional[str]
Should begin and end with a forward slash (/). Each part can can contain alphabets, digits and hypen, must begin and end with an alphanumeric characters. Parts should be separated by forward slashes (/)
auth
typing.Optional[PortAuth]
πŸ”— PortAuthAuthentication method for inbound traffic

PortAuth

Union, One Of:

PresignedUrlObject

uri
str
required
url
str
required
headers
typing.Optional[typing.Dict[(str, typing.Optional[typing.Any])]]

PrometheusAlertRule

type
typing.Literal[Any]
default:"prometheus-alert-rule"
required
name
str
required
3 to 35 alphanumeric characters long, can contain - in between, cannot start with a number and cannot end with a -
expression
str
required
Enter a valid PromQL expression that defines the condition for triggering this alert. The alert will fire when this expression evaluates to true for the duration specified in the duration to trigger alert field.
for_
typing_extensions.Annotated[(float, Any)]
required
The prometheus expression must remain true for this duration (in seconds) before the alert is triggered. If the condition becomes false before this time elapses, the alert will not fire.
severity
AlertSeverity
required
description
typing.Optional[str]
Description of the alert rule which will be displayed in the alert rule list. This can be used to provide more context about the alert rule.
notification_enabled
bool
required
When enabled, notifications will be sent to all configured target channels when the alert conditions are met.

Prompt

id
str
required
ml_repo_id
str
required
type
typing.Optional[typing.Literal[Any]]
name
str
required
fqn
str
required
created_by_subject
Subject
required
created_at
typing.Optional[dt.datetime]
updated_at
typing.Optional[dt.datetime]
latest_version
typing.Optional[PromptVersion]
run_steps
typing.Optional[typing.List[int]]

PromptVersion

id
str
required
fqn
str
required
created_by_subject
Subject
required
created_at
typing.Optional[dt.datetime]
updated_at
typing.Optional[dt.datetime]
manifest
ChatPromptManifest
required
usage_code_snippet
typing.Optional[str]
ml_repo_id
str
required
prompt_id
str
required

ProviderAccounts

Union, One Of:

PublicCostMetric

metric
str
required

PySparkTaskConfig

type
typing.Literal[Any]
default:"pyspark-task-config"
required
image
TaskPySparkBuild
required
driver_config
SparkDriverConfig
required
executor_config
SparkExecutorConfig
required
spark_conf
typing.Optional[typing.Dict[(str, typing.Optional[typing.Any])]]
Extra configuration properties to be passed to the spark job. Docs
env
typing.Optional[typing.Dict[(str, typing.Optional[str])]]
Configure environment variables to be injected in the task either as plain text or secrets. Docs
mounts
typing.Optional[typing.List[PySparkTaskConfigMountsItem]]
πŸ”— PySparkTaskConfigMountsItemConfigure data to be mounted to Workflow pod(s) as a volume.
service_account
typing.Optional[str]

PySparkTaskConfigMountsItem

Union, One Of:

PythonBuild

type
typing.Literal[Any]
default:"tfy-python-buildpack"
required
python_version
typing.Optional[str]
Please enter a valid Python version tag
build_context_path
str
default:"./"
required
Build path relative to project root path.
requirements_path
typing.Optional[str]
Path to requirements.txt relative to Path to build context
pip_packages
typing.Optional[typing.List[str]]
Define pip package requirements. In Python/YAML E.g. [β€œfastapi>=0.90,<1.0”, β€œuvicorn”]
apt_packages
typing.Optional[typing.List[str]]
Debian packages to install via apt get. In Python/YAML E.g. [β€œgit”, β€œffmpeg”, β€œhtop”]
command
PythonBuildCommand
required
πŸ”— PythonBuildCommandCommand to run when the container starts. Command will be set as the Entrypoint of the generated image. When deploying a Job, the command can be templatized by defining params and referencing them in command E.g. python main.py --learning_rate \{\{learning_rate\}\}
cuda_version
typing.Optional[str]
Version of CUDA Toolkit and CUDNN to install in the image These combinations are based off of publically available docker images on docker hub You can also specify a valid tag of the form {cuda_version_number}-cudnn{cudnn_version_number}-{runtime|devel}-ubuntu{ubuntu_version} Refer https://hub.docker.com/r/nvidia/cuda/tags for valid set of values Note: We use deadsnakes ubuntu ppa to add Python that currently supports only Ubuntu 18.04, 20.04 and 22.04

PythonBuildCommand

Union, One Of:

PythonTaskConfig

type
typing.Literal[Any]
default:"python-task-config"
required
image
PythonTaskConfigImage
required
πŸ”— PythonTaskConfigImageSpecify the image spec for the task
env
typing.Optional[typing.Dict[(str, typing.Optional[str])]]
Configure environment variables to be injected in the task either as plain text or secrets. Docs
resources
typing.Optional[Resources]
mounts
typing.Optional[typing.List[PythonTaskConfigMountsItem]]
πŸ”— PythonTaskConfigMountsItemConfigure data to be mounted to Workflow pod(s) as a volume.
service_account
typing.Optional[str]

PythonTaskConfigImage

Union, One Of:

PythonTaskConfigMountsItem

Union, One Of:

PyTorchFramework

type
typing.Literal[Any]
default:"pytorch"
required
Type of the framework

QuayArtifactsRegistry

type
typing.Literal[Any]
default:"integration/docker-registry/quay"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
registry_url
str
required
The URL of the registry.
auth_data
typing.Optional[QuayBasicAuth]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

QuayBasicAuth

type
typing.Literal[Any]
default:"basic-auth"
required
username
str
required
The username for the basic authentication.
password
str
required
The password for the basic authentication.

QuayProviderAccount

type
typing.Literal[Any]
default:"provider-account/quay"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
account_name
typing.Optional[str]
The name of the account on Quay.
auth_data
typing.Optional[QuayBasicAuth]
integrations
typing.List[QuayIntegrations]
required
List of integrations that are associated with the provider account.

RateLimitConfig

name
str
required
Name of the rate limiting configuration
type
typing.Literal[Any]
default:"gateway-rate-limiting-config"
required
rules
typing.List[RateLimitRule]
required
πŸ”— RateLimitRuleList of rate limit rules

RateLimitRule

id
str
required
Unique identifier for the rule
when
RateLimitWhen
required
limit_to
int
required
Maximum number of requests or tokens allowed
unit
RateLimitUnit
required

RateLimitWhen

subjects
typing.Optional[typing.List[str]]
List of subjects that this rule applies to
models
typing.Optional[typing.List[str]]
List of models that this rule applies to
metadata
typing.Optional[typing.Dict[(str, str)]]
Metadata key-value pairs that this rule applies to

Recommendation

id
typing.Optional[str]
cluster_id
typing_extensions.Annotated[(typing.Optional[str], Any)]
application_id
typing_extensions.Annotated[(typing.Optional[str], Any)]
deployment_id
typing_extensions.Annotated[(typing.Optional[str], Any)]
application_version
typing_extensions.Annotated[(typing.Optional[int], Any)]
recommendation_data
typing_extensions.Annotated[(typing.Dict[(str, typing.Optional[typing.Any])], Any)]
recommendation_type
typing_extensions.Annotated[(str, Any)]
required
applied_deployment_id
typing_extensions.Annotated[(typing.Optional[str], Any)]
expiry_timestamp
typing_extensions.Annotated[(dt.datetime, Any)]
required
created_at
typing_extensions.Annotated[(typing.Optional[dt.datetime], Any)]
updated_at
typing_extensions.Annotated[(typing.Optional[dt.datetime], Any)]

RefusalContentPart

type
str
required
Type of the content part
refusal
str
required
Reason

RegisterUsersResponse

Union, One Of:

RemoteSource

type
typing.Literal[Any]
default:"remote"
required
remote_uri
str
required

Resources

cpu_request
float
default:"0.2"
required
Requested CPU which determines the minimum cost incurred. The CPU usage can exceed the requested amount, but not the value specified in the limit. 1 CPU means 1 CPU core. Fractional CPU can be requested like 0.5 or 0.05
cpu_limit
float
default:"0.5"
required
CPU limit beyond which the usage cannot be exceeded. 1 CPU means 1 CPU core. Fractional CPU can be requested like 0.5. CPU limit should be >= cpu request.
memory_request
int
default:"200"
required
Requested memory which determines the minimum cost incurred. The unit of memory is in megabytes(MB). So 1 means 1 MB and 2000 means 2GB.
memory_limit
int
default:"500"
required
Memory limit after which the application will be killed with an OOM error. The unit of memory is in megabytes(MB). So 1 means 1 MB and 2000 means 2GB. MemoryLimit should be greater than memory request.
ephemeral_storage_request
int
default:"1000"
required
Requested disk storage. The unit of memory is in megabytes(MB). This is ephemeral storage and will be wiped out on pod restarts or eviction
ephemeral_storage_limit
int
default:"2000"
required
Disk storage limit. The unit of memory is in megabytes(MB). Exceeding this limit will result in eviction. It should be greater than the request. This is ephemeral storage and will be wiped out on pod restarts or eviction
shared_memory_size
typing.Optional[int]
Define the shared memory requirements for your workload. Machine learning libraries like Pytorch can use Shared Memory for inter-process communication. If you use this, we will mount a tmpfs backed volume at the /dev/shm directory. Any usage will also count against the workload’s memory limit (resources.memory_limit) along with your workload’s memory usage. If the overall usage goes above resources.memory_limit the user process may get killed. Shared Memory Size cannot be more than the defined Memory Limit for the workload.
node
typing.Optional[ResourcesNode]
πŸ”— ResourcesNodeThis field determines how the underlying node resource is to be utilized
devices
typing.Optional[typing.List[ResourcesDevicesItem]]
πŸ”— ResourcesDevicesItemDefine custom device or accelerator requirements for your workload. We currently support NVIDIA GPUs, AWS Inferentia Accelerators, Single Host TPU Slices.

ResourcesDevicesItem

Union, One Of:

ResourcesNode

Union, One Of:

RevokeAllPersonalAccessTokenResponse

Union, One Of:

Rolling

type
typing.Literal[Any]
default:"rolling_update"
required
max_unavailable_percentage
int
default:"25"
required
Percentage of total replicas that can be brought down at one time. For a value of 25 when replicas are set to 12 this would mean minimum (25% of 12) = 3 pods might be unavailable during the deployment. Setting this to a higher value can help in speeding up the deployment process.
max_surge_percentage
int
default:"25"
required
Percentage of total replicas of updated image that can be brought up over the total replicas count. For a value of 25 when replicas are set to 12 this would mean (12

RpsMetric

type
typing.Literal[Any]
default:"rps"
required
value
float
required
Average request per second averaged over all replicas that autoscaler should try to maintain

RStudio

type
typing.Optional[typing.Literal[Any]]
image
typing.Optional[WorkbenchImage]

Schedule

type
typing.Literal[Any]
default:"scheduled"
required
schedule
str
required
Specify the schedule for this job to be run periodically in cron format.
* * * * *
| | | | |
| | | | |___ day of week (0-6) (Sunday is 0)
| | | |_____ month (1-12)
| | |_______ day of month (1-31)
| |_________ hour (0-23)
|___________ minute (0-59)
concurrency_policy
ScheduleConcurrencyPolicy
required
πŸ”— ScheduleConcurrencyPolicyChoose whether to allow this job to run while another instance of the job is running, or to replace the currently running instance. Allow will enable multiple instances of this job to run. Forbid will keep the current instance of the job running and stop a new instance from being run. Replace will terminate any currently running instance of the job and start a new one.
timezone
typing.Optional[str]
Timezone against which the cron schedule will be calculated, e.g. β€œAsia/Tokyo”. Default is machine’s local time. https://docs.truefoundry.com/docs/list-of-supported-timezones

Secret

id
str
required
fqn
str
required
name
str
required
secret_group_id
typing_extensions.Annotated[(str, Any)]
required
value
typing.Optional[str]
created_by_subject
typing_extensions.Annotated[(typing.Optional[Subject], Any)]
created_at
typing_extensions.Annotated[(typing.Optional[dt.datetime], Any)]
updated_at
typing_extensions.Annotated[(typing.Optional[dt.datetime], Any)]
secret_versions
typing_extensions.Annotated[(typing.Optional[typing.List[Any]], Any)]
active_deployments_count
typing_extensions.Annotated[(typing.Optional[int], Any)]
created_by
typing_extensions.Annotated[(typing.Optional[str], Any)]

SecretGroup

id
typing.Optional[str]
fqn
typing.Optional[str]
name
str
required
tenant_name
typing_extensions.Annotated[(str, Any)]
required
created_by_subject
typing_extensions.Annotated[(Subject, Any)]
required
associated_secrets
typing_extensions.Annotated[(typing.List[Any], Any)]
required
integration_id
typing_extensions.Annotated[(typing.Optional[str], Any)]
created_at
typing_extensions.Annotated[(dt.datetime, Any)]
required
updated_at
typing_extensions.Annotated[(dt.datetime, Any)]
required
created_by
typing_extensions.Annotated[(typing.Optional[str], Any)]

SecretInput

key
str
required
Key of the secret.
value
str
required
Value of the secret.

SecretMount

type
typing.Literal[Any]
default:"secret"
required
mount_path
str
required
Please enter a valid file path
secret_fqn
str
required
The TrueFoundry secret whose value will be the file content.

SecretVersion

id
str
required
fqn
str
required
value
typing.Optional[str]
version
typing.Optional[float]
secret
typing.Optional[Any]
secret_id
typing_extensions.Annotated[(typing.Optional[str], Any)]
created_at
typing_extensions.Annotated[(typing.Optional[dt.datetime], Any)]
updated_at
typing_extensions.Annotated[(typing.Optional[dt.datetime], Any)]

SelfHostedModel

type
typing.Literal[Any]
default:"integration/model/self-hosted-model"
required
name
str
required
2 to 62 characters long alphanumeric word, may contain - in between, cannot start with a number
hosted_model_name
str
required
The name of the hosted model
url
str
required
enter valid https/http URL that should not end with trailing slash
model_server
SelfHostedModelModelServer
required
πŸ”— SelfHostedModelModelServerThe type of model server being used
tfy_application_id
typing.Optional[str]
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeSpecify the type of the model
auth_data
typing.Optional[SelfHostedModelAuthData]
πŸ”— SelfHostedModelAuthDataSelfHostedModel authentication data for the integration.
headers
typing.Optional[typing.Dict[(str, str)]]
SelfHostedModel headers for the integration. Forwarded to the provider as is. For example: \{"Authorization": "APIKey \<token\>"\}
cost
typing.Optional[ModelCostMetric]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

SelfHostedModelAuthData

Union, One Of:

SelfHostedModelProviderAccount

type
typing.Literal[Any]
default:"provider-account/self-hosted-model"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
integrations
typing.List[SelfHostedModelIntegrations]
required
πŸ”— SelfHostedModelList of integrations that are associated with the provider account.
collaborators
typing.Optional[typing.List[Collaborator]]

Service

type
typing.Optional[typing.Literal[Any]]
replicas
typing.Optional[ServiceReplicas]
πŸ”— ServiceReplicasDeploy multiple instances of your pods to distribute incoming traffic across them, ensuring effective load balancing.
auto_shutdown
typing.Optional[Autoshutdown]
allow_interception
typing.Optional[bool]
Whether to allow intercepts to be applied for this service. This would inject an additional sidecar in each pod of the service. Not recommended on production
rollout_strategy
typing.Optional[ServiceRolloutStrategy]
πŸ”— ServiceRolloutStrategyStrategy to dictate how a rollout should happen when a new release for this service is made Docs

ServiceAutoscaling

metrics
typing.Optional[ServiceAutoscalingMetrics]
πŸ”— ServiceAutoscalingMetricsMetrics to use for the autoscaler

ServiceAutoscalingMetrics

Union, One Of:

ServiceReplicas

Union, One Of:

ServiceRolloutStrategy

Union, One Of:

Session

id
str
required
user_name
typing_extensions.Annotated[(str, Any)]
required
subject_slug
typing_extensions.Annotated[(str, Any)]
required
subject_controller_name
typing_extensions.Annotated[(typing.Optional[str], Any)]
subject_pat_name
typing_extensions.Annotated[(typing.Optional[str], Any)]
email
typing.Optional[str]
subject_type
typing_extensions.Annotated[(SubjectType, Any)]
required
tenant_name
typing_extensions.Annotated[(typing.Optional[str], Any)]
roles
typing.List[str]
required
teams
typing.List[str]
required
metadata
typing.Optional[UserMetadata]

SignedUrl

path
str
required
signed_url
str
required

SklearnFramework

type
typing.Literal[Any]
default:"sklearn"
required
Type of the framework
model_filepath
typing.Optional[str]
Relative path to the model file in the model version contents
serialization_format
typing.Optional[SklearnSerializationFormat]
model_schema
typing.Optional[SklearnModelSchema]

SklearnModelSchema

infer_method_name
InferMethodName
required
πŸ”— InferMethodNameName of the method used for inference
inputs
typing.List[typing.Dict[(str, typing.Optional[typing.Any])]]
Schema of the input
outputs
typing.List[typing.Dict[(str, typing.Optional[typing.Any])]]
Schema of the output

SlackBot

type
typing.Literal[Any]
default:"slack-bot"
required
notification_channel
str
required
Specify the notification channel to send alerts to
channels
typing.List[str]
required
3 to 81 lower case characters long alphanumeric word, may contain - or _ in between, must start with #

SlackBotAuth

type
typing.Literal[Any]
default:"slack-bot"
required
bot_token
str
required
The bot token for the slack bot to send messages to the channels. This bot should have the following permissions: chat:write, chat:write.public

SlackBotIntegration

type
typing.Literal[Any]
default:"integration/notification-channel/slack-bot"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
auth_data
SlackBotAuth
required
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

SlackIntegrations

Union, One Of:

SlackProviderAccount

type
typing.Literal[Any]
default:"provider-account/slack"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
integrations
typing.List[SlackIntegrations]
required
πŸ”— SlackIntegrationsList of integrations that are associated with the provider account.

SlackWebhook

type
typing.Literal[Any]
default:"slack-webhook"
required
notification_channel
str
required
Specify the notification channel to send alerts to

SlackWebhookAuth

type
typing.Literal[Any]
default:"slack-webhook"
required
webhook_url
str
required
The URL of the slack webhook

SlackWebhookIntegration

type
typing.Literal[Any]
default:"integration/notification-channel/slack-webhook"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
auth_data
SlackWebhookAuth
required
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

SmtpCredentials

type
typing.Literal[Any]
default:"smtp-credentials"
required
host
str
required
The SMTP host of the email server.
username
str
required
The username for the SMTP server.
password
str
required
The password for the SMTP server.
port
int
default:"587"
required
The port of the SMTP server.
tls
bool
required
Whether to use TLS for the SMTP server.

SpaCyFramework

type
typing.Literal[Any]
default:"spacy"
required
Type of the framework

SparkBuild

type
typing.Literal[Any]
default:"tfy-spark-buildpack"
required
spark_version
str
default:"3.5.2"
required
Spark version should match the spark version installed in the image.
build_context_path
str
default:"./"
required
Build path relative to project root path.
requirements_path
typing.Optional[str]
Path to requirements.txt relative to Path to build context

SparkConfig

ui_base_domain
str
required
Must not contain any spaces.

SparkDriverConfig

resources
typing.Optional[Resources]

SparkExecutorConfig

instances
SparkExecutorConfigInstances
required
resources
typing.Optional[Resources]

SparkExecutorConfigInstances

Union, One Of:

SparkExecutorDynamicScaling

type
typing.Literal[Any]
default:"dynamic"
required
min
int
default:"1"
required
Minimum number of instances to start / scale down to
max
int
default:"1"
required
Maximum number of instances to scale up to

SparkExecutorFixedInstances

type
typing.Literal[Any]
default:"fixed"
required
count
int
default:"1"
required
Number of instances to start

SparkImage

type
typing.Literal[Any]
default:"spark-image"
required
spark_version
str
default:"3.5.2"
required
Spark version should match the spark version installed in the image.
image_uri
str
required
The image URI. Specify the name of the image and the tag. If the image is in Dockerhub, you can skip registry-url (for e.g. tensorflow/tensorflow). You can use an image from a private registry using Advanced fields
docker_registry
typing.Optional[str]
FQN of the container registry. If you can’t find your registry here, add it through the Integrations page

SparkImageBuild

type
typing.Literal[Any]
default:"spark-image-build"
required
docker_registry
typing.Optional[str]
FQN of the container registry. If you can’t find your registry here, add it through the Integrations page
build_source
SparkImageBuildBuildSource
required
πŸ”— SparkImageBuildBuildSourceTODO (gw): The following is a hack till the uiType GitSelect is fixed fron frontend
build_spec
SparkBuild
required

SparkImageBuildBuildSource

Union, One Of:

SparkJob

type
typing.Literal[Any]
default:"spark-job"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
image
SparkJobImage
required
πŸ”— SparkJobImageThe image to use for driver and executors. Must have spark installed. Spark version must match the version in the image.
entrypoint
SparkJobEntrypoint
required
driver_config
SparkDriverConfig
required
executor_config
SparkExecutorConfig
required
env
typing.Optional[typing.Dict[(str, typing.Optional[typing.Any])]]
Configure environment variables to be injected in the service either as plain text. Docs
spark_conf
typing.Optional[typing.Dict[(str, typing.Optional[typing.Any])]]
Extra configuration properties to be passed to the spark job. Docs
mounts
typing.Optional[typing.List[VolumeMount]]
πŸ”— VolumeMountConfigure volumes to be mounted to driver and executors. Docs
retries
typing.Optional[int]
Specify the maximum number of attempts to retry a job before it is marked as failed.
service_account
typing.Optional[str]
workspace_fqn
typing.Optional[str]

SparkJobEntrypoint

Union, One Of:

SparkJobImage

Union, One Of:

SparkJobJavaEntrypoint

type
typing.Literal[Any]
default:"java"
required
main_application_file
str
required
Filename should have .jar extension
main_class
str
required
The main class must be a valid Java class name.
arguments
typing.Optional[str]
Arguments to be passed to the main application file.

SparkJobPythonEntrypoint

type
typing.Literal[Any]
default:"python"
required
main_application_file
str
required
Filename should have .py extension
arguments
typing.Optional[str]
Arguments to be passed to the main application file.

SparkJobPythonNotebookEntrypoint

type
typing.Literal[Any]
default:"python-notebook"
required
main_application_file
str
required
Filename should have .ipynb extension

SparkJobScalaEntrypoint

type
typing.Literal[Any]
default:"scala"
required
main_application_file
str
required
Filename should have .jar extension
main_class
str
required
The main class must be a valid Java class name.
arguments
typing.Optional[str]
Arguments to be passed to the main application file.

SparkJobScalaNotebookEntrypoint

type
typing.Literal[Any]
default:"scala-notebook"
required
main_application_file
str
required
Filename should have .ipynb extension

SparkJobTriggerInput

main_class
typing_extensions.Annotated[(typing.Optional[str], Any)]
Main Class for Spark Job
main_application_file
typing_extensions.Annotated[(typing.Optional[str], Any)]
Main Application File for Spark Job
arguments
typing.Optional[str]
Arguments to pass to the main application file

SqsInputConfig

type
typing.Literal[Any]
default:"sqs"
required
queue_url
str
required
AWS SQS Queue URL of Subscriber
region_name
str
required
AWS Region Name
visibility_timeout
int
required
A period during which Amazon SQS prevents all consumers from receiving and processing the message. If one message takes 5 seconds to process, you can set this number to 7 or any number higher than 5. This will ensure that while the message is being processed, it will not be available to other replicas. For more information, see here
wait_time_seconds
int
default:"19"
required
Wait timeout for long polling. For more information, see here
auth
AwsAccessKeyAuth
required

SqsOutputConfig

type
typing.Literal[Any]
default:"sqs"
required
queue_url
str
required
AWS SQS Queue URL of Publisher
region_name
str
required
AWS Region Name
auth
AwsAccessKeyAuth
required

SqsQueueMetricConfig

type
typing.Literal[Any]
default:"sqs"
required
queue_length
int
required
Upper limit of the number of backlog messages the auto-scaler will try to maintain per replica. If you set this number to 10 and have 30 messages in the queue and one replica, the auto-scaler will scale the number of replicas to 3.

SshServer

type
typing.Optional[typing.Literal[Any]]
image
typing.Optional[WorkbenchImage]
ssh_public_key
typing.Optional[str]
Add Your SSH Public Key, this will be used to authenticate you to the SSH Server. You can find it using cat ~/.ssh/id_rsa.pub in Mac/Linux or type $home\.ssh\id_rsa.pub in Windows Powershell. You can also generate a new SSH key pair using ssh-keygen -t rsa in your local terminal. (same for both Mac/Linux and Windows Powershell)
cull_timeout
typing.Optional[int]
Stop the SSH Server instance after this much time in minutes of inactivity. The instance is considered active if there is at least one active SSH connection (a client connected to the SSH server), or if a background job is running using tmux or screen, or if the pod has restarted.

SshServerConfig

base_domain
str
required
Must not contain any spaces.
port
float
required
The port for the cluster with which you can access your SSH containers

StageArtifactRequestManifest

Union, One Of:

StageArtifactResponse

id
str
required
storage_root
str
required
artifact_id
str
required

StaticVolumeConfig

type
typing.Literal[Any]
default:"static"
required
Volume Type for the volume.
persistent_volume_name
str
required
Persistent Volume Name of the volume to be used.

StatsModelsFramework

type
typing.Literal[Any]
default:"statsmodels"
required
Type of the framework

StringDataMount

type
typing.Literal[Any]
default:"string"
required
mount_path
str
required
Please enter a valid file path
data
str
required
The file content.

Subject

subject_id
typing_extensions.Annotated[(str, Any)]
required
Subject ID
subject_type
typing_extensions.Annotated[(SubjectType, Any)]
required
subject_slug
typing_extensions.Annotated[(typing.Optional[str], Any)]
Subject slug
subject_display_name
typing_extensions.Annotated[(typing.Optional[str], Any)]
Subject display name

SystemMessage

role
typing.Literal[Any]
default:"system"
required
Role of the message
content
SystemMessageContent
required
πŸ”— SystemMessageContentText content for the system message
name
typing.Optional[str]
Name of the system

SystemMessageContent

Union, One Of:

TaskDockerFileBuild

type
typing.Literal[Any]
default:"task-dockerfile-build"
required
docker_registry
typing.Optional[str]
FQN of the container registry. If you can’t find your registry here, add it through the Integrations page
dockerfile_path
str
default:"./Dockerfile"
required
The file path of the Dockerfile relative to project root path.
build_args
typing.Optional[typing.Dict[(str, str)]]

TaskPySparkBuild

type
typing.Literal[Any]
default:"task-pyspark-build"
required
spark_version
str
default:"3.5.2"
required
Spark version should match the spark version installed in the image.
docker_registry
typing.Optional[str]
FQN of the container registry. If you can’t find your registry here, add it through the Integrations page
requirements_path
typing.Optional[str]
Path to requirements.txt relative to Path to build context
pip_packages
typing.Optional[typing.List[str]]
Define pip package requirements. In Python/YAML E.g. [β€œfastapi>=0.90,<1.0”, β€œuvicorn”]
apt_packages
typing.Optional[typing.List[str]]
Debian packages to install via apt get. In Python/YAML E.g. [β€œgit”, β€œffmpeg”, β€œhtop”]

TaskPythonBuild

type
typing.Literal[Any]
default:"task-python-build"
required
docker_registry
typing.Optional[str]
FQN of the container registry. If you can’t find your registry here, add it through the Integrations page
python_version
typing.Optional[str]
Please enter a valid Python version tag
requirements_path
typing.Optional[str]
Path to requirements.txt relative to Path to build context
pip_packages
typing.Optional[typing.List[str]]
Define pip package requirements. In Python/YAML E.g. [β€œfastapi>=0.90,<1.0”, β€œuvicorn”]
apt_packages
typing.Optional[typing.List[str]]
Debian packages to install via apt get. In Python/YAML E.g. [β€œgit”, β€œffmpeg”, β€œhtop”]
cuda_version
typing.Optional[str]
Version of CUDA Toolkit and CUDNN to install in the image These combinations are based off of publically available docker images on docker hub You can also specify a valid tag of the form {cuda_version_number}-cudnn{cudnn_version_number}-{runtime|devel}-ubuntu{ubuntu_version} Refer https://hub.docker.com/r/nvidia/cuda/tags for valid set of values Note: We use deadsnakes ubuntu ppa to add Python that currently supports only Ubuntu 18.04, 20.04 and 22.04

Team

id
str
required
team_name
typing_extensions.Annotated[(str, Any)]
required
description
str
required
tenant_name
typing_extensions.Annotated[(str, Any)]
required
created_by_subject
typing_extensions.Annotated[(Subject, Any)]
required
members
typing.Optional[typing.List[str]]
created_at
typing_extensions.Annotated[(dt.datetime, Any)]
required
updated_at
typing_extensions.Annotated[(dt.datetime, Any)]
required
manifest
TeamManifest
required

TeamManifest

type
typing.Literal[Any]
default:"team"
required
name
str
required
Use of only alpha numeric character and ”-” is allowed as team name and must be less than 25 characters
members
typing.List[str]
required
Enter email of each of the user you want to add in the team.

TensorFlowFramework

type
typing.Literal[Any]
default:"tensorflow"
required
Type of the framework

TerminateJobResponse

message
str
required
Terminate Job Message
job_run_status
typing_extensions.Annotated[(JobRunStatus, Any)]
required
πŸ”— JobRunStatusJob run status

TextContentPart

type
typing.Literal[Any]
default:"text"
required
Type of the content part
text
TextContentPartText
required
πŸ”— TextContentPartTextText content for the message

TextContentPartText

Union, One Of:

TogetherAiKeyAuth

type
typing.Literal[Any]
default:"api-key"
required
api_key
str
required
API key must not be empty

TogetherAiModel

type
typing.Literal[Any]
default:"integration/model/together-ai"
required
name
str
required
2 to 62 characters long alphanumeric word, may contain - in between, cannot start with a number
model_id
str
required
Model ID must not be empty
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeSpecify the type of the Together AI model
cost
typing.Optional[ModelCostMetric]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

TogetherAiProviderAccount

type
typing.Literal[Any]
default:"provider-account/together-ai"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
auth_data
TogetherAiKeyAuth
required
integrations
typing.Optional[typing.List[TogetherAiIntegrations]]
List of integrations that are associated with the Together AI provider account
collaborators
typing.Optional[typing.List[Collaborator]]
πŸ”— CollaboratorList of users who have access to this provider account

TokenPagination

limit
typing.Optional[int]
previous_page_token
typing.Optional[str]
next_page_token
typing.Optional[str]

ToolCall

type
typing.Literal[Any]
default:"function"
required
Type of the tool call
id
str
required
Unique identifier for the tool call
function
Function
required

ToolMessage

role
typing.Literal[Any]
default:"tool"
required
Role of the message
content
ToolMessageContent
required
πŸ”— ToolMessageContentContent of the tool call result
tool_call_id
str
required
Unique identifier for the tool call

ToolMessageContent

Union, One Of:

ToolSchema

type
typing.Literal[Any]
default:"function"
required
Type of the tool
function
FunctionSchema
required

TracingProject

id
str
required
name
str
required
fqn
str
required
ml_repo_id
int
required
manifest
TracingProjectManifest
required
created_by_subject
Subject
required
created_at
dt.datetime
required
updated_at
dt.datetime
required

TracingProjectManifest

type
typing.Literal[Any]
default:"tracing-project"
required
name
str
required
Name of the tracing project
ml_repo
typing.Optional[str]
Name of the ML Repo

TransformersFramework

type
typing.Literal[Any]
default:"transformers"
required
Type of the framework
library_name
typing.Optional[LibraryName]
πŸ”— LibraryNameName of the library for the framework
pipeline_tag
typing.Optional[str]
The pipeline() task this model can be used with e.g. text-generation. See huggingface docs for all possible values
base_model
typing.Optional[str]
Base model Id from HuggingFace Hub. If this is a finetuned model, this points to the base model id used for finetuning.

TriggerJobRequestInput

Union, One Of:

TriggerJobRunResponse

message
str
required
Job triggered
job_run_name
typing_extensions.Annotated[(str, Any)]
required
Name of the job run
data
JobRun
required
πŸ”— JobRunDetails of the triggered job run

TrueFoundryApplyRequestManifest

Union, One Of:

TrueFoundryApplyResponse

existing_manifest
typing_extensions.Annotated[(typing.Optional[TrueFoundryApplyResponseExistingManifest], Any)]
πŸ”— TrueFoundryApplyResponseExistingManifestThe existing manifest of the resource
action
typing.Optional[TrueFoundryApplyResponseAction]
πŸ”— TrueFoundryApplyResponseActionThe action performed: CREATE or UPDATE

TrueFoundryApplyResponseExistingManifest

Union, One Of:

TrueFoundryArtifactSource

type
typing.Literal[Any]
default:"truefoundry-artifact"
required
artifact_version_fqn
str
required
Artifact or Model Version FQN of the artifact to be downloaded
download_path_env_variable
str
required
Environment variable which will contain the download path of the artifact

TrueFoundryDbssm

type
typing.Literal[Any]
default:"integration/secret-store/truefoundry/db"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

TrueFoundryDeleteRequestManifest

Union, One Of:

TrueFoundryInteractiveLogin

type
typing.Literal[Any]
default:"truefoundry_oauth"
required
bypass_auth_paths
typing.Optional[typing.List[str]]
List of paths that will bypass auth. needs to start with a forward slash(/) and should not contain wildcards(*)

TrueFoundryManagedSource

type
typing.Literal[Any]
default:"truefoundry"
required
Type of the source
uri
typing.Optional[str]

TrueFoundryProviderAccount

type
typing.Literal[Any]
default:"provider-account/truefoundry"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
integrations
typing.Optional[typing.List[TrueFoundryIntegrations]]
List of integrations that are associated with the provider account.

TtlProviderAccount

type
typing.Literal[Any]
default:"provider-account/ttl"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
integrations
typing.List[TtlIntegrations]
required
List of integrations that are associated with the provider account.

TtlRegistry

type
typing.Literal[Any]
default:"integration/docker-registry/ttl"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
registry_url
str
default:"https://ttl.sh"
required
The URL of the registry.
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

UpdateSecretInput

key
str
required
Key of the secret.
value
typing.Optional[str]
Value of the secret.

UpdateUserRolesResponse

Union, One Of:

UpgradeData

diff
typing.Optional[typing.List[Any]]
current_manifest
typing_extensions.Annotated[(typing.Optional[Helm], Any)]
desired_manifest
typing_extensions.Annotated[(typing.Optional[Helm], Any)]
upgrade_possible
typing_extensions.Annotated[(typing.Optional[bool], Any)]
conflict_fields
typing_extensions.Annotated[(typing.Optional[typing.List[str]], Any)]
has_conflict
typing_extensions.Annotated[(typing.Optional[bool], Any)]

UsageLimits

tokens_per_minute
typing.Optional[int]
Maximum number of tokens processed per minute
requests_per_minute
typing.Optional[int]
Maximum number of requests processed per minute

User

id
str
required
email
str
required
user_name
typing_extensions.Annotated[(str, Any)]
required
tenant_name
typing_extensions.Annotated[(str, Any)]
required
metadata
UserMetadata
required
roles
typing.Optional[typing.List[str]]
active
bool
required
created_at
typing_extensions.Annotated[(dt.datetime, Any)]
required
updated_at
typing_extensions.Annotated[(dt.datetime, Any)]
required

UserMessage

role
typing.Literal[Any]
default:"user"
required
Role of the message
content
UserMessageContent
required
πŸ”— UserMessageContentContent of the user message. can be a mix of text and images
name
typing.Optional[str]
Name of the user this message is from

UserMessageContent

Union, One Of:

UserMessageContentItem

Union, One Of:

UserMetadata

sub
typing.Optional[str]
image_url
typing_extensions.Annotated[(typing.Optional[str], Any)]
display_name
typing_extensions.Annotated[(typing.Optional[str], Any)]
user_object
typing_extensions.Annotated[(typing.Optional[typing.Dict[(str, typing.Optional[typing.Any])]], Any)]
invite_accepted
typing_extensions.Annotated[(typing.Optional[bool], Any)]
registered_in_idp
typing_extensions.Annotated[(typing.Optional[bool], Any)]
preference
typing.Optional[typing.Dict[(str, typing.Optional[typing.Any])]]

ValidationError

loc
typing.List[ValidationErrorLocItem]
required
msg
str
required
type
str
required

ValidationErrorLocItem

Union, One Of:

VertexModel

name
str
required
2 to 62 characters long alphanumeric word, may contain - in between, cannot start with a number
model_id
str
required
type
typing.Literal[Any]
default:"integration/model/gcp/vertex"
required
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeSpecify the type of the model
region
typing.Optional[GcpRegion]
cost
typing.Optional[ModelCostMetric]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

VertexModelV2

type
typing.Literal[Any]
default:"integration/model/vertex"
required
name
str
required
2 to 62 characters long alphanumeric word, may contain - in between, cannot start with a number
model_id
str
required
Model ID must not be empty
region
typing.Optional[GcpRegion]
model_types
typing.List[ModelType]
required
πŸ”— ModelTypeSpecify the type of the Vertex AI model (e.g., chat, text, etc.)
cost
typing.Optional[ModelCostMetric]
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

VirtualAccount

id
str
required
name
str
required
type
str
required
tenant_name
typing_extensions.Annotated[(str, Any)]
required
manifest
typing.Optional[VirtualAccountManifest]
created_by_subject
typing_extensions.Annotated[(Subject, Any)]
required
created_at
typing_extensions.Annotated[(dt.datetime, Any)]
required
updated_at
typing_extensions.Annotated[(dt.datetime, Any)]
required
created_by
typing_extensions.Annotated[(typing.Optional[str], Any)]

VirtualAccountManifest

name
str
required
3 to 25 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
type
typing.Literal[Any]
default:"virtual-account"
required
expiration_date
typing.Optional[str]
Expiration date of the virtual account
permissions
typing.List[Permissions]
required

Volume

type
typing.Literal[Any]
default:"volume"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
config
VolumeConfig
required
πŸ”— VolumeConfigVolume Configuration, can be either Dynamically provisioned or statically provisioned.
volume_browser
typing.Optional[VolumeBrowser]
workspace_fqn
typing.Optional[str]

VolumeBrowser

username
typing.Optional[str]
3 to 10 lower case characters long alphanumeric word, may contain - in between, cannot start with a number.
password_secret_fqn
typing.Optional[str]
TFY Secret containing the password for logging in the volume browser.
endpoint
Endpoint
required
service_account
typing.Optional[str]
Kubernetes Service account name for the volume browser.

VolumeConfig

Union, One Of:

VolumeMount

type
typing.Literal[Any]
default:"volume"
required
mount_path
str
required
Please enter a valid mount path
sub_path
typing.Optional[str]
Sub path within the volume to mount. Defaults to root of the volume.
volume_fqn
str
required
The TrueFoundry volume that needs to be mounted.

WebhookBasicAuth

type
typing.Literal[Any]
default:"webhook-basic"
required
username
str
required
Basic auth username
password
str
required
Basic auth password

WebhookBearerAuth

type
typing.Literal[Any]
default:"webhook-bearer"
required
token
str
required
Bearer token for authentication
prefix
str
default:"Bearer"
required
Prefix for the token

WebhookIntegration

type
typing.Literal[Any]
default:"integration/gateway-request-logger/webhook"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
webhook_url
str
required
The URL of the webhook endpoint
auth_data
typing.Optional[WebhookIntegrationAuthData]
πŸ”— WebhookIntegrationAuthDataAuthentication configuration for the webhook
authorized_subjects
typing.Optional[typing.List[str]]
List of subjects that are authorized to access this integration. List of user fqn in format <user_type>:<username>.

WebhookIntegrationAuthData

Union, One Of:

WebhookProviderAccount

type
typing.Literal[Any]
default:"provider-account/webhook"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
integrations
typing.List[WebhookIntegrations]
required
πŸ”— WebhookIntegrationList of integrations that are associated with the provider account.

WeightBasedLoadBalancingRule

id
str
required
Unique identifier for the rule
when
LoadBalancingWhen
required
load_balance_targets
typing.List[LoadBalanceTarget]
required
πŸ”— LoadBalanceTargetList of targets for load balancing with weights
type
typing.Literal[Any]
default:"weight-based-routing"
required

WorkbenchImage

image_uri
str
required
The image URI. Specify the name of the image and the tag. If the image is in Dockerhub, you can skip registry-url (for e.g. tensorflow/tensorflow). You can use an image from a private registry using Advanced fields
build_script
typing.Optional[str]
The build script to run when building the image. This will be executed as the last step in the docker build process as the root user (RUN DEBIAN_FRONTEND=noninteractive bash -ex build_script.sh)
docker_registry
typing.Optional[str]
FQN of the container registry. If you can’t find your registry here, add it through the Integrations page

WorkerConfig

input_config
WorkerConfigInputConfig
required
output_config
typing.Optional[WorkerConfigOutputConfig]
num_concurrent_workers
int
default:"1"
required
Number of concurrent workers to spawn for the processor

WorkerConfigInputConfig

Union, One Of:

WorkerConfigOutputConfig

Union, One Of:

Workflow

type
typing.Literal[Any]
default:"workflow"
required
name
str
required
3 to 32 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
source
WorkflowSource
required
workflow_file_path
str
required
flyte_entities
typing.Optional[typing.List[WorkflowFlyteEntitiesItem]]
alerts
typing.Optional[typing.List[WorkflowAlert]]

WorkflowAlert

notification_target
typing.Optional[NotificationTarget]
on_completion
typing.Optional[bool]
Send an alert when the job completes
on_failure
typing.Optional[bool]
Send an alert when the job fails

WorkflowFlyteEntitiesItem

Union, One Of:

WorkflowSource

Union, One Of:

Workspace

id
str
required
fqn
str
required
name
str
required
tenant_name
typing_extensions.Annotated[(str, Any)]
required
cluster_id
typing_extensions.Annotated[(str, Any)]
required
created_by_subject
typing_extensions.Annotated[(Subject, Any)]
required
created_at
typing_extensions.Annotated[(dt.datetime, Any)]
required
updated_at
typing_extensions.Annotated[(dt.datetime, Any)]
required
environment_id
typing_extensions.Annotated[(typing.Optional[str], Any)]
manifest
WorkspaceManifest
required
is_system_ws
typing_extensions.Annotated[(typing.Optional[bool], Any)]
created_by
typing_extensions.Annotated[(typing.Optional[str], Any)]

WorkspaceManifest

type
typing.Literal[Any]
default:"workspace"
required
cluster_fqn
str
required
name
str
required
3 to 25 lower case characters long alphanumeric word, may contain - in between, cannot start with a number
environment_name
typing.Optional[str]
Tag the environment like dev, staging or production. You will need to create environments if you don’t have already.
labels
typing.Optional[typing.Dict[(str, str)]]
annotations
typing.Optional[typing.Dict[(str, str)]]
collaborators
typing.Optional[typing.List[Collaborator]]
permissions
typing.Optional[typing.List[Permissions]]

WorkspacesDeleteResponse

workspace
typing.Optional[Workspace]
message
typing.Optional[str]
Destroyed the workspace

XgBoostFramework

type
typing.Literal[Any]
default:"xgboost"
required
Type of the framework
serialization_format
typing.Optional[XgBoostSerializationFormat]
model_filepath
typing.Optional[str]
Relative path to the model file in the model version contents
model_schema
typing.Optional[XgBoostModelSchema]

XgBoostModelSchema

infer_method_name
typing.Literal[Any]
default:"predict"
required
Name of the method used for inference
inputs
typing.List[typing.Dict[(str, typing.Optional[typing.Any])]]
Schema of the input
outputs
typing.List[typing.Dict[(str, typing.Optional[typing.Any])]]
Schema of the output